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