Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 83a272ecd5c0a2f5dc501872d84d8f934c0dcc38 / . / www / api / fx.html
blob: 82ff21af922e12d2ba16cdbd1f1761c23e3c3c70 [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
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">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]52 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]53</div>
54<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]55 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]56</div>
57<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]58 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]59</div>
60<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]61 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]62</div>
63<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]64 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]65</div>
66<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]67 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]68</div>
69<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]70 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]71</div>
72<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]73 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]74</div>
75<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]76 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]77</div>
78<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]79 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]80</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]81<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]82<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]83 <a title="Install from Source" href="../../www/install-source.html">Install from Source</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="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</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="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90 </div>
91<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]92 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]93</div>
94<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]95 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]96</div>
97<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]98 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]99</div>
100<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]101 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]102</div>
103<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]104 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]105</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]106<div class="sep"></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-->
cristy2c2a4492010-03-16 15:06:03 +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 -->
cristyb4c03bb2009-09-27 13:55:46 +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>
144<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame^]145 <a title="Sponsor: Lampe Berger" href="http://www.geschenke-elsen.de/" title="Lampe Berger">Lampe Berger</a><!-- 20106101000040 -->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]149
150
151</div>
152
153<div class="main">
154
cristy0291e2d2010-04-04 17:50:18 +0000[diff] [blame]155<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]156
157<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
158_8c.html" target="source" name="AddNoiseImage">AddNoiseImage</a></h2>
159<div class="doc-section">
160
161<p>AddNoiseImage() adds random noise to the image.</p></ol>
162
163<p>The format of the AddNoiseImage method is:</p>
164
165<pre class="code">
166 Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
167 ExceptionInfo *exception)
168 Image *AddNoiseImageChannel(const Image *image,const ChannelType channel,
169 const NoiseType noise_type,ExceptionInfo *exception)
170</pre>
171
172<p>A description of each parameter follows:</p></ol>
173
174<h5>image</h5>
175<ol><p>the image.</p></ol>
176
177<h5>channel</h5>
178<ol><p>the channel type.</p></ol>
179
180<h5>noise_type</h5>
181<ol><p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p></ol>
182
183<h5>exception</h5>
184<ol><p>return any errors or warnings in this structure.</p></ol>
185
186 </div>
187<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
188_8c.html" target="source" name="BlueShiftImage">BlueShiftImage</a></h2>
189<div class="doc-section">
190
191<p>BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p></ol>
192
193<p>The format of the BlueShiftImage method is:</p>
194
195<pre class="code">
196 Image *BlueShiftImage(const Image *image,const double factor,
197 ExceptionInfo *exception)
198</pre>
199
200<p>A description of each parameter follows:</p></ol>
201
202<h5>image</h5>
203<ol><p>the image.</p></ol>
204
205<h5>factor</h5>
206<ol><p>the shift factor.</p></ol>
207
208<h5>exception</h5>
209<ol><p>return any errors or warnings in this structure.</p></ol>
210
211 </div>
212<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
213_8c.html" target="source" name="CharcoalImage">CharcoalImage</a></h2>
214<div class="doc-section">
215
216<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>
217
218<p>The format of the CharcoalImage method is:</p>
219
220<pre class="code">
221 Image *CharcoalImage(const Image *image,const double radius,
222 const double sigma,ExceptionInfo *exception)
223</pre>
224
225<p>A description of each parameter follows:</p></ol>
226
227<h5>image</h5>
228<ol><p>the image.</p></ol>
229
230<h5>radius</h5>
231<ol><p>the radius of the pixel neighborhood.</p></ol>
232
233<h5>sigma</h5>
234<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
235
236<h5>exception</h5>
237<ol><p>return any errors or warnings in this structure.</p></ol>
238
239 </div>
240<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
241_8c.html" target="source" name="ColorizeImage">ColorizeImage</a></h2>
242<div class="doc-section">
243
244<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>
245
246<p>The format of the ColorizeImage method is:</p>
247
248<pre class="code">
249 Image *ColorizeImage(const Image *image,const char *opacity,
250 const PixelPacket colorize,ExceptionInfo *exception)
251</pre>
252
253<p>A description of each parameter follows:</p></ol>
254
255<h5>image</h5>
256<ol><p>the image.</p></ol>
257
258<h5>opacity</h5>
259<ol><p>A character string indicating the level of opacity as a percentage.</p></ol>
260
261<h5>colorize</h5>
262<ol><p>A color value.</p></ol>
263
264<h5>exception</h5>
265<ol><p>return any errors or warnings in this structure.</p></ol>
266
267 </div>
268<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy0291e2d2010-04-04 17:50:18 +0000[diff] [blame]269_8c.html" target="source" name="ColorMatrixImage">ColorMatrixImage</a></h2>
270<div class="doc-section">
271
272<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>
273
274<p>The format of the ColorMatrixImage method is:</p>
275
276<pre class="code">
277 Image *ColorMatrixImage(const Image *image,
278 const KernelInfo *color_matrix,ExceptionInfo *exception)
279</pre>
280
281<p>A description of each parameter follows:</p></ol>
282
283<h5>image</h5>
284<ol><p>the image.</p></ol>
285
286<h5>color_matrix</h5>
287<ol><p>the color matrix.</p></ol>
288
289<h5>exception</h5>
290<ol><p>return any errors or warnings in this structure.</p></ol>
291
292 </div>
293<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]294_8c.html" target="source" name="FxImage">FxImage</a></h2>
295<div class="doc-section">
296
297<p>FxImage() applies a mathematical expression to the specified image.</p></ol>
298
299<p>The format of the FxImage method is:</p>
300
301<pre class="code">
302 Image *FxImage(const Image *image,const char *expression,
303 ExceptionInfo *exception)
304 Image *FxImageChannel(const Image *image,const ChannelType channel,
305 const char *expression,ExceptionInfo *exception)
306</pre>
307
308<p>A description of each parameter follows:</p></ol>
309
310<h5>image</h5>
311<ol><p>the image.</p></ol>
312
313<h5>channel</h5>
314<ol><p>the channel.</p></ol>
315
316<h5>expression</h5>
317<ol><p>A mathematical expression.</p></ol>
318
319<h5>exception</h5>
320<ol><p>return any errors or warnings in this structure.</p></ol>
321
322 </div>
323<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
324_8c.html" target="source" name="ImplodeImage">ImplodeImage</a></h2>
325<div class="doc-section">
326
327<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>
328
329<p>The format of the ImplodeImage method is:</p>
330
331<pre class="code">
332 Image *ImplodeImage(const Image *image,const double amount,
333 ExceptionInfo *exception)
334</pre>
335
336<p>A description of each parameter follows:</p></ol>
337
338<h5>implode_image</h5>
339<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>
340
341<h5>image</h5>
342<ol><p>the image.</p></ol>
343
344<h5>amount</h5>
345<ol><p>Define the extent of the implosion.</p></ol>
346
347<h5>exception</h5>
348<ol><p>return any errors or warnings in this structure.</p></ol>
349
350 </div>
351<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
352_8c.html" target="source" name="The MorphImages">The MorphImages</a></h2>
353<div class="doc-section">
354
355<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>
356
357<p>The format of the MorphImage method is:</p>
358
359<pre class="code">
360 Image *MorphImages(const Image *image,const unsigned long number_frames,
361 ExceptionInfo *exception)
362</pre>
363
364<p>A description of each parameter follows:</p></ol>
365
366<h5>image</h5>
367<ol><p>the image.</p></ol>
368
369<h5>number_frames</h5>
370<ol><p>Define the number of in-between image to generate. The more in-between frames, the smoother the morph.</p></ol>
371
372<h5>exception</h5>
373<ol><p>return any errors or warnings in this structure.</p></ol>
374
375 </div>
376<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
377_8c.html" target="source" name="PlasmaImage">PlasmaImage</a></h2>
378<div class="doc-section">
379
380<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>
381
382<p>The format of the PlasmaImage method is:</p>
383
384<pre class="code">
385 MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
386 unsigned long attenuate,unsigned long depth)
387</pre>
388
389<p>A description of each parameter follows:</p></ol>
390
391<h5>image</h5>
392<ol><p>the image.</p></ol>
393
394<h5>segment</h5>
395<ol><p> Define the region to apply plasma fractals values.</p></ol>
396
397<h5>attenuate</h5>
398<ol><p>Define the plasmattenuation factor.</p></ol>
399
400<h5>depth</h5>
401<ol><p>Limit the plasma recursion depth.</p></ol>
402
403 </div>
404<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
405_8c.html" target="source" name="PolaroidImage">PolaroidImage</a></h2>
406<div class="doc-section">
407
408<p>PolaroidImage() simulates a Polaroid picture.</p></ol>
409
410<p>The format of the AnnotateImage method is:</p>
411
412<pre class="code">
413 Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
414 const double angle,ExceptionInfo exception)
415</pre>
416
417<p>A description of each parameter follows:</p></ol>
418
419<h5>image</h5>
420<ol><p>the image.</p></ol>
421
422<h5>draw_info</h5>
423<ol><p>the draw info.</p></ol>
424
425<h5>angle</h5>
426<ol><p>Apply the effect along this angle.</p></ol>
427
428<h5>exception</h5>
429<ol><p>return any errors or warnings in this structure.</p></ol>
430
431 </div>
432<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]433_8c.html" target="source" name="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
434<div class="doc-section">
435
436<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>
437
438<p>The format of the SepiaToneImage method is:</p>
439
440<pre class="code">
441 Image *SepiaToneImage(const Image *image,const double threshold,
442 ExceptionInfo *exception)
443</pre>
444
445<p>A description of each parameter follows:</p></ol>
446
447<h5>image</h5>
448<ol><p>the image.</p></ol>
449
450<h5>threshold</h5>
451<ol><p>the tone threshold.</p></ol>
452
453<h5>exception</h5>
454<ol><p>return any errors or warnings in this structure.</p></ol>
455
456 </div>
457<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
458_8c.html" target="source" name="ShadowImage">ShadowImage</a></h2>
459<div class="doc-section">
460
461<p>ShadowImage() simulates a shadow from the specified image and returns it.</p></ol>
462
463<p>The format of the ShadowImage method is:</p>
464
465<pre class="code">
466 Image *ShadowImage(const Image *image,const double opacity,
467 const double sigma,const long x_offset,const long y_offset,
468 ExceptionInfo *exception)
469</pre>
470
471<p>A description of each parameter follows:</p></ol>
472
473<h5>image</h5>
474<ol><p>the image.</p></ol>
475
476<h5>opacity</h5>
477<ol><p>percentage transparency.</p></ol>
478
479<h5>sigma</h5>
480<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
481
482<h5>x_offset</h5>
483<ol><p>the shadow x-offset.</p></ol>
484
485<h5>y_offset</h5>
486<ol><p>the shadow y-offset.</p></ol>
487
488<h5>exception</h5>
489<ol><p>return any errors or warnings in this structure.</p></ol>
490
491 </div>
492<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
493_8c.html" target="source" name="SketchImage">SketchImage</a></h2>
494<div class="doc-section">
495
496<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>
497
498<p>The format of the SketchImage method is:</p>
499
500<pre class="code">
501 Image *SketchImage(const Image *image,const double radius,
502 const double sigma,const double angle,ExceptionInfo *exception)
503</pre>
504
505<p>A description of each parameter follows:</p></ol>
506
507<h5>image</h5>
508<ol><p>the image.</p></ol>
509
510<h5>radius</h5>
511<ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
512
513<h5>sigma</h5>
514<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
515
516<h5>angle</h5>
517<ol><p>Apply the effect along this angle.</p></ol>
518
519<h5>exception</h5>
520<ol><p>return any errors or warnings in this structure.</p></ol>
521
522 </div>
523<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
524_8c.html" target="source" name="SolarizeImage">SolarizeImage</a></h2>
525<div class="doc-section">
526
527<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>
528
529<p>The format of the SolarizeImage method is:</p>
530
531<pre class="code">
532 MagickBooleanType SolarizeImage(Image *image,const double threshold)
533</pre>
534
535<p>A description of each parameter follows:</p></ol>
536
537<h5>image</h5>
538<ol><p>the image.</p></ol>
539
540<h5>threshold</h5>
541<ol><p>Define the extent of the solarization.</p></ol>
542
543 </div>
544<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
545_8c.html" target="source" name="SteganoImage">SteganoImage</a></h2>
546<div class="doc-section">
547
548<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>
549
550<p>The format of the SteganoImage method is:</p>
551
552<pre class="code">
553 Image *SteganoImage(const Image *image,Image *watermark,
554 ExceptionInfo *exception)
555</pre>
556
557<p>A description of each parameter follows:</p></ol>
558
559<h5>image</h5>
560<ol><p>the image.</p></ol>
561
562<h5>watermark</h5>
563<ol><p>the watermark image.</p></ol>
564
565<h5>exception</h5>
566<ol><p>return any errors or warnings in this structure.</p></ol>
567
568 </div>
569<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
570_8c.html" target="source" name="StereoAnaglyphImage">StereoAnaglyphImage</a></h2>
571<div class="doc-section">
572
573<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>
574
575<p>The format of the StereoAnaglyphImage method is:</p>
576
577<pre class="code">
578 Image *StereoImage(const Image *left_image,const Image *right_image,
579 ExceptionInfo *exception)
580 Image *StereoAnaglyphImage(const Image *left_image,
581 const Image *right_image,const long x_offset,const long y_offset,
582 ExceptionInfo *exception)
583</pre>
584
585<p>A description of each parameter follows:</p></ol>
586
587<h5>left_image</h5>
588<ol><p>the left image.</p></ol>
589
590<h5>right_image</h5>
591<ol><p>the right image.</p></ol>
592
593<h5>exception</h5>
594<ol><p>return any errors or warnings in this structure.</p></ol>
595
596<h5>x_offset</h5>
597<ol><p>amount, in pixels, by which the left image is offset to the right of the right image.</p></ol>
598
599<h5>y_offset</h5>
600<ol><p>amount, in pixels, by which the left image is offset to the bottom of the right image.</p></ol>
601
602
603 </div>
604<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
605_8c.html" target="source" name="SwirlImage">SwirlImage</a></h2>
606<div class="doc-section">
607
608<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>
609
610<p>The format of the SwirlImage method is:</p>
611
612<pre class="code">
613 Image *SwirlImage(const Image *image,double degrees,
614 ExceptionInfo *exception)
615</pre>
616
617<p>A description of each parameter follows:</p></ol>
618
619<h5>image</h5>
620<ol><p>the image.</p></ol>
621
622<h5>degrees</h5>
623<ol><p>Define the tightness of the swirling effect.</p></ol>
624
625<h5>exception</h5>
626<ol><p>return any errors or warnings in this structure.</p></ol>
627
628 </div>
629<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
630_8c.html" target="source" name="TintImage">TintImage</a></h2>
631<div class="doc-section">
632
633<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>
634
635<p>The format of the TintImage method is:</p>
636
637<pre class="code">
638 Image *TintImage(const Image *image,const char *opacity,
639 const PixelPacket tint,ExceptionInfo *exception)
640</pre>
641
642<p>A description of each parameter follows:</p></ol>
643
644<h5>image</h5>
645<ol><p>the image.</p></ol>
646
647<h5>opacity</h5>
648<ol><p>A color value used for tinting.</p></ol>
649
650<h5>tint</h5>
651<ol><p>A color value used for tinting.</p></ol>
652
653<h5>exception</h5>
654<ol><p>return any errors or warnings in this structure.</p></ol>
655
656 </div>
657<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
658_8c.html" target="source" name="VignetteImage">VignetteImage</a></h2>
659<div class="doc-section">
660
661<p>VignetteImage() softens the edges of the image in vignette style.</p></ol>
662
663<p>The format of the VignetteImage method is:</p>
664
665<pre class="code">
666 Image *VignetteImage(const Image *image,const double radius,
667 const double sigma,const long x,const long y,ExceptionInfo *exception)
668</pre>
669
670<p>A description of each parameter follows:</p></ol>
671
672<h5>image</h5>
673<ol><p>the image.</p></ol>
674
675<h5>radius</h5>
676<ol><p>the radius of the pixel neighborhood.</p></ol>
677
678<h5>sigma</h5>
679<ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
680
681<h5>x, y</h5>
682<ol><p>Define the x and y ellipse offset.</p></ol>
683
684<h5>exception</h5>
685<ol><p>return any errors or warnings in this structure.</p></ol>
686
687 </div>
688<h2><a href="http://www.imagemagick.org/api/MagickCore/fx
689_8c.html" target="source" name="WaveImage">WaveImage</a></h2>
690<div class="doc-section">
691
692<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>
693
694<p>The format of the WaveImage method is:</p>
695
696<pre class="code">
697 Image *WaveImage(const Image *image,const double amplitude,
698 const double wave_length,ExceptionInfo *exception)
699</pre>
700
701<p>A description of each parameter follows:</p></ol>
702
703<h5>image</h5>
704<ol><p>the image.</p></ol>
705
706<h5>amplitude, wave_length</h5>
707<ol><p>Define the amplitude and wave length of the sine wave.</p></ol>
708
709<h5>exception</h5>
710<ol><p>return any errors or warnings in this structure.</p></ol>
711
712 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]713
714</div>
715
716<div id="linkbar">
717 <!-- <span id="linkbar-west">&nbsp;</span> -->
718 <span id="linkbar-center">
719 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristybebec402010-04-23 19:19:08 +0000[diff] [blame]720 <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]721 </span>
722 <span id="linkbar-east">&nbsp;</span>
723 </div>
724 <div class="footer">
725 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
726 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
727 </div>
728 <div style="clear: both; margin: 0; width: 100%; "></div>
729</body>
730</html>