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