Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / e6529ff52c05a2d3352d83a429cb69aa15f5b585 / . / www / magick-core.html
blob: f37450209e333a816c9e4e70bbc6fab0a08b7fdc [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]5<head>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
7 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]8 <title>ImageMagick: MagickCore, Low-level C API for ImageMagick</title>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]9 <meta http-equiv="Content-Language" content="en-US"/>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
11 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]12 <meta name="Application-name" content="ImageMagick"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]13 <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]14 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]15 <meta name="Generator" content="PHP"/>
16 <meta name="Keywords" content="magickcore, low-level, c, api, for, imagemagick, 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]17 <meta name="Rating" content="GENERAL"/>
18 <meta name="Robots" content="INDEX, FOLLOW"/>
19 <meta name="Generator" content="ImageMagick Studio LLC"/>
20 <meta name="Author" content="ImageMagick Studio LLC"/>
21 <meta name="Revisit-after" content="2 DAYS"/>
22 <meta name="Resource-type" content="document"/>
cristy7e41fe82010-12-04 23:12:08 +0000[diff] [blame]23 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]24 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]25 <link rel="icon" href="../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]26 <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
27 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]28 <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]29 <style type="text/css" media="all">
30 @import url("../www/magick.css");
31 </style>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]32 <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]33 <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>
34 <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />
35 <script type="text/javascript">
36 $(document).ready(function() {
37 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
38 'transitionIn' : 'elastic',
39 'transitionOut' : 'elastic',
40 'overlayShow' : false,
41 'opacity' : true
42 });
43 });
44 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]45</head>
46
47<body id="www-imagemagick-org">
48<div class="titlebar">
49<a href="../index.html">
50 <img src="../images/script.png" alt="[ImageMagick]"
51 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
52<a href="http://www.networkredux.com">
53 <img src="../images/networkredux.png" alt="[sponsor]"
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]54 style="margin-top: 42px; border: 0px; float: left;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]55<a href="http://www.imagemagick.org/discourse-server/">
56 <img src="../images/logo.jpg" alt=""
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">
59 <img src="../images/sprite.jpg" alt=""
60 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
61</div>
62
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]63<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]64
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]65<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]66 <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]67</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]68<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]69<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]70 <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
71</div>
72<div class="sub">
73 <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
74</div>
75<div class="sub">
76 <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
77</div>
78<div class="sub">
79 <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
80</div>
81<div class="sep"></div>
82<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]83 <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]84</div>
85<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]86 <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]87</div>
88<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]89 <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90</div>
91<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]92 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]93</div>
94<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]95 <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]96</div>
97<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]98 <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]99</div>
100<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]101 <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]102</div>
103<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]104 <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]105</div>
106<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]107 <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]108</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]109<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]110<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]111 <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112</div>
113<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]114 <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115</div>
116<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]117 <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]118 </div>
119<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]120 <a title="Resources" href="../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]121</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]122<div class="menu">
123 <a title="Architecture" href="../www/architecture.html">Architecture</a>
124</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]125<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]126 <a title="Download" href="../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]127</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]128<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]129<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]130 <a title="Search" href="../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]131</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]132<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]133<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]134 <a title="Site Map" href="../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]135</div>
136<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]137 <a title="Site Map: Links" href="../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]138</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]139<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]140<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]141 <a title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]142
143<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]144<div class="sponsor">
145 <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
146</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]147<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]148 <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]149</div>
150<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]151 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
152</div>
153<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]154 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
155</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]156<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]157 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
158</div>
159<div class="sponsor">
cristyf7964272011-01-30 03:49:12 +0000[diff] [blame]160 <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]161</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]162</div>
163</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]164</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]165
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]166<div class="eastbar">
167 <script type="text/javascript">
168 <!--
169 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]170 google_ad_slot = "0574824969";
171 google_ad_width = 160;
172 google_ad_height = 600;
173 //-->
174 </script>
175 <script type="text/javascript"
176 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
177 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]178</div>
179
180<div class="main">
181
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]182<h1>MagickCore C API</h1>
183
184<div class="doc-section">
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]185
186<p>The <a href="../www/api/MagickCore/index.html">MagickCore API</a> is a low-level interface between the C programming language and the ImageMagick image processing libraries and is recommended for wizard-level programmers only. Unlike the <a href="../www/magick-wand.html">MagickWand</a> C API which uses only a few opaque types and accessors, with MagickCore you almost exlusively access the structure members directly. A description of the MagickCore public methods are found here:</p>
187
188<ul>
189 <li><a href="../www/api/magick.html">Initialize or Destroy the ImageMagick Environment</a></li>
190 <li><a href="../www/api/constitute.html">Constitute an Image</a></li>
191 <li><a href="../www/api/composite.html">Composite an Image</a></li>
192 <li><a href="../www/api/image.html">Image Methods</a></li>
193 <li><a href="../www/api/color.html">Count the Colors in an Image</a></li>
cristy43d0f4d2009-09-17 19:35:37 +0000[diff] [blame]194 <li><a href="../www/api/colormap.html">Colormap Methods</a></li>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]195 <li><a href="../www/api/distort.html">Image Distortions</a></li>
196 <li><a href="../www/api/layer.html">Dealing with Image Layers</a></li>
197 <li><a href="../www/api/profile.html">Dealing with Image Profiles</a></li>
198 <li><a href="../www/api/quantize.html">Reduce the Number of Unique Colors in an Image</a></li>
199 <li><a href="../www/api/histogram.html">Image Histograms</a></li>
200 <li><a href="../www/api/segment.html">Segment an Image with Thresholding Fuzzy c-Means</a></li>
201 <li><a href="../www/api/resize.html">Resize an Image</a></li>
202 <li><a href="../www/api/transform.html">Transform an Image</a></li>
203 <li><a href="../www/api/shear.html">Shear or Rotate an Image by an Arbitrary Angle</a></li>
204 <li><a href="../www/api/enhance.html">Enhance an Image</a></li>
205 <li><a href="../www/api/effect.html">Add an Effect</a></li>
cristyd43a46b2010-01-21 02:13:41 +0000[diff] [blame]206 <li><a href="../www/api/morphology.html">Morphological Erosions, Dilations, Openings, and Closings</a></li>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]207 <li><a href="../www/api/fx.html">Add a Special Effect</a></li>
208 <li><a href="../www/api/decorate.html">Decorate an Image</a></li>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]209 <li><a href="../www/api/attribute.html">Get/Set an Image Attribute</a></li>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]210 <li><a href="../www/api/property.html">Get/Set Image Properties</a></li>
cristy3e2860c2010-01-24 01:36:30 +0000[diff] [blame]211 <li><a href="../www/api/statistic.html">Get Image Statistics</a></li>
212 <li><a href="../www/api/feature.html">Get Image Features</a></li>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]213 <li><a href="../www/api/annotate.html">Annotate an Image</a></li>
214 <li><a href="../www/api/paint.html">Paint on an Image</a></li>
215 <li><a href="../www/api/draw.html">Draw on an Image</a></li>
216 <li><a href="../www/api/montage.html">Create an Image Thumbnail</a></li>
217 <li><a href="../www/api/fourier.html">Compute the discrete Fourier transform (DFT)</a></li>
218 <li><a href="../www/api/compare.html">Compare an Image to a Reconstructed Image</a></li>
219 <li><a href="../www/api/display.html">Interactively Display and Edit an Image</a></li>
220 <li><a href="../www/api/animate.html">Interactively Animate an Image Sequence</a></li>
221 <li><a href="../www/api/cipher.html">Convert to and from Cipher Pixels</a></li>
222 <li><a href="../www/api/list.html">Working with Image Lists</a></li>
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]223 <li><a href="../www/api/image-view.html">Image View Methods</a></li>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]224 <li><a href="../www/api/cache.html">Get or Set Image Pixels</a></li>
225 <li><a href="../www/api/cache-view.html">Working with Cache Views</a></li>
226 <li><a href="../www/api/stream.html">The Pixel FIFO</a></li>
227 <li><a href="../www/api/blob.html">Read or Write Binary Large OBjects</a></li>
228 <li><a href="../www/api/module.html">Loadable Modules</a></li>
229 <li><a href="../www/api/signature.html">Compute a Message Digest for an Image</a></li>
230 <li><a href="../www/api/registry.html">The Image Registry</a></li>
231 <li><a href="../www/api/exception.html">Dealing with Exceptions</a></li>
232 <li><a href="../www/api/memory.html">Memory Allocation</a></li>
233 <li><a href="../www/api/resource.html">Monitor or Limit Resource Consumption</a></li>
234 <li><a href="../www/api/monitor.html">Monitor the Progress of an Image Operation</a></li>
235 <li><a href="../www/api/version.html">Get the Version and Copyrights</a></li>
236 <li><a href="../www/api/deprecate.html">Deprecated Methods</a></li>
237 <li><a href="../www/exception.html">Error and Warning Codes</a></li>
238</ul>
239
240<p>After you write your MagickCore program, compile it like this:</p>
241
cristyd4d64ed2010-08-22 22:19:33 +0000[diff] [blame]242<p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>cc `MagickCore-config --cflags --cppflags` -O2 core.c \ <br/> `MagickCore-config --ldflags --libs`</span></p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]243<p>Here is a example program that utilizes the MagickCore API to get you started, <a href="../www/source/core.c">core.c</a>. It reads a GIF image, creates a thumbnail, and writes it to disk in the PNG image format.</p>
244
245<div class="viewport">
246<pre class="code">
247 #include &lt;stdio.h>
248 #include &lt;stdlib.h>
249 #include &lt;string.h>
250 #include &lt;time.h>
251 #include &lt;magick/MagickCore.h>
252
253 int main(int argc,char **argv)
254 {
255 ExceptionInfo
256 *exception;
257
258 Image
259 *image,
260 *images,
261 *resize_image,
262 *thumbnails;
263
264 ImageInfo
265 *image_info;
266
267 if (argc != 3)
268 {
269 (void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
270 exit(0);
271 }
272 /*
273 Initialize the image info structure and read an image.
274 */
275 MagickCoreGenesis(*argv,MagickTrue);
276 exception=AcquireExceptionInfo();
277 image_info=CloneImageInfo((ImageInfo *) NULL);
278 (void) strcpy(image_info-&gt;filename,argv[1]);
279 images=ReadImage(image_info,exception);
280 if (exception-&gt;severity != UndefinedException)
281 CatchException(exception);
282 if (images == (Image *) NULL)
283 exit(1);
284 /*
285 Convert the image to a thumbnail.
286 */
287 thumbnails=NewImageList();
288 while ((image=RemoveFirstImageFromList(&amp;images)) != (Image *) NULL)
289 {
290 resize_image=ResizeImage(image,106,80,LanczosFilter,1.0,exception);
291 if (resize_image == (Image *) NULL)
292 MagickError(exception-&gt;severity,exception-&gt;reason,exception-&gt;description);
293 (void) AppendImageToList(&amp;thumbnails,resize_image);
294 DestroyImage(image);
295 }
296 /*
297 Write the image thumbnail.
298 */
299 (void) strcpy(thumbnails-&gt;filename,argv[2]);
300 WriteImage(image_info,thumbnails);
301 /*
302 Destroy the image thumbnail and exit.
303 */
304 thumbnails=DestroyImageList(thumbnails);
305 image_info=DestroyImageInfo(image_info);
306 exception=DestroyExceptionInfo(exception);
307 MagickCoreTerminus();
308 return(0);
309 }
310</pre>
311</div>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]312<p><a id="image-view"></a>Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The <a href="../www/source/core/sigmoidal-contrast.c">sigmoidal-contrast.c</a> module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).</p>
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]313
314<div class="viewport">
315<pre class="code">
316#include &lt;stdio.h>
317#include &lt;stdlib.h>
318#include &lt;math.h>
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]319#include &lt;magick/MagickCore.h>
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]320
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]321static MagickBooleanType SigmoidalContrast(ImageView *contrast_view,
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]322 const ssize_t y,const int id,void *context)
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]323{
324#define QuantumScale ((MagickRealType) 1.0/(MagickRealType) QuantumRange)
325#define SigmoidalContrast(x) \
326 (QuantumRange*(1.0/(1+exp(10.0*(0.5-QuantumScale*x)))-0.0066928509)*1.0092503)
327
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]328 RectangleInfo
329 extent;
330
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]331 register IndexPacket
332 *indexes;
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]333
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]334 register PixelPacket
335 *pixels;
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]336
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]337 register ssize_t
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]338 x;
339
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]340 extent=GetImageViewExtent(contrast_view);
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]341 pixels=GetImageViewAuthenticPixels(contrast_view);
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]342 for (x=0; x &lt; (ssize_t) (extent.width-extent.x); x++)
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]343 {
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]344 pixels[x].red=RoundToQuantum(SigmoidalContrast(pixels[x].red));
345 pixels[x].green=RoundToQuantum(SigmoidalContrast(pixels[x].green));
346 pixels[x].blue=RoundToQuantum(SigmoidalContrast(pixels[x].blue));
347 pixels[x].opacity=RoundToQuantum(SigmoidalContrast(pixels[x].opacity));
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]348 }
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]349 indexes=GetImageViewAuthenticIndexes(contrast_view);
350 if (indexes != (IndexPacket *) NULL)
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]351 for (x=0; x &lt; (ssize_t) (extent.width-extent.x); x++)
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]352 indexes[x]=(IndexPacket) RoundToQuantum(SigmoidalContrast(indexes[x]));
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]353 return(MagickTrue);
354}
355
356int main(int argc,char **argv)
357{
358#define ThrowImageException(image) \
359{ \
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]360 \
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]361 CatchException(exception); \
362 if (contrast_image != (Image *) NULL) \
363 contrast_image=DestroyImage(contrast_image); \
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]364 exit(-1); \
365}
366#define ThrowViewException(view) \
367{ \
368 char \
369 *description; \
370 \
371 ExceptionType \
372 severity; \
373 \
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]374 description=GetImageViewException(view,&amp;severity); \
cristyc3ebda22010-06-27 17:11:57 +0000[diff] [blame]375 (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
376 description=DestroyString(description); \
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]377 exit(-1); \
378}
379
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]380 ExceptionInfo
381 *exception;
382
383 Image
384 *contrast_image;
385
386 ImageInfo
387 *image_info;
388
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]389 ImageView
390 *contrast_view;
391
392 MagickBooleanType
393 status;
394
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]395 if (argc != 3)
396 {
397 (void) fprintf(stdout,"Usage: %s image sigmoidal-image\n",argv[0]);
398 exit(0);
399 }
400 /*
401 Read an image.
402 */
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]403 MagickCoreGenesis(*argv,MagickTrue);
404 image_info=AcquireImageInfo();
405 (void) CopyMagickString(image_info->filename,argv[1],MaxTextExtent);
406 exception=AcquireExceptionInfo();
407 contrast_image=ReadImage(image_info,exception);
408 if (contrast_image == (Image *) NULL)
409 ThrowImageException(contrast_image);
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]410 /*
411 Sigmoidal non-linearity contrast control.
412 */
413 contrast_view=NewImageView(contrast_image);
414 if (contrast_view == (ImageView *) NULL)
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]415 ThrowImageException(contrast_image);
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]416 status=UpdateImageViewIterator(contrast_view,SigmoidalContrast,(void *) NULL);
417 if (status == MagickFalse)
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]418 ThrowImageException(contrast_image);
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]419 contrast_view=DestroyImageView(contrast_view);
420 /*
421 Write the image then destroy it.
422 */
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]423 status=WriteImages(image_info,contrast_image,argv[2],exception);
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]424 if (status == MagickFalse)
cristy73b7d4c2010-06-27 00:31:00 +0000[diff] [blame]425 ThrowImageException(contrast_image);
426 contrast_image=DestroyImage(contrast_image);
427 exception=DestroyExceptionInfo(exception);
428 image_info=DestroyImageInfo(image_info);
cristy10c87152010-06-26 16:12:21 +0000[diff] [blame]429 MagickCoreTerminus();
430 return(0);
431}
432</pre>
433</div>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]434</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]435
436</div>
437
438<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]439 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]440 <span id="linkbar-center">
441 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]442 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]443 </span>
444 <span id="linkbar-east">&nbsp;</span>
445 </div>
446 <div class="footer">
cristy7e41fe82010-12-04 23:12:08 +0000[diff] [blame]447 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]448 <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
449 </div>
450 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]451 <script type="text/javascript">
452 var _gaq = _gaq || [];
453 _gaq.push(['_setAccount', 'UA-17690367-1']);
454 _gaq.push(['_trackPageview']);
455
456 (function() {
457 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
458 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
459 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
460 })();
461 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]462</body>
463</html>