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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
   4 <head>\r
   5   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>\r
   6   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   7   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   8   <style type="text/css" media="all">\r
   9     @import url("../../www/magick.css");\r
  10   </style>\r
  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"/>
  25   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  26   <meta name="Distribution" content="Global"/>
  27 </head>\r
  28 \r
  29 <body id="www-imagemagick-org">\r
  30 <div class="titlebar">\r
  31 <a href="../../index.html">\r
  32   <img src="../../images/script.png" alt="[ImageMagick]"\r
  33   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  34 <a href="http://www.networkredux.com">\r
  35   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  36   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  37 <a href="http://www.imagemagick.org/discourse-server/">\r
  38   <img src="../../images/logo.jpg" alt=""\r
  39   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  40 <a href="../../index.html">\r
  41   <img src="../../images/sprite.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 </div>\r
  44 \r
  45 <div class="westbar">\r
  46 \r
  47 <div class="menu">
  48   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  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>\r
  64 <div class="menu">
  65   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  66 </div>
  67 <div class="sub">
  68     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  69 </div>
  70 <div class="sub">
  71     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  72 </div>
  73 <div class="sub">
  74     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  75 </div>
  76 <div class="menu">
  77   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  78 </div>
  79 <div class="sub">
  80     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  81 </div>
  82 <div class="sub">
  83     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  90 </div>
  91 <div class="sep"></div>\r
  92 <div  class="menu">
  93    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  94 </div>
  95 <div class="sub">
  96     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 100  </div>
 101 <div class="menu">
 102   <a title="Resources" href="../../www/resources.html">Resources</a>
 103 </div>
 104 <div class="menu">
 105   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 106 </div>
 107 <div class="menu">
 108   <a title="Download" href="../../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 128 </div>
 129 <div  class="sponsor">
 130   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 140 </div>
 141 <div  class="sponsor">
 142    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 143 </div>
 144 <div  class="sponsor">
 145    <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
 146 </div>
 147 </div>
 148 </div>
 149 </div>\r
 150 \r
 151 <div class="eastbar">\r
 152   <script type="text/javascript">\r
 153   <!--\r
 154     google_ad_client = "pub-3129977114552745";\r
 155     google_ad_slot = "0574824969";\r
 156     google_ad_width = 160;\r
 157     google_ad_height = 600;\r
 158   //-->\r
 159   </script>\r
 160   <script type="text/javascript"\r
 161     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 162   </script>\r
 163 </div>\r
 164 \r
 165 <div class="main">\r
 166 \r
 167 <p class="navigation-index">[<a href="#AddNoiseImage">AddNoiseImage</a> &bull; <a href="#BlueShiftImage">BlueShiftImage</a> &bull; <a href="#CharcoalImage">CharcoalImage</a> &bull; <a href="#ColorizeImage">ColorizeImage</a> &bull; <a href="#ColorMatrixImage">ColorMatrixImage</a> &bull; <a href="#FxImage">FxImage</a> &bull; <a href="#ImplodeImage">ImplodeImage</a> &bull; <a href="#The MorphImages">The MorphImages</a> &bull; <a href="#PlasmaImage">PlasmaImage</a> &bull; <a href="#PolaroidImage">PolaroidImage</a> &bull; <a href="#MagickSepiaToneImage">MagickSepiaToneImage</a> &bull; <a href="#ShadowImage">ShadowImage</a> &bull; <a href="#SketchImage">SketchImage</a> &bull; <a href="#SolarizeImage">SolarizeImage</a> &bull; <a href="#SteganoImage">SteganoImage</a> &bull; <a href="#StereoAnaglyphImage">StereoAnaglyphImage</a> &bull; <a href="#SwirlImage">SwirlImage</a> &bull; <a href="#TintImage">TintImage</a> &bull; <a href="#VignetteImage">VignetteImage</a> &bull; <a href="#WaveImage">WaveImage</a>]</p>
 168
 169 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 170 _8c.html" target="source" name="AddNoiseImage">AddNoiseImage</a></h2>
 171 <div class="doc-section">
 172
 173 <p>AddNoiseImage() adds random noise to the image.</p></ol>
 174
 175 <p>The format of the AddNoiseImage method is:</p>
 176
 177 <pre class="code">
 178   Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
 179     ExceptionInfo *exception)
 180   Image *AddNoiseImageChannel(const Image *image,const ChannelType channel,
 181     const NoiseType noise_type,ExceptionInfo *exception)
 182 </pre>
 183
 184 <p>A description of each parameter follows:</p></ol>
 185
 186 <h5>image</h5>
 187 <ol><p>the image.</p></ol>
 188
 189 <h5>channel</h5>
 190 <ol><p>the channel type.</p></ol>
 191
 192 <h5>noise_type</h5>
 193 <ol><p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p></ol>
 194
 195 <h5>exception</h5>
 196 <ol><p>return any errors or warnings in this structure.</p></ol>
 197
 198  </div>
 199 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 200 _8c.html" target="source" name="BlueShiftImage">BlueShiftImage</a></h2>
 201 <div class="doc-section">
 202
 203 <p>BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p></ol>
 204
 205 <p>The format of the BlueShiftImage method is:</p>
 206
 207 <pre class="code">
 208   Image *BlueShiftImage(const Image *image,const double factor,
 209     ExceptionInfo *exception)
 210 </pre>
 211
 212 <p>A description of each parameter follows:</p></ol>
 213
 214 <h5>image</h5>
 215 <ol><p>the image.</p></ol>
 216
 217 <h5>factor</h5>
 218 <ol><p>the shift factor.</p></ol>
 219
 220 <h5>exception</h5>
 221 <ol><p>return any errors or warnings in this structure.</p></ol>
 222
 223  </div>
 224 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 225 _8c.html" target="source" name="CharcoalImage">CharcoalImage</a></h2>
 226 <div class="doc-section">
 227
 228 <p>CharcoalImage() creates a new image that is a copy of an existing one with the edge highlighted.  It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p></ol>
 229
 230 <p>The format of the CharcoalImage method is:</p>
 231
 232 <pre class="code">
 233   Image *CharcoalImage(const Image *image,const double radius,
 234     const double sigma,ExceptionInfo *exception)
 235 </pre>
 236
 237 <p>A description of each parameter follows:</p></ol>
 238
 239 <h5>image</h5>
 240 <ol><p>the image.</p></ol>
 241
 242 <h5>radius</h5>
 243 <ol><p>the radius of the pixel neighborhood.</p></ol>
 244
 245 <h5>sigma</h5>
 246 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 247
 248 <h5>exception</h5>
 249 <ol><p>return any errors or warnings in this structure.</p></ol>
 250
 251  </div>
 252 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 253 _8c.html" target="source" name="ColorizeImage">ColorizeImage</a></h2>
 254 <div class="doc-section">
 255
 256 <p>ColorizeImage() blends the fill color with each pixel in the image. A percentage blend is specified with opacity.  Control the application of different color components by specifying a different percentage for each component (e.g. 90/100/10 is 90 red, 100 green, and 10 blue).</p></ol>
 257
 258 <p>The format of the ColorizeImage method is:</p>
 259
 260 <pre class="code">
 261   Image *ColorizeImage(const Image *image,const char *opacity,
 262     const PixelPacket colorize,ExceptionInfo *exception)
 263 </pre>
 264
 265 <p>A description of each parameter follows:</p></ol>
 266
 267 <h5>image</h5>
 268 <ol><p>the image.</p></ol>
 269
 270 <h5>opacity</h5>
 271 <ol><p>A character string indicating the level of opacity as a percentage.</p></ol>
 272
 273 <h5>colorize</h5>
 274 <ol><p>A color value.</p></ol>
 275
 276 <h5>exception</h5>
 277 <ol><p>return any errors or warnings in this structure.</p></ol>
 278
 279  </div>
 280 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 281 _8c.html" target="source" name="ColorMatrixImage">ColorMatrixImage</a></h2>
 282 <div class="doc-section">
 283
 284 <p>ColorMatrixImage() applies color transformation to an image. This method permits saturation changes, hue rotation, luminance to alpha, and various other effects.  Although variable-sized transformation matrices can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA (or RGBA with offsets).  The matrix is similar to those used by Adobe Flash except offsets are in column 6 rather than 5 (in support of CMYKA images) and offsets are normalized (divide Flash offset by 255).</p></ol>
 285
 286 <p>The format of the ColorMatrixImage method is:</p>
 287
 288 <pre class="code">
 289   Image *ColorMatrixImage(const Image *image,
 290     const KernelInfo *color_matrix,ExceptionInfo *exception)
 291 </pre>
 292
 293 <p>A description of each parameter follows:</p></ol>
 294
 295 <h5>image</h5>
 296 <ol><p>the image.</p></ol>
 297
 298 <h5>color_matrix</h5>
 299 <ol><p>the color matrix.</p></ol>
 300
 301 <h5>exception</h5>
 302 <ol><p>return any errors or warnings in this structure.</p></ol>
 303
 304  </div>
 305 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 306 _8c.html" target="source" name="FxImage">FxImage</a></h2>
 307 <div class="doc-section">
 308
 309 <p>FxImage() applies a mathematical expression to the specified image.</p></ol>
 310
 311 <p>The format of the FxImage method is:</p>
 312
 313 <pre class="code">
 314   Image *FxImage(const Image *image,const char *expression,
 315     ExceptionInfo *exception)
 316   Image *FxImageChannel(const Image *image,const ChannelType channel,
 317     const char *expression,ExceptionInfo *exception)
 318 </pre>
 319
 320 <p>A description of each parameter follows:</p></ol>
 321
 322 <h5>image</h5>
 323 <ol><p>the image.</p></ol>
 324
 325 <h5>channel</h5>
 326 <ol><p>the channel.</p></ol>
 327
 328 <h5>expression</h5>
 329 <ol><p>A mathematical expression.</p></ol>
 330
 331 <h5>exception</h5>
 332 <ol><p>return any errors or warnings in this structure.</p></ol>
 333
 334  </div>
 335 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 336 _8c.html" target="source" name="ImplodeImage">ImplodeImage</a></h2>
 337 <div class="doc-section">
 338
 339 <p>ImplodeImage() creates a new image that is a copy of an existing one with the image pixels "implode" by the specified percentage.  It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p></ol>
 340
 341 <p>The format of the ImplodeImage method is:</p>
 342
 343 <pre class="code">
 344   Image *ImplodeImage(const Image *image,const double amount,
 345     ExceptionInfo *exception)
 346 </pre>
 347
 348 <p>A description of each parameter follows:</p></ol>
 349
 350 <h5>implode_image</h5>
 351 <ol><p>Method ImplodeImage returns a pointer to the image after it is implode.  A null image is returned if there is a memory shortage.</p></ol>
 352
 353 <h5>image</h5>
 354 <ol><p>the image.</p></ol>
 355
 356 <h5>amount</h5>
 357 <ol><p>Define the extent of the implosion.</p></ol>
 358
 359 <h5>exception</h5>
 360 <ol><p>return any errors or warnings in this structure.</p></ol>
 361
 362  </div>
 363 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 364 _8c.html" target="source" name="The MorphImages">The MorphImages</a></h2>
 365 <div class="doc-section">
 366
 367 <p>The MorphImages() method requires a minimum of two images.  The first image is transformed into the second by a number of intervening images as specified by frames.</p></ol>
 368
 369 <p>The format of the MorphImage method is:</p>
 370
 371 <pre class="code">
 372   Image *MorphImages(const Image *image,const size_t number_frames,
 373     ExceptionInfo *exception)
 374 </pre>
 375
 376 <p>A description of each parameter follows:</p></ol>
 377
 378 <h5>image</h5>
 379 <ol><p>the image.</p></ol>
 380
 381 <h5>number_frames</h5>
 382 <ol><p>Define the number of in-between image to generate. The more in-between frames, the smoother the morph.</p></ol>
 383
 384 <h5>exception</h5>
 385 <ol><p>return any errors or warnings in this structure.</p></ol>
 386
 387  </div>
 388 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 389 _8c.html" target="source" name="PlasmaImage">PlasmaImage</a></h2>
 390 <div class="doc-section">
 391
 392 <p>PlasmaImage() initializes an image with plasma fractal values.  The image must be initialized with a base color and the random number generator seeded before this method is called.</p></ol>
 393
 394 <p>The format of the PlasmaImage method is:</p>
 395
 396 <pre class="code">
 397   MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
 398     size_t attenuate,size_t depth)
 399 </pre>
 400
 401 <p>A description of each parameter follows:</p></ol>
 402
 403 <h5>image</h5>
 404 <ol><p>the image.</p></ol>
 405
 406 <h5>segment</h5>
 407 <ol><p> Define the region to apply plasma fractals values.</p></ol>
 408
 409 <h5>attenuate</h5>
 410 <ol><p>Define the plasmattenuation factor.</p></ol>
 411
 412 <h5>depth</h5>
 413 <ol><p>Limit the plasma recursion depth.</p></ol>
 414
 415  </div>
 416 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 417 _8c.html" target="source" name="PolaroidImage">PolaroidImage</a></h2>
 418 <div class="doc-section">
 419
 420 <p>PolaroidImage() simulates a Polaroid picture.</p></ol>
 421
 422 <p>The format of the AnnotateImage method is:</p>
 423
 424 <pre class="code">
 425   Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
 426     const double angle,ExceptionInfo exception)
 427 </pre>
 428
 429 <p>A description of each parameter follows:</p></ol>
 430
 431 <h5>image</h5>
 432 <ol><p>the image.</p></ol>
 433
 434 <h5>draw_info</h5>
 435 <ol><p>the draw info.</p></ol>
 436
 437 <h5>angle</h5>
 438 <ol><p>Apply the effect along this angle.</p></ol>
 439
 440 <h5>exception</h5>
 441 <ol><p>return any errors or warnings in this structure.</p></ol>
 442
 443  </div>
 444 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 445 _8c.html" target="source" name="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
 446 <div class="doc-section">
 447
 448 <p>MagickSepiaToneImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by sepia toning.  Threshold ranges from 0 to QuantumRange and is a measure of the extent of the sepia toning.  A threshold of 80 is a good starting point for a reasonable tone.</p></ol>
 449
 450 <p>The format of the SepiaToneImage method is:</p>
 451
 452 <pre class="code">
 453   Image *SepiaToneImage(const Image *image,const double threshold,
 454     ExceptionInfo *exception)
 455 </pre>
 456
 457 <p>A description of each parameter follows:</p></ol>
 458
 459 <h5>image</h5>
 460 <ol><p>the image.</p></ol>
 461
 462 <h5>threshold</h5>
 463 <ol><p>the tone threshold.</p></ol>
 464
 465 <h5>exception</h5>
 466 <ol><p>return any errors or warnings in this structure.</p></ol>
 467
 468  </div>
 469 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 470 _8c.html" target="source" name="ShadowImage">ShadowImage</a></h2>
 471 <div class="doc-section">
 472
 473 <p>ShadowImage() simulates a shadow from the specified image and returns it.</p></ol>
 474
 475 <p>The format of the ShadowImage method is:</p>
 476
 477 <pre class="code">
 478   Image *ShadowImage(const Image *image,const double opacity,
 479     const double sigma,const ssize_t x_offset,const ssize_t y_offset,
 480     ExceptionInfo *exception)
 481 </pre>
 482
 483 <p>A description of each parameter follows:</p></ol>
 484
 485 <h5>image</h5>
 486 <ol><p>the image.</p></ol>
 487
 488 <h5>opacity</h5>
 489 <ol><p>percentage transparency.</p></ol>
 490
 491 <h5>sigma</h5>
 492 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 493
 494 <h5>x_offset</h5>
 495 <ol><p>the shadow x-offset.</p></ol>
 496
 497 <h5>y_offset</h5>
 498 <ol><p>the shadow y-offset.</p></ol>
 499
 500 <h5>exception</h5>
 501 <ol><p>return any errors or warnings in this structure.</p></ol>
 502
 503  </div>
 504 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 505 _8c.html" target="source" name="SketchImage">SketchImage</a></h2>
 506 <div class="doc-section">
 507
 508 <p>SketchImage() simulates a pencil sketch.  We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma).  For reasonable results, radius should be larger than sigma.  Use a radius of 0 and SketchImage() selects a suitable radius for you.  Angle gives the angle of the sketch.</p></ol>
 509
 510 <p>The format of the SketchImage method is:</p>
 511
 512 <pre class="code">
 513       Image *SketchImage(const Image *image,const double radius,
 514   const double sigma,const double angle,ExceptionInfo *exception)
 515 </pre>
 516
 517 <p>A description of each parameter follows:</p></ol>
 518
 519 <h5>image</h5>
 520 <ol><p>the image.</p></ol>
 521
 522 <h5>radius</h5>
 523 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 524
 525 <h5>sigma</h5>
 526 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 527
 528 <h5>angle</h5>
 529 <ol><p>Apply the effect along this angle.</p></ol>
 530
 531 <h5>exception</h5>
 532 <ol><p>return any errors or warnings in this structure.</p></ol>
 533
 534  </div>
 535 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 536 _8c.html" target="source" name="SolarizeImage">SolarizeImage</a></h2>
 537 <div class="doc-section">
 538
 539 <p>SolarizeImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by selectively exposing areas of photo sensitive paper to light.  Threshold ranges from 0 to QuantumRange and is a measure of the extent of the solarization.</p></ol>
 540
 541 <p>The format of the SolarizeImage method is:</p>
 542
 543 <pre class="code">
 544   MagickBooleanType SolarizeImage(Image *image,const double threshold)
 545 </pre>
 546
 547 <p>A description of each parameter follows:</p></ol>
 548
 549 <h5>image</h5>
 550 <ol><p>the image.</p></ol>
 551
 552 <h5>threshold</h5>
 553 <ol><p>Define the extent of the solarization.</p></ol>
 554
 555  </div>
 556 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 557 _8c.html" target="source" name="SteganoImage">SteganoImage</a></h2>
 558 <div class="doc-section">
 559
 560 <p>SteganoImage() hides a digital watermark within the image.  Recover the hidden watermark later to prove that the authenticity of an image. Offset defines the start position within the image to hide the watermark.</p></ol>
 561
 562 <p>The format of the SteganoImage method is:</p>
 563
 564 <pre class="code">
 565   Image *SteganoImage(const Image *image,Image *watermark,
 566     ExceptionInfo *exception)
 567 </pre>
 568
 569 <p>A description of each parameter follows:</p></ol>
 570
 571 <h5>image</h5>
 572 <ol><p>the image.</p></ol>
 573
 574 <h5>watermark</h5>
 575 <ol><p>the watermark image.</p></ol>
 576
 577 <h5>exception</h5>
 578 <ol><p>return any errors or warnings in this structure.</p></ol>
 579
 580  </div>
 581 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 582 _8c.html" target="source" name="StereoAnaglyphImage">StereoAnaglyphImage</a></h2>
 583 <div class="doc-section">
 584
 585 <p>StereoAnaglyphImage() combines two images and produces a single image that is the composite of a left and right image of a stereo pair.  Special red-green stereo glasses are required to view this effect.</p></ol>
 586
 587 <p>The format of the StereoAnaglyphImage method is:</p>
 588
 589 <pre class="code">
 590   Image *StereoImage(const Image *left_image,const Image *right_image,
 591     ExceptionInfo *exception)
 592   Image *StereoAnaglyphImage(const Image *left_image,
 593     const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
 594     ExceptionInfo *exception)
 595 </pre>
 596
 597 <p>A description of each parameter follows:</p></ol>
 598
 599 <h5>left_image</h5>
 600 <ol><p>the left image.</p></ol>
 601
 602 <h5>right_image</h5>
 603 <ol><p>the right image.</p></ol>
 604
 605 <h5>exception</h5>
 606 <ol><p>return any errors or warnings in this structure.</p></ol>
 607
 608 <h5>x_offset</h5>
 609 <ol><p>amount, in pixels, by which the left image is offset to the right of the right image.</p></ol>
 610
 611 <h5>y_offset</h5>
 612 <ol><p>amount, in pixels, by which the left image is offset to the bottom of the right image.</p></ol>
 613
 614
 615  </div>
 616 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 617 _8c.html" target="source" name="SwirlImage">SwirlImage</a></h2>
 618 <div class="doc-section">
 619
 620 <p>SwirlImage() swirls the pixels about the center of the image, where degrees indicates the sweep of the arc through which each pixel is moved. You get a more dramatic effect as the degrees move from 1 to 360.</p></ol>
 621
 622 <p>The format of the SwirlImage method is:</p>
 623
 624 <pre class="code">
 625   Image *SwirlImage(const Image *image,double degrees,
 626     ExceptionInfo *exception)
 627 </pre>
 628
 629 <p>A description of each parameter follows:</p></ol>
 630
 631 <h5>image</h5>
 632 <ol><p>the image.</p></ol>
 633
 634 <h5>degrees</h5>
 635 <ol><p>Define the tightness of the swirling effect.</p></ol>
 636
 637 <h5>exception</h5>
 638 <ol><p>return any errors or warnings in this structure.</p></ol>
 639
 640  </div>
 641 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 642 _8c.html" target="source" name="TintImage">TintImage</a></h2>
 643 <div class="doc-section">
 644
 645 <p>TintImage() applies a color vector to each pixel in the image.  The length of the vector is 0 for black and white and at its maximum for the midtones. The vector weighting function is f(x)=(1-(4.0*((x-0.5)*(x-0.5))))</p></ol>
 646
 647 <p>The format of the TintImage method is:</p>
 648
 649 <pre class="code">
 650   Image *TintImage(const Image *image,const char *opacity,
 651     const PixelPacket tint,ExceptionInfo *exception)
 652 </pre>
 653
 654 <p>A description of each parameter follows:</p></ol>
 655
 656 <h5>image</h5>
 657 <ol><p>the image.</p></ol>
 658
 659 <h5>opacity</h5>
 660 <ol><p>A color value used for tinting.</p></ol>
 661
 662 <h5>tint</h5>
 663 <ol><p>A color value used for tinting.</p></ol>
 664
 665 <h5>exception</h5>
 666 <ol><p>return any errors or warnings in this structure.</p></ol>
 667
 668  </div>
 669 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 670 _8c.html" target="source" name="VignetteImage">VignetteImage</a></h2>
 671 <div class="doc-section">
 672
 673 <p>VignetteImage() softens the edges of the image in vignette style.</p></ol>
 674
 675 <p>The format of the VignetteImage method is:</p>
 676
 677 <pre class="code">
 678   Image *VignetteImage(const Image *image,const double radius,
 679     const double sigma,const ssize_t x,const ssize_t y,ExceptionInfo *exception)
 680 </pre>
 681
 682 <p>A description of each parameter follows:</p></ol>
 683
 684 <h5>image</h5>
 685 <ol><p>the image.</p></ol>
 686
 687 <h5>radius</h5>
 688 <ol><p>the radius of the pixel neighborhood.</p></ol>
 689
 690 <h5>sigma</h5>
 691 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 692
 693 <h5>x, y</h5>
 694 <ol><p>Define the x and y ellipse offset.</p></ol>
 695
 696 <h5>exception</h5>
 697 <ol><p>return any errors or warnings in this structure.</p></ol>
 698
 699  </div>
 700 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 701 _8c.html" target="source" name="WaveImage">WaveImage</a></h2>
 702 <div class="doc-section">
 703
 704 <p>WaveImage() creates a "ripple" effect in the image by shifting the pixels vertically along a sine wave whose amplitude and wavelength is specified by the given parameters.</p></ol>
 705
 706 <p>The format of the WaveImage method is:</p>
 707
 708 <pre class="code">
 709   Image *WaveImage(const Image *image,const double amplitude,
 710     const double wave_length,ExceptionInfo *exception)
 711 </pre>
 712
 713 <p>A description of each parameter follows:</p></ol>
 714
 715 <h5>image</h5>
 716 <ol><p>the image.</p></ol>
 717
 718 <h5>amplitude, wave_length</h5>
 719 <ol><p>Define the amplitude and wave length of the sine wave.</p></ol>
 720
 721 <h5>exception</h5>
 722 <ol><p>return any errors or warnings in this structure.</p></ol>
 723
 724  </div>
 725 \r
 726 </div>\r
 727 \r
 728 <div id="linkbar">\r
 729     <span id="linkbar-west">&nbsp;</span>\r
 730     <span id="linkbar-center">\r
 731       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 732       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 733     </span>\r
 734     <span id="linkbar-east">&nbsp;</span>\r
 735   </div>\r
 736   <div class="footer">\r
 737     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 738     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 739   </div>\r
 740   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 741   <script type="text/javascript">\r
 742     var _gaq = _gaq || [];\r
 743     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 744     _gaq.push(['_trackPageview']);\r
 745 \r
 746     (function() {\r
 747       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 748       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 749       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 750     })();\r
 751   </script>\r
 752 </body>\r
 753 </html>\r