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