Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 851dbceb0a51cbcd3ed512f074e9f2d797b7cbc1 / . / www / api / fx.html
blob: f8631cf21c77efb09c037c95a1b3aec536b3228c [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: MagickCore, C API for ImageMagick: Add a Special Effect</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="magickcore, c, api, for, imagemagick:, add, a, special, effect, 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
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]45<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]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">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame^]127 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
128</div>
129<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]130 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
cristy2c2a4492010-03-16 15:06:03 +0000[diff] [blame]131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]133 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy8f900122010-03-05 15:26:31 +0000[diff] [blame]134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]136 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy1f9e1ed2009-11-18 04:09:38 +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 -->
cristy916e1922009-10-01 12:52:47 +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>
cristya7cb4312010-06-26 00:47:03 +0000[diff] [blame]144<div class="sponsor">
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]145 <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
cristya7cb4312010-06-26 00:47:03 +0000[diff] [blame]146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]149</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]150
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]151<div class="eastbar">
152 <script type="text/javascript">
153 <!--
154 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]155 google_ad_slot = "0574824969";
156 google_ad_width = 160;
157 google_ad_height = 600;
158 //-->
159 </script>
160 <script type="text/javascript"
161 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
162 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]163</div>
164
165<div class="main">
166
cristy0291e2d2010-04-04 17:50:18 +0000[diff] [blame]167<p class="navigation-index">[<a href="#AddNoiseImage">AddNoiseImage</a> &bull; <a href="#BlueShiftImage">BlueShiftImage</a> &bull; <a href="#CharcoalImage">CharcoalImage</a> &bull; <a href="#ColorizeImage">ColorizeImage</a> &bull; <a href="#ColorMatrixImage">ColorMatrixImage</a> &bull; <a href="#FxImage">FxImage</a> &bull; <a href="#ImplodeImage">ImplodeImage</a> &bull; <a href="#The MorphImages">The MorphImages</a> &bull; <a href="#PlasmaImage">PlasmaImage</a> &bull; <a href="#PolaroidImage">PolaroidImage</a> &bull; <a href="#MagickSepiaToneImage">MagickSepiaToneImage</a> &bull; <a href="#ShadowImage">ShadowImage</a> &bull; <a href="#SketchImage">SketchImage</a> &bull; <a href="#SolarizeImage">SolarizeImage</a> &bull; <a href="#SteganoImage">SteganoImage</a> &bull; <a href="#StereoAnaglyphImage">StereoAnaglyphImage</a> &bull; <a href="#SwirlImage">SwirlImage</a> &bull; <a href="#TintImage">TintImage</a> &bull; <a href="#VignetteImage">VignetteImage</a> &bull; <a href="#WaveImage">WaveImage</a>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]168
169<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
170_8c.html" target="source" name="AddNoiseImage">AddNoiseImage</a></h2>
171<div class="doc-section">
172
173<p>AddNoiseImage() adds random noise to the image.</p></ol>
174
175<p>The format of the AddNoiseImage method is:</p>
176
177<pre class="code">
178 Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
179 ExceptionInfo *exception)
180 Image *AddNoiseImageChannel(const Image *image,const ChannelType channel,
181 const NoiseType noise_type,ExceptionInfo *exception)
182</pre>
183
184<p>A description of each parameter follows:</p></ol>
185
186<h5>image</h5>
187<ol><p>the image.</p></ol>
188
189<h5>channel</h5>
190<ol><p>the channel type.</p></ol>
191
192<h5>noise_type</h5>
193<ol><p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p></ol>
194
195<h5>exception</h5>
196<ol><p>return any errors or warnings in this structure.</p></ol>
197
198 </div>
199<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
200_8c.html" target="source" name="BlueShiftImage">BlueShiftImage</a></h2>
201<div class="doc-section">
202
203<p>BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p></ol>
204
205<p>The format of the BlueShiftImage method is:</p>
206
207<pre class="code">
208 Image *BlueShiftImage(const Image *image,const double factor,
209 ExceptionInfo *exception)
210</pre>
211
212<p>A description of each parameter follows:</p></ol>
213
214<h5>image</h5>
215<ol><p>the image.</p></ol>
216
217<h5>factor</h5>
218<ol><p>the shift factor.</p></ol>
219
220<h5>exception</h5>
221<ol><p>return any errors or warnings in this structure.</p></ol>
222
223 </div>
224<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
225_8c.html" target="source" name="CharcoalImage">CharcoalImage</a></h2>
226<div class="doc-section">
227
228<p>CharcoalImage() creates a new image that is a copy of an existing one with the edge highlighted. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p></ol>
229
230<p>The format of the CharcoalImage method is:</p>
231
232<pre class="code">
233 Image *CharcoalImage(const Image *image,const double radius,
234 const double sigma,ExceptionInfo *exception)
235</pre>
236
237<p>A description of each parameter follows:</p></ol>
238
239<h5>image</h5>
240<ol><p>the image.</p></ol>
241
242<h5>radius</h5>
243<ol><p>the radius of the pixel neighborhood.</p></ol>
244
245<h5>sigma</h5>
246<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
247
248<h5>exception</h5>
249<ol><p>return any errors or warnings in this structure.</p></ol>
250
251 </div>
252<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
253_8c.html" target="source" name="ColorizeImage">ColorizeImage</a></h2>
254<div class="doc-section">
255
256<p>ColorizeImage() blends the fill color with each pixel in the image. A percentage blend is specified with opacity. Control the application of different color components by specifying a different percentage for each component (e.g. 90/100/10 is 90 red, 100 green, and 10 blue).</p></ol>
257
258<p>The format of the ColorizeImage method is:</p>
259
260<pre class="code">
261 Image *ColorizeImage(const Image *image,const char *opacity,
262 const PixelPacket colorize,ExceptionInfo *exception)
263</pre>
264
265<p>A description of each parameter follows:</p></ol>
266
267<h5>image</h5>
268<ol><p>the image.</p></ol>
269
270<h5>opacity</h5>
271<ol><p>A character string indicating the level of opacity as a percentage.</p></ol>
272
273<h5>colorize</h5>
274<ol><p>A color value.</p></ol>
275
276<h5>exception</h5>
277<ol><p>return any errors or warnings in this structure.</p></ol>
278
279 </div>
280<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy0291e2d2010-04-04 17:50:18 +0000[diff] [blame]281_8c.html" target="source" name="ColorMatrixImage">ColorMatrixImage</a></h2>
282<div class="doc-section">
283
284<p>ColorMatrixImage() applies color transformation to an image. This 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>
285
286<p>The format of the ColorMatrixImage method is:</p>
287
288<pre class="code">
289 Image *ColorMatrixImage(const Image *image,
290 const KernelInfo *color_matrix,ExceptionInfo *exception)
291</pre>
292
293<p>A description of each parameter follows:</p></ol>
294
295<h5>image</h5>
296<ol><p>the image.</p></ol>
297
298<h5>color_matrix</h5>
299<ol><p>the color matrix.</p></ol>
300
301<h5>exception</h5>
302<ol><p>return any errors or warnings in this structure.</p></ol>
303
304 </div>
305<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]306_8c.html" target="source" name="FxImage">FxImage</a></h2>
307<div class="doc-section">
308
309<p>FxImage() applies a mathematical expression to the specified image.</p></ol>
310
311<p>The format of the FxImage method is:</p>
312
313<pre class="code">
314 Image *FxImage(const Image *image,const char *expression,
315 ExceptionInfo *exception)
316 Image *FxImageChannel(const Image *image,const ChannelType channel,
317 const char *expression,ExceptionInfo *exception)
318</pre>
319
320<p>A description of each parameter follows:</p></ol>
321
322<h5>image</h5>
323<ol><p>the image.</p></ol>
324
325<h5>channel</h5>
326<ol><p>the channel.</p></ol>
327
328<h5>expression</h5>
329<ol><p>A mathematical expression.</p></ol>
330
331<h5>exception</h5>
332<ol><p>return any errors or warnings in this structure.</p></ol>
333
334 </div>
335<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
336_8c.html" target="source" name="ImplodeImage">ImplodeImage</a></h2>
337<div class="doc-section">
338
339<p>ImplodeImage() 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>
340
341<p>The format of the ImplodeImage method is:</p>
342
343<pre class="code">
344 Image *ImplodeImage(const Image *image,const double amount,
345 ExceptionInfo *exception)
346</pre>
347
348<p>A description of each parameter follows:</p></ol>
349
350<h5>implode_image</h5>
351<ol><p>Method ImplodeImage returns a pointer to the image after it is implode. A null image is returned if there is a memory shortage.</p></ol>
352
353<h5>image</h5>
354<ol><p>the image.</p></ol>
355
356<h5>amount</h5>
357<ol><p>Define the extent of the implosion.</p></ol>
358
359<h5>exception</h5>
360<ol><p>return any errors or warnings in this structure.</p></ol>
361
362 </div>
363<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
364_8c.html" target="source" name="The MorphImages">The MorphImages</a></h2>
365<div class="doc-section">
366
367<p>The MorphImages() method requires a minimum of two images. The first image is transformed into the second by a number of intervening images as specified by frames.</p></ol>
368
369<p>The format of the MorphImage method is:</p>
370
371<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]372 Image *MorphImages(const Image *image,const size_t number_frames,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]373 ExceptionInfo *exception)
374</pre>
375
376<p>A description of each parameter follows:</p></ol>
377
378<h5>image</h5>
379<ol><p>the image.</p></ol>
380
381<h5>number_frames</h5>
382<ol><p>Define the number of in-between image to generate. The more in-between frames, the smoother the morph.</p></ol>
383
384<h5>exception</h5>
385<ol><p>return any errors or warnings in this structure.</p></ol>
386
387 </div>
388<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
389_8c.html" target="source" name="PlasmaImage">PlasmaImage</a></h2>
390<div class="doc-section">
391
392<p>PlasmaImage() initializes an image with plasma fractal values. The image must be initialized with a base color and the random number generator seeded before this method is called.</p></ol>
393
394<p>The format of the PlasmaImage method is:</p>
395
396<pre class="code">
397 MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]398 size_t attenuate,size_t depth)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]399</pre>
400
401<p>A description of each parameter follows:</p></ol>
402
403<h5>image</h5>
404<ol><p>the image.</p></ol>
405
406<h5>segment</h5>
407<ol><p> Define the region to apply plasma fractals values.</p></ol>
408
409<h5>attenuate</h5>
410<ol><p>Define the plasmattenuation factor.</p></ol>
411
412<h5>depth</h5>
413<ol><p>Limit the plasma recursion depth.</p></ol>
414
415 </div>
416<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
417_8c.html" target="source" name="PolaroidImage">PolaroidImage</a></h2>
418<div class="doc-section">
419
420<p>PolaroidImage() simulates a Polaroid picture.</p></ol>
421
422<p>The format of the AnnotateImage method is:</p>
423
424<pre class="code">
425 Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
426 const double angle,ExceptionInfo exception)
427</pre>
428
429<p>A description of each parameter follows:</p></ol>
430
431<h5>image</h5>
432<ol><p>the image.</p></ol>
433
434<h5>draw_info</h5>
435<ol><p>the draw info.</p></ol>
436
437<h5>angle</h5>
cristyeaedf062010-05-29 22:36:02 +0000[diff] [blame]438<ol><p>Apply the effect along this angle.</p></ol>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]439
440<h5>exception</h5>
441<ol><p>return any errors or warnings in this structure.</p></ol>
442
443 </div>
444<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]445_8c.html" target="source" name="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
446<div class="doc-section">
447
448<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>
449
450<p>The format of the SepiaToneImage method is:</p>
451
452<pre class="code">
453 Image *SepiaToneImage(const Image *image,const double threshold,
454 ExceptionInfo *exception)
455</pre>
456
457<p>A description of each parameter follows:</p></ol>
458
459<h5>image</h5>
460<ol><p>the image.</p></ol>
461
462<h5>threshold</h5>
463<ol><p>the tone threshold.</p></ol>
464
465<h5>exception</h5>
466<ol><p>return any errors or warnings in this structure.</p></ol>
467
468 </div>
469<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
470_8c.html" target="source" name="ShadowImage">ShadowImage</a></h2>
471<div class="doc-section">
472
473<p>ShadowImage() simulates a shadow from the specified image and returns it.</p></ol>
474
475<p>The format of the ShadowImage method is:</p>
476
477<pre class="code">
478 Image *ShadowImage(const Image *image,const double opacity,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]479 const double sigma,const ssize_t x_offset,const ssize_t y_offset,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]480 ExceptionInfo *exception)
481</pre>
482
483<p>A description of each parameter follows:</p></ol>
484
485<h5>image</h5>
486<ol><p>the image.</p></ol>
487
488<h5>opacity</h5>
489<ol><p>percentage transparency.</p></ol>
490
491<h5>sigma</h5>
492<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
493
494<h5>x_offset</h5>
495<ol><p>the shadow x-offset.</p></ol>
496
497<h5>y_offset</h5>
498<ol><p>the shadow y-offset.</p></ol>
499
500<h5>exception</h5>
501<ol><p>return any errors or warnings in this structure.</p></ol>
502
503 </div>
504<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
505_8c.html" target="source" name="SketchImage">SketchImage</a></h2>
506<div class="doc-section">
507
508<p>SketchImage() 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 sketch.</p></ol>
509
510<p>The format of the SketchImage method is:</p>
511
512<pre class="code">
513 Image *SketchImage(const Image *image,const double radius,
514 const double sigma,const double angle,ExceptionInfo *exception)
515</pre>
516
517<p>A description of each parameter follows:</p></ol>
518
519<h5>image</h5>
520<ol><p>the image.</p></ol>
521
522<h5>radius</h5>
523<ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
524
525<h5>sigma</h5>
526<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
527
528<h5>angle</h5>
cristyeaedf062010-05-29 22:36:02 +0000[diff] [blame]529<ol><p>Apply the effect along this angle.</p></ol>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]530
531<h5>exception</h5>
532<ol><p>return any errors or warnings in this structure.</p></ol>
533
534 </div>
535<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
536_8c.html" target="source" name="SolarizeImage">SolarizeImage</a></h2>
537<div class="doc-section">
538
539<p>SolarizeImage() 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>
540
541<p>The format of the SolarizeImage method is:</p>
542
543<pre class="code">
544 MagickBooleanType SolarizeImage(Image *image,const double threshold)
545</pre>
546
547<p>A description of each parameter follows:</p></ol>
548
549<h5>image</h5>
550<ol><p>the image.</p></ol>
551
552<h5>threshold</h5>
553<ol><p>Define the extent of the solarization.</p></ol>
554
555 </div>
556<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
557_8c.html" target="source" name="SteganoImage">SteganoImage</a></h2>
558<div class="doc-section">
559
560<p>SteganoImage() 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>
561
562<p>The format of the SteganoImage method is:</p>
563
564<pre class="code">
565 Image *SteganoImage(const Image *image,Image *watermark,
566 ExceptionInfo *exception)
567</pre>
568
569<p>A description of each parameter follows:</p></ol>
570
571<h5>image</h5>
572<ol><p>the image.</p></ol>
573
574<h5>watermark</h5>
575<ol><p>the watermark image.</p></ol>
576
577<h5>exception</h5>
578<ol><p>return any errors or warnings in this structure.</p></ol>
579
580 </div>
581<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
582_8c.html" target="source" name="StereoAnaglyphImage">StereoAnaglyphImage</a></h2>
583<div class="doc-section">
584
585<p>StereoAnaglyphImage() combines two images and produces a single image that is the composite of a left and right image of a stereo pair. Special red-green stereo glasses are required to view this effect.</p></ol>
586
587<p>The format of the StereoAnaglyphImage method is:</p>
588
589<pre class="code">
590 Image *StereoImage(const Image *left_image,const Image *right_image,
591 ExceptionInfo *exception)
592 Image *StereoAnaglyphImage(const Image *left_image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]593 const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]594 ExceptionInfo *exception)
595</pre>
596
597<p>A description of each parameter follows:</p></ol>
598
599<h5>left_image</h5>
600<ol><p>the left image.</p></ol>
601
602<h5>right_image</h5>
603<ol><p>the right image.</p></ol>
604
605<h5>exception</h5>
606<ol><p>return any errors or warnings in this structure.</p></ol>
607
608<h5>x_offset</h5>
609<ol><p>amount, in pixels, by which the left image is offset to the right of the right image.</p></ol>
610
611<h5>y_offset</h5>
612<ol><p>amount, in pixels, by which the left image is offset to the bottom of the right image.</p></ol>
613
614
615 </div>
616<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
617_8c.html" target="source" name="SwirlImage">SwirlImage</a></h2>
618<div class="doc-section">
619
620<p>SwirlImage() 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>
621
622<p>The format of the SwirlImage method is:</p>
623
624<pre class="code">
625 Image *SwirlImage(const Image *image,double degrees,
626 ExceptionInfo *exception)
627</pre>
628
629<p>A description of each parameter follows:</p></ol>
630
631<h5>image</h5>
632<ol><p>the image.</p></ol>
633
634<h5>degrees</h5>
635<ol><p>Define the tightness of the swirling effect.</p></ol>
636
637<h5>exception</h5>
638<ol><p>return any errors or warnings in this structure.</p></ol>
639
640 </div>
641<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
642_8c.html" target="source" name="TintImage">TintImage</a></h2>
643<div class="doc-section">
644
645<p>TintImage() 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>
646
647<p>The format of the TintImage method is:</p>
648
649<pre class="code">
650 Image *TintImage(const Image *image,const char *opacity,
651 const PixelPacket tint,ExceptionInfo *exception)
652</pre>
653
654<p>A description of each parameter follows:</p></ol>
655
656<h5>image</h5>
657<ol><p>the image.</p></ol>
658
659<h5>opacity</h5>
660<ol><p>A color value used for tinting.</p></ol>
661
662<h5>tint</h5>
663<ol><p>A color value used for tinting.</p></ol>
664
665<h5>exception</h5>
666<ol><p>return any errors or warnings in this structure.</p></ol>
667
668 </div>
669<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
670_8c.html" target="source" name="VignetteImage">VignetteImage</a></h2>
671<div class="doc-section">
672
673<p>VignetteImage() softens the edges of the image in vignette style.</p></ol>
674
675<p>The format of the VignetteImage method is:</p>
676
677<pre class="code">
678 Image *VignetteImage(const Image *image,const double radius,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]679 const double sigma,const ssize_t x,const ssize_t y,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]680</pre>
681
682<p>A description of each parameter follows:</p></ol>
683
684<h5>image</h5>
685<ol><p>the image.</p></ol>
686
687<h5>radius</h5>
688<ol><p>the radius of the pixel neighborhood.</p></ol>
689
690<h5>sigma</h5>
691<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
692
693<h5>x, y</h5>
694<ol><p>Define the x and y ellipse offset.</p></ol>
695
696<h5>exception</h5>
697<ol><p>return any errors or warnings in this structure.</p></ol>
698
699 </div>
700<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
701_8c.html" target="source" name="WaveImage">WaveImage</a></h2>
702<div class="doc-section">
703
cristyeaedf062010-05-29 22:36:02 +0000[diff] [blame]704<p>WaveImage() 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]705
706<p>The format of the WaveImage method is:</p>
707
708<pre class="code">
709 Image *WaveImage(const Image *image,const double amplitude,
710 const double wave_length,ExceptionInfo *exception)
711</pre>
712
713<p>A description of each parameter follows:</p></ol>
714
715<h5>image</h5>
716<ol><p>the image.</p></ol>
717
718<h5>amplitude, wave_length</h5>
719<ol><p>Define the amplitude and wave length of the sine wave.</p></ol>
720
721<h5>exception</h5>
722<ol><p>return any errors or warnings in this structure.</p></ol>
723
724 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]725
726</div>
727
728<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]729 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]730 <span id="linkbar-center">
731 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]732 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]733 </span>
734 <span id="linkbar-east">&nbsp;</span>
735 </div>
736 <div class="footer">
737 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
738 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
739 </div>
740 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]741 <script type="text/javascript">
742 var _gaq = _gaq || [];
743 _gaq.push(['_setAccount', 'UA-17690367-1']);
744 _gaq.push(['_trackPageview']);
745
746 (function() {
747 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
748 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
749 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
750 })();
751 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]752</body>
753</html>