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