Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / af8d6655e12345c48d687558c0665070d206a942 / . / www / api / statistic.html
blob: 7b60cd9cae5f7919371d773cc618feaf2b4a6963 [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"/>
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"/>
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/">
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
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]68</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]69<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]128</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]129<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]132</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]133<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]139</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]140<div class="sep"></div>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +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">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame^]167 <a title="Sponsor: Custom T-Shirts" href="http://www.ooshirts.com">Custom T-Shirts</a><!-- 2011050100030 ooshirts.com-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]168</div>
cristy3749be42010-02-02 02:46:51 +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 statistic
190 Methods</h1>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]191<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]192
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]193<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
194_8c.html" id="EvaluateImage">EvaluateImage</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]195<div class="doc-section">
196
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]197<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]198
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]199<p>The format of the EvaluateImageChannel method is:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]200
201<pre class="code">
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]202 MagickBooleanType EvaluateImage(Image *image,
203 const MagickEvaluateOperator op,const double value,
204 ExceptionInfo *exception)
205 MagickBooleanType EvaluateImages(Image *images,
206 const MagickEvaluateOperator op,const double value,
207 ExceptionInfo *exception)
208 MagickBooleanType EvaluateImageChannel(Image *image,
209 const ChannelType channel,const MagickEvaluateOperator op,
210 const double value,ExceptionInfo *exception)
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]211</pre>
212
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]213<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]214
215<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]216<p>the image.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]217
218<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]219<p>the channel.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]220
221<h5>op</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]222<p>A channel op.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]223
224<h5>value</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]225<p>A value value.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]226
227<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]228<p>return any errors or warnings in this structure.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]229
230 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]231<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
232_8c.html" id="FunctionImage">FunctionImage</a></h2>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]233<div class="doc-section">
234
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]235<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]236
237<p>The format of the FunctionImageChannel method is:</p>
238
239<pre class="code">
240 MagickBooleanType FunctionImage(Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]241 const MagickFunction function,const ssize_t number_parameters,
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]242 const double *parameters,ExceptionInfo *exception)
243 MagickBooleanType FunctionImageChannel(Image *image,
244 const ChannelType channel,const MagickFunction function,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]245 const ssize_t number_parameters,const double *argument,
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]246 ExceptionInfo *exception)
247</pre>
248
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]249<p>A description of each parameter follows:</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]250
251<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]252<p>the image.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]253
254<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]255<p>the channel.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]256
257<h5>function</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]258<p>A channel function.</p>
cristy63fed272010-03-07 19:08:45 +0000[diff] [blame]259
260<h5>parameters</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]261<p>one or more parameters.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]262
263<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]264<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]265
266 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]267<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
268_8c.html" id="GetImageChannelMean">GetImageChannelMean</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]269<div class="doc-section">
270
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]271<p>GetImageChannelMean() returns the mean and standard deviation of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]272
273<p>The format of the GetImageChannelMean method is:</p>
274
275<pre class="code">
276 MagickBooleanType GetImageChannelMean(const Image *image,
277 const ChannelType channel,double *mean,double *standard_deviation,
278 ExceptionInfo *exception)
279</pre>
280
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]281<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]282
283<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]284<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]285
286<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]287<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]288
289<h5>mean</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]290<p>the average value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]291
292<h5>standard_deviation</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]293<p>the standard deviation of the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]294
295<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]296<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]297
298 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]299<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
300_8c.html" id="GetImageChannelKurtosis">GetImageChannelKurtosis</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]301<div class="doc-section">
302
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]303<p>GetImageChannelKurtosis() returns the kurtosis and skewness of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]304
305<p>The format of the GetImageChannelKurtosis method is:</p>
306
307<pre class="code">
308 MagickBooleanType GetImageChannelKurtosis(const Image *image,
309 const ChannelType channel,double *kurtosis,double *skewness,
310 ExceptionInfo *exception)
311</pre>
312
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]313<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]314
315<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]316<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]317
318<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]319<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]320
321<h5>kurtosis</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]322<p>the kurtosis of the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]323
324<h5>skewness</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]325<p>the skewness of the channel.</p>
cristy3749be42010-02-02 02:46:51 +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>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]329
330 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]331<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
332_8c.html" id="GetImageChannelRange">GetImageChannelRange</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]333<div class="doc-section">
334
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]335<p>GetImageChannelRange() returns the range of one or more image channels.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]336
337<p>The format of the GetImageChannelRange method is:</p>
338
339<pre class="code">
340 MagickBooleanType GetImageChannelRange(const Image *image,
341 const ChannelType channel,double *minima,double *maxima,
342 ExceptionInfo *exception)
343</pre>
344
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]345<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]346
347<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]348<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]349
350<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]351<p>the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]352
353<h5>minima</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]354<p>the minimum value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]355
356<h5>maxima</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]357<p>the maximum value in the channel.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]358
359<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]360<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]361
362 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]363<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/statistic
364_8c.html" id="GetImageChannelStatistics">GetImageChannelStatistics</a></h2>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]365<div class="doc-section">
366
367<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>
368
369<pre class="text">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]370 channel_statistics=GetImageChannelStatistics(image,exception);
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]371 red_mean=channel_statistics[RedChannel].mean;
372</pre>
373
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]374<p>Use MagickRelinquishMemory() to free the statistics buffer.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]375
376<p>The format of the GetImageChannelStatistics method is:</p>
377
378<pre class="code">
379 ChannelStatistics *GetImageChannelStatistics(const Image *image,
380 ExceptionInfo *exception)
381</pre>
382
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]383<p>A description of each parameter follows:</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]384
385<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]386<p>the image.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]387
388<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]389<p>return any errors or warnings in this structure.</p>
cristy3749be42010-02-02 02:46:51 +0000[diff] [blame]390
391 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]392
393</div>
394
395<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]396 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]397 <span id="linkbar-center">
398 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]399 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]400 </span>
401 <span id="linkbar-east">&nbsp;</span>
402 </div>
403 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]404 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]405 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
406 </div>
407 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]408 <script type="text/javascript">
409 var _gaq = _gaq || [];
410 _gaq.push(['_setAccount', 'UA-17690367-1']);
411 _gaq.push(['_trackPageview']);
412
413 (function() {
414 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
415 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
416 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
417 })();
418 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]419</body>
420</html>