Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 64337ffa810a396d7988072f4e6b9edc0c705774 / . / www / api / magick-image.html
blob: 7dbeb55860a422f04b4bddc57a6ac412e4b13ba2 [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">
cristy2bd2a982011-02-15 00:52:58 +0000[diff] [blame]3<html version="-//W3C//DTD XHTML 1.1//EN"
4 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6 xsi:schemaLocation="http://www.w3.org/1999/xhtml
7 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]8<head>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]9 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
10 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]11 <title>ImageMagick: MagickWand, C API for ImageMagick: Image Methods</title>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]12 <meta http-equiv="Content-Language" content="en-US"/>
13 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
14 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]15 <meta name="Application-name" content="ImageMagick"/>
cristye6e84152011-06-06 14:16:49 +0000[diff] [blame]16 <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 automagically."/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]17 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]18 <meta name="Generator" content="PHP"/>
cristye6e84152011-06-06 14:16:49 +0000[diff] [blame]19 <meta name="Keywords" content="magickwc, api, for, imagemagick:, image, methods, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]20 <meta name="Rating" content="GENERAL"/>
21 <meta name="Robots" content="INDEX, FOLLOW"/>
22 <meta name="Generator" content="ImageMagick Studio LLC"/>
23 <meta name="Author" content="ImageMagick Studio LLC"/>
24 <meta name="Revisit-after" content="2 DAYS"/>
25 <meta name="Resource-type" content="document"/>
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]26 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]27 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]28 <link rel="icon" href="../../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]29 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
30 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]31 <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]32 <style type="text/css" media="all">
33 @import url("../../www/magick.css");
34 </style>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]35 <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]36 <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>
37 <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />
38 <script type="text/javascript">
39 $(document).ready(function() {
40 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
41 'transitionIn' : 'elastic',
42 'transitionOut' : 'elastic',
43 'overlayShow' : false,
44 'opacity' : true
45 });
46 });
47 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]48</head>
49
50<body id="www-imagemagick-org">
51<div class="titlebar">
cristyb52981c2011-03-19 17:09:31 +0000[diff] [blame]52<div style="margin: 17px auto; float: left;">
53 <script type="text/javascript">
54 <!--
55 google_ad_client = "pub-3129977114552745";
56 google_ad_slot = "5439289906";
57 google_ad_width = 728;
58 google_ad_height = 90;
59 //-->
60 </script>
61 <script type="text/javascript"
62 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
63 </script>
64</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]65<a href="http://www.imagemagick.org/discourse-server/">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]66 <img src="../../images/logo.jpg"
67 alt="ImageMagick Logo"
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]68 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]69<a href="../../index.html">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]70 <img src="../../images/sprite.jpg"
71 alt="ImageMagick Sprite"
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]72 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
73</div>
74
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]75<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]76
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]77<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]78 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]79</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]80<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]81<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]82 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
83</div>
84<div class="sub">
85 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
86</div>
87<div class="sub">
88 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
89</div>
90<div class="sub">
cristye6e84152011-06-06 14:16:49 +0000[diff] [blame]91 <a title="Binary Release: iOS" href="../../www/binary-releases.html#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000[diff] [blame]92</div>
93<div class="sub">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]94 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
95</div>
96<div class="sep"></div>
97<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]98 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</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="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</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="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]105</div>
106<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]107 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]108</div>
109<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]110 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111</div>
112<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]113 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</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="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</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="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
121<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]122 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]123</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]124<div class="sep"></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="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]127</div>
128<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]129 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]130</div>
131<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]132 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]133 </div>
134<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]135 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]136</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]137<div class="menu">
138 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
139</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="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]142</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]143<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]144<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]145 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]146</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]147<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]148<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]149 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]150</div>
151<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]152 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]153</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]154<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]155<div class="menu">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]156 <a rel="follow" title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]157
cristyb52981c2011-03-19 17:09:31 +0000[diff] [blame]158<a href="http://www.networkredux.com">
159 <img src="../../images/networkredux.png" alt="[sponsor]"
160 style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]161<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]162<div class="sponsor">
cristy81492d62011-06-07 16:41:42 +0000[diff] [blame]163 <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
164</div>
165<div class="sponsor">
cristy84134182011-06-15 22:59:00 +0000[diff] [blame]166 <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201110010090s jen@seo lowprofilelinks -->
167</div>
168<div class="sponsor">
cristy81492d62011-06-07 16:41:42 +0000[diff] [blame]169 <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
170</div>
171<div class="sponsor">
cristyba1758d2011-06-03 01:29:12 +0000[diff] [blame]172 <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
173</div>
174<div class="sponsor">
175 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
176</div>
177<div class="sponsor">
cristy4bf6e232011-05-21 01:43:33 +0000[diff] [blame]178 <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
cristy45dbd322011-03-27 16:40:38 +0000[diff] [blame]179</div>
180<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]181 <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]182</div>
183<div class="sponsor">
cristy575d5ee2011-05-24 01:59:01 +0000[diff] [blame]184 <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
cristy4bf6e232011-05-21 01:43:33 +0000[diff] [blame]185</div>
186<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]187 <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]188</div>
189<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]190 <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
cristy73fd1cd2010-09-12 19:14:25 +0000[diff] [blame]191</div>
192<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]193 <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
cristyee742642011-02-26 02:49:59 +0000[diff] [blame]194</div>
195<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]196 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingmasters.com">Web Hosting Reviews</a><!-- 201107011500 affliatelabel -->
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]197</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]198<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]199 <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
cristybaacd172011-04-30 23:11:03 +0000[diff] [blame]200</div>
201<div class="sponsor">
cristy9be3b602011-06-16 01:35:51 +0000[diff] [blame]202 <a rel="follow" title="Sponsor: Fototapete" href=" http://www.allesdruck.de/Fototapete-Tapetendruck,category,8830.html">Fototapete</a><!-- 20110701000080 a-o.de -->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]203</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]204</div>
205</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]206</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]207
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]208<div class="eastbar">
cristyb52981c2011-03-19 17:09:31 +0000[diff] [blame]209
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]210</div>
211
212<div class="main">
213
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]214<h1>Module magick-image Methods</h1>
cristyb52981c2011-03-19 17:09:31 +0000[diff] [blame]215<p class="navigation-index">[<a href="#GetImageFromMagickWand">GetImageFromMagickWand</a> &bull; <a href="#MagickAdaptiveBlurImage">MagickAdaptiveBlurImage</a> &bull; <a href="#MagickAdaptiveResizeImage">MagickAdaptiveResizeImage</a> &bull; <a href="#MagickAdaptiveSharpenImage">MagickAdaptiveSharpenImage</a> &bull; <a href="#MagickAdaptiveThresholdImage">MagickAdaptiveThresholdImage</a> &bull; <a href="#MagickAddImage">MagickAddImage</a> &bull; <a href="#MagickAddNoiseImage">MagickAddNoiseImage</a> &bull; <a href="#MagickAffineTransformImage">MagickAffineTransformImage</a> &bull; <a href="#MagickAnnotateImage">MagickAnnotateImage</a> &bull; <a href="#MagickAnimateImages">MagickAnimateImages</a> &bull; <a href="#MagickAppendImages">MagickAppendImages</a> &bull; <a href="#MagickAutoGammaImage">MagickAutoGammaImage</a> &bull; <a href="#MagickAutoLevelImage">MagickAutoLevelImage</a> &bull; <a href="#MagickBlackThresholdImage">MagickBlackThresholdImage</a> &bull; <a href="#MagickBlueShiftImage">MagickBlueShiftImage</a> &bull; <a href="#MagickBlurImage">MagickBlurImage</a> &bull; <a href="#MagickBorderImage">MagickBorderImage</a> &bull; <a href="#Use MagickBrightnessContrastImage">Use MagickBrightnessContrastImage</a> &bull; <a href="#MagickCharcoalImage">MagickCharcoalImage</a> &bull; <a href="#MagickChopImage">MagickChopImage</a> &bull; <a href="#MagickClampImage">MagickClampImage</a> &bull; <a href="#MagickClipImage">MagickClipImage</a> &bull; <a href="#MagickClipImagePath">MagickClipImagePath</a> &bull; <a href="#MagickClutImage">MagickClutImage</a> &bull; <a href="#MagickCoalesceImages">MagickCoalesceImages</a> &bull; <a href="#MagickColorDecisionListImage">MagickColorDecisionListImage</a> &bull; <a href="#MagickColorizeImage">MagickColorizeImage</a> &bull; <a href="#MagickColorMatrixImage">MagickColorMatrixImage</a> &bull; <a href="#MagickCombineImages">MagickCombineImages</a> &bull; <a href="#MagickCommentImage">MagickCommentImage</a> &bull; <a href="#MagickCompareImageChannels">MagickCompareImageChannels</a> &bull; <a href="#MagickCompareImageLayers">MagickCompareImageLayers</a> &bull; <a href="#MagickCompareImages">MagickCompareImages</a> &bull; <a href="#MagickCompositeImage">MagickCompositeImage</a> &bull; <a href="#MagickContrastImage">MagickContrastImage</a> &bull; <a href="#MagickContrastStretchImage">MagickContrastStretchImage</a> &bull; <a href="#MagickConvolveImage">MagickConvolveImage</a> &bull; <a href="#MagickCropImage">MagickCropImage</a> &bull; <a href="#MagickCycleColormapImage">MagickCycleColormapImage</a> &bull; <a href="#MagickConstituteImage">MagickConstituteImage</a> &bull; <a href="#MagickDecipherImage">MagickDecipherImage</a> &bull; <a href="#MagickDeconstructImages">MagickDeconstructImages</a> &bull; <a href="#MagickDeskewImage">MagickDeskewImage</a> &bull; <a href="#MagickDespeckleImage">MagickDespeckleImage</a> &bull; <a href="#MagickDestroyImage">MagickDestroyImage</a> &bull; <a href="#MagickDisplayImage">MagickDisplayImage</a> &bull; <a href="#MagickDisplayImages">MagickDisplayImages</a> &bull; <a href="#MagickDistortImage">MagickDistortImage</a> &bull; <a href="#MagickDrawImage">MagickDrawImage</a> &bull; <a href="#MagickEdgeImage">MagickEdgeImage</a> &bull; <a href="#MagickEmbossImage">MagickEmbossImage</a> &bull; <a href="#MagickEncipherImage">MagickEncipherImage</a> &bull; <a href="#MagickEnhanceImage">MagickEnhanceImage</a> &bull; <a href="#MagickEqualizeImage">MagickEqualizeImage</a> &bull; <a href="#MagickEvaluateImage">MagickEvaluateImage</a> &bull; <a href="#MagickExportImagePixels">MagickExportImagePixels</a> &bull; <a href="#MagickExtentImage">MagickExtentImage</a> &bull; <a href="#MagickFilterImage">MagickFilterImage</a> &bull; <a href="#MagickFlipImage">MagickFlipImage</a> &bull; <a href="#MagickFloodfillPaintImage">MagickFloodfillPaintImage</a> &bull; <a href="#MagickFlopImage">MagickFlopImage</a> &bull; <a href="#MagickForwardFourierTransformImage">MagickForwardFourierTransformImage</a> &bull; <a href="#MagickFrameImage">MagickFrameImage</a> &bull; <a href="#MagickFunctionImage">MagickFunctionImage</a> &bull; <a href="#MagickFxImage">MagickFxImage</a> &bull; <a href="#MagickGammaImage">MagickGammaImage</a> &bull; <a href="#MagickGaussianBlurImage">MagickGaussianBlurImage</a> &bull; <a href="#MagickGetImage">MagickGetImage</a> &bull; <a href="#MagickGetImageAlphaChannel">MagickGetImageAlphaChannel</a> &bull; <a href="#MagickGetImageClipMask">MagickGetImageClipMask</a> &bull; <a href="#MagickGetImageBackgroundColor">MagickGetImageBackgroundColor</a> &bull; <a href="#MagickGetImageBlob">MagickGetImageBlob</a> &bull; <a href="#MagickGetImageBlob">MagickGetImageBlob</a> &bull; <a href="#MagickGetImageBluePrimary">MagickGetImageBluePrimary</a> &bull; <a href="#MagickGetImageBorderColor">MagickGetImageBorderColor</a> &bull; <a href="#MagickGetImageChannelDepth">MagickGetImageChannelDepth</a> &bull; <a href="#MagickGetImageChannelDistortion">MagickGetImageChannelDistortion</a> &bull; <a href="#MagickGetImageChannelDistortions">MagickGetImageChannelDistortions</a> &bull; <a href="#MagickGetImageChannelFeatures">MagickGetImageChannelFeatures</a> &bull; <a href="#MagickGetImageChannelKurtosis">MagickGetImageChannelKurtosis</a> &bull; <a href="#MagickGetImageChannelMean">MagickGetImageChannelMean</a> &bull; <a href="#MagickGetImageChannelRange">MagickGetImageChannelRange</a> &bull; <a href="#MagickGetImageChannelStatistics">MagickGetImageChannelStatistics</a> &bull; <a href="#MagickGetImageColormapColor">MagickGetImageColormapColor</a> &bull; <a href="#MagickGetImageColors">MagickGetImageColors</a> &bull; <a href="#MagickGetImageColorspace">MagickGetImageColorspace</a> &bull; <a href="#MagickGetImageCompose">MagickGetImageCompose</a> &bull; <a href="#MagickGetImageCompression">MagickGetImageCompression</a> &bull; <a href="#MagickGetImageCompression">MagickGetImageCompression</a> &bull; <a href="#MagickGetImageDelay">MagickGetImageDelay</a> &bull; <a href="#MagickGetImageDepth">MagickGetImageDepth</a> &bull; <a href="#MagickGetImageDistortion">MagickGetImageDistortion</a> &bull; <a href="#MagickGetImageDispose">MagickGetImageDispose</a> &bull; <a href="#MagickGetImageFilename">MagickGetImageFilename</a> &bull; <a href="#MagickGetImageFormat">MagickGetImageFormat</a> &bull; <a href="#MagickGetImageFuzz">MagickGetImageFuzz</a> &bull; <a href="#MagickGetImageGamma">MagickGetImageGamma</a> &bull; <a href="#MagickGetImageGravity">MagickGetImageGravity</a> &bull; <a href="#MagickGetImageGreenPrimary">MagickGetImageGreenPrimary</a> &bull; <a href="#MagickGetImageHeight">MagickGetImageHeight</a> &bull; <a href="#MagickGetImageHistogram">MagickGetImageHistogram</a> &bull; <a href="#MagickGetImageInterlaceScheme">MagickGetImageInterlaceScheme</a> &bull; <a href="#MagickGetImageInterpolateMethod">MagickGetImageInterpolateMethod</a> &bull; <a href="#MagickGetImageIterations">MagickGetImageIterations</a> &bull; <a href="#MagickGetImageLength">MagickGetImageLength</a> &bull; <a href="#MagickGetImageMatteColor">MagickGetImageMatteColor</a> &bull; <a href="#MagickGetImageOrientation">MagickGetImageOrientation</a> &bull; <a href="#MagickGetImagePage">MagickGetImagePage</a> &bull; <a href="#MagickGetImagePixelColor">MagickGetImagePixelColor</a> &bull; <a href="#MagickGetImageRedPrimary">MagickGetImageRedPrimary</a> &bull; <a href="#MagickGetImageRegion">MagickGetImageRegion</a> &bull; <a href="#MagickGetImageRenderingIntent">MagickGetImageRenderingIntent</a> &bull; <a href="#MagickGetImageResolution">MagickGetImageResolution</a> &bull; <a href="#MagickGetImageScene">MagickGetImageScene</a> &bull; <a href="#MagickGetImageSignature">MagickGetImageSignature</a> &bull; <a href="#MagickGetImageTicksPerSecond">MagickGetImageTicksPerSecond</a> &bull; <a href="#MagickGetImageType">MagickGetImageType</a> &bull; <a href="#MagickGetImageUnits">MagickGetImageUnits</a> &bull; <a href="#MagickGetImageVirtualPixelMethod">MagickGetImageVirtualPixelMethod</a> &bull; <a href="#MagickGetImageWhitePoint">MagickGetImageWhitePoint</a> &bull; <a href="#MagickGetImageWidth">MagickGetImageWidth</a> &bull; <a href="#MagickGetNumberImages">MagickGetNumberImages</a> &bull; <a href="#MagickGetImageTotalInkDensity">MagickGetImageTotalInkDensity</a> &bull; <a href="#MagickHaldClutImage">MagickHaldClutImage</a> &bull; <a href="#MagickHasNextImage">MagickHasNextImage</a> &bull; <a href="#MagickHasPreviousImage">MagickHasPreviousImage</a> &bull; <a href="#MagickIdentifyImage">MagickIdentifyImage</a> &bull; <a href="#MagickImplodeImage">MagickImplodeImage</a> &bull; <a href="#MagickImportImagePixels">MagickImportImagePixels</a> &bull; <a href="#MagickInverseFourierTransformImage">MagickInverseFourierTransformImage</a> &bull; <a href="#MagickLabelImage">MagickLabelImage</a> &bull; <a href="#MagickLevelImage">MagickLevelImage</a> &bull; <a href="#MagickLinearStretchImage">MagickLinearStretchImage</a> &bull; <a href="#MagickLiquidRescaleImage">MagickLiquidRescaleImage</a> &bull; <a href="#MagickMagnifyImage">MagickMagnifyImage</a> &bull; <a href="#MagickMergeImageLayers">MagickMergeImageLayers</a> &bull; <a href="#MagickMinifyImage">MagickMinifyImage</a> &bull; <a href="#MagickModulateImage">MagickModulateImage</a> &bull; <a href="#MagickMontageImage">MagickMontageImage</a> &bull; <a href="#MagickMorphImages">MagickMorphImages</a> &bull; <a href="#MagickMorphologyImage">MagickMorphologyImage</a> &bull; <a href="#MagickMotionBlurImage">MagickMotionBlurImage</a> &bull; <a href="#MagickNegateImage">MagickNegateImage</a> &bull; <a href="#MagickNewImage">MagickNewImage</a> &bull; <a href="#MagickNextImage">MagickNextImage</a> &bull; <a href="#MagickNormalizeImage">MagickNormalizeImage</a> &bull; <a href="#MagickOilPaintImage">MagickOilPaintImage</a> &bull; <a href="#MagickOpaquePaintImage">MagickOpaquePaintImage</a> &bull; <a href="#MagickOptimizeImageLayers">MagickOptimizeImageLayers</a> &bull; <a href="#MagickOrderedPosterizeImage">MagickOrderedPosterizeImage</a> &bull; <a href="#MagickPingImage">MagickPingImage</a> &bull; <a href="#MagickPingImageBlob">MagickPingImageBlob</a> &bull; <a href="#MagickPingImageFile">MagickPingImageFile</a> &bull; <a href="#MagickPolaroidImage">MagickPolaroidImage</a> &bull; <a href="#MagickPosterizeImage">MagickPosterizeImage</a> &bull; <a href="#MagickPreviewImages">MagickPreviewImages</a> &bull; <a href="#MagickPreviousImage">MagickPreviousImage</a> &bull; <a href="#MagickQuantizeImage">MagickQuantizeImage</a> &bull; <a href="#MagickQuantizeImages">MagickQuantizeImages</a> &bull; <a href="#MagickRadialBlurImage">MagickRadialBlurImage</a> &bull; <a href="#MagickRaiseImage">MagickRaiseImage</a> &bull; <a href="#MagickRandomThresholdImage">MagickRandomThresholdImage</a> &bull; <a href="#MagickReadImage">MagickReadImage</a> &bull; <a href="#MagickReadImageBlob">MagickReadImageBlob</a> &bull; <a href="#MagickReadImageFile">MagickReadImageFile</a> &bull; <a href="#MagickRemapImage">MagickRemapImage</a> &bull; <a href="#MagickRemoveImage">MagickRemoveImage</a> &bull; <a href="#MagickResampleImage">MagickResampleImage</a> &bull; <a href="#MagickResetImagePage">MagickResetImagePage</a> &bull; <a href="#MagickResizeImage">MagickResizeImage</a> &bull; <a href="#MagickRollImage">MagickRollImage</a> &bull; <a href="#MagickRotateImage">MagickRotateImage</a> &bull; <a href="#MagickSampleImage">MagickSampleImage</a> &bull; <a href="#MagickScaleImage">MagickScaleImage</a> &bull; <a href="#MagickSegmentImage">MagickSegmentImage</a> &bull; <a href="#MagickSelectiveBlurImage">MagickSelectiveBlurImage</a> &bull; <a href="#MagickSeparateImageChannel">MagickSeparateImageChannel</a> &bull; <a href="#MagickSepiaToneImage">MagickSepiaToneImage</a> &bull; <a href="#MagickSetImage">MagickSetImage</a> &bull; <a href="#MagickSetImageAlphaChannel">MagickSetImageAlphaChannel</a> &bull; <a href="#MagickSetImageBackgroundColor">MagickSetImageBackgroundColor</a> &bull; <a href="#MagickSetImageBias">MagickSetImageBias</a> &bull; <a href="#MagickSetImageBluePrimary">MagickSetImageBluePrimary</a> &bull; <a href="#MagickSetImageBorderColor">MagickSetImageBorderColor</a> &bull; <a href="#MagickSetImageChannelDepth">MagickSetImageChannelDepth</a> &bull; <a href="#MagickSetImageClipMask">MagickSetImageClipMask</a> &bull; <a href="#MagickSetImageColor">MagickSetImageColor</a> &bull; <a href="#MagickSetImageColormapColor">MagickSetImageColormapColor</a> &bull; <a href="#MagickSetImageColorspace">MagickSetImageColorspace</a> &bull; <a href="#MagickSetImageCompose">MagickSetImageCompose</a> &bull; <a href="#MagickSetImageCompression">MagickSetImageCompression</a> &bull; <a href="#MagickSetImageCompressionQuality">MagickSetImageCompressionQuality</a> &bull; <a href="#MagickSetImageDelay">MagickSetImageDelay</a> &bull; <a href="#MagickSetImageDepth">MagickSetImageDepth</a> &bull; <a href="#MagickSetImageDispose">MagickSetImageDispose</a> &bull; <a href="#MagickSetImageExtent">MagickSetImageExtent</a> &bull; <a href="#MagickSetImageFilename">MagickSetImageFilename</a> &bull; <a href="#MagickSetImageFormat">MagickSetImageFormat</a> &bull; <a href="#MagickSetImageFuzz">MagickSetImageFuzz</a> &bull; <a href="#MagickSetImageGamma">MagickSetImageGamma</a> &bull; <a href="#MagickSetImageGravity">MagickSetImageGravity</a> &bull; <a href="#MagickSetImageGreenPrimary">MagickSetImageGreenPrimary</a> &bull; <a href="#MagickSetImageInterlaceScheme">MagickSetImageInterlaceScheme</a> &bull; <a href="#MagickSetImageInterpolateMethod">MagickSetImageInterpolateMethod</a> &bull; <a href="#MagickSetImageIterations">MagickSetImageIterations</a> &bull; <a href="#MagickSetImageMatte">MagickSetImageMatte</a> &bull; <a href="#MagickSetImageMatteColor">MagickSetImageMatteColor</a> &bull; <a href="#MagickSetImageOpacity">MagickSetImageOpacity</a> &bull; <a href="#MagickSetImageOrientation">MagickSetImageOrientation</a> &bull; <a href="#MagickSetImagePage">MagickSetImagePage</a> &bull; <a href="#MagickSetImageProgressMonitor">MagickSetImageProgressMonitor</a> &bull; <a href="#MagickSetImageRedPrimary">MagickSetImageRedPrimary</a> &bull; <a href="#MagickSetImageRenderingIntent">MagickSetImageRenderingIntent</a> &bull; <a href="#MagickSetImageResolution">MagickSetImageResolution</a> &bull; <a href="#MagickSetImageScene">MagickSetImageScene</a> &bull; <a href="#MagickSetImageTicksPerSecond">MagickSetImageTicksPerSecond</a> &bull; <a href="#MagickSetImageType">MagickSetImageType</a> &bull; <a href="#MagickSetImageUnits">MagickSetImageUnits</a> &bull; <a href="#MagickSetImageVirtualPixelMethod">MagickSetImageVirtualPixelMethod</a> &bull; <a href="#MagickSetImageWhitePoint">MagickSetImageWhitePoint</a> &bull; <a href="#MagickShadeImage">MagickShadeImage</a> &bull; <a href="#MagickShadowImage">MagickShadowImage</a> &bull; <a href="#MagickSharpenImage">MagickSharpenImage</a> &bull; <a href="#MagickShaveImage">MagickShaveImage</a> &bull; <a href="#MagickShearImage">MagickShearImage</a> &bull; <a href="#MagickSigmoidalContrastImage">MagickSigmoidalContrastImage</a> &bull; <a href="#MagickSimilarityImage">MagickSimilarityImage</a> &bull; <a href="#MagickSketchImage">MagickSketchImage</a> &bull; <a href="#MagickSmushImages">MagickSmushImages</a> &bull; <a href="#MagickSolarizeImage">MagickSolarizeImage</a> &bull; <a href="#MagickSparseColorImage">MagickSparseColorImage</a> &bull; <a href="#MagickSpliceImage">MagickSpliceImage</a> &bull; <a href="#MagickSpreadImage">MagickSpreadImage</a> &bull; <a href="#MagickStatisticImage">MagickStatisticImage</a> &bull; <a href="#MagickSteganoImage">MagickSteganoImage</a> &bull; <a href="#MagickStereoImage">MagickStereoImage</a> &bull; <a href="#MagickStripImage">MagickStripImage</a> &bull; <a href="#MagickSwirlImage">MagickSwirlImage</a> &bull; <a href="#MagickTextureImage">MagickTextureImage</a> &bull; <a href="#MagickThresholdImage">MagickThresholdImage</a> &bull; <a href="#MagickThumbnailImage">MagickThumbnailImage</a> &bull; <a href="#MagickTintImage">MagickTintImage</a> &bull; <a href="#MagickTransformImage">MagickTransformImage</a> &bull; <a href="#MagickTransformImageColorspace">MagickTransformImageColorspace</a> &bull; <a href="#MagickTransparentPaintImage">MagickTransparentPaintImage</a> &bull; <a href="#MagickTransposeImage">MagickTransposeImage</a> &bull; <a href="#MagickTransverseImage">MagickTransverseImage</a> &bull; <a href="#MagickTrimImage">MagickTrimImage</a> &bull; <a href="#MagickUniqueImageColors">MagickUniqueImageColors</a> &bull; <a href="#MagickUnsharpMaskImage">MagickUnsharpMaskImage</a> &bull; <a href="#MagickVignetteImage">MagickVignetteImage</a> &bull; <a href="#MagickWaveImage">MagickWaveImage</a> &bull; <a href="#MagickWhiteThresholdImage">MagickWhiteThresholdImage</a> &bull; <a href="#MagickWriteImage">MagickWriteImage</a> &bull; <a href="#MagickWriteImageFile">MagickWriteImageFile</a> &bull; <a href="#MagickWriteImages">MagickWriteImages</a> &bull; <a href="#MagickWriteImagesFile">MagickWriteImagesFile</a>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]216
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]217<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="GetImageFromMagickWand">GetImageFromMagickWand</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]218<div class="doc-section">
219
220<p>GetImageFromMagickWand() returns the current image from the magick wand.</p>
221
222<p>The format of the GetImageFromMagickWand method is:</p>
223
224<pre class="code">
225 Image *GetImageFromMagickWand(const MagickWand *wand)
226</pre>
227
228<p>A description of each parameter follows:</p>
229
230<h5>wand</h5>
231<p>the magick wand.</p>
232
233 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]234<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAdaptiveBlurImage">MagickAdaptiveBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]235<div class="doc-section">
236
237<p>MagickAdaptiveBlurImage() adaptively blurs the image by blurring less intensely near image edges and more intensely far from edges. We blur the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and MagickAdaptiveBlurImage() selects a suitable radius for you.</p>
238
239<p>The format of the MagickAdaptiveBlurImage method is:</p>
240
241<pre class="code">
242 MagickBooleanType MagickAdaptiveBlurImage(MagickWand *wand,
243 const double radius,const double sigma)
244 MagickBooleanType MagickAdaptiveBlurImageChannel(MagickWand *wand,
245 const ChannelType channel,const double radius,const double sigma)
246</pre>
247
248<p>A description of each parameter follows:</p>
249
250<h5>wand</h5>
251<p>the magick wand.</p>
252
253<h5>channel</h5>
254<p>the image channel(s).</p>
255
256<h5>radius</h5>
257<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
258
259<h5>sigma</h5>
260<p>the standard deviation of the Gaussian, in pixels.</p>
261
262 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]263<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAdaptiveResizeImage">MagickAdaptiveResizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]264<div class="doc-section">
265
266<p>MagickAdaptiveResizeImage() adaptively resize image with data dependent triangulation.</p>
267
268<p>MagickBooleanType MagickAdaptiveResizeImage(MagickWand *wand, const size_t columns,const size_t rows)</p>
269
270<p>A description of each parameter follows:</p>
271
272<h5>wand</h5>
273<p>the magick wand.</p>
274
275<h5>columns</h5>
276<p>the number of columns in the scaled image.</p>
277
278<h5>rows</h5>
279<p>the number of rows in the scaled image.</p>
280
281 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]282<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAdaptiveSharpenImage">MagickAdaptiveSharpenImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]283<div class="doc-section">
284
285<p>MagickAdaptiveSharpenImage() adaptively sharpens the image by sharpening more intensely near image edges and less intensely far from edges. We sharpen the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and MagickAdaptiveSharpenImage() selects a suitable radius for you.</p>
286
287<p>The format of the MagickAdaptiveSharpenImage method is:</p>
288
289<pre class="code">
290 MagickBooleanType MagickAdaptiveSharpenImage(MagickWand *wand,
291 const double radius,const double sigma)
292 MagickBooleanType MagickAdaptiveSharpenImageChannel(MagickWand *wand,
293 const ChannelType channel,const double radius,const double sigma)
294</pre>
295
296<p>A description of each parameter follows:</p>
297
298<h5>wand</h5>
299<p>the magick wand.</p>
300
301<h5>channel</h5>
302<p>the image channel(s).</p>
303
304<h5>radius</h5>
305<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
306
307<h5>sigma</h5>
308<p>the standard deviation of the Gaussian, in pixels.</p>
309
310 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]311<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAdaptiveThresholdImage">MagickAdaptiveThresholdImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]312<div class="doc-section">
313
314<p>MagickAdaptiveThresholdImage() selects an individual threshold for each pixel based on the range of intensity values in its local neighborhood. This allows for thresholding of an image whose global intensity histogram doesn't contain distinctive peaks.</p>
315
316<p>The format of the AdaptiveThresholdImage method is:</p>
317
318<pre class="code">
319 MagickBooleanType MagickAdaptiveThresholdImage(MagickWand *wand,
320 const size_t width,const size_t height,const ssize_t offset)
321</pre>
322
323<p>A description of each parameter follows:</p>
324
325<h5>wand</h5>
326<p>the magick wand.</p>
327
328<h5>width</h5>
329<p>the width of the local neighborhood.</p>
330
331<h5>height</h5>
332<p>the height of the local neighborhood.</p>
333
334<h5>offset</h5>
335<p>the mean offset.</p>
336
337 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]338<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAddImage">MagickAddImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]339<div class="doc-section">
340
341<p>MagickAddImage() adds the specified images at the current image location.</p>
342
343<p>The format of the MagickAddImage method is:</p>
344
345<pre class="code">
346 MagickBooleanType MagickAddImage(MagickWand *wand,
347 const MagickWand *add_wand)
348</pre>
349
350<p>A description of each parameter follows:</p>
351
352<h5>wand</h5>
353<p>the magick wand.</p>
354
355<h5>add_wand</h5>
356<p>A wand that contains images to add at the current image location.</p>
357
358 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]359<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAddNoiseImage">MagickAddNoiseImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]360<div class="doc-section">
361
362<p>MagickAddNoiseImage() adds random noise to the image.</p>
363
364<p>The format of the MagickAddNoiseImage method is:</p>
365
366<pre class="code">
367 MagickBooleanType MagickAddNoiseImage(MagickWand *wand,
368 const NoiseType noise_type)
369 MagickBooleanType MagickAddNoiseImageChannel(MagickWand *wand,
370 const ChannelType channel,const NoiseType noise_type)
371</pre>
372
373<p>A description of each parameter follows:</p>
374
375<h5>wand</h5>
376<p>the magick wand.</p>
377
378<h5>channel</h5>
379<p>the image channel(s).</p>
380
381<h5>noise_type</h5>
382<p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p>
383
384 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]385<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAffineTransformImage">MagickAffineTransformImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]386<div class="doc-section">
387
388<p>MagickAffineTransformImage() transforms an image as dictated by the affine matrix of the drawing wand.</p>
389
390<p>The format of the MagickAffineTransformImage method is:</p>
391
392<pre class="code">
393 MagickBooleanType MagickAffineTransformImage(MagickWand *wand,
394 const DrawingWand *drawing_wand)
395</pre>
396
397<p>A description of each parameter follows:</p>
398
399<h5>wand</h5>
400<p>the magick wand.</p>
401
402<h5>drawing_wand</h5>
403<p>the draw wand.</p>
404
405 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]406<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAnnotateImage">MagickAnnotateImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]407<div class="doc-section">
408
409<p>MagickAnnotateImage() annotates an image with text.</p>
410
411<p>The format of the MagickAnnotateImage method is:</p>
412
413<pre class="code">
414 MagickBooleanType MagickAnnotateImage(MagickWand *wand,
415 const DrawingWand *drawing_wand,const double x,const double y,
416 const double angle,const char *text)
417</pre>
418
419<p>A description of each parameter follows:</p>
420
421<h5>wand</h5>
422<p>the magick wand.</p>
423
424<h5>drawing_wand</h5>
425<p>the draw wand.</p>
426
427<h5>x</h5>
428<p>x ordinate to left of text</p>
429
430<h5>y</h5>
431<p>y ordinate to text baseline</p>
432
433<h5>angle</h5>
434<p>rotate text relative to this angle.</p>
435
436<h5>text</h5>
437<p>text to draw</p>
438
439 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]440<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAnimateImages">MagickAnimateImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]441<div class="doc-section">
442
443<p>MagickAnimateImages() animates an image or image sequence.</p>
444
445<p>The format of the MagickAnimateImages method is:</p>
446
447<pre class="code">
448 MagickBooleanType MagickAnimateImages(MagickWand *wand,
449 const char *server_name)
450</pre>
451
452<p>A description of each parameter follows:</p>
453
454<h5>wand</h5>
455<p>the magick wand.</p>
456
457<h5>server_name</h5>
458<p>the X server name.</p>
459
460 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]461<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAppendImages">MagickAppendImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]462<div class="doc-section">
463
464<p>MagickAppendImages() append a set of images.</p>
465
466<p>The format of the MagickAppendImages method is:</p>
467
468<pre class="code">
469 MagickWand *MagickAppendImages(MagickWand *wand,
470 const MagickBooleanType stack)
471</pre>
472
473<p>A description of each parameter follows:</p>
474
475<h5>wand</h5>
476<p>the magick wand.</p>
477
478<h5>stack</h5>
479<p>By default, images are stacked left-to-right. Set stack to MagickTrue to stack them top-to-bottom.</p>
480
481 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]482<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAutoGammaImage">MagickAutoGammaImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]483<div class="doc-section">
484
485<p>MagickAutoGammaImage() extracts the 'mean' from the image and adjust the image to try make set its gamma appropriatally.</p>
486
487<p>The format of the MagickAutoGammaImage method is:</p>
488
489<pre class="code">
490 MagickBooleanType MagickAutoGammaImage(MagickWand *wand)
491 MagickBooleanType MagickAutoGammaImageChannel(MagickWand *wand,
492 const ChannelType channel)
493</pre>
494
495<p>A description of each parameter follows:</p>
496
497<h5>wand</h5>
498<p>the magick wand.</p>
499
500<h5>channel</h5>
501<p>the image channel(s).</p>
502
503 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]504<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickAutoLevelImage">MagickAutoLevelImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]505<div class="doc-section">
506
507<p>MagickAutoLevelImage() adjusts the levels of a particular image channel by scaling the minimum and maximum values to the full quantum range.</p>
508
509<p>The format of the MagickAutoLevelImage method is:</p>
510
511<pre class="code">
512 MagickBooleanType MagickAutoLevelImage(MagickWand *wand)
513 MagickBooleanType MagickAutoLevelImageChannel(MagickWand *wand,
514 const ChannelType channel)
515</pre>
516
517<p>A description of each parameter follows:</p>
518
519<h5>wand</h5>
520<p>the magick wand.</p>
521
522<h5>channel</h5>
523<p>the image channel(s).</p>
524
525 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]526<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickBlackThresholdImage">MagickBlackThresholdImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]527<div class="doc-section">
528
529<p>MagickBlackThresholdImage() is like MagickThresholdImage() but forces all pixels below the threshold into black while leaving all pixels above the threshold unchanged.</p>
530
531<p>The format of the MagickBlackThresholdImage method is:</p>
532
533<pre class="code">
534 MagickBooleanType MagickBlackThresholdImage(MagickWand *wand,
535 const PixelWand *threshold)
536</pre>
537
538<p>A description of each parameter follows:</p>
539
540<h5>wand</h5>
541<p>the magick wand.</p>
542
543<h5>threshold</h5>
544<p>the pixel wand.</p>
545
546 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]547<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickBlueShiftImage">MagickBlueShiftImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]548<div class="doc-section">
549
550<p>MagickBlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p>
551
552<p>The format of the MagickBlueShiftImage method is:</p>
553
554<pre class="code">
555 MagickBooleanType MagickBlueShiftImage(MagickWand *wand,
556 const double factor)
557</pre>
558
559<p>A description of each parameter follows:</p>
560
561<h5>wand</h5>
562<p>the magick wand.</p>
563
564<h5>factor</h5>
565<p>the blue shift factor (default 1.5)</p>
566
567 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]568<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickBlurImage">MagickBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]569<div class="doc-section">
570
571<p>MagickBlurImage() blurs an image. We convolve the image with a gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and BlurImage() selects a suitable radius for you.</p>
572
573<p>The format of the MagickBlurImage method is:</p>
574
575<pre class="code">
576 MagickBooleanType MagickBlurImage(MagickWand *wand,const double radius,
577 const double sigma)
578 MagickBooleanType MagickBlurImageChannel(MagickWand *wand,
579 const ChannelType channel,const double radius,const double sigma)
580</pre>
581
582<p>A description of each parameter follows:</p>
583
584<h5>wand</h5>
585<p>the magick wand.</p>
586
587<h5>channel</h5>
588<p>the image channel(s).</p>
589
590<h5>radius</h5>
591<p>the radius of the , in pixels, not counting the center pixel.</p>
592
593<h5>sigma</h5>
594<p>the standard deviation of the , in pixels.</p>
595
596 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]597<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickBorderImage">MagickBorderImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]598<div class="doc-section">
599
600<p>MagickBorderImage() surrounds the image with a border of the color defined by the bordercolor pixel wand.</p>
601
602<p>The format of the MagickBorderImage method is:</p>
603
604<pre class="code">
605 MagickBooleanType MagickBorderImage(MagickWand *wand,
606 const PixelWand *bordercolor,const size_t width,
607 const size_t height)
608</pre>
609
610<p>A description of each parameter follows:</p>
611
612<h5>wand</h5>
613<p>the magick wand.</p>
614
615<h5>bordercolor</h5>
616<p>the border color pixel wand.</p>
617
618<h5>width</h5>
619<p>the border width.</p>
620
621<h5>height</h5>
622<p>the border height.</p>
623
624 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]625<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="Use_MagickBrightnessContrastImage">Use MagickBrightnessContrastImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]626<div class="doc-section">
627
628<p>Use MagickBrightnessContrastImage() to change the brightness and/or contrast of an image. It converts the brightness and contrast parameters into slope and intercept and calls a polynomical function to apply to the image.</p>
629
630
631<p>The format of the MagickBrightnessContrastImage method is:</p>
632
633<pre class="code">
634 MagickBooleanType MagickBrightnessContrastImage(MagickWand *wand,
635 const double brightness,const double contrast)
636 MagickBooleanType MagickBrightnessContrastImageChannel(MagickWand *wand,
637 const ChannelType channel,const double brightness,
638 const double contrast)
639</pre>
640
641<p>A description of each parameter follows:</p>
642
643<h5>wand</h5>
644<p>the magick wand.</p>
645
646<h5>channel</h5>
647<p>the image channel(s).</p>
648
649<h5>brightness</h5>
650<p>the brightness percent (-100 .. 100).</p>
651
652<h5>contrast</h5>
653<p>the contrast percent (-100 .. 100).</p>
654
655 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]656<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCharcoalImage">MagickCharcoalImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]657<div class="doc-section">
658
659<p>MagickCharcoalImage() simulates a charcoal drawing.</p>
660
661<p>The format of the MagickCharcoalImage method is:</p>
662
663<pre class="code">
664 MagickBooleanType MagickCharcoalImage(MagickWand *wand,
665 const double radius,const double sigma)
666</pre>
667
668<p>A description of each parameter follows:</p>
669
670<h5>wand</h5>
671<p>the magick wand.</p>
672
673<h5>radius</h5>
674<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
675
676<h5>sigma</h5>
677<p>the standard deviation of the Gaussian, in pixels.</p>
678
679 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]680<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickChopImage">MagickChopImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]681<div class="doc-section">
682
683<p>MagickChopImage() removes a region of an image and collapses the image to occupy the removed portion</p>
684
685<p>The format of the MagickChopImage method is:</p>
686
687<pre class="code">
688 MagickBooleanType MagickChopImage(MagickWand *wand,
689 const size_t width,const size_t height,const ssize_t x,
690 const ssize_t y)
691</pre>
692
693<p>A description of each parameter follows:</p>
694
695<h5>wand</h5>
696<p>the magick wand.</p>
697
698<h5>width</h5>
699<p>the region width.</p>
700
701<h5>height</h5>
702<p>the region height.</p>
703
704<h5>x</h5>
705<p>the region x offset.</p>
706
707<h5>y</h5>
708<p>the region y offset.</p>
709
710
711 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]712<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickClampImage">MagickClampImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]713<div class="doc-section">
714
715<p>MagickClampImage() restricts the color range from 0 to the quantum depth.</p>
716
717<p>The format of the MagickClampImage method is:</p>
718
719<pre class="code">
720 MagickBooleanType MagickClampImage(MagickWand *wand)
721 MagickBooleanType MagickClampImageChannel(MagickWand *wand,
722 const ChannelType channel)
723</pre>
724
725<p>A description of each parameter follows:</p>
726
727<h5>wand</h5>
728<p>the magick wand.</p>
729
730<h5>channel</h5>
731<p>the channel.</p>
732
733 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]734<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickClipImage">MagickClipImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]735<div class="doc-section">
736
737<p>MagickClipImage() clips along the first path from the 8BIM profile, if present.</p>
738
739<p>The format of the MagickClipImage method is:</p>
740
741<pre class="code">
742 MagickBooleanType MagickClipImage(MagickWand *wand)
743</pre>
744
745<p>A description of each parameter follows:</p>
746
747<h5>wand</h5>
748<p>the magick wand.</p>
749
750 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]751<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickClipImagePath">MagickClipImagePath</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]752<div class="doc-section">
753
754<p>MagickClipImagePath() clips along the named paths from the 8BIM profile, if present. Later operations take effect inside the path. Id may be a number if preceded with #, to work on a numbered path, e.g., "#1" to use the first path.</p>
755
756<p>The format of the MagickClipImagePath method is:</p>
757
758<pre class="code">
759 MagickBooleanType MagickClipImagePath(MagickWand *wand,
760 const char *pathname,const MagickBooleanType inside)
761</pre>
762
763<p>A description of each parameter follows:</p>
764
765<h5>wand</h5>
766<p>the magick wand.</p>
767
768<h5>pathname</h5>
769<p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p>
770
771<h5>inside</h5>
772<p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p>
773
774 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]775<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickClutImage">MagickClutImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]776<div class="doc-section">
777
778<p>MagickClutImage() replaces colors in the image from a color lookup table.</p>
779
780<p>The format of the MagickClutImage method is:</p>
781
782<pre class="code">
783 MagickBooleanType MagickClutImage(MagickWand *wand,
784 const MagickWand *clut_wand)
785 MagickBooleanType MagickClutImageChannel(MagickWand *wand,
786 const ChannelType channel,const MagickWand *clut_wand)
787</pre>
788
789<p>A description of each parameter follows:</p>
790
791<h5>wand</h5>
792<p>the magick wand.</p>
793
794<h5>clut_image</h5>
795<p>the clut image.</p>
796
797 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]798<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCoalesceImages">MagickCoalesceImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]799<div class="doc-section">
800
801<p>MagickCoalesceImages() composites a set of images while respecting any page offsets and disposal methods. GIF, MIFF, and MNG animation sequences typically start with an image background and each subsequent image varies in size and offset. MagickCoalesceImages() returns a new sequence where each image in the sequence is the same size as the first and composited with the next image in the sequence.</p>
802
803<p>The format of the MagickCoalesceImages method is:</p>
804
805<pre class="code">
806 MagickWand *MagickCoalesceImages(MagickWand *wand)
807</pre>
808
809<p>A description of each parameter follows:</p>
810
811<h5>wand</h5>
812<p>the magick wand.</p>
813
814 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]815<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickColorDecisionListImage">MagickColorDecisionListImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]816<div class="doc-section">
817
818<p>MagickColorDecisionListImage() accepts a lightweight Color Correction Collection (CCC) file which solely contains one or more color corrections and applies the color correction to the image. Here is a sample CCC file:</p>
819
820<pre class="text">
821 <ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
822 <ColorCorrection id="cc03345">
823 <SOPNode>
824 <Slope> 0.9 1.2 0.5 </Slope>
825 <Offset> 0.4 -0.5 0.6 </Offset>
826 <Power> 1.0 0.8 1.5 </Power>
827 </SOPNode>
828 <SATNode>
829 <Saturation> 0.85 </Saturation>
830 </SATNode>
831 </ColorCorrection>
832 </ColorCorrectionCollection>
833</pre>
834
835<p>which includes the offset, slope, and power for each of the RGB channels as well as the saturation.</p>
836
837<p>The format of the MagickColorDecisionListImage method is:</p>
838
839<pre class="code">
840 MagickBooleanType MagickColorDecisionListImage(MagickWand *wand,
841 const double gamma)
842</pre>
843
844<p>A description of each parameter follows:</p>
845
846<h5>wand</h5>
847<p>the magick wand.</p>
848
849<h5>color_correction_collection</h5>
850<p>the color correction collection in XML.</p>
851
852 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]853<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickColorizeImage">MagickColorizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]854<div class="doc-section">
855
856<p>MagickColorizeImage() blends the fill color with each pixel in the image.</p>
857
858<p>The format of the MagickColorizeImage method is:</p>
859
860<pre class="code">
861 MagickBooleanType MagickColorizeImage(MagickWand *wand,
862 const PixelWand *colorize,const PixelWand *opacity)
863</pre>
864
865<p>A description of each parameter follows:</p>
866
867<h5>wand</h5>
868<p>the magick wand.</p>
869
870<h5>colorize</h5>
871<p>the colorize pixel wand.</p>
872
873<h5>opacity</h5>
874<p>the opacity pixel wand.</p>
875
876 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]877<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickColorMatrixImage">MagickColorMatrixImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]878<div class="doc-section">
879
880<p>MagickColorMatrixImage() apply color transformation to an image. The method permits saturation changes, hue rotation, luminance to alpha, and various other effects. Although variable-sized transformation matrices can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA (or RGBA with offsets). The matrix is similar to those used by Adobe Flash except offsets are in column 6 rather than 5 (in support of CMYKA images) and offsets are normalized (divide Flash offset by 255).</p>
881
882<p>The format of the MagickColorMatrixImage method is:</p>
883
884<pre class="code">
885 MagickBooleanType MagickColorMatrixImage(MagickWand *wand,
886 const KernelInfo *color_matrix)
887</pre>
888
889<p>A description of each parameter follows:</p>
890
891<h5>wand</h5>
892<p>the magick wand.</p>
893
894<h5>color_matrix</h5>
895<p>the color matrix.</p>
896
897 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]898<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCombineImages">MagickCombineImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]899<div class="doc-section">
900
901<p>MagickCombineImages() combines one or more images into a single image. The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc.</p>
902
903<p>The format of the MagickCombineImages method is:</p>
904
905<pre class="code">
906 MagickWand *MagickCombineImages(MagickWand *wand,
907 const ChannelType channel)
908</pre>
909
910<p>A description of each parameter follows:</p>
911
912<h5>wand</h5>
913<p>the magick wand.</p>
914
915<h5>channel</h5>
916<p>the channel.</p>
917
918 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]919<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCommentImage">MagickCommentImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]920<div class="doc-section">
921
922<p>MagickCommentImage() adds a comment to your image.</p>
923
924<p>The format of the MagickCommentImage method is:</p>
925
926<pre class="code">
927 MagickBooleanType MagickCommentImage(MagickWand *wand,
928 const char *comment)
929</pre>
930
931<p>A description of each parameter follows:</p>
932
933<h5>wand</h5>
934<p>the magick wand.</p>
935
936<h5>comment</h5>
937<p>the image comment.</p>
938
939 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]940<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCompareImageChannels">MagickCompareImageChannels</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]941<div class="doc-section">
942
943<p>MagickCompareImageChannels() compares one or more image channels of an image to a reconstructed image and returns the difference image.</p>
944
945<p>The format of the MagickCompareImageChannels method is:</p>
946
947<pre class="code">
948 MagickWand *MagickCompareImageChannels(MagickWand *wand,
949 const MagickWand *reference,const ChannelType channel,
950 const MetricType metric,double *distortion)
951</pre>
952
953<p>A description of each parameter follows:</p>
954
955<h5>wand</h5>
956<p>the magick wand.</p>
957
958<h5>reference</h5>
959<p>the reference wand.</p>
960
961<h5>channel</h5>
962<p>the channel.</p>
963
964<h5>metric</h5>
965<p>the metric.</p>
966
967<h5>distortion</h5>
968<p>the computed distortion between the images.</p>
969
970 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]971<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCompareImageLayers">MagickCompareImageLayers</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]972<div class="doc-section">
973
974<p>MagickCompareImageLayers() compares each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers.</p>
975
976<p>The format of the MagickCompareImageLayers method is:</p>
977
978<pre class="code">
979 MagickWand *MagickCompareImageLayers(MagickWand *wand,
980 const ImageLayerMethod method)
981</pre>
982
983<p>A description of each parameter follows:</p>
984
985<h5>wand</h5>
986<p>the magick wand.</p>
987
988<h5>method</h5>
989<p>the compare method.</p>
990
991 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]992<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCompareImages">MagickCompareImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]993<div class="doc-section">
994
995<p>MagickCompareImages() compares an image to a reconstructed image and returns the specified difference image.</p>
996
997<p>The format of the MagickCompareImages method is:</p>
998
999<pre class="code">
1000 MagickWand *MagickCompareImages(MagickWand *wand,
1001 const MagickWand *reference,const MetricType metric,
1002 double *distortion)
1003</pre>
1004
1005<p>A description of each parameter follows:</p>
1006
1007<h5>wand</h5>
1008<p>the magick wand.</p>
1009
1010<h5>reference</h5>
1011<p>the reference wand.</p>
1012
1013<h5>metric</h5>
1014<p>the metric.</p>
1015
1016<h5>distortion</h5>
1017<p>the computed distortion between the images.</p>
1018
1019 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1020<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCompositeImage">MagickCompositeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1021<div class="doc-section">
1022
1023<p>MagickCompositeImage() composite one image onto another at the specified offset.</p>
1024
1025<p>The format of the MagickCompositeImage method is:</p>
1026
1027<pre class="code">
1028 MagickBooleanType MagickCompositeImage(MagickWand *wand,
1029 const MagickWand *composite_wand,const CompositeOperator compose,
1030 const ssize_t x,const ssize_t y)
1031 MagickBooleanType MagickCompositeImageChannel(MagickWand *wand,
1032 const ChannelType channel,const MagickWand *composite_wand,
1033 const CompositeOperator compose,const ssize_t x,const ssize_t y)
1034</pre>
1035
1036<p>A description of each parameter follows:</p>
1037
1038<h5>wand</h5>
1039<p>the magick wand.</p>
1040
1041<h5>composite_image</h5>
1042<p>the composite image.</p>
1043
1044<h5>compose</h5>
1045<p>This operator affects how the composite is applied to the image. The default is Over. Choose from these operators:</p>
1046
1047<pre class="text">
1048 OverCompositeOp InCompositeOp OutCompositeOp
1049 AtopCompositeOp XorCompositeOp PlusCompositeOp
1050 MinusCompositeOp AddCompositeOp SubtractCompositeOp
1051 DifferenceCompositeOp BumpmapCompositeOp CopyCompositeOp
1052 DisplaceCompositeOp
1053</pre>
1054
1055<h5>x</h5>
1056<p>the column offset of the composited image.</p>
1057
1058<h5>y</h5>
1059<p>the row offset of the composited image.</p>
1060
1061 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1062<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickContrastImage">MagickContrastImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1063<div class="doc-section">
1064
1065<p>MagickContrastImage() enhances the intensity differences between the lighter and darker elements of the image. Set sharpen to a value other than 0 to increase the image contrast otherwise the contrast is reduced.</p>
1066
1067<p>The format of the MagickContrastImage method is:</p>
1068
1069<pre class="code">
1070 MagickBooleanType MagickContrastImage(MagickWand *wand,
1071 const MagickBooleanType sharpen)
1072</pre>
1073
1074<p>A description of each parameter follows:</p>
1075
1076<h5>wand</h5>
1077<p>the magick wand.</p>
1078
1079<h5>sharpen</h5>
1080<p>Increase or decrease image contrast.</p>
1081
1082
1083 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1084<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickContrastStretchImage">MagickContrastStretchImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1085<div class="doc-section">
1086
1087<p>MagickContrastStretchImage() enhances the contrast of a color image by adjusting the pixels color to span the entire range of colors available. You can also reduce the influence of a particular channel with a gamma value of 0.</p>
1088
1089<p>The format of the MagickContrastStretchImage method is:</p>
1090
1091<pre class="code">
1092 MagickBooleanType MagickContrastStretchImage(MagickWand *wand,
1093 const double black_point,const double white_point)
1094 MagickBooleanType MagickContrastStretchImageChannel(MagickWand *wand,
1095 const ChannelType channel,const double black_point,
1096 const double white_point)
1097</pre>
1098
1099<p>A description of each parameter follows:</p>
1100
1101<h5>wand</h5>
1102<p>the magick wand.</p>
1103
1104<h5>channel</h5>
1105<p>the image channel(s).</p>
1106
1107<h5>black_point</h5>
1108<p>the black point.</p>
1109
1110<h5>white_point</h5>
1111<p>the white point.</p>
1112
1113 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1114<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickConvolveImage">MagickConvolveImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1115<div class="doc-section">
1116
1117<p>MagickConvolveImage() applies a custom convolution kernel to the image.</p>
1118
1119<p>The format of the MagickConvolveImage method is:</p>
1120
1121<pre class="code">
1122 MagickBooleanType MagickConvolveImage(MagickWand *wand,
1123 const size_t order,const double *kernel)
1124 MagickBooleanType MagickConvolveImageChannel(MagickWand *wand,
1125 const ChannelType channel,const size_t order,
1126 const double *kernel)
1127</pre>
1128
1129<p>A description of each parameter follows:</p>
1130
1131<h5>wand</h5>
1132<p>the magick wand.</p>
1133
1134<h5>channel</h5>
1135<p>the image channel(s).</p>
1136
1137<h5>order</h5>
1138<p>the number of columns and rows in the filter kernel.</p>
1139
1140<h5>kernel</h5>
1141<p>An array of doubles representing the convolution kernel.</p>
1142
1143 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1144<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCropImage">MagickCropImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1145<div class="doc-section">
1146
1147<p>MagickCropImage() extracts a region of the image.</p>
1148
1149<p>The format of the MagickCropImage method is:</p>
1150
1151<pre class="code">
1152 MagickBooleanType MagickCropImage(MagickWand *wand,
1153 const size_t width,const size_t height,const ssize_t x,const ssize_t y)
1154</pre>
1155
1156<p>A description of each parameter follows:</p>
1157
1158<h5>wand</h5>
1159<p>the magick wand.</p>
1160
1161<h5>width</h5>
1162<p>the region width.</p>
1163
1164<h5>height</h5>
1165<p>the region height.</p>
1166
1167<h5>x</h5>
1168<p>the region x-offset.</p>
1169
1170<h5>y</h5>
1171<p>the region y-offset.</p>
1172
1173 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1174<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickCycleColormapImage">MagickCycleColormapImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1175<div class="doc-section">
1176
1177<p>MagickCycleColormapImage() displaces an image's colormap by a given number of positions. If you cycle the colormap a number of times you can produce a psychodelic effect.</p>
1178
1179<p>The format of the MagickCycleColormapImage method is:</p>
1180
1181<pre class="code">
1182 MagickBooleanType MagickCycleColormapImage(MagickWand *wand,
1183 const ssize_t displace)
1184</pre>
1185
1186<p>A description of each parameter follows:</p>
1187
1188<h5>wand</h5>
1189<p>the magick wand.</p>
1190
1191<h5>pixel_wand</h5>
1192<p>the pixel wand.</p>
1193
1194 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1195<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickConstituteImage">MagickConstituteImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1196<div class="doc-section">
1197
1198<p>MagickConstituteImage() adds an image to the wand comprised of the pixel data you supply. The pixel data must be in scanline order top-to-bottom. The data can be char, short int, int, float, or double. Float and double require the pixels to be normalized [0..1], otherwise [0..Max], where Max is the maximum value the type can accomodate (e.g. 255 for char). For example, to create a 640x480 image from unsigned red-green-blue character data, use</p>
1199
1200<p>MagickConstituteImage(wand,640,640,"RGB",CharPixel,pixels);</p>
1201
1202<p>The format of the MagickConstituteImage method is:</p>
1203
1204<pre class="code">
1205 MagickBooleanType MagickConstituteImage(MagickWand *wand,
1206 const size_t columns,const size_t rows,const char *map,
1207 const StorageType storage,void *pixels)
1208</pre>
1209
1210<p>A description of each parameter follows:</p>
1211
1212<h5>wand</h5>
1213<p>the magick wand.</p>
1214
1215<h5>columns</h5>
1216<p>width in pixels of the image.</p>
1217
1218<h5>rows</h5>
1219<p>height in pixels of the image.</p>
1220
1221<h5>map</h5>
1222<p>This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.</p>
1223
1224<h5>storage</h5>
1225<p>Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, DoublePixel, FloatPixel, IntegerPixel, LongPixel, QuantumPixel, or ShortPixel.</p>
1226
1227<h5>pixels</h5>
1228<p>This array of values contain the pixel components as defined by map and type. You must preallocate this array where the expected length varies depending on the values of width, height, map, and type.</p>
1229
1230
1231 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1232<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDecipherImage">MagickDecipherImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1233<div class="doc-section">
1234
1235<p>MagickDecipherImage() converts cipher pixels to plain pixels.</p>
1236
1237<p>The format of the MagickDecipherImage method is:</p>
1238
1239<pre class="code">
1240 MagickBooleanType MagickDecipherImage(MagickWand *wand,
1241 const char *passphrase)
1242</pre>
1243
1244<p>A description of each parameter follows:</p>
1245
1246<h5>wand</h5>
1247<p>the magick wand.</p>
1248
1249<h5>passphrase</h5>
1250<p>the passphrase.</p>
1251
1252 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1253<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDeconstructImages">MagickDeconstructImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1254<div class="doc-section">
1255
1256<p>MagickDeconstructImages() compares each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers.</p>
1257
1258<p>The format of the MagickDeconstructImages method is:</p>
1259
1260<pre class="code">
1261 MagickWand *MagickDeconstructImages(MagickWand *wand)
1262</pre>
1263
1264<p>A description of each parameter follows:</p>
1265
1266<h5>wand</h5>
1267<p>the magick wand.</p>
1268
1269 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1270<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDeskewImage">MagickDeskewImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1271<div class="doc-section">
1272
1273<p>MagickDeskewImage() removes skew from the image. Skew is an artifact that occurs in scanned images because of the camera being misaligned, imperfections in the scanning or surface, or simply because the paper was not placed completely flat when scanned.</p>
1274
1275<p>The format of the MagickDeskewImage method is:</p>
1276
1277<pre class="code">
1278 MagickBooleanType MagickDeskewImage(MagickWand *wand,
1279 const double threshold)
1280</pre>
1281
1282<p>A description of each parameter follows:</p>
1283
1284<h5>wand</h5>
1285<p>the magick wand.</p>
1286
1287<h5>threshold</h5>
1288<p>separate background from foreground.</p>
1289
1290 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1291<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDespeckleImage">MagickDespeckleImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1292<div class="doc-section">
1293
1294<p>MagickDespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.</p>
1295
1296<p>The format of the MagickDespeckleImage method is:</p>
1297
1298<pre class="code">
1299 MagickBooleanType MagickDespeckleImage(MagickWand *wand)
1300</pre>
1301
1302<p>A description of each parameter follows:</p>
1303
1304<h5>wand</h5>
1305<p>the magick wand.</p>
1306
1307 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1308<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDestroyImage">MagickDestroyImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1309<div class="doc-section">
1310
1311<p>MagickDestroyImage() dereferences an image, deallocating memory associated with the image if the reference count becomes zero.</p>
1312
1313<p>The format of the MagickDestroyImage method is:</p>
1314
1315<pre class="code">
1316 Image *MagickDestroyImage(Image *image)
1317</pre>
1318
1319<p>A description of each parameter follows:</p>
1320
1321<h5>image</h5>
1322<p>the image.</p>
1323
1324 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1325<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDisplayImage">MagickDisplayImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1326<div class="doc-section">
1327
1328<p>MagickDisplayImage() displays an image.</p>
1329
1330<p>The format of the MagickDisplayImage method is:</p>
1331
1332<pre class="code">
1333 MagickBooleanType MagickDisplayImage(MagickWand *wand,
1334 const char *server_name)
1335</pre>
1336
1337<p>A description of each parameter follows:</p>
1338
1339<h5>wand</h5>
1340<p>the magick wand.</p>
1341
1342<h5>server_name</h5>
1343<p>the X server name.</p>
1344
1345 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1346<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDisplayImages">MagickDisplayImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1347<div class="doc-section">
1348
1349<p>MagickDisplayImages() displays an image or image sequence.</p>
1350
1351<p>The format of the MagickDisplayImages method is:</p>
1352
1353<pre class="code">
1354 MagickBooleanType MagickDisplayImages(MagickWand *wand,
1355 const char *server_name)
1356</pre>
1357
1358<p>A description of each parameter follows:</p>
1359
1360<h5>wand</h5>
1361<p>the magick wand.</p>
1362
1363<h5>server_name</h5>
1364<p>the X server name.</p>
1365
1366 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1367<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDistortImage">MagickDistortImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1368<div class="doc-section">
1369
1370<p>MagickDistortImage() distorts an image using various distortion methods, by mapping color lookups of the source image to a new destination image usally of the same size as the source image, unless 'bestfit' is set to true.</p>
1371
1372<p>If 'bestfit' is enabled, and distortion allows it, the destination image is adjusted to ensure the whole source 'image' will just fit within the final destination image, which will be sized and offset accordingly. Also in many cases the virtual offset of the source image will be taken into account in the mapping.</p>
1373
1374<p>The format of the MagickDistortImage method is:</p>
1375
1376<pre class="code">
1377 MagickBooleanType MagickDistortImage(MagickWand *wand,
1378 const DistortImageMethod method,const size_t number_arguments,
1379 const double *arguments,const MagickBooleanType bestfit)
1380</pre>
1381
1382<p>A description of each parameter follows:</p>
1383
1384<h5>image</h5>
1385<p>the image to be distorted.</p>
1386
1387<h5>method</h5>
1388<p>the method of image distortion.</p>
1389
1390<p>ArcDistortion always ignores the source image offset, and always 'bestfit' the destination image with the top left corner offset relative to the polar mapping center.</p>
1391
1392<p>Bilinear has no simple inverse mapping so it does not allow 'bestfit' style of image distortion.</p>
1393
1394<p>Affine, Perspective, and Bilinear, do least squares fitting of the distortion when more than the minimum number of control point pairs are provided.</p>
1395
1396<p>Perspective, and Bilinear, falls back to a Affine distortion when less that 4 control point pairs are provided. While Affine distortions let you use any number of control point pairs, that is Zero pairs is a no-Op (viewport only) distrotion, one pair is a translation and two pairs of control points do a scale-rotate-translate, without any shearing.</p>
1397
1398<h5>number_arguments</h5>
1399<p>the number of arguments given for this distortion method.</p>
1400
1401<h5>arguments</h5>
1402<p>the arguments for this distortion method.</p>
1403
1404<h5>bestfit</h5>
1405<p>Attempt to resize destination to fit distorted source.</p>
1406
1407 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1408<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickDrawImage">MagickDrawImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1409<div class="doc-section">
1410
1411<p>MagickDrawImage() renders the drawing wand on the current image.</p>
1412
1413<p>The format of the MagickDrawImage method is:</p>
1414
1415<pre class="code">
1416 MagickBooleanType MagickDrawImage(MagickWand *wand,
1417 const DrawingWand *drawing_wand)
1418</pre>
1419
1420<p>A description of each parameter follows:</p>
1421
1422<h5>wand</h5>
1423<p>the magick wand.</p>
1424
1425<h5>drawing_wand</h5>
1426<p>the draw wand.</p>
1427
1428 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1429<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEdgeImage">MagickEdgeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1430<div class="doc-section">
1431
1432<p>MagickEdgeImage() enhance edges within the image with a convolution filter of the given radius. Use a radius of 0 and Edge() selects a suitable radius for you.</p>
1433
1434<p>The format of the MagickEdgeImage method is:</p>
1435
1436<pre class="code">
1437 MagickBooleanType MagickEdgeImage(MagickWand *wand,const double radius)
1438</pre>
1439
1440<p>A description of each parameter follows:</p>
1441
1442<h5>wand</h5>
1443<p>the magick wand.</p>
1444
1445<h5>radius</h5>
1446<p>the radius of the pixel neighborhood.</p>
1447
1448 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1449<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEmbossImage">MagickEmbossImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1450<div class="doc-section">
1451
1452<p>MagickEmbossImage() returns a grayscale image with a three-dimensional effect. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and Emboss() selects a suitable radius for you.</p>
1453
1454<p>The format of the MagickEmbossImage method is:</p>
1455
1456<pre class="code">
1457 MagickBooleanType MagickEmbossImage(MagickWand *wand,const double radius,
1458 const double sigma)
1459</pre>
1460
1461<p>A description of each parameter follows:</p>
1462
1463<h5>wand</h5>
1464<p>the magick wand.</p>
1465
1466<h5>radius</h5>
1467<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
1468
1469<h5>sigma</h5>
1470<p>the standard deviation of the Gaussian, in pixels.</p>
1471
1472 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1473<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEncipherImage">MagickEncipherImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1474<div class="doc-section">
1475
1476<p>MagickEncipherImage() converts plaint pixels to cipher pixels.</p>
1477
1478<p>The format of the MagickEncipherImage method is:</p>
1479
1480<pre class="code">
1481 MagickBooleanType MagickEncipherImage(MagickWand *wand,
1482 const char *passphrase)
1483</pre>
1484
1485<p>A description of each parameter follows:</p>
1486
1487<h5>wand</h5>
1488<p>the magick wand.</p>
1489
1490<h5>passphrase</h5>
1491<p>the passphrase.</p>
1492
1493 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1494<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEnhanceImage">MagickEnhanceImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1495<div class="doc-section">
1496
1497<p>MagickEnhanceImage() applies a digital filter that improves the quality of a noisy image.</p>
1498
1499<p>The format of the MagickEnhanceImage method is:</p>
1500
1501<pre class="code">
1502 MagickBooleanType MagickEnhanceImage(MagickWand *wand)
1503</pre>
1504
1505<p>A description of each parameter follows:</p>
1506
1507<h5>wand</h5>
1508<p>the magick wand.</p>
1509
1510 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1511<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEqualizeImage">MagickEqualizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1512<div class="doc-section">
1513
1514<p>MagickEqualizeImage() equalizes the image histogram.</p>
1515
1516<p>The format of the MagickEqualizeImage method is:</p>
1517
1518<pre class="code">
1519 MagickBooleanType MagickEqualizeImage(MagickWand *wand)
1520 MagickBooleanType MagickEqualizeImageChannel(MagickWand *wand,
1521 const ChannelType channel)
1522</pre>
1523
1524<p>A description of each parameter follows:</p>
1525
1526<h5>wand</h5>
1527<p>the magick wand.</p>
1528
1529<h5>channel</h5>
1530<p>the image channel(s).</p>
1531
1532 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1533<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickEvaluateImage">MagickEvaluateImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1534<div class="doc-section">
1535
1536<p>MagickEvaluateImage() applys an arithmetic, relational, or logical expression to an image. Use these operators to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p>
1537
1538<p>The format of the MagickEvaluateImage method is:</p>
1539
1540<pre class="code">
1541 MagickBooleanType MagickEvaluateImage(MagickWand *wand,
1542 const MagickEvaluateOperator operator,const double value)
1543 MagickBooleanType MagickEvaluateImages(MagickWand *wand,
1544 const MagickEvaluateOperator operator)
1545 MagickBooleanType MagickEvaluateImageChannel(MagickWand *wand,
1546 const ChannelType channel,const MagickEvaluateOperator op,
1547 const double value)
1548</pre>
1549
1550<p>A description of each parameter follows:</p>
1551
1552<h5>wand</h5>
1553<p>the magick wand.</p>
1554
1555<h5>channel</h5>
1556<p>the channel(s).</p>
1557
1558<h5>op</h5>
1559<p>A channel operator.</p>
1560
1561<h5>value</h5>
1562<p>A value value.</p>
1563
1564 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1565<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickExportImagePixels">MagickExportImagePixels</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1566<div class="doc-section">
1567
1568<p>MagickExportImagePixels() extracts pixel data from an image and returns it to you. The method returns MagickTrue on success otherwise MagickFalse if an error is encountered. The data is returned as char, short int, int, ssize_t, float, or double in the order specified by map.</p>
1569
1570<p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
1571
1572<pre class="text">
1573 MagickExportImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);
1574</pre>
1575
1576<p>The format of the MagickExportImagePixels method is:</p>
1577
1578<pre class="code">
1579 MagickBooleanType MagickExportImagePixels(MagickWand *wand,
1580 const ssize_t x,const ssize_t y,const size_t columns,
1581 const size_t rows,const char *map,const StorageType storage,
1582 void *pixels)
1583</pre>
1584
1585<p>A description of each parameter follows:</p>
1586
1587<h5>wand</h5>
1588<p>the magick wand.</p>
1589
1590<h5>x, y, columns, rows</h5>
1591<p>These values define the perimeter of a region of pixels you want to extract.</p>
1592
1593<h5>map</h5>
1594<p>This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.</p>
1595
1596<h5>storage</h5>
1597<p>Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, DoublePixel, FloatPixel, IntegerPixel, LongPixel, QuantumPixel, or ShortPixel.</p>
1598
1599<h5>pixels</h5>
1600<p>This array of values contain the pixel components as defined by map and type. You must preallocate this array where the expected length varies depending on the values of width, height, map, and type.</p>
1601
1602 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1603<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickExtentImage">MagickExtentImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1604<div class="doc-section">
1605
1606<p>MagickExtentImage() extends the image as defined by the geometry, gravity, and wand background color. Set the (x,y) offset of the geometry to move the original wand relative to the extended wand.</p>
1607
1608<p>The format of the MagickExtentImage method is:</p>
1609
1610<pre class="code">
1611 MagickBooleanType MagickExtentImage(MagickWand *wand,
1612 const size_t width,const size_t height,const ssize_t x,
1613 const ssize_t y)
1614</pre>
1615
1616<p>A description of each parameter follows:</p>
1617
1618<h5>wand</h5>
1619<p>the magick wand.</p>
1620
1621<h5>width</h5>
1622<p>the region width.</p>
1623
1624<h5>height</h5>
1625<p>the region height.</p>
1626
1627<h5>x</h5>
1628<p>the region x offset.</p>
1629
1630<h5>y</h5>
1631<p>the region y offset.</p>
1632
1633 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1634<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFilterImage">MagickFilterImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1635<div class="doc-section">
1636
1637<p>MagickFilterImage() applies a custom convolution kernel to the image.</p>
1638
1639<p>The format of the MagickFilterImage method is:</p>
1640
1641<pre class="code">
1642 MagickBooleanType MagickFilterImage(MagickWand *wand,
1643 const KernelInfo *kernel)
1644 MagickBooleanType MagickFilterImageChannel(MagickWand *wand,
1645 const ChannelType channel,const KernelInfo *kernel)
1646</pre>
1647
1648<p>A description of each parameter follows:</p>
1649
1650<h5>wand</h5>
1651<p>the magick wand.</p>
1652
1653<h5>channel</h5>
1654<p>the image channel(s).</p>
1655
1656<h5>kernel</h5>
1657<p>An array of doubles representing the convolution kernel.</p>
1658
1659 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1660<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFlipImage">MagickFlipImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1661<div class="doc-section">
1662
1663<p>MagickFlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis.</p>
1664
1665<p>The format of the MagickFlipImage method is:</p>
1666
1667<pre class="code">
1668 MagickBooleanType MagickFlipImage(MagickWand *wand)
1669</pre>
1670
1671<p>A description of each parameter follows:</p>
1672
1673<h5>wand</h5>
1674<p>the magick wand.</p>
1675
1676 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1677<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFloodfillPaintImage">MagickFloodfillPaintImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1678<div class="doc-section">
1679
1680<p>MagickFloodfillPaintImage() changes the color value of any pixel that matches target and is an immediate neighbor. If the method FillToBorderMethod is specified, the color value is changed for any neighbor pixel that does not match the bordercolor member of image.</p>
1681
1682<p>The format of the MagickFloodfillPaintImage method is:</p>
1683
1684<pre class="code">
1685 MagickBooleanType MagickFloodfillPaintImage(MagickWand *wand,
1686 const ChannelType channel,const PixelWand *fill,const double fuzz,
1687 const PixelWand *bordercolor,const ssize_t x,const ssize_t y,
1688 const MagickBooleanType invert)
1689</pre>
1690
1691<p>A description of each parameter follows:</p>
1692
1693<h5>wand</h5>
1694<p>the magick wand.</p>
1695
1696<h5>channel</h5>
1697<p>the channel(s).</p>
1698
1699<h5>fill</h5>
1700<p>the floodfill color pixel wand.</p>
1701
1702<h5>fuzz</h5>
1703<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p>
1704
1705<h5>bordercolor</h5>
1706<p>the border color pixel wand.</p>
1707
1708<h5>x,y</h5>
1709<p>the starting location of the operation.</p>
1710
1711<h5>invert</h5>
1712<p>paint any pixel that does not match the target color.</p>
1713
1714 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1715<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFlopImage">MagickFlopImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1716<div class="doc-section">
1717
1718<p>MagickFlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis.</p>
1719
1720<p>The format of the MagickFlopImage method is:</p>
1721
1722<pre class="code">
1723 MagickBooleanType MagickFlopImage(MagickWand *wand)
1724</pre>
1725
1726<p>A description of each parameter follows:</p>
1727
1728<h5>wand</h5>
1729<p>the magick wand.</p>
1730
1731 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1732<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickForwardFourierTransformImage">MagickForwardFourierTransformImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1733<div class="doc-section">
1734
1735<p>MagickForwardFourierTransformImage() implements the discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.</p>
1736
1737<p>The format of the MagickForwardFourierTransformImage method is:</p>
1738
1739<pre class="code">
1740 MagickBooleanType MagickForwardFourierTransformImage(MagickWand *wand,
1741 const MagickBooleanType magnitude)
1742</pre>
1743
1744<p>A description of each parameter follows:</p>
1745
1746<h5>wand</h5>
1747<p>the magick wand.</p>
1748
1749<h5>magnitude</h5>
1750<p>if true, return as magnitude / phase pair otherwise a real / imaginary image pair.</p>
1751
1752 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1753<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFrameImage">MagickFrameImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1754<div class="doc-section">
1755
1756<p>MagickFrameImage() adds a simulated three-dimensional border around the image. The width and height specify the border width of the vertical and horizontal sides of the frame. The inner and outer bevels indicate the width of the inner and outer shadows of the frame.</p>
1757
1758<p>The format of the MagickFrameImage method is:</p>
1759
1760<pre class="code">
1761 MagickBooleanType MagickFrameImage(MagickWand *wand,
1762 const PixelWand *matte_color,const size_t width,
1763 const size_t height,const ssize_t inner_bevel,
1764 const ssize_t outer_bevel)
1765</pre>
1766
1767<p>A description of each parameter follows:</p>
1768
1769<h5>wand</h5>
1770<p>the magick wand.</p>
1771
1772<h5>matte_color</h5>
1773<p>the frame color pixel wand.</p>
1774
1775<h5>width</h5>
1776<p>the border width.</p>
1777
1778<h5>height</h5>
1779<p>the border height.</p>
1780
1781<h5>inner_bevel</h5>
1782<p>the inner bevel width.</p>
1783
1784<h5>outer_bevel</h5>
1785<p>the outer bevel width.</p>
1786
1787 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1788<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFunctionImage">MagickFunctionImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1789<div class="doc-section">
1790
1791<p>MagickFunctionImage() applys an arithmetic, relational, or logical expression to an image. Use these operators to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p>
1792
1793<p>The format of the MagickFunctionImage method is:</p>
1794
1795<pre class="code">
1796 MagickBooleanType MagickFunctionImage(MagickWand *wand,
1797 const MagickFunction function,const size_t number_arguments,
1798 const double *arguments)
1799 MagickBooleanType MagickFunctionImageChannel(MagickWand *wand,
1800 const ChannelType channel,const MagickFunction function,
1801 const size_t number_arguments,const double *arguments)
1802</pre>
1803
1804<p>A description of each parameter follows:</p>
1805
1806<h5>wand</h5>
1807<p>the magick wand.</p>
1808
1809<h5>channel</h5>
1810<p>the channel(s).</p>
1811
1812<h5>function</h5>
1813<p>the image function.</p>
1814
1815<h5>number_arguments</h5>
1816<p>the number of function arguments.</p>
1817
1818<h5>arguments</h5>
1819<p>the function arguments.</p>
1820
1821 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1822<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickFxImage">MagickFxImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1823<div class="doc-section">
1824
1825<p>MagickFxImage() evaluate expression for each pixel in the image.</p>
1826
1827<p>The format of the MagickFxImage method is:</p>
1828
1829<pre class="code">
1830 MagickWand *MagickFxImage(MagickWand *wand,const char *expression)
1831 MagickWand *MagickFxImageChannel(MagickWand *wand,
1832 const ChannelType channel,const char *expression)
1833</pre>
1834
1835<p>A description of each parameter follows:</p>
1836
1837<h5>wand</h5>
1838<p>the magick wand.</p>
1839
1840<h5>channel</h5>
1841<p>the image channel(s).</p>
1842
1843<h5>expression</h5>
1844<p>the expression.</p>
1845
1846 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1847<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGammaImage">MagickGammaImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1848<div class="doc-section">
1849
1850<p>MagickGammaImage() gamma-corrects an image. The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma parameter. Values typically range from 0.8 to 2.3.</p>
1851
1852<p>You can also reduce the influence of a particular channel with a gamma value of 0.</p>
1853
1854<p>The format of the MagickGammaImage method is:</p>
1855
1856<pre class="code">
1857 MagickBooleanType MagickGammaImage(MagickWand *wand,const double gamma)
1858 MagickBooleanType MagickGammaImageChannel(MagickWand *wand,
1859 const ChannelType channel,const double gamma)
1860</pre>
1861
1862<p>A description of each parameter follows:</p>
1863
1864<h5>wand</h5>
1865<p>the magick wand.</p>
1866
1867<h5>channel</h5>
1868<p>the channel.</p>
1869
1870<h5>level</h5>
1871<p>Define the level of gamma correction.</p>
1872
1873 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1874<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGaussianBlurImage">MagickGaussianBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1875<div class="doc-section">
1876
1877<p>MagickGaussianBlurImage() blurs an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and MagickGaussianBlurImage() selects a suitable radius for you.</p>
1878
1879<p>The format of the MagickGaussianBlurImage method is:</p>
1880
1881<pre class="code">
1882 MagickBooleanType MagickGaussianBlurImage(MagickWand *wand,
1883 const double radius,const double sigma)
1884 MagickBooleanType MagickGaussianBlurImageChannel(MagickWand *wand,
1885 const ChannelType channel,const double radius,const double sigma)
1886</pre>
1887
1888<p>A description of each parameter follows:</p>
1889
1890<h5>wand</h5>
1891<p>the magick wand.</p>
1892
1893<h5>channel</h5>
1894<p>the image channel(s).</p>
1895
1896<h5>radius</h5>
1897<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
1898
1899<h5>sigma</h5>
1900<p>the standard deviation of the Gaussian, in pixels.</p>
1901
1902 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1903<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImage">MagickGetImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1904<div class="doc-section">
1905
1906<p>MagickGetImage() gets the image at the current image index.</p>
1907
1908<p>The format of the MagickGetImage method is:</p>
1909
1910<pre class="code">
1911 MagickWand *MagickGetImage(MagickWand *wand)
1912</pre>
1913
1914<p>A description of each parameter follows:</p>
1915
1916<h5>wand</h5>
1917<p>the magick wand.</p>
1918
1919 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1920<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageAlphaChannel">MagickGetImageAlphaChannel</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1921<div class="doc-section">
1922
1923<p>MagickGetImageAlphaChannel() returns MagickFalse if the image alpha channel is not activated. That is, the image is RGB rather than RGBA or CMYK rather than CMYKA.</p>
1924
1925<p>The format of the MagickGetImageAlphaChannel method is:</p>
1926
1927<pre class="code">
1928 size_t MagickGetImageAlphaChannel(MagickWand *wand)
1929</pre>
1930
1931<p>A description of each parameter follows:</p>
1932
1933<h5>wand</h5>
1934<p>the magick wand.</p>
1935
1936 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1937<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageClipMask">MagickGetImageClipMask</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1938<div class="doc-section">
1939
1940<p>MagickGetImageClipMask() gets the image clip mask at the current image index.</p>
1941
1942<p>The format of the MagickGetImageClipMask method is:</p>
1943
1944<pre class="code">
1945 MagickWand *MagickGetImageClipMask(MagickWand *wand)
1946</pre>
1947
1948<p>A description of each parameter follows:</p>
1949
1950<h5>wand</h5>
1951<p>the magick wand.</p>
1952
1953 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1954<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageBackgroundColor">MagickGetImageBackgroundColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1955<div class="doc-section">
1956
1957<p>MagickGetImageBackgroundColor() returns the image background color.</p>
1958
1959<p>The format of the MagickGetImageBackgroundColor method is:</p>
1960
1961<pre class="code">
1962 MagickBooleanType MagickGetImageBackgroundColor(MagickWand *wand,
1963 PixelWand *background_color)
1964</pre>
1965
1966<p>A description of each parameter follows:</p>
1967
1968<h5>wand</h5>
1969<p>the magick wand.</p>
1970
1971<h5>background_color</h5>
1972<p>Return the background color.</p>
1973
1974 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1975<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageBlob">MagickGetImageBlob</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]1976<div class="doc-section">
1977
1978<p>MagickGetImageBlob() implements direct to memory image formats. It returns the image as a blob (a formatted "file" in memory) and its length, starting from the current position in the image sequence. Use MagickSetImageFormat() to set the format to write to the blob (GIF, JPEG, PNG, etc.).</p>
1979
1980<p>Utilize MagickResetIterator() to ensure the write is from the beginning of the image sequence.</p>
1981
1982<p>Use MagickRelinquishMemory() to free the blob when you are done with it.</p>
1983
1984<p>The format of the MagickGetImageBlob method is:</p>
1985
1986<pre class="code">
1987 unsigned char *MagickGetImageBlob(MagickWand *wand,size_t *length)
1988</pre>
1989
1990<p>A description of each parameter follows:</p>
1991
1992<h5>wand</h5>
1993<p>the magick wand.</p>
1994
1995<h5>length</h5>
1996<p>the length of the blob.</p>
1997
1998 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]1999<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageBlob">MagickGetImageBlob</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2000<div class="doc-section">
2001
2002<p>MagickGetImageBlob() implements direct to memory image formats. It returns the image sequence as a blob and its length. The format of the image determines the format of the returned blob (GIF, JPEG, PNG, etc.). To return a different image format, use MagickSetImageFormat().</p>
2003
2004<p>Note, some image formats do not permit multiple images to the same image stream (e.g. JPEG). in this instance, just the first image of the sequence is returned as a blob.</p>
2005
2006<p>The format of the MagickGetImagesBlob method is:</p>
2007
2008<pre class="code">
2009 unsigned char *MagickGetImagesBlob(MagickWand *wand,size_t *length)
2010</pre>
2011
2012<p>A description of each parameter follows:</p>
2013
2014<h5>wand</h5>
2015<p>the magick wand.</p>
2016
2017<h5>length</h5>
2018<p>the length of the blob.</p>
2019
2020 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2021<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageBluePrimary">MagickGetImageBluePrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2022<div class="doc-section">
2023
2024<p>MagickGetImageBluePrimary() returns the chromaticy blue primary point for the image.</p>
2025
2026<p>The format of the MagickGetImageBluePrimary method is:</p>
2027
2028<pre class="code">
2029 MagickBooleanType MagickGetImageBluePrimary(MagickWand *wand,double *x,
2030 double *y)
2031</pre>
2032
2033<p>A description of each parameter follows:</p>
2034
2035<h5>wand</h5>
2036<p>the magick wand.</p>
2037
2038<h5>x</h5>
2039<p>the chromaticity blue primary x-point.</p>
2040
2041<h5>y</h5>
2042<p>the chromaticity blue primary y-point.</p>
2043
2044 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2045<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageBorderColor">MagickGetImageBorderColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2046<div class="doc-section">
2047
2048<p>MagickGetImageBorderColor() returns the image border color.</p>
2049
2050<p>The format of the MagickGetImageBorderColor method is:</p>
2051
2052<pre class="code">
2053 MagickBooleanType MagickGetImageBorderColor(MagickWand *wand,
2054 PixelWand *border_color)
2055</pre>
2056
2057<p>A description of each parameter follows:</p>
2058
2059<h5>wand</h5>
2060<p>the magick wand.</p>
2061
2062<h5>border_color</h5>
2063<p>Return the border color.</p>
2064
2065 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2066<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelDepth">MagickGetImageChannelDepth</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2067<div class="doc-section">
2068
2069<p>MagickGetImageChannelDepth() gets the depth for one or more image channels.</p>
2070
2071<p>The format of the MagickGetImageChannelDepth method is:</p>
2072
2073<pre class="code">
2074 size_t MagickGetImageChannelDepth(MagickWand *wand,
2075 const ChannelType channel)
2076</pre>
2077
2078<p>A description of each parameter follows:</p>
2079
2080<h5>wand</h5>
2081<p>the magick wand.</p>
2082
2083<h5>channel</h5>
2084<p>the image channel(s).</p>
2085
2086 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2087<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelDistortion">MagickGetImageChannelDistortion</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2088<div class="doc-section">
2089
2090<p>MagickGetImageChannelDistortion() compares one or more image channels of an image to a reconstructed image and returns the specified distortion metric.</p>
2091
2092<p>The format of the MagickGetImageChannelDistortion method is:</p>
2093
2094<pre class="code">
2095 MagickBooleanType MagickGetImageChannelDistortion(MagickWand *wand,
2096 const MagickWand *reference,const ChannelType channel,
2097 const MetricType metric,double *distortion)
2098</pre>
2099
2100<p>A description of each parameter follows:</p>
2101
2102<h5>wand</h5>
2103<p>the magick wand.</p>
2104
2105<h5>reference</h5>
2106<p>the reference wand.</p>
2107
2108<h5>channel</h5>
2109<p>the channel.</p>
2110
2111<h5>metric</h5>
2112<p>the metric.</p>
2113
2114<h5>distortion</h5>
2115<p>the computed distortion between the images.</p>
2116
2117 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2118<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelDistortions">MagickGetImageChannelDistortions</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2119<div class="doc-section">
2120
2121<p>MagickGetImageChannelDistortions() compares one or more image channels of an image to a reconstructed image and returns the specified distortion metrics.</p>
2122
2123<p>Use MagickRelinquishMemory() to free the metrics when you are done with them.</p>
2124
2125<p>The format of the MagickGetImageChannelDistortion method is:</p>
2126
2127<pre class="code">
2128 double *MagickGetImageChannelDistortion(MagickWand *wand,
2129 const MagickWand *reference,const MetricType metric)
2130</pre>
2131
2132<p>A description of each parameter follows:</p>
2133
2134<h5>wand</h5>
2135<p>the magick wand.</p>
2136
2137<h5>reference</h5>
2138<p>the reference wand.</p>
2139
2140<h5>metric</h5>
2141<p>the metric.</p>
2142
2143 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2144<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelFeatures">MagickGetImageChannelFeatures</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2145<div class="doc-section">
2146
2147<p>MagickGetImageChannelFeatures() returns features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance. The features include the angular second moment, contrast, correlation, sum of squares: variance, inverse difference moment, sum average, sum varience, sum entropy, entropy, difference variance, difference entropy, information measures of correlation 1, information measures of correlation 2, and maximum correlation coefficient. You can access the red channel contrast, for example, like this:</p>
2148
2149<pre class="text">
2150 channel_features=MagickGetImageChannelFeatures(wand,1);
2151 contrast=channel_features[RedChannel].contrast[0];
2152</pre>
2153
2154<p>Use MagickRelinquishMemory() to free the statistics buffer.</p>
2155
2156<p>The format of the MagickGetImageChannelFeatures method is:</p>
2157
2158<pre class="code">
2159 ChannelFeatures *MagickGetImageChannelFeatures(MagickWand *wand,
2160 const size_t distance)
2161</pre>
2162
2163<p>A description of each parameter follows:</p>
2164
2165<h5>wand</h5>
2166<p>the magick wand.</p>
2167
2168<h5>distance</h5>
2169<p>the distance.</p>
2170
2171 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2172<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelKurtosis">MagickGetImageChannelKurtosis</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2173<div class="doc-section">
2174
2175<p>MagickGetImageChannelKurtosis() gets the kurtosis and skewness of one or more image channels.</p>
2176
2177<p>The format of the MagickGetImageChannelKurtosis method is:</p>
2178
2179<pre class="code">
2180 MagickBooleanType MagickGetImageChannelKurtosis(MagickWand *wand,
2181 const ChannelType channel,double *kurtosis,double *skewness)
2182</pre>
2183
2184<p>A description of each parameter follows:</p>
2185
2186<h5>wand</h5>
2187<p>the magick wand.</p>
2188
2189<h5>channel</h5>
2190<p>the image channel(s).</p>
2191
2192<h5>kurtosis</h5>
2193<p>The kurtosis for the specified channel(s).</p>
2194
2195<h5>skewness</h5>
2196<p>The skewness for the specified channel(s).</p>
2197
2198 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2199<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelMean">MagickGetImageChannelMean</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2200<div class="doc-section">
2201
2202<p>MagickGetImageChannelMean() gets the mean and standard deviation of one or more image channels.</p>
2203
2204<p>The format of the MagickGetImageChannelMean method is:</p>
2205
2206<pre class="code">
2207 MagickBooleanType MagickGetImageChannelMean(MagickWand *wand,
2208 const ChannelType channel,double *mean,double *standard_deviation)
2209</pre>
2210
2211<p>A description of each parameter follows:</p>
2212
2213<h5>wand</h5>
2214<p>the magick wand.</p>
2215
2216<h5>channel</h5>
2217<p>the image channel(s).</p>
2218
2219<h5>mean</h5>
2220<p>The mean pixel value for the specified channel(s).</p>
2221
2222<h5>standard_deviation</h5>
2223<p>The standard deviation for the specified channel(s).</p>
2224
2225 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2226<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelRange">MagickGetImageChannelRange</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2227<div class="doc-section">
2228
2229<p>MagickGetImageChannelRange() gets the range for one or more image channels.</p>
2230
2231<p>The format of the MagickGetImageChannelRange method is:</p>
2232
2233<pre class="code">
2234 MagickBooleanType MagickGetImageChannelRange(MagickWand *wand,
2235 const ChannelType channel,double *minima,double *maxima)
2236</pre>
2237
2238<p>A description of each parameter follows:</p>
2239
2240<h5>wand</h5>
2241<p>the magick wand.</p>
2242
2243<h5>channel</h5>
2244<p>the image channel(s).</p>
2245
2246<h5>minima</h5>
2247<p>The minimum pixel value for the specified channel(s).</p>
2248
2249<h5>maxima</h5>
2250<p>The maximum pixel value for the specified channel(s).</p>
2251
2252 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2253<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageChannelStatistics">MagickGetImageChannelStatistics</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2254<div class="doc-section">
2255
2256<p>MagickGetImageChannelStatistics() returns statistics for each channel in the image. The statistics include the channel depth, its minima and maxima, the mean, the standard deviation, the kurtosis and the skewness. You can access the red channel mean, for example, like this:</p>
2257
2258<pre class="text">
2259 channel_statistics=MagickGetImageChannelStatistics(wand);
2260 red_mean=channel_statistics[RedChannel].mean;
2261</pre>
2262
2263<p>Use MagickRelinquishMemory() to free the statistics buffer.</p>
2264
2265<p>The format of the MagickGetImageChannelStatistics method is:</p>
2266
2267<pre class="code">
2268 ChannelStatistics *MagickGetImageChannelStatistics(MagickWand *wand)
2269</pre>
2270
2271<p>A description of each parameter follows:</p>
2272
2273<h5>wand</h5>
2274<p>the magick wand.</p>
2275
2276 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2277<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageColormapColor">MagickGetImageColormapColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2278<div class="doc-section">
2279
2280<p>MagickGetImageColormapColor() returns the color of the specified colormap index.</p>
2281
2282<p>The format of the MagickGetImageColormapColor method is:</p>
2283
2284<pre class="code">
2285 MagickBooleanType MagickGetImageColormapColor(MagickWand *wand,
2286 const size_t index,PixelWand *color)
2287</pre>
2288
2289<p>A description of each parameter follows:</p>
2290
2291<h5>wand</h5>
2292<p>the magick wand.</p>
2293
2294<h5>index</h5>
2295<p>the offset into the image colormap.</p>
2296
2297<h5>color</h5>
2298<p>Return the colormap color in this wand.</p>
2299
2300 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2301<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageColors">MagickGetImageColors</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2302<div class="doc-section">
2303
2304<p>MagickGetImageColors() gets the number of unique colors in the image.</p>
2305
2306<p>The format of the MagickGetImageColors method is:</p>
2307
2308<pre class="code">
2309 size_t MagickGetImageColors(MagickWand *wand)
2310</pre>
2311
2312<p>A description of each parameter follows:</p>
2313
2314<h5>wand</h5>
2315<p>the magick wand.</p>
2316
2317 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2318<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageColorspace">MagickGetImageColorspace</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2319<div class="doc-section">
2320
2321<p>MagickGetImageColorspace() gets the image colorspace.</p>
2322
2323<p>The format of the MagickGetImageColorspace method is:</p>
2324
2325<pre class="code">
2326 ColorspaceType MagickGetImageColorspace(MagickWand *wand)
2327</pre>
2328
2329<p>A description of each parameter follows:</p>
2330
2331<h5>wand</h5>
2332<p>the magick wand.</p>
2333
2334 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2335<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageCompose">MagickGetImageCompose</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2336<div class="doc-section">
2337
2338<p>MagickGetImageCompose() returns the composite operator associated with the image.</p>
2339
2340<p>The format of the MagickGetImageCompose method is:</p>
2341
2342<pre class="code">
2343 CompositeOperator MagickGetImageCompose(MagickWand *wand)
2344</pre>
2345
2346<p>A description of each parameter follows:</p>
2347
2348<h5>wand</h5>
2349<p>the magick wand.</p>
2350
2351 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2352<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageCompression">MagickGetImageCompression</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2353<div class="doc-section">
2354
2355<p>MagickGetImageCompression() gets the image compression.</p>
2356
2357<p>The format of the MagickGetImageCompression method is:</p>
2358
2359<pre class="code">
2360 CompressionType MagickGetImageCompression(MagickWand *wand)
2361</pre>
2362
2363<p>A description of each parameter follows:</p>
2364
2365<h5>wand</h5>
2366<p>the magick wand.</p>
2367
2368 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2369<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageCompression">MagickGetImageCompression</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2370<div class="doc-section">
2371
2372<p>MagickGetImageCompression() gets the image compression quality.</p>
2373
2374<p>The format of the MagickGetImageCompression method is:</p>
2375
2376<pre class="code">
2377 size_t MagickGetImageCompression(MagickWand *wand)
2378</pre>
2379
2380<p>A description of each parameter follows:</p>
2381
2382<h5>wand</h5>
2383<p>the magick wand.</p>
2384
2385 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2386<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageDelay">MagickGetImageDelay</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2387<div class="doc-section">
2388
2389<p>MagickGetImageDelay() gets the image delay.</p>
2390
2391<p>The format of the MagickGetImageDelay method is:</p>
2392
2393<pre class="code">
2394 size_t MagickGetImageDelay(MagickWand *wand)
2395</pre>
2396
2397<p>A description of each parameter follows:</p>
2398
2399<h5>wand</h5>
2400<p>the magick wand.</p>
2401
2402 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2403<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageDepth">MagickGetImageDepth</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2404<div class="doc-section">
2405
2406<p>MagickGetImageDepth() gets the image depth.</p>
2407
2408<p>The format of the MagickGetImageDepth method is:</p>
2409
2410<pre class="code">
2411 size_t MagickGetImageDepth(MagickWand *wand)
2412</pre>
2413
2414<p>A description of each parameter follows:</p>
2415
2416<h5>wand</h5>
2417<p>the magick wand.</p>
2418
2419 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2420<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageDistortion">MagickGetImageDistortion</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2421<div class="doc-section">
2422
2423<p>MagickGetImageDistortion() compares an image to a reconstructed image and returns the specified distortion metric.</p>
2424
2425<p>The format of the MagickGetImageDistortion method is:</p>
2426
2427<pre class="code">
2428 MagickBooleanType MagickGetImageDistortion(MagickWand *wand,
2429 const MagickWand *reference,const MetricType metric,
2430 double *distortion)
2431</pre>
2432
2433<p>A description of each parameter follows:</p>
2434
2435<h5>wand</h5>
2436<p>the magick wand.</p>
2437
2438<h5>reference</h5>
2439<p>the reference wand.</p>
2440
2441<h5>metric</h5>
2442<p>the metric.</p>
2443
2444<h5>distortion</h5>
2445<p>the computed distortion between the images.</p>
2446
2447 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2448<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageDispose">MagickGetImageDispose</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2449<div class="doc-section">
2450
2451<p>MagickGetImageDispose() gets the image disposal method.</p>
2452
2453<p>The format of the MagickGetImageDispose method is:</p>
2454
2455<pre class="code">
2456 DisposeType MagickGetImageDispose(MagickWand *wand)
2457</pre>
2458
2459<p>A description of each parameter follows:</p>
2460
2461<h5>wand</h5>
2462<p>the magick wand.</p>
2463
2464 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2465<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageFilename">MagickGetImageFilename</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2466<div class="doc-section">
2467
2468<p>MagickGetImageFilename() returns the filename of a particular image in a sequence.</p>
2469
2470<p>The format of the MagickGetImageFilename method is:</p>
2471
2472<pre class="code">
2473 char *MagickGetImageFilename(MagickWand *wand)
2474</pre>
2475
2476<p>A description of each parameter follows:</p>
2477
2478<h5>wand</h5>
2479<p>the magick wand.</p>
2480
2481 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2482<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageFormat">MagickGetImageFormat</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2483<div class="doc-section">
2484
2485<p>MagickGetImageFormat() returns the format of a particular image in a sequence.</p>
2486
2487<p>The format of the MagickGetImageFormat method is:</p>
2488
2489<pre class="code">
2490 const char *MagickGetImageFormat(MagickWand *wand)
2491</pre>
2492
2493<p>A description of each parameter follows:</p>
2494
2495<h5>wand</h5>
2496<p>the magick wand.</p>
2497
2498 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2499<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageFuzz">MagickGetImageFuzz</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2500<div class="doc-section">
2501
2502<p>MagickGetImageFuzz() gets the image fuzz.</p>
2503
2504<p>The format of the MagickGetImageFuzz method is:</p>
2505
2506<pre class="code">
2507 double MagickGetImageFuzz(MagickWand *wand)
2508</pre>
2509
2510<p>A description of each parameter follows:</p>
2511
2512<h5>wand</h5>
2513<p>the magick wand.</p>
2514
2515 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2516<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageGamma">MagickGetImageGamma</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2517<div class="doc-section">
2518
2519<p>MagickGetImageGamma() gets the image gamma.</p>
2520
2521<p>The format of the MagickGetImageGamma method is:</p>
2522
2523<pre class="code">
2524 double MagickGetImageGamma(MagickWand *wand)
2525</pre>
2526
2527<p>A description of each parameter follows:</p>
2528
2529<h5>wand</h5>
2530<p>the magick wand.</p>
2531
2532 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2533<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageGravity">MagickGetImageGravity</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2534<div class="doc-section">
2535
2536<p>MagickGetImageGravity() gets the image gravity.</p>
2537
2538<p>The format of the MagickGetImageGravity method is:</p>
2539
2540<pre class="code">
2541 GravityType MagickGetImageGravity(MagickWand *wand)
2542</pre>
2543
2544<p>A description of each parameter follows:</p>
2545
2546<h5>wand</h5>
2547<p>the magick wand.</p>
2548
2549 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2550<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageGreenPrimary">MagickGetImageGreenPrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2551<div class="doc-section">
2552
2553<p>MagickGetImageGreenPrimary() returns the chromaticy green primary point.</p>
2554
2555<p>The format of the MagickGetImageGreenPrimary method is:</p>
2556
2557<pre class="code">
2558 MagickBooleanType MagickGetImageGreenPrimary(MagickWand *wand,double *x,
2559 double *y)
2560</pre>
2561
2562<p>A description of each parameter follows:</p>
2563
2564<h5>wand</h5>
2565<p>the magick wand.</p>
2566
2567<h5>x</h5>
2568<p>the chromaticity green primary x-point.</p>
2569
2570<h5>y</h5>
2571<p>the chromaticity green primary y-point.</p>
2572
2573 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2574<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageHeight">MagickGetImageHeight</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2575<div class="doc-section">
2576
2577<p>MagickGetImageHeight() returns the image height.</p>
2578
2579<p>The format of the MagickGetImageHeight method is:</p>
2580
2581<pre class="code">
2582 size_t MagickGetImageHeight(MagickWand *wand)
2583</pre>
2584
2585<p>A description of each parameter follows:</p>
2586
2587<h5>wand</h5>
2588<p>the magick wand.</p>
2589
2590 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2591<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageHistogram">MagickGetImageHistogram</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2592<div class="doc-section">
2593
2594<p>MagickGetImageHistogram() returns the image histogram as an array of PixelWand wands.</p>
2595
2596<p>The format of the MagickGetImageHistogram method is:</p>
2597
2598<pre class="code">
2599 PixelWand **MagickGetImageHistogram(MagickWand *wand,
2600 size_t *number_colors)
2601</pre>
2602
2603<p>A description of each parameter follows:</p>
2604
2605<h5>wand</h5>
2606<p>the magick wand.</p>
2607
2608<h5>number_colors</h5>
2609<p>the number of unique colors in the image and the number of pixel wands returned.</p>
2610
2611 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2612<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageInterlaceScheme">MagickGetImageInterlaceScheme</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2613<div class="doc-section">
2614
2615<p>MagickGetImageInterlaceScheme() gets the image interlace scheme.</p>
2616
2617<p>The format of the MagickGetImageInterlaceScheme method is:</p>
2618
2619<pre class="code">
2620 InterlaceType MagickGetImageInterlaceScheme(MagickWand *wand)
2621</pre>
2622
2623<p>A description of each parameter follows:</p>
2624
2625<h5>wand</h5>
2626<p>the magick wand.</p>
2627
2628 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2629<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageInterpolateMethod">MagickGetImageInterpolateMethod</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2630<div class="doc-section">
2631
2632<p>MagickGetImageInterpolateMethod() returns the interpolation method for the sepcified image.</p>
2633
2634<p>The format of the MagickGetImageInterpolateMethod method is:</p>
2635
2636<pre class="code">
2637 InterpolatePixelMethod MagickGetImageInterpolateMethod(MagickWand *wand)
2638</pre>
2639
2640<p>A description of each parameter follows:</p>
2641
2642<h5>wand</h5>
2643<p>the magick wand.</p>
2644
2645 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2646<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageIterations">MagickGetImageIterations</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2647<div class="doc-section">
2648
2649<p>MagickGetImageIterations() gets the image iterations.</p>
2650
2651<p>The format of the MagickGetImageIterations method is:</p>
2652
2653<pre class="code">
2654 size_t MagickGetImageIterations(MagickWand *wand)
2655</pre>
2656
2657<p>A description of each parameter follows:</p>
2658
2659<h5>wand</h5>
2660<p>the magick wand.</p>
2661
2662 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2663<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageLength">MagickGetImageLength</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2664<div class="doc-section">
2665
2666<p>MagickGetImageLength() returns the image length in bytes.</p>
2667
2668<p>The format of the MagickGetImageLength method is:</p>
2669
2670<pre class="code">
2671 MagickBooleanType MagickGetImageLength(MagickWand *wand,
2672 MagickSizeType *length)
2673</pre>
2674
2675<p>A description of each parameter follows:</p>
2676
2677<h5>wand</h5>
2678<p>the magick wand.</p>
2679
2680<h5>length</h5>
2681<p>the image length in bytes.</p>
2682
2683 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2684<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageMatteColor">MagickGetImageMatteColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2685<div class="doc-section">
2686
2687<p>MagickGetImageMatteColor() returns the image matte color.</p>
2688
2689<p>The format of the MagickGetImageMatteColor method is:</p>
2690
2691<pre class="code">
2692 MagickBooleanType MagickGetImagematteColor(MagickWand *wand,
2693 PixelWand *matte_color)
2694</pre>
2695
2696<p>A description of each parameter follows:</p>
2697
2698<h5>wand</h5>
2699<p>the magick wand.</p>
2700
2701<h5>matte_color</h5>
2702<p>Return the matte color.</p>
2703
2704 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2705<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageOrientation">MagickGetImageOrientation</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2706<div class="doc-section">
2707
2708<p>MagickGetImageOrientation() returns the image orientation.</p>
2709
2710<p>The format of the MagickGetImageOrientation method is:</p>
2711
2712<pre class="code">
2713 OrientationType MagickGetImageOrientation(MagickWand *wand)
2714</pre>
2715
2716<p>A description of each parameter follows:</p>
2717
2718<h5>wand</h5>
2719<p>the magick wand.</p>
2720
2721 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2722<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImagePage">MagickGetImagePage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2723<div class="doc-section">
2724
2725<p>MagickGetImagePage() returns the page geometry associated with the image.</p>
2726
2727<p>The format of the MagickGetImagePage method is:</p>
2728
2729<pre class="code">
2730 MagickBooleanType MagickGetImagePage(MagickWand *wand,
2731 size_t *width,size_t *height,ssize_t *x,ssize_t *y)
2732</pre>
2733
2734<p>A description of each parameter follows:</p>
2735
2736<h5>wand</h5>
2737<p>the magick wand.</p>
2738
2739<h5>width</h5>
2740<p>the page width.</p>
2741
2742<h5>height</h5>
2743<p>the page height.</p>
2744
2745<h5>x</h5>
2746<p>the page x-offset.</p>
2747
2748<h5>y</h5>
2749<p>the page y-offset.</p>
2750
2751 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2752<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImagePixelColor">MagickGetImagePixelColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2753<div class="doc-section">
2754
2755<p>MagickGetImagePixelColor() returns the color of the specified pixel.</p>
2756
2757<p>The format of the MagickGetImagePixelColor method is:</p>
2758
2759<pre class="code">
2760 MagickBooleanType MagickGetImagePixelColor(MagickWand *wand,
2761 const ssize_t x,const ssize_t y,PixelWand *color)
2762</pre>
2763
2764<p>A description of each parameter follows:</p>
2765
2766<h5>wand</h5>
2767<p>the magick wand.</p>
2768
2769<h5>x,y</h5>
2770<p>the pixel offset into the image.</p>
2771
2772<h5>color</h5>
2773<p>Return the colormap color in this wand.</p>
2774
2775 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2776<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageRedPrimary">MagickGetImageRedPrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2777<div class="doc-section">
2778
2779<p>MagickGetImageRedPrimary() returns the chromaticy red primary point.</p>
2780
2781<p>The format of the MagickGetImageRedPrimary method is:</p>
2782
2783<pre class="code">
2784 MagickBooleanType MagickGetImageRedPrimary(MagickWand *wand,double *x,
2785 double *y)
2786</pre>
2787
2788<p>A description of each parameter follows:</p>
2789
2790<h5>wand</h5>
2791<p>the magick wand.</p>
2792
2793<h5>x</h5>
2794<p>the chromaticity red primary x-point.</p>
2795
2796<h5>y</h5>
2797<p>the chromaticity red primary y-point.</p>
2798
2799 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2800<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageRegion">MagickGetImageRegion</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2801<div class="doc-section">
2802
2803<p>MagickGetImageRegion() extracts a region of the image and returns it as a a new wand.</p>
2804
2805<p>The format of the MagickGetImageRegion method is:</p>
2806
2807<pre class="code">
2808 MagickWand *MagickGetImageRegion(MagickWand *wand,
2809 const size_t width,const size_t height,const ssize_t x,
2810 const ssize_t y)
2811</pre>
2812
2813<p>A description of each parameter follows:</p>
2814
2815<h5>wand</h5>
2816<p>the magick wand.</p>
2817
2818<h5>width</h5>
2819<p>the region width.</p>
2820
2821<h5>height</h5>
2822<p>the region height.</p>
2823
2824<h5>x</h5>
2825<p>the region x offset.</p>
2826
2827<h5>y</h5>
2828<p>the region y offset.</p>
2829
2830 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2831<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageRenderingIntent">MagickGetImageRenderingIntent</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2832<div class="doc-section">
2833
2834<p>MagickGetImageRenderingIntent() gets the image rendering intent.</p>
2835
2836<p>The format of the MagickGetImageRenderingIntent method is:</p>
2837
2838<pre class="code">
2839 RenderingIntent MagickGetImageRenderingIntent(MagickWand *wand)
2840</pre>
2841
2842<p>A description of each parameter follows:</p>
2843
2844<h5>wand</h5>
2845<p>the magick wand.</p>
2846
2847 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2848<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageResolution">MagickGetImageResolution</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2849<div class="doc-section">
2850
2851<p>MagickGetImageResolution() gets the image X and Y resolution.</p>
2852
2853<p>The format of the MagickGetImageResolution method is:</p>
2854
2855<pre class="code">
2856 MagickBooleanType MagickGetImageResolution(MagickWand *wand,double *x,
2857 double *y)
2858</pre>
2859
2860<p>A description of each parameter follows:</p>
2861
2862<h5>wand</h5>
2863<p>the magick wand.</p>
2864
2865<h5>x</h5>
2866<p>the image x-resolution.</p>
2867
2868<h5>y</h5>
2869<p>the image y-resolution.</p>
2870
2871 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2872<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageScene">MagickGetImageScene</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2873<div class="doc-section">
2874
2875<p>MagickGetImageScene() gets the image scene.</p>
2876
2877<p>The format of the MagickGetImageScene method is:</p>
2878
2879<pre class="code">
2880 size_t MagickGetImageScene(MagickWand *wand)
2881</pre>
2882
2883<p>A description of each parameter follows:</p>
2884
2885<h5>wand</h5>
2886<p>the magick wand.</p>
2887
2888 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2889<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageSignature">MagickGetImageSignature</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2890<div class="doc-section">
2891
2892<p>MagickGetImageSignature() generates an SHA-256 message digest for the image pixel stream.</p>
2893
2894<p>The format of the MagickGetImageSignature method is:</p>
2895
2896<pre class="code">
2897 const char MagickGetImageSignature(MagickWand *wand)
2898</pre>
2899
2900<p>A description of each parameter follows:</p>
2901
2902<h5>wand</h5>
2903<p>the magick wand.</p>
2904
2905 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2906<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageTicksPerSecond">MagickGetImageTicksPerSecond</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2907<div class="doc-section">
2908
2909<p>MagickGetImageTicksPerSecond() gets the image ticks-per-second.</p>
2910
2911<p>The format of the MagickGetImageTicksPerSecond method is:</p>
2912
2913<pre class="code">
2914 size_t MagickGetImageTicksPerSecond(MagickWand *wand)
2915</pre>
2916
2917<p>A description of each parameter follows:</p>
2918
2919<h5>wand</h5>
2920<p>the magick wand.</p>
2921
2922 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2923<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageType">MagickGetImageType</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2924<div class="doc-section">
2925
2926<p>MagickGetImageType() gets the potential image type:</p>
2927
2928<p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte</p>
2929
2930<p>To ensure the image type matches its potential, use MagickSetImageType():</p>
2931
2932<pre class="text">
2933 (void) MagickSetImageType(wand,MagickGetImageType(wand));
2934</pre>
2935
2936<p>The format of the MagickGetImageType method is:</p>
2937
2938<pre class="code">
2939 ImageType MagickGetImageType(MagickWand *wand)
2940</pre>
2941
2942<p>A description of each parameter follows:</p>
2943
2944<h5>wand</h5>
2945<p>the magick wand.</p>
2946
2947 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2948<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageUnits">MagickGetImageUnits</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2949<div class="doc-section">
2950
2951<p>MagickGetImageUnits() gets the image units of resolution.</p>
2952
2953<p>The format of the MagickGetImageUnits method is:</p>
2954
2955<pre class="code">
2956 ResolutionType MagickGetImageUnits(MagickWand *wand)
2957</pre>
2958
2959<p>A description of each parameter follows:</p>
2960
2961<h5>wand</h5>
2962<p>the magick wand.</p>
2963
2964 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2965<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageVirtualPixelMethod">MagickGetImageVirtualPixelMethod</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2966<div class="doc-section">
2967
2968<p>MagickGetImageVirtualPixelMethod() returns the virtual pixel method for the sepcified image.</p>
2969
2970<p>The format of the MagickGetImageVirtualPixelMethod method is:</p>
2971
2972<pre class="code">
2973 VirtualPixelMethod MagickGetImageVirtualPixelMethod(MagickWand *wand)
2974</pre>
2975
2976<p>A description of each parameter follows:</p>
2977
2978<h5>wand</h5>
2979<p>the magick wand.</p>
2980
2981 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]2982<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageWhitePoint">MagickGetImageWhitePoint</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]2983<div class="doc-section">
2984
2985<p>MagickGetImageWhitePoint() returns the chromaticy white point.</p>
2986
2987<p>The format of the MagickGetImageWhitePoint method is:</p>
2988
2989<pre class="code">
2990 MagickBooleanType MagickGetImageWhitePoint(MagickWand *wand,double *x,
2991 double *y)
2992</pre>
2993
2994<p>A description of each parameter follows:</p>
2995
2996<h5>wand</h5>
2997<p>the magick wand.</p>
2998
2999<h5>x</h5>
3000<p>the chromaticity white x-point.</p>
3001
3002<h5>y</h5>
3003<p>the chromaticity white y-point.</p>
3004
3005 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3006<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageWidth">MagickGetImageWidth</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3007<div class="doc-section">
3008
3009<p>MagickGetImageWidth() returns the image width.</p>
3010
3011<p>The format of the MagickGetImageWidth method is:</p>
3012
3013<pre class="code">
3014 size_t MagickGetImageWidth(MagickWand *wand)
3015</pre>
3016
3017<p>A description of each parameter follows:</p>
3018
3019<h5>wand</h5>
3020<p>the magick wand.</p>
3021
3022 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3023<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetNumberImages">MagickGetNumberImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3024<div class="doc-section">
3025
3026<p>MagickGetNumberImages() returns the number of images associated with a magick wand.</p>
3027
3028<p>The format of the MagickGetNumberImages method is:</p>
3029
3030<pre class="code">
3031 size_t MagickGetNumberImages(MagickWand *wand)
3032</pre>
3033
3034<p>A description of each parameter follows:</p>
3035
3036<h5>wand</h5>
3037<p>the magick wand.</p>
3038
3039 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3040<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickGetImageTotalInkDensity">MagickGetImageTotalInkDensity</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3041<div class="doc-section">
3042
3043<p>MagickGetImageTotalInkDensity() gets the image total ink density.</p>
3044
3045<p>The format of the MagickGetImageTotalInkDensity method is:</p>
3046
3047<pre class="code">
3048 double MagickGetImageTotalInkDensity(MagickWand *wand)
3049</pre>
3050
3051<p>A description of each parameter follows:</p>
3052
3053<h5>wand</h5>
3054<p>the magick wand.</p>
3055
3056 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3057<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickHaldClutImage">MagickHaldClutImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3058<div class="doc-section">
3059
3060<p>MagickHaldClutImage() replaces colors in the image from a Hald color lookup table. A Hald color lookup table is a 3-dimensional color cube mapped to 2 dimensions. Create it with the HALD coder. You can apply any color transformation to the Hald image and then use this method to apply the transform to the image.</p>
3061
3062<p>The format of the MagickHaldClutImage method is:</p>
3063
3064<pre class="code">
3065 MagickBooleanType MagickHaldClutImage(MagickWand *wand,
3066 const MagickWand *hald_wand)
3067 MagickBooleanType MagickHaldClutImageChannel(MagickWand *wand,
3068 const ChannelType channel,const MagickWand *hald_wand)
3069</pre>
3070
3071<p>A description of each parameter follows:</p>
3072
3073<h5>wand</h5>
3074<p>the magick wand.</p>
3075
3076<h5>hald_image</h5>
3077<p>the hald CLUT image.</p>
3078
3079 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3080<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickHasNextImage">MagickHasNextImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3081<div class="doc-section">
3082
3083<p>MagickHasNextImage() returns MagickTrue if the wand has more images when traversing the list in the forward direction</p>
3084
3085<p>The format of the MagickHasNextImage method is:</p>
3086
3087<pre class="code">
3088 MagickBooleanType MagickHasNextImage(MagickWand *wand)
3089</pre>
3090
3091<p>A description of each parameter follows:</p>
3092
3093<h5>wand</h5>
3094<p>the magick wand.</p>
3095
3096 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3097<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickHasPreviousImage">MagickHasPreviousImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3098<div class="doc-section">
3099
3100<p>MagickHasPreviousImage() returns MagickTrue if the wand has more images when traversing the list in the reverse direction</p>
3101
3102<p>The format of the MagickHasPreviousImage method is:</p>
3103
3104<pre class="code">
3105 MagickBooleanType MagickHasPreviousImage(MagickWand *wand)
3106</pre>
3107
3108<p>A description of each parameter follows:</p>
3109
3110<h5>wand</h5>
3111<p>the magick wand.</p>
3112
3113 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3114<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickIdentifyImage">MagickIdentifyImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3115<div class="doc-section">
3116
3117<p>MagickIdentifyImage() identifies an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p>
3118
3119<p>The format of the MagickIdentifyImage method is:</p>
3120
3121<pre class="code">
3122 const char *MagickIdentifyImage(MagickWand *wand)
3123</pre>
3124
3125<p>A description of each parameter follows:</p>
3126
3127<h5>wand</h5>
3128<p>the magick wand.</p>
3129
3130 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3131<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickImplodeImage">MagickImplodeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3132<div class="doc-section">
3133
3134<p>MagickImplodeImage() creates a new image that is a copy of an existing one with the image pixels "implode" by the specified percentage. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p>
3135
3136<p>The format of the MagickImplodeImage method is:</p>
3137
3138<pre class="code">
3139 MagickBooleanType MagickImplodeImage(MagickWand *wand,
3140 const double radius)
3141</pre>
3142
3143<p>A description of each parameter follows:</p>
3144
3145<h5>wand</h5>
3146<p>the magick wand.</p>
3147
3148<h5>amount</h5>
3149<p>Define the extent of the implosion.</p>
3150
3151 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3152<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickImportImagePixels">MagickImportImagePixels</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3153<div class="doc-section">
3154
3155<p>MagickImportImagePixels() accepts pixel datand stores it in the image at the location you specify. The method returns MagickFalse on success otherwise MagickTrue if an error is encountered. The pixel data can be either char, short int, int, ssize_t, float, or double in the order specified by map.</p>
3156
3157<p>Suppose your want to upload the first scanline of a 640x480 image from character data in red-green-blue order:</p>
3158
3159<pre class="text">
3160 MagickImportImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);
3161</pre>
3162
3163<p>The format of the MagickImportImagePixels method is:</p>
3164
3165<pre class="code">
3166 MagickBooleanType MagickImportImagePixels(MagickWand *wand,
3167 const ssize_t x,const ssize_t y,const size_t columns,
3168 const size_t rows,const char *map,const StorageType storage,
3169 const void *pixels)
3170</pre>
3171
3172<p>A description of each parameter follows:</p>
3173
3174<h5>wand</h5>
3175<p>the magick wand.</p>
3176
3177<h5>x, y, columns, rows</h5>
3178<p>These values define the perimeter of a region of pixels you want to define.</p>
3179
3180<h5>map</h5>
3181<p>This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.</p>
3182
3183<h5>storage</h5>
3184<p>Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.</p>
3185
3186<h5>pixels</h5>
3187<p>This array of values contain the pixel components as defined by map and type. You must preallocate this array where the expected length varies depending on the values of width, height, map, and type.</p>
3188
3189 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3190<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickInverseFourierTransformImage">MagickInverseFourierTransformImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3191<div class="doc-section">
3192
3193<p>MagickInverseFourierTransformImage() implements the inverse discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.</p>
3194
3195<p>The format of the MagickInverseFourierTransformImage method is:</p>
3196
3197<pre class="code">
3198 MagickBooleanType MagickInverseFourierTransformImage(
3199 MagickWand *magnitude_wand,MagickWand *phase_wand,
3200 const MagickBooleanType magnitude)
3201</pre>
3202
3203<p>A description of each parameter follows:</p>
3204
3205<h5>magnitude_wand</h5>
3206<p>the magnitude or real wand.</p>
3207
3208<h5>phase_wand</h5>
3209<p>the phase or imaginary wand.</p>
3210
3211<h5>magnitude</h5>
3212<p>if true, return as magnitude / phase pair otherwise a real / imaginary image pair.</p>
3213
3214 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3215<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickLabelImage">MagickLabelImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3216<div class="doc-section">
3217
3218<p>MagickLabelImage() adds a label to your image.</p>
3219
3220<p>The format of the MagickLabelImage method is:</p>
3221
3222<pre class="code">
3223 MagickBooleanType MagickLabelImage(MagickWand *wand,const char *label)
3224</pre>
3225
3226<p>A description of each parameter follows:</p>
3227
3228<h5>wand</h5>
3229<p>the magick wand.</p>
3230
3231<h5>label</h5>
3232<p>the image label.</p>
3233
3234 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3235<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickLevelImage">MagickLevelImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3236<div class="doc-section">
3237
3238<p>MagickLevelImage() adjusts the levels of an image by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid, and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value.</p>
3239
3240<p>The format of the MagickLevelImage method is:</p>
3241
3242<pre class="code">
3243 MagickBooleanType MagickLevelImage(MagickWand *wand,
3244 const double black_point,const double gamma,const double white_point)
3245 MagickBooleanType MagickLevelImageChannel(MagickWand *wand,
3246 const ChannelType channel,const double black_point,const double gamma,
3247 const double white_point)
3248</pre>
3249
3250<p>A description of each parameter follows:</p>
3251
3252<h5>wand</h5>
3253<p>the magick wand.</p>
3254
3255<h5>channel</h5>
3256<p>Identify which channel to level: RedChannel, GreenChannel,</p>
3257
3258<h5>black_point</h5>
3259<p>the black point.</p>
3260
3261<h5>gamma</h5>
3262<p>the gamma.</p>
3263
3264<h5>white_point</h5>
3265<p>the white point.</p>
3266
3267 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3268<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickLinearStretchImage">MagickLinearStretchImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3269<div class="doc-section">
3270
3271<p>MagickLinearStretchImage() stretches with saturation the image intensity.</p>
3272
3273<p>You can also reduce the influence of a particular channel with a gamma value of 0.</p>
3274
3275<p>The format of the MagickLinearStretchImage method is:</p>
3276
3277<pre class="code">
3278 MagickBooleanType MagickLinearStretchImage(MagickWand *wand,
3279 const double black_point,const double white_point)
3280</pre>
3281
3282<p>A description of each parameter follows:</p>
3283
3284<h5>wand</h5>
3285<p>the magick wand.</p>
3286
3287<h5>black_point</h5>
3288<p>the black point.</p>
3289
3290<h5>white_point</h5>
3291<p>the white point.</p>
3292
3293 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3294<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickLiquidRescaleImage">MagickLiquidRescaleImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3295<div class="doc-section">
3296
3297<p>MagickLiquidRescaleImage() rescales image with seam carving.</p>
3298
3299<p>MagickBooleanType MagickLiquidRescaleImage(MagickWand *wand, const size_t columns,const size_t rows, const double delta_x,const double rigidity)</p>
3300
3301<p>A description of each parameter follows:</p>
3302
3303<h5>wand</h5>
3304<p>the magick wand.</p>
3305
3306<h5>columns</h5>
3307<p>the number of columns in the scaled image.</p>
3308
3309<h5>rows</h5>
3310<p>the number of rows in the scaled image.</p>
3311
3312<h5>delta_x</h5>
3313<p>maximum seam transversal step (0 means straight seams).</p>
3314
3315<h5>rigidity</h5>
3316<p>introduce a bias for non-straight seams (typically 0).</p>
3317
3318 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3319<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMagnifyImage">MagickMagnifyImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3320<div class="doc-section">
3321
3322<p>MagickMagnifyImage() is a convenience method that scales an image proportionally to twice its original size.</p>
3323
3324<p>The format of the MagickMagnifyImage method is:</p>
3325
3326<pre class="code">
3327 MagickBooleanType MagickMagnifyImage(MagickWand *wand)
3328</pre>
3329
3330<p>A description of each parameter follows:</p>
3331
3332<h5>wand</h5>
3333<p>the magick wand.</p>
3334
3335 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3336<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMergeImageLayers">MagickMergeImageLayers</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3337<div class="doc-section">
3338
3339<p>MagickMergeImageLayers() composes all the image layers from the current given image onward to produce a single image of the merged layers.</p>
3340
3341<p>The inital canvas's size depends on the given ImageLayerMethod, and is initialized using the first images background color. The images are then compositied onto that image in sequence using the given composition that has been assigned to each individual image.</p>
3342
3343<p>The format of the MagickMergeImageLayers method is:</p>
3344
3345<pre class="code">
3346 MagickWand *MagickMergeImageLayers(MagickWand *wand,
3347 const ImageLayerMethod method)
3348</pre>
3349
3350<p>A description of each parameter follows:</p>
3351
3352<h5>wand</h5>
3353<p>the magick wand.</p>
3354
3355<h5>method</h5>
3356<p>the method of selecting the size of the initial canvas.</p>
3357
3358<p>MergeLayer: Merge all layers onto a canvas just large enough to hold all the actual images. The virtual canvas of the first image is preserved but otherwise ignored.</p>
3359
3360<p>FlattenLayer: Use the virtual canvas size of first image. Images which fall outside this canvas is clipped. This can be used to 'fill out' a given virtual canvas.</p>
3361
3362<p>MosaicLayer: Start with the virtual canvas of the first image, enlarging left and right edges to contain all images. Images with negative offsets will be clipped.</p>
3363
3364 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3365<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMinifyImage">MagickMinifyImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3366<div class="doc-section">
3367
3368<p>MagickMinifyImage() is a convenience method that scales an image proportionally to one-half its original size</p>
3369
3370<p>The format of the MagickMinifyImage method is:</p>
3371
3372<pre class="code">
3373 MagickBooleanType MagickMinifyImage(MagickWand *wand)
3374</pre>
3375
3376<p>A description of each parameter follows:</p>
3377
3378<h5>wand</h5>
3379<p>the magick wand.</p>
3380
3381 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3382<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickModulateImage">MagickModulateImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3383<div class="doc-section">
3384
3385<p>MagickModulateImage() lets you control the brightness, saturation, and hue of an image. Hue is the percentage of absolute rotation from the current position. For example 50 results in a counter-clockwise rotation of 90 degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and 200 both resulting in a rotation of 180 degrees.</p>
3386
3387<p>To increase the color brightness by 20 and decrease the color saturation by 10 and leave the hue unchanged, use: 120,90,100.</p>
3388
3389<p>The format of the MagickModulateImage method is:</p>
3390
3391<pre class="code">
3392 MagickBooleanType MagickModulateImage(MagickWand *wand,
3393 const double brightness,const double saturation,const double hue)
3394</pre>
3395
3396<p>A description of each parameter follows:</p>
3397
3398<h5>wand</h5>
3399<p>the magick wand.</p>
3400
3401<h5>brightness</h5>
3402<p>the percent change in brighness.</p>
3403
3404<h5>saturation</h5>
3405<p>the percent change in saturation.</p>
3406
3407<h5>hue</h5>
3408<p>the percent change in hue.</p>
3409
3410 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3411<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMontageImage">MagickMontageImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3412<div class="doc-section">
3413
3414<p>MagickMontageImage() creates a composite image by combining several separate images. The images are tiled on the composite image with the name of the image optionally appearing just below the individual tile.</p>
3415
3416<p>The format of the MagickMontageImage method is:</p>
3417
3418<pre class="code">
3419 MagickWand *MagickMontageImage(MagickWand *wand,
3420 const DrawingWand drawing_wand,const char *tile_geometry,
3421 const char *thumbnail_geometry,const MontageMode mode,
3422 const char *frame)
3423</pre>
3424
3425<p>A description of each parameter follows:</p>
3426
3427<h5>wand</h5>
3428<p>the magick wand.</p>
3429
3430<h5>drawing_wand</h5>
3431<p>the drawing wand. The font name, size, and color are obtained from this wand.</p>
3432
3433<h5>tile_geometry</h5>
3434<p>the number of tiles per row and page (e.g. 6x4+0+0).</p>
3435
3436<h5>thumbnail_geometry</h5>
3437<p>Preferred image size and border size of each thumbnail (e.g. 120x120+4+3>).</p>
3438
3439<h5>mode</h5>
3440<p>Thumbnail framing mode: Frame, Unframe, or Concatenate.</p>
3441
3442<h5>frame</h5>
3443<p>Surround the image with an ornamental border (e.g. 15x15+3+3). The frame color is that of the thumbnail's matte color.</p>
3444
3445 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3446<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMorphImages">MagickMorphImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3447<div class="doc-section">
3448
3449<p>MagickMorphImages() method morphs a set of images. Both the image pixels and size are linearly interpolated to give the appearance of a meta-morphosis from one image to the next.</p>
3450
3451<p>The format of the MagickMorphImages method is:</p>
3452
3453<pre class="code">
3454 MagickWand *MagickMorphImages(MagickWand *wand,
3455 const size_t number_frames)
3456</pre>
3457
3458<p>A description of each parameter follows:</p>
3459
3460<h5>wand</h5>
3461<p>the magick wand.</p>
3462
3463<h5>number_frames</h5>
3464<p>the number of in-between images to generate.</p>
3465
3466 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3467<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMorphologyImage">MagickMorphologyImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3468<div class="doc-section">
3469
3470<p>MagickMorphologyImage() applies a user supplied kernel to the image according to the given mophology method.</p>
3471
3472<p>The format of the MagickMorphologyImage method is:</p>
3473
3474<pre class="code">
3475 MagickBooleanType MagickMorphologyImage(MagickWand *wand,
3476 MorphologyMethod method,const ssize_t iterations,KernelInfo *kernel)
3477 MagickBooleanType MagickMorphologyImageChannel(MagickWand *wand,
3478 ChannelType channel,MorphologyMethod method,const ssize_t iterations,
3479 KernelInfo *kernel)
3480</pre>
3481
3482<p>A description of each parameter follows:</p>
3483
3484<h5>wand</h5>
3485<p>the magick wand.</p>
3486
3487<h5>channel</h5>
3488<p>the image channel(s).</p>
3489
3490<h5>method</h5>
3491<p>the morphology method to be applied.</p>
3492
3493<h5>iterations</h5>
3494<p>apply the operation this many times (or no change). A value of -1 means loop until no change found. How this is applied may depend on the morphology method. Typically this is a value of 1.</p>
3495
3496<h5>kernel</h5>
3497<p>An array of doubles representing the morphology kernel.</p>
3498
3499 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3500<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickMotionBlurImage">MagickMotionBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3501<div class="doc-section">
3502
3503<p>MagickMotionBlurImage() simulates motion blur. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and MotionBlurImage() selects a suitable radius for you. Angle gives the angle of the blurring motion.</p>
3504
3505<p>The format of the MagickMotionBlurImage method is:</p>
3506
3507<pre class="code">
3508 MagickBooleanType MagickMotionBlurImage(MagickWand *wand,
3509 const double radius,const double sigma,const double angle)
3510 MagickBooleanType MagickMotionBlurImageChannel(MagickWand *wand,
3511 const ChannelType channel,const double radius,const double sigma,
3512 const double angle)
3513</pre>
3514
3515<p>A description of each parameter follows:</p>
3516
3517<h5>wand</h5>
3518<p>the magick wand.</p>
3519
3520<h5>channel</h5>
3521<p>the image channel(s).</p>
3522
3523<h5>radius</h5>
3524<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
3525
3526<h5>sigma</h5>
3527<p>the standard deviation of the Gaussian, in pixels.</p>
3528
3529<h5>angle</h5>
3530<p>Apply the effect along this angle.</p>
3531
3532 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3533<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickNegateImage">MagickNegateImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3534<div class="doc-section">
3535
3536<p>MagickNegateImage() negates the colors in the reference image. The Grayscale option means that only grayscale values within the image are negated.</p>
3537
3538<p>You can also reduce the influence of a particular channel with a gamma value of 0.</p>
3539
3540<p>The format of the MagickNegateImage method is:</p>
3541
3542<pre class="code">
3543 MagickBooleanType MagickNegateImage(MagickWand *wand,
3544 const MagickBooleanType gray)
3545 MagickBooleanType MagickNegateImage(MagickWand *wand,
3546 const ChannelType channel,const MagickBooleanType gray)
3547</pre>
3548
3549<p>A description of each parameter follows:</p>
3550
3551<h5>wand</h5>
3552<p>the magick wand.</p>
3553
3554<h5>channel</h5>
3555<p>the image channel(s).</p>
3556
3557<h5>gray</h5>
3558<p>If MagickTrue, only negate grayscale pixels within the image.</p>
3559
3560 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3561<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickNewImage">MagickNewImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3562<div class="doc-section">
3563
3564<p>MagickNewImage() adds a blank image canvas of the specified size and background color to the wand.</p>
3565
3566<p>The format of the MagickNewImage method is:</p>
3567
3568<pre class="code">
3569 MagickBooleanType MagickNewImage(MagickWand *wand,
3570 const size_t columns,const size_t rows,
3571 const PixelWand *background)
3572</pre>
3573
3574<p>A description of each parameter follows:</p>
3575
3576<h5>wand</h5>
3577<p>the magick wand.</p>
3578
3579<h5>width</h5>
3580<p>the image width.</p>
3581
3582<h5>height</h5>
3583<p>the image height.</p>
3584
3585<h5>background</h5>
3586<p>the image color.</p>
3587
3588 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3589<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickNextImage">MagickNextImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3590<div class="doc-section">
3591
3592<p>MagickNextImage() associates the next image in the image list with a magick wand.</p>
3593
3594<p>The format of the MagickNextImage method is:</p>
3595
3596<pre class="code">
3597 MagickBooleanType MagickNextImage(MagickWand *wand)
3598</pre>
3599
3600<p>A description of each parameter follows:</p>
3601
3602<h5>wand</h5>
3603<p>the magick wand.</p>
3604
3605 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3606<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickNormalizeImage">MagickNormalizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3607<div class="doc-section">
3608
3609<p>MagickNormalizeImage() enhances the contrast of a color image by adjusting the pixels color to span the entire range of colors available</p>
3610
3611<p>You can also reduce the influence of a particular channel with a gamma value of 0.</p>
3612
3613<p>The format of the MagickNormalizeImage method is:</p>
3614
3615<pre class="code">
3616 MagickBooleanType MagickNormalizeImage(MagickWand *wand)
3617 MagickBooleanType MagickNormalizeImageChannel(MagickWand *wand,
3618 const ChannelType channel)
3619</pre>
3620
3621<p>A description of each parameter follows:</p>
3622
3623<h5>wand</h5>
3624<p>the magick wand.</p>
3625
3626<h5>channel</h5>
3627<p>the image channel(s).</p>
3628
3629 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3630<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickOilPaintImage">MagickOilPaintImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3631<div class="doc-section">
3632
3633<p>MagickOilPaintImage() applies a special effect filter that simulates an oil painting. Each pixel is replaced by the most frequent color occurring in a circular region defined by radius.</p>
3634
3635<p>The format of the MagickOilPaintImage method is:</p>
3636
3637<pre class="code">
3638 MagickBooleanType MagickOilPaintImage(MagickWand *wand,
3639 const double radius)
3640</pre>
3641
3642<p>A description of each parameter follows:</p>
3643
3644<h5>wand</h5>
3645<p>the magick wand.</p>
3646
3647<h5>radius</h5>
3648<p>the radius of the circular neighborhood.</p>
3649
3650 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3651<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickOpaquePaintImage">MagickOpaquePaintImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3652<div class="doc-section">
3653
3654<p>MagickOpaquePaintImage() changes any pixel that matches color with the color defined by fill.</p>
3655
3656<p>The format of the MagickOpaquePaintImage method is:</p>
3657
3658<pre class="code">
3659 MagickBooleanType MagickOpaquePaintImage(MagickWand *wand,
3660 const PixelWand *target,const PixelWand *fill,const double fuzz,
3661 const MagickBooleanType invert)
3662 MagickBooleanType MagickOpaquePaintImageChannel(MagickWand *wand,
3663 const ChannelType channel,const PixelWand *target,
3664 const PixelWand *fill,const double fuzz,const MagickBooleanType invert)
3665</pre>
3666
3667<p>A description of each parameter follows:</p>
3668
3669<h5>wand</h5>
3670<p>the magick wand.</p>
3671
3672<h5>channel</h5>
3673<p>the channel(s).</p>
3674
3675<h5>target</h5>
3676<p>Change this target color to the fill color within the image.</p>
3677
3678<h5>fill</h5>
3679<p>the fill pixel wand.</p>
3680
3681<h5>fuzz</h5>
3682<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p>
3683
3684<h5>invert</h5>
3685<p>paint any pixel that does not match the target color.</p>
3686
3687 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3688<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickOptimizeImageLayers">MagickOptimizeImageLayers</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3689<div class="doc-section">
3690
3691<p>MagickOptimizeImageLayers() compares each image the GIF disposed forms of the previous image in the sequence. From this it attempts to select the smallest cropped image to replace each frame, while preserving the results of the animation.</p>
3692
3693<p>The format of the MagickOptimizeImageLayers method is:</p>
3694
3695<pre class="code">
3696 MagickWand *MagickOptimizeImageLayers(MagickWand *wand)
3697</pre>
3698
3699<p>A description of each parameter follows:</p>
3700
3701<h5>wand</h5>
3702<p>the magick wand.</p>
3703
3704 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3705<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickOrderedPosterizeImage">MagickOrderedPosterizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3706<div class="doc-section">
3707
3708<p>MagickOrderedPosterizeImage() performs an ordered dither based on a number of pre-defined dithering threshold maps, but over multiple intensity levels, which can be different for different channels, according to the input arguments.</p>
3709
3710<p>The format of the MagickOrderedPosterizeImage method is:</p>
3711
3712<pre class="code">
3713 MagickBooleanType MagickOrderedPosterizeImage(MagickWand *wand,
3714 const char *threshold_map)
3715 MagickBooleanType MagickOrderedPosterizeImageChannel(MagickWand *wand,
3716 const ChannelType channel,const char *threshold_map)
3717</pre>
3718
3719<p>A description of each parameter follows:</p>
3720
3721<h5>image</h5>
3722<p>the image.</p>
3723
3724<h5>channel</h5>
3725<p>the channel or channels to be thresholded.</p>
3726
3727<h5>threshold_map</h5>
3728<p>A string containing the name of the threshold dither map to use, followed by zero or more numbers representing the number of color levels tho dither between.</p>
3729
cristybaacd172011-04-30 23:11:03 +0000[diff] [blame]3730<p>Any level number less than 2 is equivalent to 2, and means only binary dithering will be applied to each color channel.</p>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3731
3732<p>No numbers also means a 2 level (bitmap) dither will be applied to all channels, while a single number is the number of levels applied to each channel in sequence. More numbers will be applied in turn to each of the color channels.</p>
3733
3734<p>For example: "o3x3,6" generates a 6 level posterization of the image with a ordered 3x3 diffused pixel dither being applied between each level. While checker,8,8,4 will produce a 332 colormaped image with only a single checkerboard hash pattern (50 grey) between each color level, to basically double the number of color levels with a bare minimim of dithering.</p>
3735
3736 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3737<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPingImage">MagickPingImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3738<div class="doc-section">
3739
3740<p>MagickPingImage() is like MagickReadImage() except the only valid information returned is the image width, height, size, and format. It is designed to efficiently obtain this information from a file without reading the entire image sequence into memory.</p>
3741
3742<p>The format of the MagickPingImage method is:</p>
3743
3744<pre class="code">
3745 MagickBooleanType MagickPingImage(MagickWand *wand,const char *filename)
3746</pre>
3747
3748<p>A description of each parameter follows:</p>
3749
3750<h5>wand</h5>
3751<p>the magick wand.</p>
3752
3753<h5>filename</h5>
3754<p>the image filename.</p>
3755
3756 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3757<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPingImageBlob">MagickPingImageBlob</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3758<div class="doc-section">
3759
3760<p>MagickPingImageBlob() pings an image or image sequence from a blob.</p>
3761
3762<p>The format of the MagickPingImageBlob method is:</p>
3763
3764<pre class="code">
3765 MagickBooleanType MagickPingImageBlob(MagickWand *wand,
3766 const void *blob,const size_t length)
3767</pre>
3768
3769<p>A description of each parameter follows:</p>
3770
3771<h5>wand</h5>
3772<p>the magick wand.</p>
3773
3774<h5>blob</h5>
3775<p>the blob.</p>
3776
3777<h5>length</h5>
3778<p>the blob length.</p>
3779
3780 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3781<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPingImageFile">MagickPingImageFile</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3782<div class="doc-section">
3783
3784<p>MagickPingImageFile() pings an image or image sequence from an open file descriptor.</p>
3785
3786<p>The format of the MagickPingImageFile method is:</p>
3787
3788<pre class="code">
3789 MagickBooleanType MagickPingImageFile(MagickWand *wand,FILE *file)
3790</pre>
3791
3792<p>A description of each parameter follows:</p>
3793
3794<h5>wand</h5>
3795<p>the magick wand.</p>
3796
3797<h5>file</h5>
3798<p>the file descriptor.</p>
3799
3800 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3801<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPolaroidImage">MagickPolaroidImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3802<div class="doc-section">
3803
3804<p>MagickPolaroidImage() simulates a Polaroid picture.</p>
3805
3806<p>The format of the MagickPolaroidImage method is:</p>
3807
3808<pre class="code">
3809 MagickBooleanType MagickPolaroidImage(MagickWand *wand,
3810 const DrawingWand *drawing_wand,const double angle)
3811</pre>
3812
3813<p>A description of each parameter follows:</p>
3814
3815<h5>wand</h5>
3816<p>the magick wand.</p>
3817
3818<h5>drawing_wand</h5>
3819<p>the draw wand.</p>
3820
3821<h5>angle</h5>
3822<p>Apply the effect along this angle.</p>
3823
3824 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3825<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPosterizeImage">MagickPosterizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3826<div class="doc-section">
3827
3828<p>MagickPosterizeImage() reduces the image to a limited number of color level.</p>
3829
3830<p>The format of the MagickPosterizeImage method is:</p>
3831
3832<pre class="code">
3833 MagickBooleanType MagickPosterizeImage(MagickWand *wand,
3834 const unsigned levels,const MagickBooleanType dither)
3835</pre>
3836
3837<p>A description of each parameter follows:</p>
3838
3839<h5>wand</h5>
3840<p>the magick wand.</p>
3841
3842<h5>levels</h5>
3843<p>Number of color levels allowed in each channel. Very low values (2, 3, or 4) have the most visible effect.</p>
3844
3845<h5>dither</h5>
3846<p>Set this integer value to something other than zero to dither the mapped image.</p>
3847
3848 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3849<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPreviewImages">MagickPreviewImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3850<div class="doc-section">
3851
3852<p>MagickPreviewImages() tiles 9 thumbnails of the specified image with an image processing operation applied at varying strengths. This helpful to quickly pin-point an appropriate parameter for an image processing operation.</p>
3853
3854<p>The format of the MagickPreviewImages method is:</p>
3855
3856<pre class="code">
3857 MagickWand *MagickPreviewImages(MagickWand *wand,
3858 const PreviewType preview)
3859</pre>
3860
3861<p>A description of each parameter follows:</p>
3862
3863<h5>wand</h5>
3864<p>the magick wand.</p>
3865
3866<h5>preview</h5>
3867<p>the preview type.</p>
3868
3869 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3870<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickPreviousImage">MagickPreviousImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3871<div class="doc-section">
3872
3873<p>MagickPreviousImage() assocates the previous image in an image list with the magick wand.</p>
3874
3875<p>The format of the MagickPreviousImage method is:</p>
3876
3877<pre class="code">
3878 MagickBooleanType MagickPreviousImage(MagickWand *wand)
3879</pre>
3880
3881<p>A description of each parameter follows:</p>
3882
3883<h5>wand</h5>
3884<p>the magick wand.</p>
3885
3886 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3887<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickQuantizeImage">MagickQuantizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3888<div class="doc-section">
3889
3890<p>MagickQuantizeImage() analyzes the colors within a reference image and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.</p>
3891
3892<p>The format of the MagickQuantizeImage method is:</p>
3893
3894<pre class="code">
3895 MagickBooleanType MagickQuantizeImage(MagickWand *wand,
3896 const size_t number_colors,const ColorspaceType colorspace,
3897 const size_t treedepth,const MagickBooleanType dither,
3898 const MagickBooleanType measure_error)
3899</pre>
3900
3901<p>A description of each parameter follows:</p>
3902
3903<h5>wand</h5>
3904<p>the magick wand.</p>
3905
3906<h5>number_colors</h5>
3907<p>the number of colors.</p>
3908
3909<h5>colorspace</h5>
3910<p>Perform color reduction in this colorspace, typically RGBColorspace.</p>
3911
3912<h5>treedepth</h5>
3913<p>Normally, this integer value is zero or one. A zero or one tells Quantize to choose a optimal tree depth of Log4(number_colors). A tree of this depth generally allows the best representation of the reference image with the least amount of memory and the fastest computational speed. In some cases, such as an image with low color dispersion (a few number of colors), a value other than Log4(number_colors) is required. To expand the color tree completely, use a value of 8.</p>
3914
3915<h5>dither</h5>
3916<p>A value other than zero distributes the difference between an original image and the corresponding color reduced image to neighboring pixels along a Hilbert curve.</p>
3917
3918<h5>measure_error</h5>
3919<p>A value other than zero measures the difference between the original and quantized images. This difference is the total quantization error. The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value.</p>
3920
3921 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3922<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickQuantizeImages">MagickQuantizeImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3923<div class="doc-section">
3924
3925<p>MagickQuantizeImages() analyzes the colors within a sequence of images and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.</p>
3926
3927<p>The format of the MagickQuantizeImages method is:</p>
3928
3929<pre class="code">
3930 MagickBooleanType MagickQuantizeImages(MagickWand *wand,
3931 const size_t number_colors,const ColorspaceType colorspace,
3932 const size_t treedepth,const MagickBooleanType dither,
3933 const MagickBooleanType measure_error)
3934</pre>
3935
3936<p>A description of each parameter follows:</p>
3937
3938<h5>wand</h5>
3939<p>the magick wand.</p>
3940
3941<h5>number_colors</h5>
3942<p>the number of colors.</p>
3943
3944<h5>colorspace</h5>
3945<p>Perform color reduction in this colorspace, typically RGBColorspace.</p>
3946
3947<h5>treedepth</h5>
3948<p>Normally, this integer value is zero or one. A zero or one tells Quantize to choose a optimal tree depth of Log4(number_colors). A tree of this depth generally allows the best representation of the reference image with the least amount of memory and the fastest computational speed. In some cases, such as an image with low color dispersion (a few number of colors), a value other than Log4(number_colors) is required. To expand the color tree completely, use a value of 8.</p>
3949
3950<h5>dither</h5>
3951<p>A value other than zero distributes the difference between an original image and the corresponding color reduced algorithm to neighboring pixels along a Hilbert curve.</p>
3952
3953<h5>measure_error</h5>
3954<p>A value other than zero measures the difference between the original and quantized images. This difference is the total quantization error. The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value.</p>
3955
3956 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3957<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRadialBlurImage">MagickRadialBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3958<div class="doc-section">
3959
3960<p>MagickRadialBlurImage() radial blurs an image.</p>
3961
3962<p>The format of the MagickRadialBlurImage method is:</p>
3963
3964<pre class="code">
3965 MagickBooleanType MagickRadialBlurImage(MagickWand *wand,
3966 const double angle)
3967 MagickBooleanType MagickRadialBlurImageChannel(MagickWand *wand,
3968 const ChannelType channel,const double angle)
3969</pre>
3970
3971<p>A description of each parameter follows:</p>
3972
3973<h5>wand</h5>
3974<p>the magick wand.</p>
3975
3976<h5>channel</h5>
3977<p>the image channel(s).</p>
3978
3979<h5>angle</h5>
3980<p>the angle of the blur in degrees.</p>
3981
3982 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]3983<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRaiseImage">MagickRaiseImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]3984<div class="doc-section">
3985
3986<p>MagickRaiseImage() creates a simulated three-dimensional button-like effect by lightening and darkening the edges of the image. Members width and height of raise_info define the width of the vertical and horizontal edge of the effect.</p>
3987
3988<p>The format of the MagickRaiseImage method is:</p>
3989
3990<pre class="code">
3991 MagickBooleanType MagickRaiseImage(MagickWand *wand,
3992 const size_t width,const size_t height,const ssize_t x,
3993 const ssize_t y,const MagickBooleanType raise)
3994</pre>
3995
3996<p>A description of each parameter follows:</p>
3997
3998<h5>wand</h5>
3999<p>the magick wand.</p>
4000
4001<h5>width,height,x,y</h5>
4002<p>Define the dimensions of the area to raise.</p>
4003
4004<h5>raise</h5>
4005<p>A value other than zero creates a 3-D raise effect, otherwise it has a lowered effect.</p>
4006
4007 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4008<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRandomThresholdImage">MagickRandomThresholdImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4009<div class="doc-section">
4010
4011<p>MagickRandomThresholdImage() changes the value of individual pixels based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image.</p>
4012
4013<p>The format of the MagickRandomThresholdImage method is:</p>
4014
4015<pre class="code">
4016 MagickBooleanType MagickRandomThresholdImage(MagickWand *wand,
4017 const double low,const double high)
4018 MagickBooleanType MagickRandomThresholdImageChannel(MagickWand *wand,
4019 const ChannelType channel,const double low,const double high)
4020</pre>
4021
4022<p>A description of each parameter follows:</p>
4023
4024<h5>wand</h5>
4025<p>the magick wand.</p>
4026
4027<h5>channel</h5>
4028<p>the image channel(s).</p>
4029
4030<h5>low,high</h5>
4031<p>Specify the high and low thresholds. These values range from 0 to QuantumRange.</p>
4032
4033 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4034<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickReadImage">MagickReadImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4035<div class="doc-section">
4036
4037<p>MagickReadImage() reads an image or image sequence. The images are inserted at the current image pointer position. Use MagickSetFirstIterator(), MagickSetLastIterator, or MagickSetImageIndex() to specify the current image pointer position at the beginning of the image list, the end, or anywhere in-between respectively.</p>
4038
4039<p>The format of the MagickReadImage method is:</p>
4040
4041<pre class="code">
4042 MagickBooleanType MagickReadImage(MagickWand *wand,const char *filename)
4043</pre>
4044
4045<p>A description of each parameter follows:</p>
4046
4047<h5>wand</h5>
4048<p>the magick wand.</p>
4049
4050<h5>filename</h5>
4051<p>the image filename.</p>
4052
4053 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4054<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickReadImageBlob">MagickReadImageBlob</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4055<div class="doc-section">
4056
4057<p>MagickReadImageBlob() reads an image or image sequence from a blob.</p>
4058
4059<p>The format of the MagickReadImageBlob method is:</p>
4060
4061<pre class="code">
4062 MagickBooleanType MagickReadImageBlob(MagickWand *wand,
4063 const void *blob,const size_t length)
4064</pre>
4065
4066<p>A description of each parameter follows:</p>
4067
4068<h5>wand</h5>
4069<p>the magick wand.</p>
4070
4071<h5>blob</h5>
4072<p>the blob.</p>
4073
4074<h5>length</h5>
4075<p>the blob length.</p>
4076
4077 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4078<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickReadImageFile">MagickReadImageFile</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4079<div class="doc-section">
4080
4081<p>MagickReadImageFile() reads an image or image sequence from an open file descriptor.</p>
4082
4083<p>The format of the MagickReadImageFile method is:</p>
4084
4085<pre class="code">
4086 MagickBooleanType MagickReadImageFile(MagickWand *wand,FILE *file)
4087</pre>
4088
4089<p>A description of each parameter follows:</p>
4090
4091<h5>wand</h5>
4092<p>the magick wand.</p>
4093
4094<h5>file</h5>
4095<p>the file descriptor.</p>
4096
4097 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4098<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRemapImage">MagickRemapImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4099<div class="doc-section">
4100
4101<p>MagickRemapImage() replaces the colors of an image with the closest color from a reference image.</p>
4102
4103<p>The format of the MagickRemapImage method is:</p>
4104
4105<pre class="code">
4106 MagickBooleanType MagickRemapImage(MagickWand *wand,
4107 const MagickWand *remap_wand,const DitherMethod method)
4108</pre>
4109
4110<p>A description of each parameter follows:</p>
4111
4112<h5>wand</h5>
4113<p>the magick wand.</p>
4114
4115<h5>affinity</h5>
4116<p>the affinity wand.</p>
4117
4118<h5>method</h5>
4119<p>choose from these dither methods: NoDitherMethod, RiemersmaDitherMethod, or FloydSteinbergDitherMethod.</p>
4120
4121 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4122<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRemoveImage">MagickRemoveImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4123<div class="doc-section">
4124
4125<p>MagickRemoveImage() removes an image from the image list.</p>
4126
4127<p>The format of the MagickRemoveImage method is:</p>
4128
4129<pre class="code">
4130 MagickBooleanType MagickRemoveImage(MagickWand *wand)
4131</pre>
4132
4133<p>A description of each parameter follows:</p>
4134
4135<h5>wand</h5>
4136<p>the magick wand.</p>
4137
4138<h5>insert</h5>
4139<p>the splice wand.</p>
4140
4141 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4142<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickResampleImage">MagickResampleImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4143<div class="doc-section">
4144
4145<p>MagickResampleImage() resample image to desired resolution.</p>
4146
4147<p>Bessel Blackman Box Catrom Cubic Gaussian Hanning Hermite Lanczos Mitchell Point Quandratic Sinc Triangle</p>
4148
4149<p>Most of the filters are FIR (finite impulse response), however, Bessel, Gaussian, and Sinc are IIR (infinite impulse response). Bessel and Sinc are windowed (brought down to zero) with the Blackman filter.</p>
4150
4151<p>The format of the MagickResampleImage method is:</p>
4152
4153<pre class="code">
4154 MagickBooleanType MagickResampleImage(MagickWand *wand,
4155 const double x_resolution,const double y_resolution,
4156 const FilterTypes filter,const double blur)
4157</pre>
4158
4159<p>A description of each parameter follows:</p>
4160
4161<h5>wand</h5>
4162<p>the magick wand.</p>
4163
4164<h5>x_resolution</h5>
4165<p>the new image x resolution.</p>
4166
4167<h5>y_resolution</h5>
4168<p>the new image y resolution.</p>
4169
4170<h5>filter</h5>
4171<p>Image filter to use.</p>
4172
4173<h5>blur</h5>
4174<p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
4175
4176 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4177<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickResetImagePage">MagickResetImagePage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4178<div class="doc-section">
4179
4180<p>MagickResetImagePage() resets the Wand page canvas and position.</p>
4181
4182<p>The format of the MagickResetImagePage method is:</p>
4183
4184<pre class="code">
4185 MagickBooleanType MagickResetImagePage(MagickWand *wand,
4186 const char *page)
4187</pre>
4188
4189<p>A description of each parameter follows:</p>
4190
4191<h5>wand</h5>
4192<p>the magick wand.</p>
4193
4194<h5>page</h5>
4195<p>the relative page specification.</p>
4196
4197 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4198<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickResizeImage">MagickResizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4199<div class="doc-section">
4200
4201<p>MagickResizeImage() scales an image to the desired dimensions with one of these filters:</p>
4202
4203<pre class="text">
4204 Bessel Blackman Box
4205 Catrom CubicGaussian
4206 Hanning Hermite Lanczos
4207 Mitchell PointQuandratic
4208 Sinc Triangle
4209</pre>
4210
4211<p>Most of the filters are FIR (finite impulse response), however, Bessel, Gaussian, and Sinc are IIR (infinite impulse response). Bessel and Sinc are windowed (brought down to zero) with the Blackman filter.</p>
4212
4213<p>The format of the MagickResizeImage method is:</p>
4214
4215<pre class="code">
4216 MagickBooleanType MagickResizeImage(MagickWand *wand,
4217 const size_t columns,const size_t rows,
4218 const FilterTypes filter,const double blur)
4219</pre>
4220
4221<p>A description of each parameter follows:</p>
4222
4223<h5>wand</h5>
4224<p>the magick wand.</p>
4225
4226<h5>columns</h5>
4227<p>the number of columns in the scaled image.</p>
4228
4229<h5>rows</h5>
4230<p>the number of rows in the scaled image.</p>
4231
4232<h5>filter</h5>
4233<p>Image filter to use.</p>
4234
4235<h5>blur</h5>
4236<p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
4237
4238 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4239<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRollImage">MagickRollImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4240<div class="doc-section">
4241
4242<p>MagickRollImage() offsets an image as defined by x and y.</p>
4243
4244<p>The format of the MagickRollImage method is:</p>
4245
4246<pre class="code">
4247 MagickBooleanType MagickRollImage(MagickWand *wand,const ssize_t x,
4248 const size_t y)
4249</pre>
4250
4251<p>A description of each parameter follows:</p>
4252
4253<h5>wand</h5>
4254<p>the magick wand.</p>
4255
4256<h5>x</h5>
4257<p>the x offset.</p>
4258
4259<h5>y</h5>
4260<p>the y offset.</p>
4261
4262
4263 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4264<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickRotateImage">MagickRotateImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4265<div class="doc-section">
4266
4267<p>MagickRotateImage() rotates an image the specified number of degrees. Empty triangles left over from rotating the image are filled with the background color.</p>
4268
4269<p>The format of the MagickRotateImage method is:</p>
4270
4271<pre class="code">
4272 MagickBooleanType MagickRotateImage(MagickWand *wand,
4273 const PixelWand *background,const double degrees)
4274</pre>
4275
4276<p>A description of each parameter follows:</p>
4277
4278<h5>wand</h5>
4279<p>the magick wand.</p>
4280
4281<h5>background</h5>
4282<p>the background pixel wand.</p>
4283
4284<h5>degrees</h5>
4285<p>the number of degrees to rotate the image.</p>
4286
4287
4288 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4289<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSampleImage">MagickSampleImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4290<div class="doc-section">
4291
4292<p>MagickSampleImage() scales an image to the desired dimensions with pixel sampling. Unlike other scaling methods, this method does not introduce any additional color into the scaled image.</p>
4293
4294<p>The format of the MagickSampleImage method is:</p>
4295
4296<pre class="code">
4297 MagickBooleanType MagickSampleImage(MagickWand *wand,
4298 const size_t columns,const size_t rows)
4299</pre>
4300
4301<p>A description of each parameter follows:</p>
4302
4303<h5>wand</h5>
4304<p>the magick wand.</p>
4305
4306<h5>columns</h5>
4307<p>the number of columns in the scaled image.</p>
4308
4309<h5>rows</h5>
4310<p>the number of rows in the scaled image.</p>
4311
4312
4313 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4314<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickScaleImage">MagickScaleImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4315<div class="doc-section">
4316
4317<p>MagickScaleImage() scales the size of an image to the given dimensions.</p>
4318
4319<p>The format of the MagickScaleImage method is:</p>
4320
4321<pre class="code">
4322 MagickBooleanType MagickScaleImage(MagickWand *wand,
4323 const size_t columns,const size_t rows)
4324</pre>
4325
4326<p>A description of each parameter follows:</p>
4327
4328<h5>wand</h5>
4329<p>the magick wand.</p>
4330
4331<h5>columns</h5>
4332<p>the number of columns in the scaled image.</p>
4333
4334<h5>rows</h5>
4335<p>the number of rows in the scaled image.</p>
4336
4337
4338 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4339<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSegmentImage">MagickSegmentImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4340<div class="doc-section">
4341
4342<p>MagickSegmentImage() segments an image by analyzing the histograms of the color components and identifying units that are homogeneous with the fuzzy C-means technique.</p>
4343
4344<p>The format of the SegmentImage method is:</p>
4345
4346<pre class="code">
4347 MagickBooleanType MagickSegmentImage(MagickWand *wand,
4348 const ColorspaceType colorspace,const MagickBooleanType verbose,
4349 const double cluster_threshold,const double smooth_threshold)
4350</pre>
4351
4352<p>A description of each parameter follows.</p>
4353
4354<h5>wand</h5>
4355<p>the wand.</p>
4356
4357<h5>colorspace</h5>
4358<p>the image colorspace.</p>
4359
4360<h5>verbose</h5>
4361<p>Set to MagickTrue to print detailed information about the identified classes.</p>
4362
4363<h5>cluster_threshold</h5>
4364<p>This represents the minimum number of pixels contained in a hexahedra before it can be considered valid (expressed as a percentage).</p>
4365
4366<h5>smooth_threshold</h5>
4367<p>the smoothing threshold eliminates noise in the second derivative of the histogram. As the value is increased, you can expect a smoother second derivative.</p>
4368
4369 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4370<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSelectiveBlurImage">MagickSelectiveBlurImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4371<div class="doc-section">
4372
4373<p>MagickSelectiveBlurImage() selectively blur an image within a contrast threshold. It is similar to the unsharpen mask that sharpens everything with contrast above a certain threshold.</p>
4374
4375<p>The format of the MagickSelectiveBlurImage method is:</p>
4376
4377<pre class="code">
4378 MagickBooleanType MagickSelectiveBlurImage(MagickWand *wand,
4379 const double radius,const double sigma,const double threshold)
4380 MagickBooleanType MagickSelectiveBlurImageChannel(MagickWand *wand,
4381 const ChannelType channel,const double radius,const double sigma,
4382 const double threshold)
4383</pre>
4384
4385<p>A description of each parameter follows:</p>
4386
4387<h5>wand</h5>
4388<p>the magick wand.</p>
4389
4390<h5>channel</h5>
4391<p>the image channel(s).</p>
4392
4393<h5>radius</h5>
4394<p>the radius of the gaussian, in pixels, not counting the center pixel.</p>
4395
4396<h5>sigma</h5>
4397<p>the standard deviation of the gaussian, in pixels.</p>
4398
4399<h5>threshold</h5>
4400<p>only pixels within this contrast threshold are included in the blur operation.</p>
4401
4402 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4403<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSeparateImageChannel">MagickSeparateImageChannel</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4404<div class="doc-section">
4405
4406<p>MagickSeparateImageChannel() separates a channel from the image and returns a grayscale image. A channel is a particular color component of each pixel in the image.</p>
4407
4408<p>The format of the MagickSeparateImageChannel method is:</p>
4409
4410<pre class="code">
4411 MagickBooleanType MagickSeparateImageChannel(MagickWand *wand,
4412 const ChannelType channel)
4413</pre>
4414
4415<p>A description of each parameter follows:</p>
4416
4417<h5>wand</h5>
4418<p>the magick wand.</p>
4419
4420<h5>channel</h5>
4421<p>the image channel(s).</p>
4422
4423 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4424<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4425<div class="doc-section">
4426
4427<p>MagickSepiaToneImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the sepia toning. A threshold of 80 is a good starting point for a reasonable tone.</p>
4428
4429<p>The format of the MagickSepiaToneImage method is:</p>
4430
4431<pre class="code">
4432 MagickBooleanType MagickSepiaToneImage(MagickWand *wand,
4433 const double threshold)
4434</pre>
4435
4436<p>A description of each parameter follows:</p>
4437
4438<h5>wand</h5>
4439<p>the magick wand.</p>
4440
4441<h5>threshold</h5>
4442<p>Define the extent of the sepia toning.</p>
4443
4444 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4445<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImage">MagickSetImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4446<div class="doc-section">
4447
4448<p>MagickSetImage() replaces the last image returned by MagickSetImageIndex(), MagickNextImage(), MagickPreviousImage() with the images from the specified wand.</p>
4449
4450<p>The format of the MagickSetImage method is:</p>
4451
4452<pre class="code">
4453 MagickBooleanType MagickSetImage(MagickWand *wand,
4454 const MagickWand *set_wand)
4455</pre>
4456
4457<p>A description of each parameter follows:</p>
4458
4459<h5>wand</h5>
4460<p>the magick wand.</p>
4461
4462<h5>set_wand</h5>
4463<p>the set_wand wand.</p>
4464
4465 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4466<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageAlphaChannel">MagickSetImageAlphaChannel</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4467<div class="doc-section">
4468
4469<p>MagickSetImageAlphaChannel() activates, deactivates, resets, or sets the alpha channel.</p>
4470
4471<p>The format of the MagickSetImageAlphaChannel method is:</p>
4472
4473<pre class="code">
4474 MagickBooleanType MagickSetImageAlphaChannel(MagickWand *wand,
4475 const AlphaChannelType alpha_type)
4476</pre>
4477
4478<p>A description of each parameter follows:</p>
4479
4480<h5>wand</h5>
4481<p>the magick wand.</p>
4482
4483<h5>alpha_type</h5>
4484<p>the alpha channel type: ActivateAlphaChannel, DeactivateAlphaChannel, OpaqueAlphaChannel, or SetAlphaChannel.</p>
4485
4486 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4487<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageBackgroundColor">MagickSetImageBackgroundColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4488<div class="doc-section">
4489
4490<p>MagickSetImageBackgroundColor() sets the image background color.</p>
4491
4492<p>The format of the MagickSetImageBackgroundColor method is:</p>
4493
4494<pre class="code">
4495 MagickBooleanType MagickSetImageBackgroundColor(MagickWand *wand,
4496 const PixelWand *background)
4497</pre>
4498
4499<p>A description of each parameter follows:</p>
4500
4501<h5>wand</h5>
4502<p>the magick wand.</p>
4503
4504<h5>background</h5>
4505<p>the background pixel wand.</p>
4506
4507 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4508<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageBias">MagickSetImageBias</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4509<div class="doc-section">
4510
4511<p>MagickSetImageBias() sets the image bias for any method that convolves an image (e.g. MagickConvolveImage()).</p>
4512
4513<p>The format of the MagickSetImageBias method is:</p>
4514
4515<pre class="code">
4516 MagickBooleanType MagickSetImageBias(MagickWand *wand,
4517 const double bias)
4518</pre>
4519
4520<p>A description of each parameter follows:</p>
4521
4522<h5>wand</h5>
4523<p>the magick wand.</p>
4524
4525<h5>bias</h5>
4526<p>the image bias.</p>
4527
4528 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4529<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageBluePrimary">MagickSetImageBluePrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4530<div class="doc-section">
4531
4532<p>MagickSetImageBluePrimary() sets the image chromaticity blue primary point.</p>
4533
4534<p>The format of the MagickSetImageBluePrimary method is:</p>
4535
4536<pre class="code">
4537 MagickBooleanType MagickSetImageBluePrimary(MagickWand *wand,
4538 const double x,const double y)
4539</pre>
4540
4541<p>A description of each parameter follows:</p>
4542
4543<h5>wand</h5>
4544<p>the magick wand.</p>
4545
4546<h5>x</h5>
4547<p>the blue primary x-point.</p>
4548
4549<h5>y</h5>
4550<p>the blue primary y-point.</p>
4551
4552 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4553<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageBorderColor">MagickSetImageBorderColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4554<div class="doc-section">
4555
4556<p>MagickSetImageBorderColor() sets the image border color.</p>
4557
4558<p>The format of the MagickSetImageBorderColor method is:</p>
4559
4560<pre class="code">
4561 MagickBooleanType MagickSetImageBorderColor(MagickWand *wand,
4562 const PixelWand *border)
4563</pre>
4564
4565<p>A description of each parameter follows:</p>
4566
4567<h5>wand</h5>
4568<p>the magick wand.</p>
4569
4570<h5>border</h5>
4571<p>the border pixel wand.</p>
4572
4573 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4574<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageChannelDepth">MagickSetImageChannelDepth</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4575<div class="doc-section">
4576
4577<p>MagickSetImageChannelDepth() sets the depth of a particular image channel.</p>
4578
4579<p>The format of the MagickSetImageChannelDepth method is:</p>
4580
4581<pre class="code">
4582 MagickBooleanType MagickSetImageChannelDepth(MagickWand *wand,
4583 const ChannelType channel,const size_t depth)
4584</pre>
4585
4586<p>A description of each parameter follows:</p>
4587
4588<h5>wand</h5>
4589<p>the magick wand.</p>
4590
4591<h5>channel</h5>
4592<p>the image channel(s).</p>
4593
4594<h5>depth</h5>
4595<p>the image depth in bits.</p>
4596
4597 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4598<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageClipMask">MagickSetImageClipMask</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4599<div class="doc-section">
4600
4601<p>MagickSetImageClipMask() sets image clip mask.</p>
4602
4603<p>The format of the MagickSetImageClipMask method is:</p>
4604
4605<pre class="code">
4606 MagickBooleanType MagickSetImageClipMask(MagickWand *wand,
4607 const MagickWand *clip_mask)
4608</pre>
4609
4610<p>A description of each parameter follows:</p>
4611
4612<h5>wand</h5>
4613<p>the magick wand.</p>
4614
4615<h5>clip_mask</h5>
4616<p>the clip_mask wand.</p>
4617
4618 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4619<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageColor">MagickSetImageColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4620<div class="doc-section">
4621
4622<p>MagickSetImageColor() set the entire wand canvas to the specified color.</p>
4623
4624<p>The format of the MagickSetImageColor method is:</p>
4625
4626<pre class="code">
4627 MagickBooleanType MagickSetImageColor(MagickWand *wand,
4628 const PixelWand *color)
4629</pre>
4630
4631<p>A description of each parameter follows:</p>
4632
4633<h5>wand</h5>
4634<p>the magick wand.</p>
4635
4636<h5>background</h5>
4637<p>the image color.</p>
4638
4639 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4640<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageColormapColor">MagickSetImageColormapColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4641<div class="doc-section">
4642
4643<p>MagickSetImageColormapColor() sets the color of the specified colormap index.</p>
4644
4645<p>The format of the MagickSetImageColormapColor method is:</p>
4646
4647<pre class="code">
4648 MagickBooleanType MagickSetImageColormapColor(MagickWand *wand,
4649 const size_t index,const PixelWand *color)
4650</pre>
4651
4652<p>A description of each parameter follows:</p>
4653
4654<h5>wand</h5>
4655<p>the magick wand.</p>
4656
4657<h5>index</h5>
4658<p>the offset into the image colormap.</p>
4659
4660<h5>color</h5>
4661<p>Return the colormap color in this wand.</p>
4662
4663 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4664<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageColorspace">MagickSetImageColorspace</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4665<div class="doc-section">
4666
4667<p>MagickSetImageColorspace() sets the image colorspace.</p>
4668
4669<p>The format of the MagickSetImageColorspace method is:</p>
4670
4671<pre class="code">
4672 MagickBooleanType MagickSetImageColorspace(MagickWand *wand,
4673 const ColorspaceType colorspace)
4674</pre>
4675
4676<p>A description of each parameter follows:</p>
4677
4678<h5>wand</h5>
4679<p>the magick wand.</p>
4680
4681<h5>colorspace</h5>
4682<p>the image colorspace: UndefinedColorspace, RGBColorspace, GRAYColorspace, TransparentColorspace, OHTAColorspace, XYZColorspace, YCbCrColorspace, YCCColorspace, YIQColorspace, YPbPrColorspace, YPbPrColorspace, YUVColorspace, CMYKColorspace, sRGBColorspace, HSLColorspace, or HWBColorspace.</p>
4683
4684 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4685<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageCompose">MagickSetImageCompose</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4686<div class="doc-section">
4687
4688<p>MagickSetImageCompose() sets the image composite operator, useful for specifying how to composite the image thumbnail when using the MagickMontageImage() method.</p>
4689
4690<p>The format of the MagickSetImageCompose method is:</p>
4691
4692<pre class="code">
4693 MagickBooleanType MagickSetImageCompose(MagickWand *wand,
4694 const CompositeOperator compose)
4695</pre>
4696
4697<p>A description of each parameter follows:</p>
4698
4699<h5>wand</h5>
4700<p>the magick wand.</p>
4701
4702<h5>compose</h5>
4703<p>the image composite operator.</p>
4704
4705 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4706<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageCompression">MagickSetImageCompression</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4707<div class="doc-section">
4708
4709<p>MagickSetImageCompression() sets the image compression.</p>
4710
4711<p>The format of the MagickSetImageCompression method is:</p>
4712
4713<pre class="code">
4714 MagickBooleanType MagickSetImageCompression(MagickWand *wand,
4715 const CompressionType compression)
4716</pre>
4717
4718<p>A description of each parameter follows:</p>
4719
4720<h5>wand</h5>
4721<p>the magick wand.</p>
4722
4723<h5>compression</h5>
4724<p>the image compression type.</p>
4725
4726 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4727<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageCompressionQuality">MagickSetImageCompressionQuality</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4728<div class="doc-section">
4729
4730<p>MagickSetImageCompressionQuality() sets the image compression quality.</p>
4731
4732<p>The format of the MagickSetImageCompressionQuality method is:</p>
4733
4734<pre class="code">
4735 MagickBooleanType MagickSetImageCompressionQuality(MagickWand *wand,
4736 const size_t quality)
4737</pre>
4738
4739<p>A description of each parameter follows:</p>
4740
4741<h5>wand</h5>
4742<p>the magick wand.</p>
4743
4744<h5>quality</h5>
4745<p>the image compression tlityype.</p>
4746
4747 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4748<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageDelay">MagickSetImageDelay</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4749<div class="doc-section">
4750
4751<p>MagickSetImageDelay() sets the image delay.</p>
4752
4753<p>The format of the MagickSetImageDelay method is:</p>
4754
4755<pre class="code">
4756 MagickBooleanType MagickSetImageDelay(MagickWand *wand,
4757 const size_t delay)
4758</pre>
4759
4760<p>A description of each parameter follows:</p>
4761
4762<h5>wand</h5>
4763<p>the magick wand.</p>
4764
4765<h5>delay</h5>
4766<p>the image delay in ticks-per-second units.</p>
4767
4768 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4769<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageDepth">MagickSetImageDepth</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4770<div class="doc-section">
4771
4772<p>MagickSetImageDepth() sets the image depth.</p>
4773
4774<p>The format of the MagickSetImageDepth method is:</p>
4775
4776<pre class="code">
4777 MagickBooleanType MagickSetImageDepth(MagickWand *wand,
4778 const size_t depth)
4779</pre>
4780
4781<p>A description of each parameter follows:</p>
4782
4783<h5>wand</h5>
4784<p>the magick wand.</p>
4785
4786<h5>depth</h5>
4787<p>the image depth in bits: 8, 16, or 32.</p>
4788
4789 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4790<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageDispose">MagickSetImageDispose</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4791<div class="doc-section">
4792
4793<p>MagickSetImageDispose() sets the image disposal method.</p>
4794
4795<p>The format of the MagickSetImageDispose method is:</p>
4796
4797<pre class="code">
4798 MagickBooleanType MagickSetImageDispose(MagickWand *wand,
4799 const DisposeType dispose)
4800</pre>
4801
4802<p>A description of each parameter follows:</p>
4803
4804<h5>wand</h5>
4805<p>the magick wand.</p>
4806
4807<h5>dispose</h5>
4808<p>the image disposeal type.</p>
4809
4810 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4811<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageExtent">MagickSetImageExtent</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4812<div class="doc-section">
4813
4814<p>MagickSetImageExtent() sets the image size (i.e. columns & rows).</p>
4815
4816<p>The format of the MagickSetImageExtent method is:</p>
4817
4818<pre class="code">
4819 MagickBooleanType MagickSetImageExtent(MagickWand *wand,
4820 const size_t columns,const unsigned rows)
4821</pre>
4822
4823<p>A description of each parameter follows:</p>
4824
4825<h5>wand</h5>
4826<p>the magick wand.</p>
4827
4828<h5>columns</h5>
4829<p>The image width in pixels.</p>
4830
4831<h5>rows</h5>
4832<p>The image height in pixels.</p>
4833
4834 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4835<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageFilename">MagickSetImageFilename</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4836<div class="doc-section">
4837
4838<p>MagickSetImageFilename() sets the filename of a particular image in a sequence.</p>
4839
4840<p>The format of the MagickSetImageFilename method is:</p>
4841
4842<pre class="code">
4843 MagickBooleanType MagickSetImageFilename(MagickWand *wand,
4844 const char *filename)
4845</pre>
4846
4847<p>A description of each parameter follows:</p>
4848
4849<h5>wand</h5>
4850<p>the magick wand.</p>
4851
4852<h5>filename</h5>
4853<p>the image filename.</p>
4854
4855 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4856<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageFormat">MagickSetImageFormat</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4857<div class="doc-section">
4858
4859<p>MagickSetImageFormat() sets the format of a particular image in a sequence.</p>
4860
4861<p>The format of the MagickSetImageFormat method is:</p>
4862
4863<pre class="code">
4864 MagickBooleanType MagickSetImageFormat(MagickWand *wand,
4865 const char *format)
4866</pre>
4867
4868<p>A description of each parameter follows:</p>
4869
4870<h5>wand</h5>
4871<p>the magick wand.</p>
4872
4873<h5>format</h5>
4874<p>the image format.</p>
4875
4876 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4877<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageFuzz">MagickSetImageFuzz</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4878<div class="doc-section">
4879
4880<p>MagickSetImageFuzz() sets the image fuzz.</p>
4881
4882<p>The format of the MagickSetImageFuzz method is:</p>
4883
4884<pre class="code">
4885 MagickBooleanType MagickSetImageFuzz(MagickWand *wand,
4886 const double fuzz)
4887</pre>
4888
4889<p>A description of each parameter follows:</p>
4890
4891<h5>wand</h5>
4892<p>the magick wand.</p>
4893
4894<h5>fuzz</h5>
4895<p>the image fuzz.</p>
4896
4897 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4898<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageGamma">MagickSetImageGamma</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4899<div class="doc-section">
4900
4901<p>MagickSetImageGamma() sets the image gamma.</p>
4902
4903<p>The format of the MagickSetImageGamma method is:</p>
4904
4905<pre class="code">
4906 MagickBooleanType MagickSetImageGamma(MagickWand *wand,
4907 const double gamma)
4908</pre>
4909
4910<p>A description of each parameter follows:</p>
4911
4912<h5>wand</h5>
4913<p>the magick wand.</p>
4914
4915<h5>gamma</h5>
4916<p>the image gamma.</p>
4917
4918 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4919<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageGravity">MagickSetImageGravity</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4920<div class="doc-section">
4921
4922<p>MagickSetImageGravity() sets the image gravity type.</p>
4923
4924<p>The format of the MagickSetImageGravity method is:</p>
4925
4926<pre class="code">
4927 MagickBooleanType MagickSetImageGravity(MagickWand *wand,
4928 const GravityType gravity)
4929</pre>
4930
4931<p>A description of each parameter follows:</p>
4932
4933<h5>wand</h5>
4934<p>the magick wand.</p>
4935
4936<h5>gravity</h5>
4937<p>the image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.</p>
4938
4939 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4940<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageGreenPrimary">MagickSetImageGreenPrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4941<div class="doc-section">
4942
4943<p>MagickSetImageGreenPrimary() sets the image chromaticity green primary point.</p>
4944
4945<p>The format of the MagickSetImageGreenPrimary method is:</p>
4946
4947<pre class="code">
4948 MagickBooleanType MagickSetImageGreenPrimary(MagickWand *wand,
4949 const double x,const double y)
4950</pre>
4951
4952<p>A description of each parameter follows:</p>
4953
4954<h5>wand</h5>
4955<p>the magick wand.</p>
4956
4957<h5>x</h5>
4958<p>the green primary x-point.</p>
4959
4960<h5>y</h5>
4961<p>the green primary y-point.</p>
4962
4963
4964 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4965<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageInterlaceScheme">MagickSetImageInterlaceScheme</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4966<div class="doc-section">
4967
4968<p>MagickSetImageInterlaceScheme() sets the image interlace scheme.</p>
4969
4970<p>The format of the MagickSetImageInterlaceScheme method is:</p>
4971
4972<pre class="code">
4973 MagickBooleanType MagickSetImageInterlaceScheme(MagickWand *wand,
4974 const InterlaceType interlace)
4975</pre>
4976
4977<p>A description of each parameter follows:</p>
4978
4979<h5>wand</h5>
4980<p>the magick wand.</p>
4981
4982<h5>interlace</h5>
4983<p>the image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.</p>
4984
4985 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]4986<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageInterpolateMethod">MagickSetImageInterpolateMethod</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]4987<div class="doc-section">
4988
4989<p>MagickSetImageInterpolateMethod() sets the image interpolate pixel method.</p>
4990
4991<p>The format of the MagickSetImageInterpolateMethod method is:</p>
4992
4993<pre class="code">
4994 MagickBooleanType MagickSetImageInterpolateMethod(MagickWand *wand,
4995 const InterpolatePixelMethod method)
4996</pre>
4997
4998<p>A description of each parameter follows:</p>
4999
5000<h5>wand</h5>
5001<p>the magick wand.</p>
5002
5003<h5>method</h5>
5004<p>the image interpole pixel methods: choose from Undefined, Average, Bicubic, Bilinear, Filter, Integer, Mesh, NearestNeighbor.</p>
5005
5006 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5007<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageIterations">MagickSetImageIterations</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5008<div class="doc-section">
5009
5010<p>MagickSetImageIterations() sets the image iterations.</p>
5011
5012<p>The format of the MagickSetImageIterations method is:</p>
5013
5014<pre class="code">
5015 MagickBooleanType MagickSetImageIterations(MagickWand *wand,
5016 const size_t iterations)
5017</pre>
5018
5019<p>A description of each parameter follows:</p>
5020
5021<h5>wand</h5>
5022<p>the magick wand.</p>
5023
5024<h5>delay</h5>
5025<p>the image delay in 1/100th of a second.</p>
5026
5027 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5028<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageMatte">MagickSetImageMatte</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5029<div class="doc-section">
5030
5031<p>MagickSetImageMatte() sets the image matte channel.</p>
5032
5033<p>The format of the MagickSetImageMatteColor method is:</p>
5034
5035<pre class="code">
5036 MagickBooleanType MagickSetImageMatteColor(MagickWand *wand,
5037 const MagickBooleanType *matte)
5038</pre>
5039
5040<p>A description of each parameter follows:</p>
5041
5042<h5>wand</h5>
5043<p>the magick wand.</p>
5044
5045<h5>matte</h5>
5046<p>Set to MagickTrue to enable the image matte channel otherwise MagickFalse.</p>
5047
5048 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5049<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageMatteColor">MagickSetImageMatteColor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5050<div class="doc-section">
5051
5052<p>MagickSetImageMatteColor() sets the image matte color.</p>
5053
5054<p>The format of the MagickSetImageMatteColor method is:</p>
5055
5056<pre class="code">
5057 MagickBooleanType MagickSetImageMatteColor(MagickWand *wand,
5058 const PixelWand *matte)
5059</pre>
5060
5061<p>A description of each parameter follows:</p>
5062
5063<h5>wand</h5>
5064<p>the magick wand.</p>
5065
5066<h5>matte</h5>
5067<p>the matte pixel wand.</p>
5068
5069 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5070<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageOpacity">MagickSetImageOpacity</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5071<div class="doc-section">
5072
5073<p>MagickSetImageOpacity() sets the image to the specified opacity level.</p>
5074
5075<p>The format of the MagickSetImageOpacity method is:</p>
5076
5077<pre class="code">
5078 MagickBooleanType MagickSetImageOpacity(MagickWand *wand,
5079 const double alpha)
5080</pre>
5081
5082<p>A description of each parameter follows:</p>
5083
5084<h5>wand</h5>
5085<p>the magick wand.</p>
5086
5087<h5>alpha</h5>
5088<p>the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.</p>
5089
5090 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5091<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageOrientation">MagickSetImageOrientation</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5092<div class="doc-section">
5093
5094<p>MagickSetImageOrientation() sets the image orientation.</p>
5095
5096<p>The format of the MagickSetImageOrientation method is:</p>
5097
5098<pre class="code">
5099 MagickBooleanType MagickSetImageOrientation(MagickWand *wand,
5100 const OrientationType orientation)
5101</pre>
5102
5103<p>A description of each parameter follows:</p>
5104
5105<h5>wand</h5>
5106<p>the magick wand.</p>
5107
5108<h5>orientation</h5>
5109<p>the image orientation type.</p>
5110
5111 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5112<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImagePage">MagickSetImagePage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5113<div class="doc-section">
5114
5115<p>MagickSetImagePage() sets the page geometry of the image.</p>
5116
5117<p>The format of the MagickSetImagePage method is:</p>
5118
5119<pre class="code">
5120 MagickBooleanType MagickSetImagePage(MagickWand *wand,
5121 const size_t width,const size_t height,const ssize_t x,
5122 const ssize_t y)
5123</pre>
5124
5125<p>A description of each parameter follows:</p>
5126
5127<h5>wand</h5>
5128<p>the magick wand.</p>
5129
5130<h5>width</h5>
5131<p>the page width.</p>
5132
5133<h5>height</h5>
5134<p>the page height.</p>
5135
5136<h5>x</h5>
5137<p>the page x-offset.</p>
5138
5139<h5>y</h5>
5140<p>the page y-offset.</p>
5141
5142 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5143<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageProgressMonitor">MagickSetImageProgressMonitor</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5144<div class="doc-section">
5145
5146<p>MagickSetImageProgressMonitor() sets the wand image progress monitor to the specified method and returns the previous progress monitor if any. The progress monitor method looks like this:</p>
5147
5148<pre class="text">
5149 MagickBooleanType MagickProgressMonitor(const char *text,
5150 const MagickOffsetType offset,const MagickSizeType span,
5151 void *client_data)
5152</pre>
5153
5154<p>If the progress monitor returns MagickFalse, the current operation is interrupted.</p>
5155
5156<p>The format of the MagickSetImageProgressMonitor method is:</p>
5157
5158<pre class="code">
5159 MagickProgressMonitor MagickSetImageProgressMonitor(MagickWand *wand
5160 const MagickProgressMonitor progress_monitor,void *client_data)
5161</pre>
5162
5163<p>A description of each parameter follows:</p>
5164
5165<h5>wand</h5>
5166<p>the magick wand.</p>
5167
5168<h5>progress_monitor</h5>
5169<p>Specifies a pointer to a method to monitor progress of an image operation.</p>
5170
5171<h5>client_data</h5>
5172<p>Specifies a pointer to any client data.</p>
5173
5174 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5175<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageRedPrimary">MagickSetImageRedPrimary</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5176<div class="doc-section">
5177
5178<p>MagickSetImageRedPrimary() sets the image chromaticity red primary point.</p>
5179
5180<p>The format of the MagickSetImageRedPrimary method is:</p>
5181
5182<pre class="code">
5183 MagickBooleanType MagickSetImageRedPrimary(MagickWand *wand,
5184 const double x,const double y)
5185</pre>
5186
5187<p>A description of each parameter follows:</p>
5188
5189<h5>wand</h5>
5190<p>the magick wand.</p>
5191
5192<h5>x</h5>
5193<p>the red primary x-point.</p>
5194
5195<h5>y</h5>
5196<p>the red primary y-point.</p>
5197
5198 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5199<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageRenderingIntent">MagickSetImageRenderingIntent</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5200<div class="doc-section">
5201
5202<p>MagickSetImageRenderingIntent() sets the image rendering intent.</p>
5203
5204<p>The format of the MagickSetImageRenderingIntent method is:</p>
5205
5206<pre class="code">
5207 MagickBooleanType MagickSetImageRenderingIntent(MagickWand *wand,
5208 const RenderingIntent rendering_intent)
5209</pre>
5210
5211<p>A description of each parameter follows:</p>
5212
5213<h5>wand</h5>
5214<p>the magick wand.</p>
5215
5216<h5>rendering_intent</h5>
5217<p>the image rendering intent: UndefinedIntent, SaturationIntent, PerceptualIntent, AbsoluteIntent, or RelativeIntent.</p>
5218
5219 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5220<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageResolution">MagickSetImageResolution</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5221<div class="doc-section">
5222
5223<p>MagickSetImageResolution() sets the image resolution.</p>
5224
5225<p>The format of the MagickSetImageResolution method is:</p>
5226
5227<pre class="code">
5228 MagickBooleanType MagickSetImageResolution(MagickWand *wand,
5229 const double x_resolution,const doubtl y_resolution)
5230</pre>
5231
5232<p>A description of each parameter follows:</p>
5233
5234<h5>wand</h5>
5235<p>the magick wand.</p>
5236
5237<h5>x_resolution</h5>
5238<p>the image x resolution.</p>
5239
5240<h5>y_resolution</h5>
5241<p>the image y resolution.</p>
5242
5243 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5244<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageScene">MagickSetImageScene</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5245<div class="doc-section">
5246
5247<p>MagickSetImageScene() sets the image scene.</p>
5248
5249<p>The format of the MagickSetImageScene method is:</p>
5250
5251<pre class="code">
5252 MagickBooleanType MagickSetImageScene(MagickWand *wand,
5253 const size_t scene)
5254</pre>
5255
5256<p>A description of each parameter follows:</p>
5257
5258<h5>wand</h5>
5259<p>the magick wand.</p>
5260
5261<h5>delay</h5>
5262<p>the image scene number.</p>
5263
5264 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5265<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageTicksPerSecond">MagickSetImageTicksPerSecond</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5266<div class="doc-section">
5267
5268<p>MagickSetImageTicksPerSecond() sets the image ticks-per-second.</p>
5269
5270<p>The format of the MagickSetImageTicksPerSecond method is:</p>
5271
5272<pre class="code">
5273 MagickBooleanType MagickSetImageTicksPerSecond(MagickWand *wand,
5274 const ssize_t ticks_per-second)
5275</pre>
5276
5277<p>A description of each parameter follows:</p>
5278
5279<h5>wand</h5>
5280<p>the magick wand.</p>
5281
5282<h5>ticks_per_second</h5>
5283<p>the units to use for the image delay.</p>
5284
5285 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5286<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageType">MagickSetImageType</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5287<div class="doc-section">
5288
5289<p>MagickSetImageType() sets the image type.</p>
5290
5291<p>The format of the MagickSetImageType method is:</p>
5292
5293<pre class="code">
5294 MagickBooleanType MagickSetImageType(MagickWand *wand,
5295 const ImageType image_type)
5296</pre>
5297
5298<p>A description of each parameter follows:</p>
5299
5300<h5>wand</h5>
5301<p>the magick wand.</p>
5302
5303<h5>image_type</h5>
5304<p>the image type: UndefinedType, BilevelType, GrayscaleType, GrayscaleMatteType, PaletteType, PaletteMatteType, TrueColorType, TrueColorMatteType, ColorSeparationType, ColorSeparationMatteType, or OptimizeType.</p>
5305
5306 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5307<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageUnits">MagickSetImageUnits</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5308<div class="doc-section">
5309
5310<p>MagickSetImageUnits() sets the image units of resolution.</p>
5311
5312<p>The format of the MagickSetImageUnits method is:</p>
5313
5314<pre class="code">
5315 MagickBooleanType MagickSetImageUnits(MagickWand *wand,
5316 const ResolutionType units)
5317</pre>
5318
5319<p>A description of each parameter follows:</p>
5320
5321<h5>wand</h5>
5322<p>the magick wand.</p>
5323
5324<h5>units</h5>
5325<p>the image units of resolution : UndefinedResolution, PixelsPerInchResolution, or PixelsPerCentimeterResolution.</p>
5326
5327 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5328<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageVirtualPixelMethod">MagickSetImageVirtualPixelMethod</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5329<div class="doc-section">
5330
5331<p>MagickSetImageVirtualPixelMethod() sets the image virtual pixel method.</p>
5332
5333<p>The format of the MagickSetImageVirtualPixelMethod method is:</p>
5334
5335<pre class="code">
5336 VirtualPixelMethod MagickSetImageVirtualPixelMethod(MagickWand *wand,
5337 const VirtualPixelMethod method)
5338</pre>
5339
5340<p>A description of each parameter follows:</p>
5341
5342<h5>wand</h5>
5343<p>the magick wand.</p>
5344
5345<h5>method</h5>
5346<p>the image virtual pixel method : UndefinedVirtualPixelMethod, ConstantVirtualPixelMethod, EdgeVirtualPixelMethod, MirrorVirtualPixelMethod, or TileVirtualPixelMethod.</p>
5347
5348 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5349<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSetImageWhitePoint">MagickSetImageWhitePoint</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5350<div class="doc-section">
5351
5352<p>MagickSetImageWhitePoint() sets the image chromaticity white point.</p>
5353
5354<p>The format of the MagickSetImageWhitePoint method is:</p>
5355
5356<pre class="code">
5357 MagickBooleanType MagickSetImageWhitePoint(MagickWand *wand,
5358 const double x,const double y)
5359</pre>
5360
5361<p>A description of each parameter follows:</p>
5362
5363<h5>wand</h5>
5364<p>the magick wand.</p>
5365
5366<h5>x</h5>
5367<p>the white x-point.</p>
5368
5369<h5>y</h5>
5370<p>the white y-point.</p>
5371
5372 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5373<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickShadeImage">MagickShadeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5374<div class="doc-section">
5375
5376<p>MagickShadeImage() shines a distant light on an image to create a three-dimensional effect. You control the positioning of the light with azimuth and elevation; azimuth is measured in degrees off the x axis and elevation is measured in pixels above the Z axis.</p>
5377
5378<p>The format of the MagickShadeImage method is:</p>
5379
5380<pre class="code">
5381 MagickBooleanType MagickShadeImage(MagickWand *wand,
5382 const MagickBooleanType gray,const double azimuth,
5383 const double elevation)
5384</pre>
5385
5386<p>A description of each parameter follows:</p>
5387
5388<h5>wand</h5>
5389<p>the magick wand.</p>
5390
5391<h5>gray</h5>
5392<p>A value other than zero shades the intensity of each pixel.</p>
5393
5394<h5>azimuth, elevation</h5>
5395<p>Define the light source direction.</p>
5396
5397 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5398<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickShadowImage">MagickShadowImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5399<div class="doc-section">
5400
5401<p>MagickShadowImage() simulates an image shadow.</p>
5402
5403<p>The format of the MagickShadowImage method is:</p>
5404
5405<pre class="code">
5406 MagickBooleanType MagickShadowImage(MagickWand *wand,
5407 const double opacity,const double sigma,const ssize_t x,const ssize_t y)
5408</pre>
5409
5410<p>A description of each parameter follows:</p>
5411
5412<h5>wand</h5>
5413<p>the magick wand.</p>
5414
5415<h5>opacity</h5>
5416<p>percentage transparency.</p>
5417
5418<h5>sigma</h5>
5419<p>the standard deviation of the Gaussian, in pixels.</p>
5420
5421<h5>x</h5>
5422<p>the shadow x-offset.</p>
5423
5424<h5>y</h5>
5425<p>the shadow y-offset.</p>
5426
5427 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5428<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSharpenImage">MagickSharpenImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5429<div class="doc-section">
5430
5431<p>MagickSharpenImage() sharpens an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and MagickSharpenImage() selects a suitable radius for you.</p>
5432
5433<p>The format of the MagickSharpenImage method is:</p>
5434
5435<pre class="code">
5436 MagickBooleanType MagickSharpenImage(MagickWand *wand,
5437 const double radius,const double sigma)
5438 MagickBooleanType MagickSharpenImageChannel(MagickWand *wand,
5439 const ChannelType channel,const double radius,const double sigma)
5440</pre>
5441
5442<p>A description of each parameter follows:</p>
5443
5444<h5>wand</h5>
5445<p>the magick wand.</p>
5446
5447<h5>channel</h5>
5448<p>the image channel(s).</p>
5449
5450<h5>radius</h5>
5451<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
5452
5453<h5>sigma</h5>
5454<p>the standard deviation of the Gaussian, in pixels.</p>
5455
5456 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5457<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickShaveImage">MagickShaveImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5458<div class="doc-section">
5459
5460<p>MagickShaveImage() shaves pixels from the image edges. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p>
5461
5462<p>The format of the MagickShaveImage method is:</p>
5463
5464<pre class="code">
5465 MagickBooleanType MagickShaveImage(MagickWand *wand,
5466 const size_t columns,const size_t rows)
5467</pre>
5468
5469<p>A description of each parameter follows:</p>
5470
5471<h5>wand</h5>
5472<p>the magick wand.</p>
5473
5474<h5>columns</h5>
5475<p>the number of columns in the scaled image.</p>
5476
5477<h5>rows</h5>
5478<p>the number of rows in the scaled image.</p>
5479
5480
5481 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5482<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickShearImage">MagickShearImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5483<div class="doc-section">
5484
5485<p>MagickShearImage() slides one edge of an image along the X or Y axis, creating a parallelogram. An X direction shear slides an edge along the X axis, while a Y direction shear slides an edge along the Y axis. The amount of the shear is controlled by a shear angle. For X direction shears, x_shear is measured relative to the Y axis, and similarly, for Y direction shears y_shear is measured relative to the X axis. Empty triangles left over from shearing the image are filled with the background color.</p>
5486
5487<p>The format of the MagickShearImage method is:</p>
5488
5489<pre class="code">
5490 MagickBooleanType MagickShearImage(MagickWand *wand,
5491 const PixelWand *background,const double x_shear,onst double y_shear)
5492</pre>
5493
5494<p>A description of each parameter follows:</p>
5495
5496<h5>wand</h5>
5497<p>the magick wand.</p>
5498
5499<h5>background</h5>
5500<p>the background pixel wand.</p>
5501
5502<h5>x_shear</h5>
5503<p>the number of degrees to shear the image.</p>
5504
5505<h5>y_shear</h5>
5506<p>the number of degrees to shear the image.</p>
5507
5508 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5509<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSigmoidalContrastImage">MagickSigmoidalContrastImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5510<div class="doc-section">
5511
5512<p>MagickSigmoidalContrastImage() adjusts the contrast of an image with a non-linear sigmoidal contrast algorithm. Increase the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows. Contrast indicates how much to increase the contrast (0 is none; 3 is typical; 20 is pushing it); mid-point indicates where midtones fall in the resultant image (0 is white; 50 is middle-gray; 100 is black). Set sharpen to MagickTrue to increase the image contrast otherwise the contrast is reduced.</p>
5513
5514<p>The format of the MagickSigmoidalContrastImage method is:</p>
5515
5516<pre class="code">
5517 MagickBooleanType MagickSigmoidalContrastImage(MagickWand *wand,
5518 const MagickBooleanType sharpen,const double alpha,const double beta)
5519 MagickBooleanType MagickSigmoidalContrastImageChannel(MagickWand *wand,
5520 const ChannelType channel,const MagickBooleanType sharpen,
5521 const double alpha,const double beta)
5522</pre>
5523
5524<p>A description of each parameter follows:</p>
5525
5526<h5>wand</h5>
5527<p>the magick wand.</p>
5528
5529<h5>channel</h5>
5530<p>Identify which channel to level: RedChannel, GreenChannel,</p>
5531
5532<h5>sharpen</h5>
5533<p>Increase or decrease image contrast.</p>
5534
5535<h5>alpha</h5>
5536<p>strength of the contrast, the larger the number the more 'threshold-like' it becomes.</p>
5537
5538<h5>beta</h5>
5539<p>midpoint of the function as a color value 0 to QuantumRange.</p>
5540
5541 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5542<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSimilarityImage">MagickSimilarityImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5543<div class="doc-section">
5544
5545<p>MagickSimilarityImage() compares the reference image of the image and returns the best match offset. In addition, it returns a similarity image such that an exact match location is completely white and if none of the pixels match, black, otherwise some gray level in-between.</p>
5546
5547<p>The format of the MagickSimilarityImage method is:</p>
5548
5549<pre class="code">
5550 MagickWand *MagickSimilarityImage(MagickWand *wand,
5551 const MagickWand *reference,RectangeInfo *offset,double *similarity)
5552</pre>
5553
5554<p>A description of each parameter follows:</p>
5555
5556<h5>wand</h5>
5557<p>the magick wand.</p>
5558
5559<h5>reference</h5>
5560<p>the reference wand.</p>
5561
5562<h5>offset</h5>
5563<p>the best match offset of the reference image within the image.</p>
5564
5565<h5>similarity</h5>
5566<p>the computed similarity between the images.</p>
5567
5568 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5569<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSketchImage">MagickSketchImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5570<div class="doc-section">
5571
5572<p>MagickSketchImage() simulates a pencil sketch. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and SketchImage() selects a suitable radius for you. Angle gives the angle of the blurring motion.</p>
5573
5574<p>The format of the MagickSketchImage method is:</p>
5575
5576<pre class="code">
5577 MagickBooleanType MagickSketchImage(MagickWand *wand,
5578 const double radius,const double sigma,const double angle)
5579</pre>
5580
5581<p>A description of each parameter follows:</p>
5582
5583<h5>wand</h5>
5584<p>the magick wand.</p>
5585
5586<h5>radius</h5>
5587<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
5588
5589<h5>sigma</h5>
5590<p>the standard deviation of the Gaussian, in pixels.</p>
5591
5592<h5>angle</h5>
5593<p>Apply the effect along this angle.</p>
5594
5595 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5596<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSmushImages">MagickSmushImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5597<div class="doc-section">
5598
5599<p>MagickSmushImages() takes all images from the current image pointer to the end of the image list and smushs them to each other top-to-bottom if the stack parameter is true, otherwise left-to-right.</p>
5600
5601<p>The format of the MagickSmushImages method is:</p>
5602
5603<pre class="code">
5604 MagickWand *MagickSmushImages(MagickWand *wand,
5605 const MagickBooleanType stack,const ssize_t offset)
5606</pre>
5607
5608<p>A description of each parameter follows:</p>
5609
5610<h5>wand</h5>
5611<p>the magick wand.</p>
5612
5613<h5>stack</h5>
5614<p>By default, images are stacked left-to-right. Set stack to MagickTrue to stack them top-to-bottom.</p>
5615
5616<h5>offset</h5>
5617<p>minimum distance in pixels between images.</p>
5618
5619 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5620<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSolarizeImage">MagickSolarizeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5621<div class="doc-section">
5622
5623<p>MagickSolarizeImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by selectively exposing areas of photo sensitive paper to light. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the solarization.</p>
5624
5625<p>The format of the MagickSolarizeImage method is:</p>
5626
5627<pre class="code">
5628 MagickBooleanType MagickSolarizeImage(MagickWand *wand,
5629 const double threshold)
5630</pre>
5631
5632<p>A description of each parameter follows:</p>
5633
5634<h5>wand</h5>
5635<p>the magick wand.</p>
5636
5637<h5>threshold</h5>
5638<p>Define the extent of the solarization.</p>
5639
5640 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5641<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSparseColorImage">MagickSparseColorImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5642<div class="doc-section">
5643
5644<p>MagickSparseColorImage(), given a set of coordinates, interpolates the colors found at those coordinates, across the whole image, using various methods.</p>
5645
5646<p>The format of the MagickSparseColorImage method is:</p>
5647
5648<pre class="code">
5649 MagickBooleanType MagickSparseColorImage(MagickWand *wand,
5650 const ChannelType channel,const SparseColorMethod method,
5651 const size_t number_arguments,const double *arguments)
5652</pre>
5653
5654<p>A description of each parameter follows:</p>
5655
5656<h5>image</h5>
5657<p>the image to be sparseed.</p>
5658
5659<h5>method</h5>
5660<p>the method of image sparseion.</p>
5661
5662<p>ArcSparseColorion will always ignore source image offset, and always 'bestfit' the destination image with the top left corner offset relative to the polar mapping center.</p>
5663
5664<p>Bilinear has no simple inverse mapping so will not allow 'bestfit' style of image sparseion.</p>
5665
5666<p>Affine, Perspective, and Bilinear, will do least squares fitting of the distrotion when more than the minimum number of control point pairs are provided.</p>
5667
5668<p>Perspective, and Bilinear, will fall back to a Affine sparseion when less than 4 control point pairs are provided. While Affine sparseions will let you use any number of control point pairs, that is Zero pairs is a No-Op (viewport only) distrotion, one pair is a translation and two pairs of control points will do a scale-rotate-translate, without any shearing.</p>
5669
5670<h5>number_arguments</h5>
5671<p>the number of arguments given for this sparseion method.</p>
5672
5673<h5>arguments</h5>
5674<p>the arguments for this sparseion method.</p>
5675
5676 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5677<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSpliceImage">MagickSpliceImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5678<div class="doc-section">
5679
5680<p>MagickSpliceImage() splices a solid color into the image.</p>
5681
5682<p>The format of the MagickSpliceImage method is:</p>
5683
5684<pre class="code">
5685 MagickBooleanType MagickSpliceImage(MagickWand *wand,
5686 const size_t width,const size_t height,const ssize_t x,
5687 const ssize_t y)
5688</pre>
5689
5690<p>A description of each parameter follows:</p>
5691
5692<h5>wand</h5>
5693<p>the magick wand.</p>
5694
5695<h5>width</h5>
5696<p>the region width.</p>
5697
5698<h5>height</h5>
5699<p>the region height.</p>
5700
5701<h5>x</h5>
5702<p>the region x offset.</p>
5703
5704<h5>y</h5>
5705<p>the region y offset.</p>
5706
5707 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5708<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSpreadImage">MagickSpreadImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5709<div class="doc-section">
5710
5711<p>MagickSpreadImage() is a special effects method that randomly displaces each pixel in a block defined by the radius parameter.</p>
5712
5713<p>The format of the MagickSpreadImage method is:</p>
5714
5715<pre class="code">
5716 MagickBooleanType MagickSpreadImage(MagickWand *wand,const double radius)
5717</pre>
5718
5719<p>A description of each parameter follows:</p>
5720
5721<h5>wand</h5>
5722<p>the magick wand.</p>
5723
5724<h5>radius</h5>
5725<p>Choose a random pixel in a neighborhood of this extent.</p>
5726
5727 </div>
cristyb52981c2011-03-19 17:09:31 +0000[diff] [blame]5728<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickStatisticImage">MagickStatisticImage</a></h2>
5729<div class="doc-section">
5730
5731<p>MagickStatisticImage() replace each pixel with corresponding statistic from the neighborhood of the specified width and height.</p>
5732
5733<p>The format of the MagickStatisticImage method is:</p>
5734
5735<pre class="code">
5736 MagickBooleanType MagickStatisticImage(MagickWand *wand,
5737 const StatisticType type,const double width,const size_t height)
5738 MagickBooleanType MagickStatisticImageChannel(MagickWand *wand,
5739 const ChannelType channel,const StatisticType type,const double width,
5740 const size_t height)
5741</pre>
5742
5743<p>A description of each parameter follows:</p>
5744
5745<h5>wand</h5>
5746<p>the magick wand.</p>
5747
5748<h5>channel</h5>
5749<p>the image channel(s).</p>
5750
5751<h5>type</h5>
5752<p>the statistic type (e.g. median, mode, etc.).</p>
5753
5754<h5>width</h5>
5755<p>the width of the pixel neighborhood.</p>
5756
5757<h5>height</h5>
5758<p>the height of the pixel neighborhood.</p>
5759
5760 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5761<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSteganoImage">MagickSteganoImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5762<div class="doc-section">
5763
5764<p>MagickSteganoImage() hides a digital watermark within the image. Recover the hidden watermark later to prove that the authenticity of an image. Offset defines the start position within the image to hide the watermark.</p>
5765
5766<p>The format of the MagickSteganoImage method is:</p>
5767
5768<pre class="code">
5769 MagickWand *MagickSteganoImage(MagickWand *wand,
5770 const MagickWand *watermark_wand,const ssize_t offset)
5771</pre>
5772
5773<p>A description of each parameter follows:</p>
5774
5775<h5>wand</h5>
5776<p>the magick wand.</p>
5777
5778<h5>watermark_wand</h5>
5779<p>the watermark wand.</p>
5780
5781<h5>offset</h5>
5782<p>Start hiding at this offset into the image.</p>
5783
5784 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5785<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickStereoImage">MagickStereoImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5786<div class="doc-section">
5787
5788<p>MagickStereoImage() composites two images and produces a single image that is the composite of a left and right image of a stereo pair</p>
5789
5790<p>The format of the MagickStereoImage method is:</p>
5791
5792<pre class="code">
5793 MagickWand *MagickStereoImage(MagickWand *wand,
5794 const MagickWand *offset_wand)
5795</pre>
5796
5797<p>A description of each parameter follows:</p>
5798
5799<h5>wand</h5>
5800<p>the magick wand.</p>
5801
5802<h5>offset_wand</h5>
5803<p>Another image wand.</p>
5804
5805 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5806<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickStripImage">MagickStripImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5807<div class="doc-section">
5808
5809<p>MagickStripImage() strips an image of all profiles and comments.</p>
5810
5811<p>The format of the MagickStripImage method is:</p>
5812
5813<pre class="code">
5814 MagickBooleanType MagickStripImage(MagickWand *wand)
5815</pre>
5816
5817<p>A description of each parameter follows:</p>
5818
5819<h5>wand</h5>
5820<p>the magick wand.</p>
5821
5822 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5823<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickSwirlImage">MagickSwirlImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5824<div class="doc-section">
5825
5826<p>MagickSwirlImage() swirls the pixels about the center of the image, where degrees indicates the sweep of the arc through which each pixel is moved. You get a more dramatic effect as the degrees move from 1 to 360.</p>
5827
5828<p>The format of the MagickSwirlImage method is:</p>
5829
5830<pre class="code">
5831 MagickBooleanType MagickSwirlImage(MagickWand *wand,const double degrees)
5832</pre>
5833
5834<p>A description of each parameter follows:</p>
5835
5836<h5>wand</h5>
5837<p>the magick wand.</p>
5838
5839<h5>degrees</h5>
5840<p>Define the tightness of the swirling effect.</p>
5841
5842 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5843<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTextureImage">MagickTextureImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5844<div class="doc-section">
5845
5846<p>MagickTextureImage() repeatedly tiles the texture image across and down the image canvas.</p>
5847
5848<p>The format of the MagickTextureImage method is:</p>
5849
5850<pre class="code">
5851 MagickWand *MagickTextureImage(MagickWand *wand,
5852 const MagickWand *texture_wand)
5853</pre>
5854
5855<p>A description of each parameter follows:</p>
5856
5857<h5>wand</h5>
5858<p>the magick wand.</p>
5859
5860<h5>texture_wand</h5>
5861<p>the texture wand</p>
5862
5863 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5864<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickThresholdImage">MagickThresholdImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5865<div class="doc-section">
5866
5867<p>MagickThresholdImage() changes the value of individual pixels based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image.</p>
5868
5869<p>The format of the MagickThresholdImage method is:</p>
5870
5871<pre class="code">
5872 MagickBooleanType MagickThresholdImage(MagickWand *wand,
5873 const double threshold)
5874 MagickBooleanType MagickThresholdImageChannel(MagickWand *wand,
5875 const ChannelType channel,const double threshold)
5876</pre>
5877
5878<p>A description of each parameter follows:</p>
5879
5880<h5>wand</h5>
5881<p>the magick wand.</p>
5882
5883<h5>channel</h5>
5884<p>the image channel(s).</p>
5885
5886<h5>threshold</h5>
5887<p>Define the threshold value.</p>
5888
5889 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5890<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickThumbnailImage">MagickThumbnailImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5891<div class="doc-section">
5892
5893<p>MagickThumbnailImage() changes the size of an image to the given dimensions and removes any associated profiles. The goal is to produce small low cost thumbnail images suited for display on the Web.</p>
5894
5895<p>The format of the MagickThumbnailImage method is:</p>
5896
5897<pre class="code">
5898 MagickBooleanType MagickThumbnailImage(MagickWand *wand,
5899 const size_t columns,const size_t rows)
5900</pre>
5901
5902<p>A description of each parameter follows:</p>
5903
5904<h5>wand</h5>
5905<p>the magick wand.</p>
5906
5907<h5>columns</h5>
5908<p>the number of columns in the scaled image.</p>
5909
5910<h5>rows</h5>
5911<p>the number of rows in the scaled image.</p>
5912
5913 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5914<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTintImage">MagickTintImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5915<div class="doc-section">
5916
5917<p>MagickTintImage() applies a color vector to each pixel in the image. The length of the vector is 0 for black and white and at its maximum for the midtones. The vector weighting function is f(x)=(1-(4.0*((x-0.5)*(x-0.5)))).</p>
5918
5919<p>The format of the MagickTintImage method is:</p>
5920
5921<pre class="code">
5922 MagickBooleanType MagickTintImage(MagickWand *wand,
5923 const PixelWand *tint,const PixelWand *opacity)
5924</pre>
5925
5926<p>A description of each parameter follows:</p>
5927
5928<h5>wand</h5>
5929<p>the magick wand.</p>
5930
5931<h5>tint</h5>
5932<p>the tint pixel wand.</p>
5933
5934<h5>opacity</h5>
5935<p>the opacity pixel wand.</p>
5936
5937 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5938<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTransformImage">MagickTransformImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5939<div class="doc-section">
5940
5941<p>MagickTransformImage() is a convenience method that behaves like MagickResizeImage() or MagickCropImage() but accepts scaling and/or cropping information as a region geometry specification. If the operation fails, a NULL image handle is returned.</p>
5942
5943<p>The format of the MagickTransformImage method is:</p>
5944
5945<pre class="code">
5946 MagickWand *MagickTransformImage(MagickWand *wand,const char *crop,
5947 const char *geometry)
5948</pre>
5949
5950<p>A description of each parameter follows:</p>
5951
5952<h5>wand</h5>
5953<p>the magick wand.</p>
5954
5955<h5>crop</h5>
5956<p>A crop geometry string. This geometry defines a subregion of the image to crop.</p>
5957
5958<h5>geometry</h5>
5959<p>An image geometry string. This geometry defines the final size of the image.</p>
5960
5961 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5962<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTransformImageColorspace">MagickTransformImageColorspace</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5963<div class="doc-section">
5964
5965<p>MagickTransformImageColorspace() transform the image colorspace.</p>
5966
5967<p>The format of the MagickTransformImageColorspace method is:</p>
5968
5969<pre class="code">
5970 MagickBooleanType MagickTransformImageColorspace(MagickWand *wand,
5971 const ColorspaceType colorspace)
5972</pre>
5973
5974<p>A description of each parameter follows:</p>
5975
5976<h5>wand</h5>
5977<p>the magick wand.</p>
5978
5979<h5>colorspace</h5>
5980<p>the image colorspace: UndefinedColorspace, RGBColorspace, GRAYColorspace, TransparentColorspace, OHTAColorspace, XYZColorspace, YCbCrColorspace, YCCColorspace, YIQColorspace, YPbPrColorspace, YPbPrColorspace, YUVColorspace, CMYKColorspace, sRGBColorspace, HSLColorspace, or HWBColorspace.</p>
5981
5982 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]5983<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTransparentPaintImage">MagickTransparentPaintImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]5984<div class="doc-section">
5985
5986<p>MagickTransparentPaintImage() changes any pixel that matches color with the color defined by fill.</p>
5987
5988<p>The format of the MagickTransparentPaintImage method is:</p>
5989
5990<pre class="code">
5991 MagickBooleanType MagickTransparentPaintImage(MagickWand *wand,
5992 const PixelWand *target,const double alpha,const double fuzz,
5993 const MagickBooleanType invert)
5994</pre>
5995
5996<p>A description of each parameter follows:</p>
5997
5998<h5>wand</h5>
5999<p>the magick wand.</p>
6000
6001<h5>target</h5>
6002<p>Change this target color to specified opacity value within the image.</p>
6003
6004<h5>alpha</h5>
6005<p>the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.</p>
6006
6007<h5>fuzz</h5>
6008<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p>
6009
6010<h5>invert</h5>
6011<p>paint any pixel that does not match the target color.</p>
6012
6013 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6014<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTransposeImage">MagickTransposeImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6015<div class="doc-section">
6016
6017<p>MagickTransposeImage() creates a vertical mirror image by reflecting the pixels around the central x-axis while rotating them 90-degrees.</p>
6018
6019<p>The format of the MagickTransposeImage method is:</p>
6020
6021<pre class="code">
6022 MagickBooleanType MagickTransposeImage(MagickWand *wand)
6023</pre>
6024
6025<p>A description of each parameter follows:</p>
6026
6027<h5>wand</h5>
6028<p>the magick wand.</p>
6029
6030 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6031<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTransverseImage">MagickTransverseImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6032<div class="doc-section">
6033
6034<p>MagickTransverseImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis while rotating them 270-degrees.</p>
6035
6036<p>The format of the MagickTransverseImage method is:</p>
6037
6038<pre class="code">
6039 MagickBooleanType MagickTransverseImage(MagickWand *wand)
6040</pre>
6041
6042<p>A description of each parameter follows:</p>
6043
6044<h5>wand</h5>
6045<p>the magick wand.</p>
6046
6047 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6048<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickTrimImage">MagickTrimImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6049<div class="doc-section">
6050
6051<p>MagickTrimImage() remove edges that are the background color from the image.</p>
6052
6053<p>The format of the MagickTrimImage method is:</p>
6054
6055<pre class="code">
6056 MagickBooleanType MagickTrimImage(MagickWand *wand,const double fuzz)
6057</pre>
6058
6059<p>A description of each parameter follows:</p>
6060
6061<h5>wand</h5>
6062<p>the magick wand.</p>
6063
6064<h5>fuzz</h5>
6065<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p>
6066
6067 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6068<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickUniqueImageColors">MagickUniqueImageColors</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6069<div class="doc-section">
6070
6071<p>MagickUniqueImageColors() discards all but one of any pixel color.</p>
6072
6073<p>The format of the MagickUniqueImageColors method is:</p>
6074
6075<pre class="code">
6076 MagickBooleanType MagickUniqueImageColors(MagickWand *wand)
6077</pre>
6078
6079<p>A description of each parameter follows:</p>
6080
6081<h5>wand</h5>
6082<p>the magick wand.</p>
6083
6084 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6085<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickUnsharpMaskImage">MagickUnsharpMaskImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6086<div class="doc-section">
6087
6088<p>MagickUnsharpMaskImage() sharpens an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and UnsharpMaskImage() selects a suitable radius for you.</p>
6089
6090<p>The format of the MagickUnsharpMaskImage method is:</p>
6091
6092<pre class="code">
6093 MagickBooleanType MagickUnsharpMaskImage(MagickWand *wand,
6094 const double radius,const double sigma,const double amount,
6095 const double threshold)
6096 MagickBooleanType MagickUnsharpMaskImageChannel(MagickWand *wand,
6097 const ChannelType channel,const double radius,const double sigma,
6098 const double amount,const double threshold)
6099</pre>
6100
6101<p>A description of each parameter follows:</p>
6102
6103<h5>wand</h5>
6104<p>the magick wand.</p>
6105
6106<h5>channel</h5>
6107<p>the image channel(s).</p>
6108
6109<h5>radius</h5>
6110<p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
6111
6112<h5>sigma</h5>
6113<p>the standard deviation of the Gaussian, in pixels.</p>
6114
6115<h5>amount</h5>
6116<p>the percentage of the difference between the original and the blur image that is added back into the original.</p>
6117
6118<h5>threshold</h5>
6119<p>the threshold in pixels needed to apply the diffence amount.</p>
6120
6121 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6122<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickVignetteImage">MagickVignetteImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6123<div class="doc-section">
6124
6125<p>MagickVignetteImage() softens the edges of the image in vignette style.</p>
6126
6127<p>The format of the MagickVignetteImage method is:</p>
6128
6129<pre class="code">
6130 MagickBooleanType MagickVignetteImage(MagickWand *wand,
6131 const double black_point,const double white_point,const ssize_t x,
6132 const ssize_t y)
6133</pre>
6134
6135<p>A description of each parameter follows:</p>
6136
6137<h5>wand</h5>
6138<p>the magick wand.</p>
6139
6140<h5>black_point</h5>
6141<p>the black point.</p>
6142
6143<h5>white_point</h5>
6144<p>the white point.</p>
6145
6146<h5>x, y</h5>
6147<p>Define the x and y ellipse offset.</p>
6148
6149 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6150<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWaveImage">MagickWaveImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6151<div class="doc-section">
6152
6153<p>MagickWaveImage() creates a "ripple" effect in the image by shifting the pixels vertically along a sine wave whose amplitude and wavelength is specified by the given parameters.</p>
6154
6155<p>The format of the MagickWaveImage method is:</p>
6156
6157<pre class="code">
6158 MagickBooleanType MagickWaveImage(MagickWand *wand,const double amplitude,
6159 const double wave_length)
6160</pre>
6161
6162<p>A description of each parameter follows:</p>
6163
6164<h5>wand</h5>
6165<p>the magick wand.</p>
6166
6167<h5>amplitude, wave_length</h5>
6168<p>Define the amplitude and wave length of the sine wave.</p>
6169
6170 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6171<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWhiteThresholdImage">MagickWhiteThresholdImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6172<div class="doc-section">
6173
6174<p>MagickWhiteThresholdImage() is like ThresholdImage() but force all pixels above the threshold into white while leaving all pixels below the threshold unchanged.</p>
6175
6176<p>The format of the MagickWhiteThresholdImage method is:</p>
6177
6178<pre class="code">
6179 MagickBooleanType MagickWhiteThresholdImage(MagickWand *wand,
6180 const PixelWand *threshold)
6181</pre>
6182
6183<p>A description of each parameter follows:</p>
6184
6185<h5>wand</h5>
6186<p>the magick wand.</p>
6187
6188<h5>threshold</h5>
6189<p>the pixel wand.</p>
6190
6191 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6192<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWriteImage">MagickWriteImage</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6193<div class="doc-section">
6194
6195<p>MagickWriteImage() writes an image to the specified filename. If the filename parameter is NULL, the image is written to the filename set by MagickReadImage() or MagickSetImageFilename().</p>
6196
6197<p>The format of the MagickWriteImage method is:</p>
6198
6199<pre class="code">
6200 MagickBooleanType MagickWriteImage(MagickWand *wand,
6201 const char *filename)
6202</pre>
6203
6204<p>A description of each parameter follows:</p>
6205
6206<h5>wand</h5>
6207<p>the magick wand.</p>
6208
6209<h5>filename</h5>
6210<p>the image filename.</p>
6211
6212
6213 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6214<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWriteImageFile">MagickWriteImageFile</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6215<div class="doc-section">
6216
6217<p>MagickWriteImageFile() writes an image to an open file descriptor.</p>
6218
6219<p>The format of the MagickWriteImageFile method is:</p>
6220
6221<pre class="code">
6222 MagickBooleanType MagickWriteImageFile(MagickWand *wand,FILE *file)
6223</pre>
6224
6225<p>A description of each parameter follows:</p>
6226
6227<h5>wand</h5>
6228<p>the magick wand.</p>
6229
6230<h5>file</h5>
6231<p>the file descriptor.</p>
6232
6233 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6234<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWriteImages">MagickWriteImages</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6235<div class="doc-section">
6236
6237<p>MagickWriteImages() writes an image or image sequence.</p>
6238
6239<p>The format of the MagickWriteImages method is:</p>
6240
6241<pre class="code">
6242 MagickBooleanType MagickWriteImages(MagickWand *wand,
6243 const char *filename,const MagickBooleanType adjoin)
6244</pre>
6245
6246<p>A description of each parameter follows:</p>
6247
6248<h5>wand</h5>
6249<p>the magick wand.</p>
6250
6251<h5>filename</h5>
6252<p>the image filename.</p>
6253
6254<h5>adjoin</h5>
6255<p>join images into a single multi-image file.</p>
6256
6257 </div>
cristy350dea42011-02-15 17:31:04 +0000[diff] [blame]6258<h2><a href="http://www.imagemagick.org/api/MagickWand/magick-image_8c.html" id="MagickWriteImagesFile">MagickWriteImagesFile</a></h2>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]6259<div class="doc-section">
6260
6261<p>MagickWriteImagesFile() writes an image sequence to an open file descriptor.</p>
6262
6263<p>The format of the MagickWriteImagesFile method is:</p>
6264
6265<pre class="code">
6266 MagickBooleanType MagickWriteImagesFile(MagickWand *wand,FILE *file)
6267</pre>
6268
6269<p>A description of each parameter follows:</p>
6270
6271<h5>wand</h5>
6272<p>the magick wand.</p>
6273
6274<h5>file</h5>
6275<p>the file descriptor.</p>
6276
6277 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6278
6279</div>
6280
6281<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]6282 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6283 <span id="linkbar-center">
6284 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]6285 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6286 </span>
6287 <span id="linkbar-east">&nbsp;</span>
6288 </div>
6289 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]6290 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6291 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
6292 </div>
6293 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]6294 <script type="text/javascript">
6295 var _gaq = _gaq || [];
6296 _gaq.push(['_setAccount', 'UA-17690367-1']);
6297 _gaq.push(['_trackPageview']);
6298
6299 (function() {
6300 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
6301 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
6302 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
6303 })();
6304 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6305</body>
6306</html>