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