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