granicus.if.org Git - imagemagick/blob - www/api/fx.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3 <html version="-//W3C//DTD XHTML 1.1//EN"
   4       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
   5       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   6       xsi:schemaLocation="http://www.w3.org/1999/xhtml
   7                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
   8 <head>
   9   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
  10   <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
  11   <title>ImageMagick: MagickCore, C API for ImageMagick: Add a Special Effect</title>
  12   <meta http-equiv="content-language" content="en-US"/>
  13   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
  14   <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
  15   <meta name="application-name" content="ImageMagick"/>
  16   <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images automagically."/>
  17   <meta name="application-url" content="http://www.imagemagick.org"/>
  18   <meta name="generator" content="PHP"/>
  19   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, add, a, special, effect, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
  20   <meta name="rating" content="GENERAL"/>
  21   <meta name="robots" content="INDEX, FOLLOW"/>
  22   <meta name="generator" content="ImageMagick Studio LLC"/>
  23   <meta name="author" content="ImageMagick Studio LLC"/>
  24   <meta name="revisit-after" content="2 DAYS"/>
  25   <meta name="resource-type" content="document"/>
  26   <meta name="copyright" content="Copyright (c) 1999-2013 ImageMagick Studio LLC"/>
  27   <meta name="distribution" content="Global"/>
  28   <link rel="icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.png"/>
  29   <link rel="shortcut icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.ico"  type="images/x-icon"/>
  30   <link rel="canonical" href="http://www.imagemagick.org" />
  31   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
  32   <!-- Add jQuery library -->
  33   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>
  34
  35   <!-- Optionaly include easing and/or mousewheel plugins -->
  36   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>
  37   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>
  38
  39   <!-- Add fancyBox -->
  40   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.4" type="text/css" media="screen" />
  41   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.4"></script>
  42
  43   <!-- Optionaly include button and/or thumbnail helpers -->
  44   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.4" type="text/css" media="screen" />
  45   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.4"></script>
  46
  47   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.4" type="text/css" media="screen" />
  48   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.4"></script>
  49   <script type="text/javascript">
  50         $(document).ready(function() {
  51                 $(".fancybox").fancybox();
  52         });
  53   </script>
  54   <!-- ImageMagick style -->
  55   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
  56   <style type="text/css" media="all">
  57     @import url("../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick.css");
  58   </style>
  59 </head>
  60
  61 <body id="www-imagemagick-org">
  62 <div class="titlebar">
  63 <div style="margin: 17px auto; float: left;">
  64   <script type="text/javascript">
  65   <!--
  66     google_ad_client = "pub-3129977114552745";
  67     google_ad_slot = "5439289906";
  68     google_ad_width = 728;
  69     google_ad_height = 90;
  70   //-->
  71   </script>
  72   <script type="text/javascript"
  73     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
  74   </script>
  75 </div>
  76 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">
  77   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/logo.jpg"
  78   alt="ImageMagick Logo"
  79   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
  80 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">
  81   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/sprite.jpg"
  82   alt="ImageMagick Sprite"
  83   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  84 </div>
  85
  86 <div class="westbar">
  87
  88 <div class="menu">
  89   <a title="About ImageMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">About ImageMagick</a>
  90 </div>
  91 <div class="menu">
  92   <a title="Binary Releases" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html">Binary Releases</a>
  93 </div>
  94 <div class="sub">
  95     <a title="Binary Release: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#unix">Unix</a>
  96 </div>
  97 <div class="sub">
  98     <a title="Binary Release: MacOS X" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#macosx">Mac OS X</a>
  99 </div>
 100 <div class="sub">
 101     <a title="Binary Release: iOS" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#iOS">iOS</a>
 102 </div>
 103 <div class="sub">
 104     <a title="Binary Release: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#windows">Windows</a>
 105 </div>
 106 <div class="sep"></div>
 107 <div class="menu">
 108   <a title="Command-line Tools" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-tools.html">Command-line Tools</a>
 109 </div>
 110 <div class="sub">
 111     <a title="Command-line Tools: Processing" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-processing.html">Processing</a>
 112 </div>
 113 <div class="sub">
 114     <a title="Command-line Tools: Options" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-options.html">Options</a>
 115 </div>
 116 <div class="sub">
 117     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 118 </div>
 119 <div class="menu">
 120   <a title="Program Interfaces" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/api.html">Program Interfaces</a>
 121 </div>
 122 <div class="sub">
 123     <a title="Program Interface: MagickWand" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-wand.html">MagickWand</a>
 124 </div>
 125 <div class="sub">
 126     <a title="Program Interface: MagickCore" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-core.html">MagickCore</a>
 127 </div>
 128 <div class="sub">
 129     <a title="Program Interface: PerlMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/perl-magick.html">PerlMagick</a>
 130 </div>
 131 <div class="sub">
 132     <a title="Program Interface: Magick++" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick++.html">Magick++</a>
 133 </div>
 134 <div class="sep"></div>
 135 <div  class="menu">
 136    <a title="Install from Source" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html">Install from Source</a>
 137 </div>
 138 <div class="sub">
 139     <a title="Install from Source: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#unix">Unix</a>
 140 </div>
 141 <div class="sub">
 142     <a title="Install from Source: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#windows">Windows</a>
 143  </div>
 144 <div class="menu">
 145   <a title="Resources" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/resources.html">Resources</a>
 146 </div>
 147 <div class="menu">
 148   <a title="Architecture" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/architecture.html">Architecture</a>
 149 </div>
 150 <div class="menu">
 151   <a title="Download" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/download.html">Download</a>
 152 </div>
 153 <div class="sep"></div>
 154 <div class="menu">
 155   <a title="Search" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/search.html">Search</a>
 156 </div>
 157 <div class="sep"></div>
 158 <div class="menu">
 159   <a title="Site Map" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sitemap.html">Site Map</a>
 160 </div>
 161 <div  class="sub">
 162   <a title="Site Map: Links" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/links.html">Links</a>
 163 </div>
 164 <div class="sep"></div>
 165 <div class="menu">
 166   <a rel="follow" title="Sponsors" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sponsors.html">Sponsors:</a>
 167
 168   <a href="http://www.networkredux.com"> <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
 169   <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201208010120 mickey@163... -->
 170 <div class="sponsbox">
 171 <div class="sponsor">
 172   <a rel="follow" title="Sponsor: The Fastest &amp; Easiest Way to Find Images" href="http://www.graphicsfactory.com">The Fastest &amp; Easiest Way to Find Images</a><!-- 201210010270 graphicsfac... -->
 173 </div>
 174 <div class="sponsor">
 175   <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201209010090 barsh@inter... -->
 176 </div>
 177 <div class="sponsor">
 178   <a rel="follow" title="Werbebanner Werbeplane" href="http://www.allesbanner.de">Werbebanner Werbeplane</a><!-- 201212010450 info@druck... -->
 179 </div>
 180 <div class="sponsor">
 181   <a rel="follow" title="Entertainment News &amp; Photos" href="http://www.zimbio.com">Entertainment News &amp; Photos</a><!-- 201211010540 bd@zimb... -->
 182 </div>
 183 <div class="sponsor">
 184   <a rel="follow" title="Sponsor: LED24" href="http://led24.de/">LED24</a><!-- 201207010270 info@led24... -->
 185 </div>
 186 <div class="sponsor">
 187   <a rel="follow" title="Sponsor: Best Website Hosting" href="http://www.top-cheap-web-hosting.com">Best Website Hosting</a><!-- 201304010090 eunge.liu-->
 188 </div>
 189 <div class="sponsor">
 190   <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201208010120 mickey@163... -->
 191 </div>
 192 <div class="sponsor">
 193   <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
 194 </div>
 195 <div class="sponsor">
 196    <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
 197 </div>
 198 <div class="sponsor">
 199    <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
 200 </div>
 201 <div class="sponsor">
 202   <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
 203 </div>
 204 <div class="sponsor">
 205   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 206 </div>
 207 <div  class="sponsor">
 208    <a rel="follow" title="Sponsor: Kaffeemaschinen reparatur" href="http://www.kaffeemaschinen-reparatur.de">Kaffeemaschinen reparatur</a><!-- 2012080100030 Temurbas atlas-multimedia-->
 209 </div>
 210 <div  class="sponsor">
 211    <a rel="follow" title="Sponsor: Fernsehdienst Berlin" href="http://www.atlas-multimedia.de">Fernsehdienst Berlin</a><!-- 2012080100030 atlas-multimedia-->
 212 </div>
 213 </div>
 214 </div>
 215 </div>
 216
 217 <div class="eastbar">
 218   <div class="g-plusone" id="gplusone"></div>
 219   <script type="text/javascript">
 220     window.___gcfg = {
 221       lang: 'en-US'
 222     };
 223
 224     (function() {
 225       var po = document.createElement('script');
 226       po.type = 'text/javascript'; po.async = true;
 227       po.src = 'https://apis.google.com/js/plusone.js';
 228       var script = document.getElementsByTagName('script')[0];
 229       script.parentNode.insertBefore(po, script);
 230     })();
 231     var gplusone = document.getElementById("gplusone");
 232     gplusone.setAttribute("data-size","medium");
 233     gplusone.setAttribute("data-count","false");
 234   </script>
 235 </div>
 236
 237 <div class="main">
 238
 239 <h1>Module fx Methods</h1>
 240 <p class="navigation-index">[<a href="fx.html#AddNoiseImage">AddNoiseImage</a> &bull; <a href="fx.html#BlueShiftImage">BlueShiftImage</a> &bull; <a href="fx.html#CharcoalImage">CharcoalImage</a> &bull; <a href="fx.html#ColorizeImage">ColorizeImage</a> &bull; <a href="fx.html#ColorMatrixImage">ColorMatrixImage</a> &bull; <a href="fx.html#FxImage">FxImage</a> &bull; <a href="fx.html#ImplodeImage">ImplodeImage</a> &bull; <a href="fx.html#The MorphImages">The MorphImages</a> &bull; <a href="fx.html#PlasmaImage">PlasmaImage</a> &bull; <a href="fx.html#PolaroidImage">PolaroidImage</a> &bull; <a href="fx.html#MagickSepiaToneImage">MagickSepiaToneImage</a> &bull; <a href="fx.html#ShadowImage">ShadowImage</a> &bull; <a href="fx.html#SketchImage">SketchImage</a> &bull; <a href="fx.html#SolarizeImage">SolarizeImage</a> &bull; <a href="fx.html#SteganoImage">SteganoImage</a> &bull; <a href="fx.html#StereoAnaglyphImage">StereoAnaglyphImage</a> &bull; <a href="fx.html#SwirlImage">SwirlImage</a> &bull; <a href="fx.html#TintImage">TintImage</a> &bull; <a href="fx.html#VignetteImage">VignetteImage</a> &bull; <a href="fx.html#WaveImage">WaveImage</a>]</p>
 241
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="AddNoiseImage">AddNoiseImage</a></h2>
 243 <div class="doc-section">
 244
 245 <p>AddNoiseImage() adds random noise to the image.</p>
 246
 247 <p>The format of the AddNoiseImage method is:</p>
 248
 249 <pre class="code">
 250   Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
 251     ExceptionInfo *exception)
 252   Image *AddNoiseImageChannel(const Image *image,const ChannelType channel,
 253     const NoiseType noise_type,ExceptionInfo *exception)
 254 </pre>
 255
 256 <p>A description of each parameter follows:</p>
 257
 258 <h5>image</h5>
 259 <p>the image.</p>
 260
 261 <h5>channel</h5>
 262 <p>the channel type.</p>
 263
 264 <h5>noise_type</h5>
 265 <p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p>
 266
 267 <h5>exception</h5>
 268 <p>return any errors or warnings in this structure.</p>
 269
 270  </div>
 271 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="BlueShiftImage">BlueShiftImage</a></h2>
 272 <div class="doc-section">
 273
 274 <p>BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p>
 275
 276 <p>The format of the BlueShiftImage method is:</p>
 277
 278 <pre class="code">
 279   Image *BlueShiftImage(const Image *image,const double factor,
 280     ExceptionInfo *exception)
 281 </pre>
 282
 283 <p>A description of each parameter follows:</p>
 284
 285 <h5>image</h5>
 286 <p>the image.</p>
 287
 288 <h5>factor</h5>
 289 <p>the shift factor.</p>
 290
 291 <h5>exception</h5>
 292 <p>return any errors or warnings in this structure.</p>
 293
 294  </div>
 295 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="CharcoalImage">CharcoalImage</a></h2>
 296 <div class="doc-section">
 297
 298 <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>
 299
 300 <p>The format of the CharcoalImage method is:</p>
 301
 302 <pre class="code">
 303   Image *CharcoalImage(const Image *image,const double radius,
 304     const double sigma,ExceptionInfo *exception)
 305 </pre>
 306
 307 <p>A description of each parameter follows:</p>
 308
 309 <h5>image</h5>
 310 <p>the image.</p>
 311
 312 <h5>radius</h5>
 313 <p>the radius of the pixel neighborhood.</p>
 314
 315 <h5>sigma</h5>
 316 <p>the standard deviation of the Gaussian, in pixels.</p>
 317
 318 <h5>exception</h5>
 319 <p>return any errors or warnings in this structure.</p>
 320
 321  </div>
 322 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="ColorizeImage">ColorizeImage</a></h2>
 323 <div class="doc-section">
 324
 325 <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>
 326
 327 <p>The format of the ColorizeImage method is:</p>
 328
 329 <pre class="code">
 330   Image *ColorizeImage(const Image *image,const char *opacity,
 331     const PixelPacket colorize,ExceptionInfo *exception)
 332 </pre>
 333
 334 <p>A description of each parameter follows:</p>
 335
 336 <h5>image</h5>
 337 <p>the image.</p>
 338
 339 <h5>opacity</h5>
 340 <p>A character string indicating the level of opacity as a percentage.</p>
 341
 342 <h5>colorize</h5>
 343 <p>A color value.</p>
 344
 345 <h5>exception</h5>
 346 <p>return any errors or warnings in this structure.</p>
 347
 348  </div>
 349 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="ColorMatrixImage">ColorMatrixImage</a></h2>
 350 <div class="doc-section">
 351
 352 <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>
 353
 354 <p>The format of the ColorMatrixImage method is:</p>
 355
 356 <pre class="code">
 357   Image *ColorMatrixImage(const Image *image,
 358     const KernelInfo *color_matrix,ExceptionInfo *exception)
 359 </pre>
 360
 361 <p>A description of each parameter follows:</p>
 362
 363 <h5>image</h5>
 364 <p>the image.</p>
 365
 366 <h5>color_matrix</h5>
 367 <p>the color matrix.</p>
 368
 369 <h5>exception</h5>
 370 <p>return any errors or warnings in this structure.</p>
 371
 372  </div>
 373 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="FxImage">FxImage</a></h2>
 374 <div class="doc-section">
 375
 376 <p>FxImage() applies a mathematical expression to the specified image.</p>
 377
 378 <p>The format of the FxImage method is:</p>
 379
 380 <pre class="code">
 381   Image *FxImage(const Image *image,const char *expression,
 382     ExceptionInfo *exception)
 383   Image *FxImageChannel(const Image *image,const ChannelType channel,
 384     const char *expression,ExceptionInfo *exception)
 385 </pre>
 386
 387 <p>A description of each parameter follows:</p>
 388
 389 <h5>image</h5>
 390 <p>the image.</p>
 391
 392 <h5>channel</h5>
 393 <p>the channel.</p>
 394
 395 <h5>expression</h5>
 396 <p>A mathematical expression.</p>
 397
 398 <h5>exception</h5>
 399 <p>return any errors or warnings in this structure.</p>
 400
 401  </div>
 402 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="ImplodeImage">ImplodeImage</a></h2>
 403 <div class="doc-section">
 404
 405 <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>
 406
 407 <p>The format of the ImplodeImage method is:</p>
 408
 409 <pre class="code">
 410   Image *ImplodeImage(const Image *image,const double amount,
 411     ExceptionInfo *exception)
 412 </pre>
 413
 414 <p>A description of each parameter follows:</p>
 415
 416 <h5>implode_image</h5>
 417 <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>
 418
 419 <h5>image</h5>
 420 <p>the image.</p>
 421
 422 <h5>amount</h5>
 423 <p>Define the extent of the implosion.</p>
 424
 425 <h5>exception</h5>
 426 <p>return any errors or warnings in this structure.</p>
 427
 428  </div>
 429 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="The_MorphImages">The MorphImages</a></h2>
 430 <div class="doc-section">
 431
 432 <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>
 433
 434 <p>The format of the MorphImage method is:</p>
 435
 436 <pre class="code">
 437   Image *MorphImages(const Image *image,const size_t number_frames,
 438     ExceptionInfo *exception)
 439 </pre>
 440
 441 <p>A description of each parameter follows:</p>
 442
 443 <h5>image</h5>
 444 <p>the image.</p>
 445
 446 <h5>number_frames</h5>
 447 <p>Define the number of in-between image to generate. The more in-between frames, the smoother the morph.</p>
 448
 449 <h5>exception</h5>
 450 <p>return any errors or warnings in this structure.</p>
 451
 452  </div>
 453 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="PlasmaImage">PlasmaImage</a></h2>
 454 <div class="doc-section">
 455
 456 <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>
 457
 458 <p>The format of the PlasmaImage method is:</p>
 459
 460 <pre class="code">
 461   MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
 462     size_t attenuate,size_t depth)
 463 </pre>
 464
 465 <p>A description of each parameter follows:</p>
 466
 467 <h5>image</h5>
 468 <p>the image.</p>
 469
 470 <h5>segment</h5>
 471 <p> Define the region to apply plasma fractals values.</p>
 472
 473 <h5>attenuate</h5>
 474 <p>Define the plasma attenuation factor.</p>
 475
 476 <h5>depth</h5>
 477 <p>Limit the plasma recursion depth.</p>
 478
 479  </div>
 480 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="PolaroidImage">PolaroidImage</a></h2>
 481 <div class="doc-section">
 482
 483 <p>PolaroidImage() simulates a Polaroid picture.</p>
 484
 485 <p>The format of the AnnotateImage method is:</p>
 486
 487 <pre class="code">
 488   Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
 489     const double angle,ExceptionInfo exception)
 490 </pre>
 491
 492 <p>A description of each parameter follows:</p>
 493
 494 <h5>image</h5>
 495 <p>the image.</p>
 496
 497 <h5>draw_info</h5>
 498 <p>the draw info.</p>
 499
 500 <h5>angle</h5>
 501 <p>Apply the effect along this angle.</p>
 502
 503 <h5>exception</h5>
 504 <p>return any errors or warnings in this structure.</p>
 505
 506  </div>
 507 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
 508 <div class="doc-section">
 509
 510 <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>
 511
 512 <p>The format of the SepiaToneImage method is:</p>
 513
 514 <pre class="code">
 515   Image *SepiaToneImage(const Image *image,const double threshold,
 516     ExceptionInfo *exception)
 517 </pre>
 518
 519 <p>A description of each parameter follows:</p>
 520
 521 <h5>image</h5>
 522 <p>the image.</p>
 523
 524 <h5>threshold</h5>
 525 <p>the tone threshold.</p>
 526
 527 <h5>exception</h5>
 528 <p>return any errors or warnings in this structure.</p>
 529
 530  </div>
 531 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="ShadowImage">ShadowImage</a></h2>
 532 <div class="doc-section">
 533
 534 <p>ShadowImage() simulates a shadow from the specified image and returns it.</p>
 535
 536 <p>The format of the ShadowImage method is:</p>
 537
 538 <pre class="code">
 539   Image *ShadowImage(const Image *image,const double opacity,
 540     const double sigma,const ssize_t x_offset,const ssize_t y_offset,
 541     ExceptionInfo *exception)
 542 </pre>
 543
 544 <p>A description of each parameter follows:</p>
 545
 546 <h5>image</h5>
 547 <p>the image.</p>
 548
 549 <h5>opacity</h5>
 550 <p>percentage transparency.</p>
 551
 552 <h5>sigma</h5>
 553 <p>the standard deviation of the Gaussian, in pixels.</p>
 554
 555 <h5>x_offset</h5>
 556 <p>the shadow x-offset.</p>
 557
 558 <h5>y_offset</h5>
 559 <p>the shadow y-offset.</p>
 560
 561 <h5>exception</h5>
 562 <p>return any errors or warnings in this structure.</p>
 563
 564  </div>
 565 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="SketchImage">SketchImage</a></h2>
 566 <div class="doc-section">
 567
 568 <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>
 569
 570 <p>The format of the SketchImage method is:</p>
 571
 572 <pre class="code">
 573       Image *SketchImage(const Image *image,const double radius,
 574   const double sigma,const double angle,ExceptionInfo *exception)
 575 </pre>
 576
 577 <p>A description of each parameter follows:</p>
 578
 579 <h5>image</h5>
 580 <p>the image.</p>
 581
 582 <h5>radius</h5>
 583 <p>the radius of the Gaussian, in pixels, not counting the center pixel.</p>
 584
 585 <h5>sigma</h5>
 586 <p>the standard deviation of the Gaussian, in pixels.</p>
 587
 588 <h5>angle</h5>
 589 <p>Apply the effect along this angle.</p>
 590
 591 <h5>exception</h5>
 592 <p>return any errors or warnings in this structure.</p>
 593
 594  </div>
 595 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="SolarizeImage">SolarizeImage</a></h2>
 596 <div class="doc-section">
 597
 598 <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>
 599
 600 <p>The format of the SolarizeImage method is:</p>
 601
 602 <pre class="code">
 603   MagickBooleanType SolarizeImage(Image *image,const double threshold)
 604 </pre>
 605
 606 <p>A description of each parameter follows:</p>
 607
 608 <h5>image</h5>
 609 <p>the image.</p>
 610
 611 <h5>threshold</h5>
 612 <p>Define the extent of the solarization.</p>
 613
 614  </div>
 615 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="SteganoImage">SteganoImage</a></h2>
 616 <div class="doc-section">
 617
 618 <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>
 619
 620 <p>The format of the SteganoImage method is:</p>
 621
 622 <pre class="code">
 623   Image *SteganoImage(const Image *image,Image *watermark,
 624     ExceptionInfo *exception)
 625 </pre>
 626
 627 <p>A description of each parameter follows:</p>
 628
 629 <h5>image</h5>
 630 <p>the image.</p>
 631
 632 <h5>watermark</h5>
 633 <p>the watermark image.</p>
 634
 635 <h5>exception</h5>
 636 <p>return any errors or warnings in this structure.</p>
 637
 638  </div>
 639 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="StereoAnaglyphImage">StereoAnaglyphImage</a></h2>
 640 <div class="doc-section">
 641
 642 <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>
 643
 644 <p>The format of the StereoAnaglyphImage method is:</p>
 645
 646 <pre class="code">
 647   Image *StereoImage(const Image *left_image,const Image *right_image,
 648     ExceptionInfo *exception)
 649   Image *StereoAnaglyphImage(const Image *left_image,
 650     const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
 651     ExceptionInfo *exception)
 652 </pre>
 653
 654 <p>A description of each parameter follows:</p>
 655
 656 <h5>left_image</h5>
 657 <p>the left image.</p>
 658
 659 <h5>right_image</h5>
 660 <p>the right image.</p>
 661
 662 <h5>exception</h5>
 663 <p>return any errors or warnings in this structure.</p>
 664
 665 <h5>x_offset</h5>
 666 <p>amount, in pixels, by which the left image is offset to the right of the right image.</p>
 667
 668 <h5>y_offset</h5>
 669 <p>amount, in pixels, by which the left image is offset to the bottom of the right image.</p>
 670
 671
 672  </div>
 673 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="SwirlImage">SwirlImage</a></h2>
 674 <div class="doc-section">
 675
 676 <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>
 677
 678 <p>The format of the SwirlImage method is:</p>
 679
 680 <pre class="code">
 681   Image *SwirlImage(const Image *image,double degrees,
 682     ExceptionInfo *exception)
 683 </pre>
 684
 685 <p>A description of each parameter follows:</p>
 686
 687 <h5>image</h5>
 688 <p>the image.</p>
 689
 690 <h5>degrees</h5>
 691 <p>Define the tightness of the swirling effect.</p>
 692
 693 <h5>exception</h5>
 694 <p>return any errors or warnings in this structure.</p>
 695
 696  </div>
 697 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="TintImage">TintImage</a></h2>
 698 <div class="doc-section">
 699
 700 <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>
 701
 702 <p>The format of the TintImage method is:</p>
 703
 704 <pre class="code">
 705   Image *TintImage(const Image *image,const char *opacity,
 706     const PixelPacket tint,ExceptionInfo *exception)
 707 </pre>
 708
 709 <p>A description of each parameter follows:</p>
 710
 711 <h5>image</h5>
 712 <p>the image.</p>
 713
 714 <h5>opacity</h5>
 715 <p>A color value used for tinting.</p>
 716
 717 <h5>tint</h5>
 718 <p>A color value used for tinting.</p>
 719
 720 <h5>exception</h5>
 721 <p>return any errors or warnings in this structure.</p>
 722
 723  </div>
 724 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="VignetteImage">VignetteImage</a></h2>
 725 <div class="doc-section">
 726
 727 <p>VignetteImage() softens the edges of the image in vignette style.</p>
 728
 729 <p>The format of the VignetteImage method is:</p>
 730
 731 <pre class="code">
 732   Image *VignetteImage(const Image *image,const double radius,
 733     const double sigma,const ssize_t x,const ssize_t y,ExceptionInfo *exception)
 734 </pre>
 735
 736 <p>A description of each parameter follows:</p>
 737
 738 <h5>image</h5>
 739 <p>the image.</p>
 740
 741 <h5>radius</h5>
 742 <p>the radius of the pixel neighborhood.</p>
 743
 744 <h5>sigma</h5>
 745 <p>the standard deviation of the Gaussian, in pixels.</p>
 746
 747 <h5>x, y</h5>
 748 <p>Define the x and y ellipse offset.</p>
 749
 750 <h5>exception</h5>
 751 <p>return any errors or warnings in this structure.</p>
 752
 753  </div>
 754 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx_8c.html" id="WaveImage">WaveImage</a></h2>
 755 <div class="doc-section">
 756
 757 <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>
 758
 759 <p>The format of the WaveImage method is:</p>
 760
 761 <pre class="code">
 762   Image *WaveImage(const Image *image,const double amplitude,
 763     const double wave_length,ExceptionInfo *exception)
 764 </pre>
 765
 766 <p>A description of each parameter follows:</p>
 767
 768 <h5>image</h5>
 769 <p>the image.</p>
 770
 771 <h5>amplitude, wave_length</h5>
 772 <p>Define the amplitude and wave length of the sine wave.</p>
 773
 774 <h5>exception</h5>
 775 <p>return any errors or warnings in this structure.</p>
 776
 777  </div>
 778
 779 </div>
 780
 781 <div id="linkbar">
 782     <span id="linkbar-west">&nbsp;</span>
 783     <span id="linkbar-center">
 784       <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">Discourse Server</a> &bull;
 785       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
 786     </span>
 787     <span id="linkbar-east">&nbsp;</span>
 788   </div>
 789   <div class="footer">
 790     <span id="footer-west">&copy; 1999-2013 ImageMagick Studio LLC</span>
 791     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
 792   </div>
 793   <div style="clear: both; margin: 0; width: 100%; "></div>
 794   <script type="text/javascript">
 795     var _gaq = _gaq || [];
 796     _gaq.push(['_setAccount', 'UA-17690367-1']);
 797     _gaq.push(['_trackPageview']);
 798
 799     (function() {
 800       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 801       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 802       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 803     })();
 804   </script>
 805 </body>
 806 </html>