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