granicus.if.org Git - imagemagick/blob - www/api/effect.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 name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   7   <style type="text/css" media="screen,projection"><!--\r
   8     @import url("../../www/magick.css");\r
   9   --></style>\r
  10   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  11   <title>ImageMagick: MagickCore, C API for ImageMagick: Add an Effect</title>
  12   <meta http-equiv="Content-Language" content="en-US"/>
  13   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  14   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  15   <meta name="Generator" content="PHP"/>
  16   <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, add, an, effect, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  17   <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."/>
  18   <meta name="Rating" content="GENERAL"/>
  19   <meta name="Robots" content="INDEX, FOLLOW"/>
  20   <meta name="Generator" content="ImageMagick Studio LLC"/>
  21   <meta name="Author" content="ImageMagick Studio LLC"/>
  22   <meta name="Revisit-after" content="2 DAYS"/>
  23   <meta name="Resource-type" content="document"/>
  24   <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
  25   <meta name="Distribution" content="Global"/>
  26 </head>\r
  27 \r
  28 <body id="www-imagemagick-org">\r
  29 <div class="titlebar">\r
  30 <a href="../../index.html">\r
  31   <img src="../../images/script.png" alt="[ImageMagick]"\r
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  33 <a href="http://www.networkredux.com">\r
  34   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  36 <a href="http://www.imagemagick.org/discourse-server/">\r
  37   <img src="../../images/logo.jpg" alt=""\r
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  39 <a href="../../index.html">\r
  40   <img src="../../images/sprite.jpg" alt=""\r
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  42 </div>\r
  43 \r
  44 <div class="eastbar">\r
  45 \r
  46 <div class="menu">
  47   <a href="../../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>\r
  50 <div class="menu">
  51   <a href="../../www/command-line-tools.html">Command-line Tools</a>
  52 </div>
  53 <div class="sub">
  54     <a href="../../www/command-line-processing.html">Processing</a>
  55 </div>
  56 <div class="sub">
  57     <a href="../../www/command-line-options.html">Options</a>
  58 </div>
  59 <div class="sub">
  60     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  61 </div>
  62 <div class="menu">
  63   <a href="../../www/api.html">Program Interfaces</a>
  64 </div>
  65 <div class="sub">
  66     <a href="../../www/magick-wand.html">MagickWand</a>
  67 </div>
  68 <div class="sub">
  69     <a href="../../www/magick-core.html">MagickCore</a>
  70 </div>
  71 <div class="sub">
  72     <a href="../../www/perl-magick.html">PerlMagick</a>
  73 </div>
  74 <div class="sub">
  75     <a href="../../Magick++/">Magick++</a>
  76 </div>
  77 <div class="menu">
  78   <a href="../../www/architecture.html">Architecture</a>
  79 </div>
  80 <div class="sep"></div>\r
  81 <div  class="menu">
  82    <a href="../../www/install-source.html">Install from Source</a>
  83 </div>
  84 <div class="sub">
  85     <a href="../../www/install-source.html#unix">Unix</a>
  86 </div>
  87 <div class="sub">
  88     <a href="../../www/install-source.html#windows">Windows</a>
  89  </div>
  90 <div class="menu">
  91   <a href="../../www/binary-releases.html">Binary Releases</a>
  92 </div>
  93 <div class="sub">
  94     <a href="../../www/binary-releases.html#unix">Unix</a>
  95 </div>
  96 <div class="sub">
  97     <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
  98 </div>
  99 <div class="sub">
 100     <a href="../../www/binary-releases.html#windows">Windows</a>
 101 </div>
 102 <div class="menu">
 103   <a href="../../www/resources.html">Resources</a>
 104 </div>
 105 <div class="sep"></div>\r
 106 <div class="menu">
 107   <a href="../../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div class="menu">
 111   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a href="../../www/sitemap.html">Site Map</a>
 116 </div>
 117 <div  class="sub">
 118     <a href="../../www/links.html">Links</a>
 119 </div>
 120 <div class="sep"></div>\r
 121 <div  class="menu">
 122   <a href="../../www/sponsors.html">Sponsors:</a>
 123
 124 <div class="sponsbox">
 125 <div  class="sponsor">
 126    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 127 </div>
 128 <div  class="sponsor">
 129    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 142 </div>
 143 </div>
 144 </div>
 145 \r
 146 \r
 147 </div>\r
 148 \r
 149 <div class="main">\r
 150 \r
 151 <p class="navigation-index">[<a href="#AdaptiveBlurImage">AdaptiveBlurImage</a> &bull; <a href="#AdaptiveSharpenImage">AdaptiveSharpenImage</a> &bull; <a href="#BlurImage">BlurImage</a> &bull; <a href="#DespeckleImage">DespeckleImage</a> &bull; <a href="#EdgeImage">EdgeImage</a> &bull; <a href="#EmbossImage">EmbossImage</a> &bull; <a href="#GaussianBlurImage">GaussianBlurImage</a> &bull; <a href="#MedianFilterImage">MedianFilterImage</a> &bull; <a href="#MotionBlurImage">MotionBlurImage</a> &bull; <a href="#PreviewImage">PreviewImage</a> &bull; <a href="#RadialBlurImage">RadialBlurImage</a> &bull; <a href="#ReduceNoiseImage">ReduceNoiseImage</a> &bull; <a href="#SelectiveBlurImage">SelectiveBlurImage</a> &bull; <a href="#ShadeImage">ShadeImage</a> &bull; <a href="#SharpenImage">SharpenImage</a> &bull; <a href="#SpreadImage">SpreadImage</a> &bull; <a href="#UnsharpMaskImage">UnsharpMaskImage</a>]</p>
 152
 153 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 154 _8c.html" target="source" name="AdaptiveBlurImage">AdaptiveBlurImage</a></h2>
 155 <div class="doc-section">
 156
 157 <p>AdaptiveBlurImage() adaptively blurs the image by blurring less intensely near image edges and more intensely far from edges.  We blur 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 AdaptiveBlurImage() selects a suitable radius for you.</p></ol>
 158
 159 <p>The format of the AdaptiveBlurImage method is:</p>
 160
 161 <pre class="code">
 162   Image *AdaptiveBlurImage(const Image *image,const double radius,
 163     const double sigma,ExceptionInfo *exception)
 164   Image *AdaptiveBlurImageChannel(const Image *image,
 165     const ChannelType channel,double radius,const double sigma,
 166     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>radius</h5>
 178 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 179
 180 <h5>sigma</h5>
 181 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 182
 183 <h5>exception</h5>
 184 <ol><p>return any errors or warnings in this structure.</p></ol>
 185
 186  </div>
 187 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 188 _8c.html" target="source" name="AdaptiveSharpenImage">AdaptiveSharpenImage</a></h2>
 189 <div class="doc-section">
 190
 191 <p>AdaptiveSharpenImage() adaptively sharpens the image by sharpening more intensely near image edges and less intensely far from edges. We sharpen 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 AdaptiveSharpenImage() selects a suitable radius for you.</p></ol>
 192
 193 <p>The format of the AdaptiveSharpenImage method is:</p>
 194
 195 <pre class="code">
 196   Image *AdaptiveSharpenImage(const Image *image,const double radius,
 197     const double sigma,ExceptionInfo *exception)
 198   Image *AdaptiveSharpenImageChannel(const Image *image,
 199     const ChannelType channel,double radius,const double sigma,
 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>channel</h5>
 209 <ol><p>the channel type.</p></ol>
 210
 211 <h5>radius</h5>
 212 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 213
 214 <h5>sigma</h5>
 215 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 216
 217 <h5>exception</h5>
 218 <ol><p>return any errors or warnings in this structure.</p></ol>
 219
 220  </div>
 221 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 222 _8c.html" target="source" name="BlurImage">BlurImage</a></h2>
 223 <div class="doc-section">
 224
 225 <p>BlurImage() blurs an image.  We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma).  For reasonable results, the radius should be larger than sigma.  Use a radius of 0 and BlurImage() selects a suitable radius for you.</p></ol>
 226
 227 <p>BlurImage() differs from GaussianBlurImage() in that it uses a separable kernel which is faster but mathematically equivalent to the non-separable kernel.</p></ol>
 228
 229 <p>The format of the BlurImage method is:</p>
 230
 231 <pre class="code">
 232   Image *BlurImage(const Image *image,const double radius,
 233     const double sigma,ExceptionInfo *exception)
 234   Image *BlurImageChannel(const Image *image,const ChannelType channel,
 235     const double radius,const double sigma,ExceptionInfo *exception)
 236 </pre>
 237
 238 <p>A description of each parameter follows:</p></ol>
 239
 240 <h5>image</h5>
 241 <ol><p>the image.</p></ol>
 242
 243 <h5>channel</h5>
 244 <ol><p>the channel type.</p></ol>
 245
 246 <h5>radius</h5>
 247 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 248
 249 <h5>sigma</h5>
 250 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 251
 252 <h5>exception</h5>
 253 <ol><p>return any errors or warnings in this structure.</p></ol>
 254
 255  </div>
 256 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 257 _8c.html" target="source" name="DespeckleImage">DespeckleImage</a></h2>
 258 <div class="doc-section">
 259
 260 <p>DespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.</p></ol>
 261
 262 <p>The format of the DespeckleImage method is:</p>
 263
 264 <pre class="code">
 265   Image *DespeckleImage(const Image *image,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>exception</h5>
 274 <ol><p>return any errors or warnings in this structure.</p></ol>
 275
 276  </div>
 277 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 278 _8c.html" target="source" name="EdgeImage">EdgeImage</a></h2>
 279 <div class="doc-section">
 280
 281 <p>EdgeImage() finds edges in an image.  Radius defines the radius of the convolution filter.  Use a radius of 0 and EdgeImage() selects a suitable radius for you.</p></ol>
 282
 283 <p>The format of the EdgeImage method is:</p>
 284
 285 <pre class="code">
 286   Image *EdgeImage(const Image *image,const double radius,
 287     ExceptionInfo *exception)
 288 </pre>
 289
 290 <p>A description of each parameter follows:</p></ol>
 291
 292 <h5>image</h5>
 293 <ol><p>the image.</p></ol>
 294
 295 <h5>radius</h5>
 296 <ol><p>the radius of the pixel neighborhood.</p></ol>
 297
 298 <h5>exception</h5>
 299 <ol><p>return any errors or warnings in this structure.</p></ol>
 300
 301  </div>
 302 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 303 _8c.html" target="source" name="EmbossImage">EmbossImage</a></h2>
 304 <div class="doc-section">
 305
 306 <p>EmbossImage() returns a grayscale image with a three-dimensional effect. 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 Emboss() selects a suitable radius for you.</p></ol>
 307
 308 <p>The format of the EmbossImage method is:</p>
 309
 310 <pre class="code">
 311   Image *EmbossImage(const Image *image,const double radius,
 312     const double sigma,ExceptionInfo *exception)
 313 </pre>
 314
 315 <p>A description of each parameter follows:</p></ol>
 316
 317 <h5>image</h5>
 318 <ol><p>the image.</p></ol>
 319
 320 <h5>radius</h5>
 321 <ol><p>the radius of the pixel neighborhood.</p></ol>
 322
 323 <h5>sigma</h5>
 324 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 325
 326 <h5>exception</h5>
 327 <ol><p>return any errors or warnings in this structure.</p></ol>
 328
 329  </div>
 330 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 331 _8c.html" target="source" name="GaussianBlurImage">GaussianBlurImage</a></h2>
 332 <div class="doc-section">
 333
 334 <p>GaussianBlurImage() blurs an image.  We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma.  Use a radius of 0 and GaussianBlurImage() selects a suitable radius for you</p></ol>
 335
 336 <p>The format of the GaussianBlurImage method is:</p>
 337
 338 <pre class="code">
 339   Image *GaussianBlurImage(const Image *image,onst double radius,
 340     const double sigma,ExceptionInfo *exception)
 341   Image *GaussianBlurImageChannel(const Image *image,
 342     const ChannelType channel,const double radius,const double sigma,
 343     ExceptionInfo *exception)
 344 </pre>
 345
 346 <p>A description of each parameter follows:</p></ol>
 347
 348 <h5>image</h5>
 349 <ol><p>the image.</p></ol>
 350
 351 <h5>channel</h5>
 352 <ol><p>the channel type.</p></ol>
 353
 354 <h5>radius</h5>
 355 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 356
 357 <h5>sigma</h5>
 358 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 359
 360 <h5>exception</h5>
 361 <ol><p>return any errors or warnings in this structure.</p></ol>
 362
 363  </div>
 364 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 365 _8c.html" target="source" name="MedianFilterImage">MedianFilterImage</a></h2>
 366 <div class="doc-section">
 367
 368 <p>MedianFilterImage() applies a digital filter that improves the quality of a noisy image.  Each pixel is replaced by the median in a set of neighboring pixels as defined by radius.</p></ol>
 369
 370 <p>The algorithm was contributed by Mike Edmonds and implements an insertion sort for selecting median color-channel values.  For more on this algorithm see "Skip Lists: A probabilistic Alternative to Balanced Trees" by William Pugh in the June 1990 of Communications of the ACM.</p></ol>
 371
 372 <p>The format of the MedianFilterImage method is:</p>
 373
 374 <pre class="code">
 375   Image *MedianFilterImage(const Image *image,const double radius,
 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>radius</h5>
 385 <ol><p>the radius of the pixel neighborhood.</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/effect
 392 _8c.html" target="source" name="MotionBlurImage">MotionBlurImage</a></h2>
 393 <div class="doc-section">
 394
 395 <p>MotionBlurImage() simulates motion blur.  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 MotionBlurImage() selects a suitable radius for you. Angle gives the angle of the blurring motion.</p></ol>
 396
 397 <p>Andrew Protano contributed this effect.</p></ol>
 398
 399 <p>The format of the MotionBlurImage method is:</p>
 400
 401 <pre class="code">
 402       Image *MotionBlurImage(const Image *image,const double radius,
 403   const double sigma,const double angle,ExceptionInfo *exception)
 404       Image *MotionBlurImageChannel(const Image *image,const ChannelType channel,
 405   const double radius,const double sigma,const double angle,
 406   ExceptionInfo *exception)
 407 </pre>
 408
 409 <p>A description of each parameter follows:</p></ol>
 410
 411 <h5>image</h5>
 412 <ol><p>the image.</p></ol>
 413
 414 <h5>channel</h5>
 415 <ol><p>the channel type.</p></ol>
 416
 417 <h5>radius</h5>
 418 <ol><p>the radius of the Gaussian, in pixels, not counting the center</p>
 419 <h5>radius</h5>
 420 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 421
 422 <h5>sigma</h5>
 423 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 424
 425 <h5>angle</h5>
 426 <ol><p>Apply the effect along this angle.</p></ol>
 427
 428 <h5>exception</h5>
 429 <ol><p>return any errors or warnings in this structure.</p></ol>
 430
 431  </div>
 432 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 433 _8c.html" target="source" name="PreviewImage">PreviewImage</a></h2>
 434 <div class="doc-section">
 435
 436 <p>PreviewImage() tiles 9 thumbnails of the specified image with an image processing operation applied with varying parameters.  This may be helpful pin-pointing an appropriate parameter for a particular image processing operation.</p></ol>
 437
 438 <p>The format of the PreviewImages method is:</p>
 439
 440 <pre class="code">
 441   Image *PreviewImages(const Image *image,const PreviewType preview,
 442     ExceptionInfo *exception)
 443 </pre>
 444
 445 <p>A description of each parameter follows:</p></ol>
 446
 447 <h5>image</h5>
 448 <ol><p>the image.</p></ol>
 449
 450 <h5>preview</h5>
 451 <ol><p>the image processing operation.</p></ol>
 452
 453 <h5>exception</h5>
 454 <ol><p>return any errors or warnings in this structure.</p></ol>
 455
 456  </div>
 457 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 458 _8c.html" target="source" name="RadialBlurImage">RadialBlurImage</a></h2>
 459 <div class="doc-section">
 460
 461 <p>RadialBlurImage() applies a radial blur to the image.</p></ol>
 462
 463 <p>Andrew Protano contributed this effect.</p></ol>
 464
 465 <p>The format of the RadialBlurImage method is:</p>
 466
 467 <pre class="code">
 468       Image *RadialBlurImage(const Image *image,const double angle,
 469   ExceptionInfo *exception)
 470       Image *RadialBlurImageChannel(const Image *image,const ChannelType channel,
 471   const double angle,ExceptionInfo *exception)
 472 </pre>
 473
 474 <p>A description of each parameter follows:</p></ol>
 475
 476 <h5>image</h5>
 477 <ol><p>the image.</p></ol>
 478
 479 <h5>channel</h5>
 480 <ol><p>the channel type.</p></ol>
 481
 482 <h5>angle</h5>
 483 <ol><p>the angle of the radial blur.</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/effect
 490 _8c.html" target="source" name="ReduceNoiseImage">ReduceNoiseImage</a></h2>
 491 <div class="doc-section">
 492
 493 <p>ReduceNoiseImage() smooths the contours of an image while still preserving edge information.  The algorithm works by replacing each pixel with its neighbor closest in value.  A neighbor is defined by radius.  Use a radius of 0 and ReduceNoise() selects a suitable radius for you.</p></ol>
 494
 495 <p>The format of the ReduceNoiseImage method is:</p>
 496
 497 <pre class="code">
 498   Image *ReduceNoiseImage(const Image *image,const double radius,
 499     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 pixel neighborhood.</p></ol>
 509
 510 <h5>exception</h5>
 511 <ol><p>return any errors or warnings in this structure.</p></ol>
 512
 513  </div>
 514 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 515 _8c.html" target="source" name="SelectiveBlurImage">SelectiveBlurImage</a></h2>
 516 <div class="doc-section">
 517
 518 <p>SelectiveBlurImage() selectively blur pixels within a contrast threshold. It is similar to the unsharpen mask that sharpens everything with contrast above a certain threshold.</p></ol>
 519
 520 <p>The format of the SelectiveBlurImage method is:</p>
 521
 522 <pre class="code">
 523   Image *SelectiveBlurImage(const Image *image,const double radius,
 524     const double sigma,const double threshold,ExceptionInfo *exception)
 525   Image *SelectiveBlurImageChannel(const Image *image,
 526     const ChannelType channel,const double radius,const double sigma,
 527     const double threshold,ExceptionInfo *exception)
 528 </pre>
 529
 530 <p>A description of each parameter follows:</p></ol>
 531
 532 <h5>image</h5>
 533 <ol><p>the image.</p></ol>
 534
 535 <h5>channel</h5>
 536 <ol><p>the channel type.</p></ol>
 537
 538 <h5>radius</h5>
 539 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 540
 541 <h5>sigma</h5>
 542 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 543
 544 <h5>threshold</h5>
 545 <ol><p>only pixels within this contrast threshold are included in the blur operation.</p></ol>
 546
 547 <h5>exception</h5>
 548 <ol><p>return any errors or warnings in this structure.</p></ol>
 549
 550  </div>
 551 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 552 _8c.html" target="source" name="ShadeImage">ShadeImage</a></h2>
 553 <div class="doc-section">
 554
 555 <p>ShadeImage() shines a distant light on an image to create a three-dimensional effect. You control the positioning of the light with azimuth and elevation; azimuth is measured in degrees off the x axis and elevation is measured in pixels above the Z axis.</p></ol>
 556
 557 <p>The format of the ShadeImage method is:</p>
 558
 559 <pre class="code">
 560   Image *ShadeImage(const Image *image,const MagickBooleanType gray,
 561     const double azimuth,const double elevation,ExceptionInfo *exception)
 562 </pre>
 563
 564 <p>A description of each parameter follows:</p></ol>
 565
 566 <h5>image</h5>
 567 <ol><p>the image.</p></ol>
 568
 569 <h5>gray</h5>
 570 <ol><p>A value other than zero shades the intensity of each pixel.</p></ol>
 571
 572 <h5>azimuth, elevation</h5>
 573 <ol><p>Define the light source direction.</p></ol>
 574
 575 <h5>exception</h5>
 576 <ol><p>return any errors or warnings in this structure.</p></ol>
 577
 578  </div>
 579 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 580 _8c.html" target="source" name="SharpenImage">SharpenImage</a></h2>
 581 <div class="doc-section">
 582
 583 <p>SharpenImage() sharpens the image.  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 SharpenImage() selects a suitable radius for you.</p></ol>
 584
 585 <p>Using a separable kernel would be faster, but the negative weights cancel out on the corners of the kernel producing often undesirable ringing in the filtered result; this can be avoided by using a 2D gaussian shaped image sharpening kernel instead.</p></ol>
 586
 587 <p>The format of the SharpenImage method is:</p>
 588
 589 <pre class="code">
 590       Image *SharpenImage(const Image *image,const double radius,
 591   const double sigma,ExceptionInfo *exception)
 592       Image *SharpenImageChannel(const Image *image,const ChannelType channel,
 593   const double radius,const double sigma,ExceptionInfo *exception)
 594 </pre>
 595
 596 <p>A description of each parameter follows:</p></ol>
 597
 598 <h5>image</h5>
 599 <ol><p>the image.</p></ol>
 600
 601 <h5>channel</h5>
 602 <ol><p>the channel type.</p></ol>
 603
 604 <h5>radius</h5>
 605 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 606
 607 <h5>sigma</h5>
 608 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 609
 610 <h5>exception</h5>
 611 <ol><p>return any errors or warnings in this structure.</p></ol>
 612
 613  </div>
 614 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 615 _8c.html" target="source" name="SpreadImage">SpreadImage</a></h2>
 616 <div class="doc-section">
 617
 618 <p>SpreadImage() is a special effects method that randomly displaces each pixel in a block defined by the radius parameter.</p></ol>
 619
 620 <p>The format of the SpreadImage method is:</p>
 621
 622 <pre class="code">
 623   Image *SpreadImage(const Image *image,const double radius,
 624     ExceptionInfo *exception)
 625 </pre>
 626
 627 <p>A description of each parameter follows:</p></ol>
 628
 629 <h5>image</h5>
 630 <ol><p>the image.</p></ol>
 631
 632 <h5>radius</h5>
 633 <ol><p>Choose a random pixel in a neighborhood of this extent.</p></ol>
 634
 635 <h5>exception</h5>
 636 <ol><p>return any errors or warnings in this structure.</p></ol>
 637
 638  </div>
 639 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 640 _8c.html" target="source" name="UnsharpMaskImage">UnsharpMaskImage</a></h2>
 641 <div class="doc-section">
 642
 643 <p>UnsharpMaskImage() sharpens one or more image channels.  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 UnsharpMaskImage() selects a suitable radius for you.</p></ol>
 644
 645 <p>The format of the UnsharpMaskImage method is:</p>
 646
 647 <pre class="code">
 648       Image *UnsharpMaskImage(const Image *image,const double radius,
 649   const double sigma,const double amount,const double threshold,
 650   ExceptionInfo *exception)
 651       Image *UnsharpMaskImageChannel(const Image *image,
 652   const ChannelType channel,const double radius,const double sigma,
 653   const double amount,const double threshold,ExceptionInfo *exception)
 654 </pre>
 655
 656 <p>A description of each parameter follows:</p></ol>
 657
 658 <h5>image</h5>
 659 <ol><p>the image.</p></ol>
 660
 661 <h5>channel</h5>
 662 <ol><p>the channel type.</p></ol>
 663
 664 <h5>radius</h5>
 665 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 666
 667 <h5>sigma</h5>
 668 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 669
 670 <h5>amount</h5>
 671 <ol><p>the percentage of the difference between the original and the blur image that is added back into the original.</p></ol>
 672
 673 <h5>threshold</h5>
 674 <ol><p>the threshold in pixels needed to apply the diffence amount.</p></ol>
 675
 676 <h5>exception</h5>
 677 <ol><p>return any errors or warnings in this structure.</p></ol>
 678
 679  </div>
 680 \r
 681 </div>\r
 682 \r
 683 <div id="linkbar">\r
 684  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 685     <span id="linkbar-center">\r
 686       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 687       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
 688     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 689     </span>\r
 690     <span id="linkbar-east">&nbsp;</span>\r
 691   </div>\r
 692   <div class="footer">\r
 693     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 694     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 695   </div>\r
 696   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 697 </body>\r
 698 </html>\r