Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 178edafa2ddbc40465115383b13685f7bc913b1f / . / www / api / statistic.html
blob: c84213319d6249d67d65e615a43a1bc646ad71ec [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 Statistics</title>
cristy3749be42010-02-02 02:46:51 +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"/>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]14 <meta name="Generator" content="PHP"/>
15 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, image, statistics, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
cristy3749be42010-02-02 02:46:51 +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"/>
cristy3749be42010-02-02 02:46:51 +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=""
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]56 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]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
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]66</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]67<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]107</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]108<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]126</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]127<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]130</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]131<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]137</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]138<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]141
142<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]143<div class="sponsor">
144 <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
145</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]146<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]147 <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]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">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]156 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
157</div>
158<div class="sponsor">
cristye855cb32011-01-16 02:13:10 +0000[diff] [blame]159 <a title="Sponsor: Fernsehdienst Berlin" href="http://www.atlas-multimedia.de">Fernsehdienst Berlin</a><!-- 2011050100025 atlas.multimedia-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]160</div>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]161</div>
162</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]163</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]164
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]165<div class="eastbar">
166 <script type="text/javascript">
167 <!--
168 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]169 google_ad_slot = "0574824969";
170 google_ad_width = 160;
171 google_ad_height = 600;
172 //-->
173 </script>
174 <script type="text/javascript"
175 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
176 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]177</div>
178
179<div class="main">
180
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]181<h1>Module statistic
182 Methods</h1>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]183<p class="navigation-index">[<a href="#EvaluateImage">EvaluateImage</a> &bull; <a href="#FunctionImage">FunctionImage</a> &bull; <a href="#GetImageChannelMean">GetImageChannelMean</a> &bull; <a href="#GetImageChannelKurtosis">GetImageChannelKurtosis</a> &bull; <a href="#GetImageChannelRange">GetImageChannelRange</a> &bull; <a href="#GetImageChannelStatistics">GetImageChannelStatistics</a>]</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]184
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]185<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
186_8c.html" id="EvaluateImage">EvaluateImage</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]187<div class="doc-section">
188
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]189<p>EvaluateImage() applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]190
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]191<p>The format of the EvaluateImageChannel method is:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]192
193<pre class="code">
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]194 MagickBooleanType EvaluateImage(Image *image,
195 const MagickEvaluateOperator op,const double value,
196 ExceptionInfo *exception)
197 MagickBooleanType EvaluateImages(Image *images,
198 const MagickEvaluateOperator op,const double value,
199 ExceptionInfo *exception)
200 MagickBooleanType EvaluateImageChannel(Image *image,
201 const ChannelType channel,const MagickEvaluateOperator op,
202 const double value,ExceptionInfo *exception)
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]203</pre>
204
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]205<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]206
207<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]208<p>the image.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]209
210<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]211<p>the channel.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]212
213<h5>op</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]214<p>A channel op.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]215
216<h5>value</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]217<p>A value value.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]218
219<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]220<p>return any errors or warnings in this structure.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]221
222 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]223<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
224_8c.html" id="FunctionImage">FunctionImage</a></h2>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]225<div class="doc-section">
226
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]227<p>FunctionImage() applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]228
229<p>The format of the FunctionImageChannel method is:</p>
230
231<pre class="code">
232 MagickBooleanType FunctionImage(Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]233 const MagickFunction function,const ssize_t number_parameters,
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]234 const double *parameters,ExceptionInfo *exception)
235 MagickBooleanType FunctionImageChannel(Image *image,
236 const ChannelType channel,const MagickFunction function,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]237 const ssize_t number_parameters,const double *argument,
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]238 ExceptionInfo *exception)
239</pre>
240
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]241<p>A description of each parameter follows:</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]242
243<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]244<p>the image.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]245
246<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]247<p>the channel.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]248
249<h5>function</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]250<p>A channel function.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]251
252<h5>parameters</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]253<p>one or more parameters.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]254
255<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]256<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]257
258 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]259<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
260_8c.html" id="GetImageChannelMean">GetImageChannelMean</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]261<div class="doc-section">
262
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]263<p>GetImageChannelMean() returns the mean and standard deviation of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]264
265<p>The format of the GetImageChannelMean method is:</p>
266
267<pre class="code">
268 MagickBooleanType GetImageChannelMean(const Image *image,
269 const ChannelType channel,double *mean,double *standard_deviation,
270 ExceptionInfo *exception)
271</pre>
272
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]273<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]274
275<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]276<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]277
278<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]279<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]280
281<h5>mean</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]282<p>the average value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]283
284<h5>standard_deviation</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]285<p>the standard deviation of the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]286
287<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]288<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]289
290 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]291<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
292_8c.html" id="GetImageChannelKurtosis">GetImageChannelKurtosis</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]293<div class="doc-section">
294
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]295<p>GetImageChannelKurtosis() returns the kurtosis and skewness of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]296
297<p>The format of the GetImageChannelKurtosis method is:</p>
298
299<pre class="code">
300 MagickBooleanType GetImageChannelKurtosis(const Image *image,
301 const ChannelType channel,double *kurtosis,double *skewness,
302 ExceptionInfo *exception)
303</pre>
304
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]305<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]306
307<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]308<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]309
310<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]311<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]312
313<h5>kurtosis</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]314<p>the kurtosis of the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]315
316<h5>skewness</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]317<p>the skewness of the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]318
319<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]320<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]321
322 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]323<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
324_8c.html" id="GetImageChannelRange">GetImageChannelRange</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]325<div class="doc-section">
326
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]327<p>GetImageChannelRange() returns the range of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]328
329<p>The format of the GetImageChannelRange method is:</p>
330
331<pre class="code">
332 MagickBooleanType GetImageChannelRange(const Image *image,
333 const ChannelType channel,double *minima,double *maxima,
334 ExceptionInfo *exception)
335</pre>
336
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]337<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]338
339<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]340<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]341
342<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]343<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]344
345<h5>minima</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]346<p>the minimum value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]347
348<h5>maxima</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]349<p>the maximum value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]350
351<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]352<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]353
354 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]355<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
356_8c.html" id="GetImageChannelStatistics">GetImageChannelStatistics</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]357<div class="doc-section">
358
359<p>GetImageChannelStatistics() returns statistics for each channel in the image. The statistics include the channel depth, its minima, maxima, mean, standard deviation, kurtosis and skewness. You can access the red channel mean, for example, like this:</p>
360
361<pre class="text">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame^]362 channel_statistics=GetImageChannelStatistics(image,exception);
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]363 red_mean=channel_statistics[RedChannel].mean;
364</pre>
365
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]366<p>Use MagickRelinquishMemory() to free the statistics buffer.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]367
368<p>The format of the GetImageChannelStatistics method is:</p>
369
370<pre class="code">
371 ChannelStatistics *GetImageChannelStatistics(const Image *image,
372 ExceptionInfo *exception)
373</pre>
374
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]375<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]376
377<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]378<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]379
380<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]381<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]382
383 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]384
385</div>
386
387<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]388 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]389 <span id="linkbar-center">
390 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]391 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]392 </span>
393 <span id="linkbar-east">&nbsp;</span>
394 </div>
395 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]396 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]397 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
398 </div>
399 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]400 <script type="text/javascript">
401 var _gaq = _gaq || [];
402 _gaq.push(['_setAccount', 'UA-17690367-1']);
403 _gaq.push(['_trackPageview']);
404
405 (function() {
406 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
407 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
408 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
409 })();
410 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]411</body>
412</html>