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">\r
   4 <head>\r
   5   <meta http-equiv="Content-Type" value="application/xhtml+xml" />\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="screen,projection"><!--\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 href="../../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  52   <a href="../../www/command-line-tools.html">Command-line Tools</a>
  53 </div>
  54 <div class="sub">
  55     <a href="../../www/command-line-processing.html">Processing</a>
  56 </div>
  57 <div class="sub">
  58     <a href="../../www/command-line-options.html">Options</a>
  59 </div>
  60 <div class="sub">
  61     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  62 </div>
  63 <div class="menu">
  64   <a href="../../www/api.html">Program Interfaces</a>
  65 </div>
  66 <div class="sub">
  67     <a href="../../www/magick-wand.html">MagickWand</a>
  68 </div>
  69 <div class="sub">
  70     <a href="../../www/magick-core.html">MagickCore</a>
  71 </div>
  72 <div class="sub">
  73     <a href="../../www/perl-magick.html">PerlMagick</a>
  74 </div>
  75 <div class="sub">
  76     <a href="../../Magick++/">Magick++</a>
  77 </div>
  78 <div class="menu">
  79   <a href="../../www/architecture.html">Architecture</a>
  80 </div>
  81 <div class="sep"></div>\r
  82 <div  class="menu">
  83    <a href="../../www/install-source.html">Install from Source</a>
  84 </div>
  85 <div class="sub">
  86     <a href="../../www/install-source.html#unix">Unix</a>
  87 </div>
  88 <div class="sub">
  89     <a href="../../www/install-source.html#windows">Windows</a>
  90  </div>
  91 <div class="menu">
  92   <a href="../../www/binary-releases.html">Binary Releases</a>
  93 </div>
  94 <div class="sub">
  95     <a href="../../www/binary-releases.html#unix">Unix</a>
  96 </div>
  97 <div class="sub">
  98     <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
  99 </div>
 100 <div class="sub">
 101     <a href="../../www/binary-releases.html#windows">Windows</a>
 102 </div>
 103 <div class="menu">
 104   <a href="../../www/resources.html">Resources</a>
 105 </div>
 106 <div class="sep"></div>\r
 107 <div class="menu">
 108   <a href="../../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a href="../../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a href="../../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a href="../../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127    <a href="http://www.abi-stoff.de/abizeitung/" title="Abibuch">Abizeitung</a><!-- 20101101000200 -->
 128 </div>
 129 <div  class="sponsor">
 130   <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 131 </div>
 132 <div  class="sponsor">
 133   <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
 134 </div>
 135 <div  class="sponsor">
 136   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
 137 </div>
 138 <div  class="sponsor">
 139   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
 140 </div>
 141 <div  class="sponsor">
 142   <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 143 </div>
 144 <div  class="sponsor">
 145    <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
 146 </div>
 147 <div  class="sponsor">
 148    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 149 </div>
 150 </div>
 151 </div>
 152 \r
 153 \r
 154 </div>\r
 155 \r
 156 <div class="main">\r
 157 \r
 158 <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="#EvaluateImage">EvaluateImage</a> &bull; <a href="#FunctionImage">FunctionImage</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="#RecolorImage">RecolorImage</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>
 159
 160 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 161 _8c.html" target="source" name="AddNoiseImage">AddNoiseImage</a></h2>
 162 <div class="doc-section">
 163
 164 <p>AddNoiseImage() adds random noise to the image.</p></ol>
 165
 166 <p>The format of the AddNoiseImage method is:</p>
 167
 168 <pre class="code">
 169   Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
 170     ExceptionInfo *exception)
 171   Image *AddNoiseImageChannel(const Image *image,const ChannelType channel,
 172     const NoiseType noise_type,ExceptionInfo *exception)
 173 </pre>
 174
 175 <p>A description of each parameter follows:</p></ol>
 176
 177 <h5>image</h5>
 178 <ol><p>the image.</p></ol>
 179
 180 <h5>channel</h5>
 181 <ol><p>the channel type.</p></ol>
 182
 183 <h5>noise_type</h5>
 184 <ol><p>The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.</p></ol>
 185
 186 <h5>exception</h5>
 187 <ol><p>return any errors or warnings in this structure.</p></ol>
 188
 189  </div>
 190 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 191 _8c.html" target="source" name="BlueShiftImage">BlueShiftImage</a></h2>
 192 <div class="doc-section">
 193
 194 <p>BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.</p></ol>
 195
 196 <p>The format of the BlueShiftImage method is:</p>
 197
 198 <pre class="code">
 199   Image *BlueShiftImage(const Image *image,const double factor,
 200     ExceptionInfo *exception)
 201 </pre>
 202
 203 <p>A description of each parameter follows:</p></ol>
 204
 205 <h5>image</h5>
 206 <ol><p>the image.</p></ol>
 207
 208 <h5>factor</h5>
 209 <ol><p>the shift factor.</p></ol>
 210
 211 <h5>exception</h5>
 212 <ol><p>return any errors or warnings in this structure.</p></ol>
 213
 214  </div>
 215 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 216 _8c.html" target="source" name="CharcoalImage">CharcoalImage</a></h2>
 217 <div class="doc-section">
 218
 219 <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>
 220
 221 <p>The format of the CharcoalImage method is:</p>
 222
 223 <pre class="code">
 224   Image *CharcoalImage(const Image *image,const double radius,
 225     const double sigma,ExceptionInfo *exception)
 226 </pre>
 227
 228 <p>A description of each parameter follows:</p></ol>
 229
 230 <h5>image</h5>
 231 <ol><p>the image.</p></ol>
 232
 233 <h5>radius</h5>
 234 <ol><p>the radius of the pixel neighborhood.</p></ol>
 235
 236 <h5>sigma</h5>
 237 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 238
 239 <h5>exception</h5>
 240 <ol><p>return any errors or warnings in this structure.</p></ol>
 241
 242  </div>
 243 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 244 _8c.html" target="source" name="ColorizeImage">ColorizeImage</a></h2>
 245 <div class="doc-section">
 246
 247 <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>
 248
 249 <p>The format of the ColorizeImage method is:</p>
 250
 251 <pre class="code">
 252   Image *ColorizeImage(const Image *image,const char *opacity,
 253     const PixelPacket colorize,ExceptionInfo *exception)
 254 </pre>
 255
 256 <p>A description of each parameter follows:</p></ol>
 257
 258 <h5>image</h5>
 259 <ol><p>the image.</p></ol>
 260
 261 <h5>opacity</h5>
 262 <ol><p>A character string indicating the level of opacity as a percentage.</p></ol>
 263
 264 <h5>colorize</h5>
 265 <ol><p>A color value.</p></ol>
 266
 267 <h5>exception</h5>
 268 <ol><p>return any errors or warnings in this structure.</p></ol>
 269
 270  </div>
 271 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 272 _8c.html" target="source" name="EvaluateImage">EvaluateImage</a></h2>
 273 <div class="doc-section">
 274
 275 <p>EvaluateImage() applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p></ol>
 276
 277 <p>The format of the EvaluateImageChannel method is:</p>
 278
 279 <pre class="code">
 280   MagickBooleanType EvaluateImage(Image *image,
 281     const MagickEvaluateOperator op,const double value,
 282     ExceptionInfo *exception)
 283   MagickBooleanType EvaluateImageChannel(Image *image,
 284     const ChannelType channel,const MagickEvaluateOperator op,
 285     const double value,ExceptionInfo *exception)
 286 </pre>
 287
 288 <p>A description of each parameter follows:</p></ol>
 289
 290 <h5>image</h5>
 291 <ol><p>the image.</p></ol>
 292
 293 <h5>channel</h5>
 294 <ol><p>the channel.</p></ol>
 295
 296 <h5>op</h5>
 297 <ol><p>A channel op.</p></ol>
 298
 299 <h5>value</h5>
 300 <ol><p>A value value.</p></ol>
 301
 302 <h5>exception</h5>
 303 <ol><p>return any errors or warnings in this structure.</p></ol>
 304
 305  </div>
 306 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 307 _8c.html" target="source" name="FunctionImage">FunctionImage</a></h2>
 308 <div class="doc-section">
 309
 310 <p>FunctionImage() applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.</p></ol>
 311
 312 <p>The format of the FunctionImageChannel method is:</p>
 313
 314 <pre class="code">
 315   MagickBooleanType FunctionImage(Image *image,
 316     const MagickFunction function,const long number_parameters,
 317     const double *parameters,ExceptionInfo *exception)
 318   MagickBooleanType FunctionImageChannel(Image *image,
 319     const ChannelType channel,const MagickFunction function,
 320     const long number_parameters,const double *argument,
 321     ExceptionInfo *exception)
 322 </pre>
 323
 324 <p>A description of each parameter follows:</p></ol>
 325
 326 <h5>image</h5>
 327 <ol><p>the image.</p></ol>
 328
 329 <h5>channel</h5>
 330 <ol><p>the channel.</p></ol>
 331
 332 <h5>function</h5>
 333 <ol><p>A channel function.</p></ol>
 334
 335 <h5>parameters</h5>
 336 <ol><p>one or more parameters.</p></ol>
 337
 338 <h5>exception</h5>
 339 <ol><p>return any errors or warnings in this structure.</p></ol>
 340
 341  </div>
 342 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 343 _8c.html" target="source" name="FxImage">FxImage</a></h2>
 344 <div class="doc-section">
 345
 346 <p>FxImage() applies a mathematical expression to the specified image.</p></ol>
 347
 348 <p>The format of the FxImage method is:</p>
 349
 350 <pre class="code">
 351   Image *FxImage(const Image *image,const char *expression,
 352     ExceptionInfo *exception)
 353   Image *FxImageChannel(const Image *image,const ChannelType channel,
 354     const char *expression,ExceptionInfo *exception)
 355 </pre>
 356
 357 <p>A description of each parameter follows:</p></ol>
 358
 359 <h5>image</h5>
 360 <ol><p>the image.</p></ol>
 361
 362 <h5>channel</h5>
 363 <ol><p>the channel.</p></ol>
 364
 365 <h5>expression</h5>
 366 <ol><p>A mathematical expression.</p></ol>
 367
 368 <h5>exception</h5>
 369 <ol><p>return any errors or warnings in this structure.</p></ol>
 370
 371  </div>
 372 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 373 _8c.html" target="source" name="ImplodeImage">ImplodeImage</a></h2>
 374 <div class="doc-section">
 375
 376 <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>
 377
 378 <p>The format of the ImplodeImage method is:</p>
 379
 380 <pre class="code">
 381   Image *ImplodeImage(const Image *image,const double amount,
 382     ExceptionInfo *exception)
 383 </pre>
 384
 385 <p>A description of each parameter follows:</p></ol>
 386
 387 <h5>implode_image</h5>
 388 <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>
 389
 390 <h5>image</h5>
 391 <ol><p>the image.</p></ol>
 392
 393 <h5>amount</h5>
 394 <ol><p>Define the extent of the implosion.</p></ol>
 395
 396 <h5>exception</h5>
 397 <ol><p>return any errors or warnings in this structure.</p></ol>
 398
 399  </div>
 400 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 401 _8c.html" target="source" name="The MorphImages">The MorphImages</a></h2>
 402 <div class="doc-section">
 403
 404 <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>
 405
 406 <p>The format of the MorphImage method is:</p>
 407
 408 <pre class="code">
 409   Image *MorphImages(const Image *image,const unsigned long number_frames,
 410     ExceptionInfo *exception)
 411 </pre>
 412
 413 <p>A description of each parameter follows:</p></ol>
 414
 415 <h5>image</h5>
 416 <ol><p>the image.</p></ol>
 417
 418 <h5>number_frames</h5>
 419 <ol><p>Define the number of in-between image to generate. The more in-between frames, the smoother the morph.</p></ol>
 420
 421 <h5>exception</h5>
 422 <ol><p>return any errors or warnings in this structure.</p></ol>
 423
 424  </div>
 425 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 426 _8c.html" target="source" name="PlasmaImage">PlasmaImage</a></h2>
 427 <div class="doc-section">
 428
 429 <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>
 430
 431 <p>The format of the PlasmaImage method is:</p>
 432
 433 <pre class="code">
 434   MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
 435     unsigned long attenuate,unsigned long depth)
 436 </pre>
 437
 438 <p>A description of each parameter follows:</p></ol>
 439
 440 <h5>image</h5>
 441 <ol><p>the image.</p></ol>
 442
 443 <h5>segment</h5>
 444 <ol><p> Define the region to apply plasma fractals values.</p></ol>
 445
 446 <h5>attenuate</h5>
 447 <ol><p>Define the plasmattenuation factor.</p></ol>
 448
 449 <h5>depth</h5>
 450 <ol><p>Limit the plasma recursion depth.</p></ol>
 451
 452  </div>
 453 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 454 _8c.html" target="source" name="PolaroidImage">PolaroidImage</a></h2>
 455 <div class="doc-section">
 456
 457 <p>PolaroidImage() simulates a Polaroid picture.</p></ol>
 458
 459 <p>The format of the AnnotateImage method is:</p>
 460
 461 <pre class="code">
 462   Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
 463     const double angle,ExceptionInfo exception)
 464 </pre>
 465
 466 <p>A description of each parameter follows:</p></ol>
 467
 468 <h5>image</h5>
 469 <ol><p>the image.</p></ol>
 470
 471 <h5>draw_info</h5>
 472 <ol><p>the draw info.</p></ol>
 473
 474 <h5>angle</h5>
 475 <ol><p>Apply the effect along this angle.</p></ol>
 476
 477 <h5>exception</h5>
 478 <ol><p>return any errors or warnings in this structure.</p></ol>
 479
 480  </div>
 481 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 482 _8c.html" target="source" name="RecolorImage">RecolorImage</a></h2>
 483 <div class="doc-section">
 484
 485 <p>RecolorImage() translate, scale, shear, or rotate image colors.  Although you can use variable sized matrices, typically you use a 5 x 5 for an RGBA image and a 6x6 for CMYKA.  Populate the last row with normalized values to translate.</p></ol>
 486
 487 <p>The format of the RecolorImage method is:</p>
 488
 489 <pre class="code">
 490   Image *RecolorImage(const Image *image,const unsigned long order,
 491     const double *color_matrix,ExceptionInfo *exception)
 492 </pre>
 493
 494 <p>A description of each parameter follows:</p></ol>
 495
 496 <h5>image</h5>
 497 <ol><p>the image.</p></ol>
 498
 499 <h5>order</h5>
 500 <ol><p>the number of columns and rows in the recolor matrix.</p></ol>
 501
 502 <h5>color_matrix</h5>
 503 <ol><p>An array of double representing the recolor matrix.</p></ol>
 504
 505 <h5>exception</h5>
 506 <ol><p>return any errors or warnings in this structure.</p></ol>
 507
 508  </div>
 509 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 510 _8c.html" target="source" name="MagickSepiaToneImage">MagickSepiaToneImage</a></h2>
 511 <div class="doc-section">
 512
 513 <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>
 514
 515 <p>The format of the SepiaToneImage method is:</p>
 516
 517 <pre class="code">
 518   Image *SepiaToneImage(const Image *image,const double threshold,
 519     ExceptionInfo *exception)
 520 </pre>
 521
 522 <p>A description of each parameter follows:</p></ol>
 523
 524 <h5>image</h5>
 525 <ol><p>the image.</p></ol>
 526
 527 <h5>threshold</h5>
 528 <ol><p>the tone threshold.</p></ol>
 529
 530 <h5>exception</h5>
 531 <ol><p>return any errors or warnings in this structure.</p></ol>
 532
 533  </div>
 534 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 535 _8c.html" target="source" name="ShadowImage">ShadowImage</a></h2>
 536 <div class="doc-section">
 537
 538 <p>ShadowImage() simulates a shadow from the specified image and returns it.</p></ol>
 539
 540 <p>The format of the ShadowImage method is:</p>
 541
 542 <pre class="code">
 543   Image *ShadowImage(const Image *image,const double opacity,
 544     const double sigma,const long x_offset,const long y_offset,
 545     ExceptionInfo *exception)
 546 </pre>
 547
 548 <p>A description of each parameter follows:</p></ol>
 549
 550 <h5>image</h5>
 551 <ol><p>the image.</p></ol>
 552
 553 <h5>opacity</h5>
 554 <ol><p>percentage transparency.</p></ol>
 555
 556 <h5>sigma</h5>
 557 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 558
 559 <h5>x_offset</h5>
 560 <ol><p>the shadow x-offset.</p></ol>
 561
 562 <h5>y_offset</h5>
 563 <ol><p>the shadow y-offset.</p></ol>
 564
 565 <h5>exception</h5>
 566 <ol><p>return any errors or warnings in this structure.</p></ol>
 567
 568  </div>
 569 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 570 _8c.html" target="source" name="SketchImage">SketchImage</a></h2>
 571 <div class="doc-section">
 572
 573 <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>
 574
 575 <p>The format of the SketchImage method is:</p>
 576
 577 <pre class="code">
 578       Image *SketchImage(const Image *image,const double radius,
 579   const double sigma,const double angle,ExceptionInfo *exception)
 580 </pre>
 581
 582 <p>A description of each parameter follows:</p></ol>
 583
 584 <h5>image</h5>
 585 <ol><p>the image.</p></ol>
 586
 587 <h5>radius</h5>
 588 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 589
 590 <h5>sigma</h5>
 591 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 592
 593 <h5>angle</h5>
 594 <ol><p>Apply the effect along this angle.</p></ol>
 595
 596 <h5>exception</h5>
 597 <ol><p>return any errors or warnings in this structure.</p></ol>
 598
 599  </div>
 600 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 601 _8c.html" target="source" name="SolarizeImage">SolarizeImage</a></h2>
 602 <div class="doc-section">
 603
 604 <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>
 605
 606 <p>The format of the SolarizeImage method is:</p>
 607
 608 <pre class="code">
 609   MagickBooleanType SolarizeImage(Image *image,const double threshold)
 610 </pre>
 611
 612 <p>A description of each parameter follows:</p></ol>
 613
 614 <h5>image</h5>
 615 <ol><p>the image.</p></ol>
 616
 617 <h5>threshold</h5>
 618 <ol><p>Define the extent of the solarization.</p></ol>
 619
 620  </div>
 621 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 622 _8c.html" target="source" name="SteganoImage">SteganoImage</a></h2>
 623 <div class="doc-section">
 624
 625 <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>
 626
 627 <p>The format of the SteganoImage method is:</p>
 628
 629 <pre class="code">
 630   Image *SteganoImage(const Image *image,Image *watermark,
 631     ExceptionInfo *exception)
 632 </pre>
 633
 634 <p>A description of each parameter follows:</p></ol>
 635
 636 <h5>image</h5>
 637 <ol><p>the image.</p></ol>
 638
 639 <h5>watermark</h5>
 640 <ol><p>the watermark image.</p></ol>
 641
 642 <h5>exception</h5>
 643 <ol><p>return any errors or warnings in this structure.</p></ol>
 644
 645  </div>
 646 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 647 _8c.html" target="source" name="StereoAnaglyphImage">StereoAnaglyphImage</a></h2>
 648 <div class="doc-section">
 649
 650 <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>
 651
 652 <p>The format of the StereoAnaglyphImage method is:</p>
 653
 654 <pre class="code">
 655   Image *StereoImage(const Image *left_image,const Image *right_image,
 656     ExceptionInfo *exception)
 657   Image *StereoAnaglyphImage(const Image *left_image,
 658     const Image *right_image,const long x_offset,const long y_offset,
 659     ExceptionInfo *exception)
 660 </pre>
 661
 662 <p>A description of each parameter follows:</p></ol>
 663
 664 <h5>left_image</h5>
 665 <ol><p>the left image.</p></ol>
 666
 667 <h5>right_image</h5>
 668 <ol><p>the right image.</p></ol>
 669
 670 <h5>exception</h5>
 671 <ol><p>return any errors or warnings in this structure.</p></ol>
 672
 673 <h5>x_offset</h5>
 674 <ol><p>amount, in pixels, by which the left image is offset to the right of the right image.</p></ol>
 675
 676 <h5>y_offset</h5>
 677 <ol><p>amount, in pixels, by which the left image is offset to the bottom of the right image.</p></ol>
 678
 679
 680  </div>
 681 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 682 _8c.html" target="source" name="SwirlImage">SwirlImage</a></h2>
 683 <div class="doc-section">
 684
 685 <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>
 686
 687 <p>The format of the SwirlImage method is:</p>
 688
 689 <pre class="code">
 690   Image *SwirlImage(const Image *image,double degrees,
 691     ExceptionInfo *exception)
 692 </pre>
 693
 694 <p>A description of each parameter follows:</p></ol>
 695
 696 <h5>image</h5>
 697 <ol><p>the image.</p></ol>
 698
 699 <h5>degrees</h5>
 700 <ol><p>Define the tightness of the swirling effect.</p></ol>
 701
 702 <h5>exception</h5>
 703 <ol><p>return any errors or warnings in this structure.</p></ol>
 704
 705  </div>
 706 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 707 _8c.html" target="source" name="TintImage">TintImage</a></h2>
 708 <div class="doc-section">
 709
 710 <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>
 711
 712 <p>The format of the TintImage method is:</p>
 713
 714 <pre class="code">
 715   Image *TintImage(const Image *image,const char *opacity,
 716     const PixelPacket tint,ExceptionInfo *exception)
 717 </pre>
 718
 719 <p>A description of each parameter follows:</p></ol>
 720
 721 <h5>image</h5>
 722 <ol><p>the image.</p></ol>
 723
 724 <h5>opacity</h5>
 725 <ol><p>A color value used for tinting.</p></ol>
 726
 727 <h5>tint</h5>
 728 <ol><p>A color value used for tinting.</p></ol>
 729
 730 <h5>exception</h5>
 731 <ol><p>return any errors or warnings in this structure.</p></ol>
 732
 733  </div>
 734 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 735 _8c.html" target="source" name="VignetteImage">VignetteImage</a></h2>
 736 <div class="doc-section">
 737
 738 <p>VignetteImage() softens the edges of the image in vignette style.</p></ol>
 739
 740 <p>The format of the VignetteImage method is:</p>
 741
 742 <pre class="code">
 743   Image *VignetteImage(const Image *image,const double radius,
 744     const double sigma,const long x,const long y,ExceptionInfo *exception)
 745 </pre>
 746
 747 <p>A description of each parameter follows:</p></ol>
 748
 749 <h5>image</h5>
 750 <ol><p>the image.</p></ol>
 751
 752 <h5>radius</h5>
 753 <ol><p>the radius of the pixel neighborhood.</p></ol>
 754
 755 <h5>sigma</h5>
 756 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 757
 758 <h5>x, y</h5>
 759 <ol><p>Define the x and y ellipse offset.</p></ol>
 760
 761 <h5>exception</h5>
 762 <ol><p>return any errors or warnings in this structure.</p></ol>
 763
 764  </div>
 765 <h2><a href="http://www.imagemagick.org/api/MagickCore/fx
 766 _8c.html" target="source" name="WaveImage">WaveImage</a></h2>
 767 <div class="doc-section">
 768
 769 <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>
 770
 771 <p>The format of the WaveImage method is:</p>
 772
 773 <pre class="code">
 774   Image *WaveImage(const Image *image,const double amplitude,
 775     const double wave_length,ExceptionInfo *exception)
 776 </pre>
 777
 778 <p>A description of each parameter follows:</p></ol>
 779
 780 <h5>image</h5>
 781 <ol><p>the image.</p></ol>
 782
 783 <h5>amplitude, wave_length</h5>
 784 <ol><p>Define the amplitude and wave length of the sine wave.</p></ol>
 785
 786 <h5>exception</h5>
 787 <ol><p>return any errors or warnings in this structure.</p></ol>
 788
 789  </div>
 790 \r
 791 </div>\r
 792 \r
 793 <div id="linkbar">\r
 794  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 795     <span id="linkbar-center">\r
 796       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 797     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 798     </span>\r
 799     <span id="linkbar-east">&nbsp;</span>\r
 800   </div>\r
 801   <div class="footer">\r
 802     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 803     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 804   </div>\r
 805   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 806 </body>\r
 807 </html>\r