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" 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 an 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, an, effect, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  18   <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
  19   <meta name="Rating" content="GENERAL"/>
  20   <meta name="Robots" content="INDEX, FOLLOW"/>
  21   <meta name="Generator" content="ImageMagick Studio LLC"/>
  22   <meta name="Author" content="ImageMagick Studio LLC"/>
  23   <meta name="Revisit-after" content="2 DAYS"/>
  24   <meta name="Resource-type" content="document"/>
  25   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  26   <meta name="Distribution" content="Global"/>
  27 </head>\r
  28 \r
  29 <body id="www-imagemagick-org">\r
  30 <div class="titlebar">\r
  31 <a href="../../index.html">\r
  32   <img src="../../images/script.png" alt="[ImageMagick]"\r
  33   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  34 <a href="http://www.networkredux.com">\r
  35   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  36   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  37 <a href="http://www.imagemagick.org/discourse-server/">\r
  38   <img src="../../images/logo.jpg" alt=""\r
  39   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  40 <a href="../../index.html">\r
  41   <img src="../../images/sprite.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 </div>\r
  44 \r
  45 <div class="westbar">\r
  46 \r
  47 <div class="menu">
  48   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  52   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  53 </div>
  54 <div class="sub">
  55     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  56 </div>
  57 <div class="sub">
  58     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  59 </div>
  60 <div class="sub">
  61     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
  62 </div>
  63 <div class="sep"></div>\r
  64 <div class="menu">
  65   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  66 </div>
  67 <div class="sub">
  68     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  69 </div>
  70 <div class="sub">
  71     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  72 </div>
  73 <div class="sub">
  74     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  75 </div>
  76 <div class="menu">
  77   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  78 </div>
  79 <div class="sub">
  80     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  81 </div>
  82 <div class="sub">
  83     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  90 </div>
  91 <div class="sep"></div>\r
  92 <div  class="menu">
  93    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  94 </div>
  95 <div class="sub">
  96     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 100  </div>
 101 <div class="menu">
 102   <a title="Resources" href="../../www/resources.html">Resources</a>
 103 </div>
 104 <div class="menu">
 105   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 106 </div>
 107 <div class="menu">
 108   <a title="Download" href="../../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 128 </div>
 129 <div  class="sponsor">
 130   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 140 </div>
 141 <div  class="sponsor">
 142    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 143 </div>
 144 <div  class="sponsor">
 145    <a title="Sponsor: Online-Magazin" href="http://www.unkostenbeitrag.de/">Online-Magazin</a><!-- 20101101000200 -->
 146 </div>
 147 </div>
 148 </div>
 149 </div>\r
 150 \r
 151 <div class="eastbar">\r
 152   <script type="text/javascript">\r
 153   <!--\r
 154     google_ad_client = "pub-3129977114552745";\r
 155     google_ad_slot = "0574824969";\r
 156     google_ad_width = 160;\r
 157     google_ad_height = 600;\r
 158   //-->\r
 159   </script>\r
 160   <script type="text/javascript"\r
 161     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 162   </script>\r
 163 </div>\r
 164 \r
 165 <div class="main">\r
 166 \r
 167 <p class="navigation-index">[<a href="#AdaptiveBlurImage">AdaptiveBlurImage</a> &bull; <a href="#AdaptiveSharpenImage">AdaptiveSharpenImage</a> &bull; <a href="#BlurImage">BlurImage</a> &bull; <a href="#ConvolveImage">ConvolveImage</a> &bull; <a href="#DespeckleImage">DespeckleImage</a> &bull; <a href="#EdgeImage">EdgeImage</a> &bull; <a href="#EmbossImage">EmbossImage</a> &bull; <a href="#FilterImage">FilterImage</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>
 168
 169 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 170 _8c.html" target="source" name="AdaptiveBlurImage">AdaptiveBlurImage</a></h2>
 171 <div class="doc-section">
 172
 173 <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>
 174
 175 <p>The format of the AdaptiveBlurImage method is:</p>
 176
 177 <pre class="code">
 178   Image *AdaptiveBlurImage(const Image *image,const double radius,
 179     const double sigma,ExceptionInfo *exception)
 180   Image *AdaptiveBlurImageChannel(const Image *image,
 181     const ChannelType channel,double radius,const double sigma,
 182     ExceptionInfo *exception)
 183 </pre>
 184
 185 <p>A description of each parameter follows:</p></ol>
 186
 187 <h5>image</h5>
 188 <ol><p>the image.</p></ol>
 189
 190 <h5>channel</h5>
 191 <ol><p>the channel type.</p></ol>
 192
 193 <h5>radius</h5>
 194 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 195
 196 <h5>sigma</h5>
 197 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 198
 199 <h5>exception</h5>
 200 <ol><p>return any errors or warnings in this structure.</p></ol>
 201
 202  </div>
 203 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 204 _8c.html" target="source" name="AdaptiveSharpenImage">AdaptiveSharpenImage</a></h2>
 205 <div class="doc-section">
 206
 207 <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>
 208
 209 <p>The format of the AdaptiveSharpenImage method is:</p>
 210
 211 <pre class="code">
 212   Image *AdaptiveSharpenImage(const Image *image,const double radius,
 213     const double sigma,ExceptionInfo *exception)
 214   Image *AdaptiveSharpenImageChannel(const Image *image,
 215     const ChannelType channel,double radius,const double sigma,
 216     ExceptionInfo *exception)
 217 </pre>
 218
 219 <p>A description of each parameter follows:</p></ol>
 220
 221 <h5>image</h5>
 222 <ol><p>the image.</p></ol>
 223
 224 <h5>channel</h5>
 225 <ol><p>the channel type.</p></ol>
 226
 227 <h5>radius</h5>
 228 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 229
 230 <h5>sigma</h5>
 231 <ol><p>the standard deviation of the Laplacian, 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/effect
 238 _8c.html" target="source" name="BlurImage">BlurImage</a></h2>
 239 <div class="doc-section">
 240
 241 <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>
 242
 243 <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>
 244
 245 <p>The format of the BlurImage method is:</p>
 246
 247 <pre class="code">
 248   Image *BlurImage(const Image *image,const double radius,
 249     const double sigma,ExceptionInfo *exception)
 250   Image *BlurImageChannel(const Image *image,const ChannelType channel,
 251     const double radius,const double sigma,ExceptionInfo *exception)
 252 </pre>
 253
 254 <p>A description of each parameter follows:</p></ol>
 255
 256 <h5>image</h5>
 257 <ol><p>the image.</p></ol>
 258
 259 <h5>channel</h5>
 260 <ol><p>the channel type.</p></ol>
 261
 262 <h5>radius</h5>
 263 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 264
 265 <h5>sigma</h5>
 266 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 267
 268 <h5>exception</h5>
 269 <ol><p>return any errors or warnings in this structure.</p></ol>
 270
 271  </div>
 272 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 273 _8c.html" target="source" name="ConvolveImage">ConvolveImage</a></h2>
 274 <div class="doc-section">
 275
 276 <p>ConvolveImage() applies a custom convolution kernel to the image.</p></ol>
 277
 278 <p>The format of the ConvolveImage method is:</p>
 279
 280 <pre class="code">
 281   Image *ConvolveImage(const Image *image,const size_t order,
 282     const double *kernel,ExceptionInfo *exception)
 283   Image *ConvolveImageChannel(const Image *image,const ChannelType channel,
 284     const size_t order,const double *kernel,
 285     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 type.</p></ol>
 295
 296 <h5>order</h5>
 297 <ol><p>the number of columns and rows in the filter kernel.</p></ol>
 298
 299 <h5>kernel</h5>
 300 <ol><p>An array of double representing the convolution kernel.</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/effect
 307 _8c.html" target="source" name="DespeckleImage">DespeckleImage</a></h2>
 308 <div class="doc-section">
 309
 310 <p>DespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.</p></ol>
 311
 312 <p>The format of the DespeckleImage method is:</p>
 313
 314 <pre class="code">
 315   Image *DespeckleImage(const Image *image,ExceptionInfo *exception)
 316 </pre>
 317
 318 <p>A description of each parameter follows:</p></ol>
 319
 320 <h5>image</h5>
 321 <ol><p>the image.</p></ol>
 322
 323 <h5>exception</h5>
 324 <ol><p>return any errors or warnings in this structure.</p></ol>
 325
 326  </div>
 327 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 328 _8c.html" target="source" name="EdgeImage">EdgeImage</a></h2>
 329 <div class="doc-section">
 330
 331 <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>
 332
 333 <p>The format of the EdgeImage method is:</p>
 334
 335 <pre class="code">
 336   Image *EdgeImage(const Image *image,const double radius,
 337     ExceptionInfo *exception)
 338 </pre>
 339
 340 <p>A description of each parameter follows:</p></ol>
 341
 342 <h5>image</h5>
 343 <ol><p>the image.</p></ol>
 344
 345 <h5>radius</h5>
 346 <ol><p>the radius of the pixel neighborhood.</p></ol>
 347
 348 <h5>exception</h5>
 349 <ol><p>return any errors or warnings in this structure.</p></ol>
 350
 351  </div>
 352 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 353 _8c.html" target="source" name="EmbossImage">EmbossImage</a></h2>
 354 <div class="doc-section">
 355
 356 <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>
 357
 358 <p>The format of the EmbossImage method is:</p>
 359
 360 <pre class="code">
 361   Image *EmbossImage(const Image *image,const double radius,
 362     const double sigma,ExceptionInfo *exception)
 363 </pre>
 364
 365 <p>A description of each parameter follows:</p></ol>
 366
 367 <h5>image</h5>
 368 <ol><p>the image.</p></ol>
 369
 370 <h5>radius</h5>
 371 <ol><p>the radius of the pixel neighborhood.</p></ol>
 372
 373 <h5>sigma</h5>
 374 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 375
 376 <h5>exception</h5>
 377 <ol><p>return any errors or warnings in this structure.</p></ol>
 378
 379  </div>
 380 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 381 _8c.html" target="source" name="FilterImage">FilterImage</a></h2>
 382 <div class="doc-section">
 383
 384 <p>FilterImage() applies a custom convolution kernel to the image.</p></ol>
 385
 386 <p>The format of the FilterImage method is:</p>
 387
 388 <pre class="code">
 389   Image *FilterImage(const Image *image,const KernelInfo *kernel,
 390     ExceptionInfo *exception)
 391   Image *FilterImageChannel(const Image *image,const ChannelType channel,
 392     const KernelInfo *kernel,ExceptionInfo *exception)
 393 </pre>
 394
 395 <p>A description of each parameter follows:</p></ol>
 396
 397 <h5>image</h5>
 398 <ol><p>the image.</p></ol>
 399
 400 <h5>channel</h5>
 401 <ol><p>the channel type.</p></ol>
 402
 403 <h5>kernel</h5>
 404 <ol><p>the filtering kernel.</p></ol>
 405
 406 <h5>exception</h5>
 407 <ol><p>return any errors or warnings in this structure.</p></ol>
 408
 409  </div>
 410 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 411 _8c.html" target="source" name="GaussianBlurImage">GaussianBlurImage</a></h2>
 412 <div class="doc-section">
 413
 414 <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>
 415
 416 <p>The format of the GaussianBlurImage method is:</p>
 417
 418 <pre class="code">
 419   Image *GaussianBlurImage(const Image *image,onst double radius,
 420     const double sigma,ExceptionInfo *exception)
 421   Image *GaussianBlurImageChannel(const Image *image,
 422     const ChannelType channel,const double radius,const double sigma,
 423     ExceptionInfo *exception)
 424 </pre>
 425
 426 <p>A description of each parameter follows:</p></ol>
 427
 428 <h5>image</h5>
 429 <ol><p>the image.</p></ol>
 430
 431 <h5>channel</h5>
 432 <ol><p>the channel type.</p></ol>
 433
 434 <h5>radius</h5>
 435 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 436
 437 <h5>sigma</h5>
 438 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 439
 440 <h5>exception</h5>
 441 <ol><p>return any errors or warnings in this structure.</p></ol>
 442
 443  </div>
 444 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 445 _8c.html" target="source" name="MedianFilterImage">MedianFilterImage</a></h2>
 446 <div class="doc-section">
 447
 448 <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>
 449
 450 <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>
 451
 452 <p>The format of the MedianFilterImage method is:</p>
 453
 454 <pre class="code">
 455   Image *MedianFilterImage(const Image *image,const double radius,
 456     ExceptionInfo *exception)
 457 </pre>
 458
 459 <p>A description of each parameter follows:</p></ol>
 460
 461 <h5>image</h5>
 462 <ol><p>the image.</p></ol>
 463
 464 <h5>radius</h5>
 465 <ol><p>the radius of the pixel neighborhood.</p></ol>
 466
 467 <h5>exception</h5>
 468 <ol><p>return any errors or warnings in this structure.</p></ol>
 469
 470  </div>
 471 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 472 _8c.html" target="source" name="MotionBlurImage">MotionBlurImage</a></h2>
 473 <div class="doc-section">
 474
 475 <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>
 476
 477 <p>Andrew Protano contributed this effect.</p></ol>
 478
 479 <p>The format of the MotionBlurImage method is:</p>
 480
 481 <pre class="code">
 482       Image *MotionBlurImage(const Image *image,const double radius,
 483   const double sigma,const double angle,ExceptionInfo *exception)
 484       Image *MotionBlurImageChannel(const Image *image,const ChannelType channel,
 485   const double radius,const double sigma,const double angle,
 486   ExceptionInfo *exception)
 487 </pre>
 488
 489 <p>A description of each parameter follows:</p></ol>
 490
 491 <h5>image</h5>
 492 <ol><p>the image.</p></ol>
 493
 494 <h5>channel</h5>
 495 <ol><p>the channel type.</p></ol>
 496
 497 <h5>radius</h5>
 498 <ol><p>the radius of the Gaussian, in pixels, not counting the center</p>
 499 <h5>radius</h5>
 500 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 501
 502 <h5>sigma</h5>
 503 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 504
 505 <h5>angle</h5>
 506 <ol><p>Apply the effect along this angle.</p></ol>
 507
 508 <h5>exception</h5>
 509 <ol><p>return any errors or warnings in this structure.</p></ol>
 510
 511  </div>
 512 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 513 _8c.html" target="source" name="PreviewImage">PreviewImage</a></h2>
 514 <div class="doc-section">
 515
 516 <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>
 517
 518 <p>The format of the PreviewImages method is:</p>
 519
 520 <pre class="code">
 521   Image *PreviewImages(const Image *image,const PreviewType preview,
 522     ExceptionInfo *exception)
 523 </pre>
 524
 525 <p>A description of each parameter follows:</p></ol>
 526
 527 <h5>image</h5>
 528 <ol><p>the image.</p></ol>
 529
 530 <h5>preview</h5>
 531 <ol><p>the image processing operation.</p></ol>
 532
 533 <h5>exception</h5>
 534 <ol><p>return any errors or warnings in this structure.</p></ol>
 535
 536  </div>
 537 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 538 _8c.html" target="source" name="RadialBlurImage">RadialBlurImage</a></h2>
 539 <div class="doc-section">
 540
 541 <p>RadialBlurImage() applies a radial blur to the image.</p></ol>
 542
 543 <p>Andrew Protano contributed this effect.</p></ol>
 544
 545 <p>The format of the RadialBlurImage method is:</p>
 546
 547 <pre class="code">
 548       Image *RadialBlurImage(const Image *image,const double angle,
 549   ExceptionInfo *exception)
 550       Image *RadialBlurImageChannel(const Image *image,const ChannelType channel,
 551   const double angle,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>channel</h5>
 560 <ol><p>the channel type.</p></ol>
 561
 562 <h5>angle</h5>
 563 <ol><p>the angle of the radial blur.</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/effect
 570 _8c.html" target="source" name="ReduceNoiseImage">ReduceNoiseImage</a></h2>
 571 <div class="doc-section">
 572
 573 <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>
 574
 575 <p>The format of the ReduceNoiseImage method is:</p>
 576
 577 <pre class="code">
 578   Image *ReduceNoiseImage(const Image *image,const double radius,
 579     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 pixel neighborhood.</p></ol>
 589
 590 <h5>exception</h5>
 591 <ol><p>return any errors or warnings in this structure.</p></ol>
 592
 593  </div>
 594 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 595 _8c.html" target="source" name="SelectiveBlurImage">SelectiveBlurImage</a></h2>
 596 <div class="doc-section">
 597
 598 <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>
 599
 600 <p>The format of the SelectiveBlurImage method is:</p>
 601
 602 <pre class="code">
 603   Image *SelectiveBlurImage(const Image *image,const double radius,
 604     const double sigma,const double threshold,ExceptionInfo *exception)
 605   Image *SelectiveBlurImageChannel(const Image *image,
 606     const ChannelType channel,const double radius,const double sigma,
 607     const double threshold,ExceptionInfo *exception)
 608 </pre>
 609
 610 <p>A description of each parameter follows:</p></ol>
 611
 612 <h5>image</h5>
 613 <ol><p>the image.</p></ol>
 614
 615 <h5>channel</h5>
 616 <ol><p>the channel type.</p></ol>
 617
 618 <h5>radius</h5>
 619 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 620
 621 <h5>sigma</h5>
 622 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 623
 624 <h5>threshold</h5>
 625 <ol><p>only pixels within this contrast threshold are included in the blur operation.</p></ol>
 626
 627 <h5>exception</h5>
 628 <ol><p>return any errors or warnings in this structure.</p></ol>
 629
 630  </div>
 631 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 632 _8c.html" target="source" name="ShadeImage">ShadeImage</a></h2>
 633 <div class="doc-section">
 634
 635 <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>
 636
 637 <p>The format of the ShadeImage method is:</p>
 638
 639 <pre class="code">
 640   Image *ShadeImage(const Image *image,const MagickBooleanType gray,
 641     const double azimuth,const double elevation,ExceptionInfo *exception)
 642 </pre>
 643
 644 <p>A description of each parameter follows:</p></ol>
 645
 646 <h5>image</h5>
 647 <ol><p>the image.</p></ol>
 648
 649 <h5>gray</h5>
 650 <ol><p>A value other than zero shades the intensity of each pixel.</p></ol>
 651
 652 <h5>azimuth, elevation</h5>
 653 <ol><p>Define the light source direction.</p></ol>
 654
 655 <h5>exception</h5>
 656 <ol><p>return any errors or warnings in this structure.</p></ol>
 657
 658  </div>
 659 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 660 _8c.html" target="source" name="SharpenImage">SharpenImage</a></h2>
 661 <div class="doc-section">
 662
 663 <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>
 664
 665 <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>
 666
 667 <p>The format of the SharpenImage method is:</p>
 668
 669 <pre class="code">
 670       Image *SharpenImage(const Image *image,const double radius,
 671   const double sigma,ExceptionInfo *exception)
 672       Image *SharpenImageChannel(const Image *image,const ChannelType channel,
 673   const double radius,const double sigma,ExceptionInfo *exception)
 674 </pre>
 675
 676 <p>A description of each parameter follows:</p></ol>
 677
 678 <h5>image</h5>
 679 <ol><p>the image.</p></ol>
 680
 681 <h5>channel</h5>
 682 <ol><p>the channel type.</p></ol>
 683
 684 <h5>radius</h5>
 685 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 686
 687 <h5>sigma</h5>
 688 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 689
 690 <h5>exception</h5>
 691 <ol><p>return any errors or warnings in this structure.</p></ol>
 692
 693  </div>
 694 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 695 _8c.html" target="source" name="SpreadImage">SpreadImage</a></h2>
 696 <div class="doc-section">
 697
 698 <p>SpreadImage() is a special effects method that randomly displaces each pixel in a block defined by the radius parameter.</p></ol>
 699
 700 <p>The format of the SpreadImage method is:</p>
 701
 702 <pre class="code">
 703   Image *SpreadImage(const Image *image,const double radius,
 704     ExceptionInfo *exception)
 705 </pre>
 706
 707 <p>A description of each parameter follows:</p></ol>
 708
 709 <h5>image</h5>
 710 <ol><p>the image.</p></ol>
 711
 712 <h5>radius</h5>
 713 <ol><p>Choose a random pixel in a neighborhood of this extent.</p></ol>
 714
 715 <h5>exception</h5>
 716 <ol><p>return any errors or warnings in this structure.</p></ol>
 717
 718  </div>
 719 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 720 _8c.html" target="source" name="UnsharpMaskImage">UnsharpMaskImage</a></h2>
 721 <div class="doc-section">
 722
 723 <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>
 724
 725 <p>The format of the UnsharpMaskImage method is:</p>
 726
 727 <pre class="code">
 728       Image *UnsharpMaskImage(const Image *image,const double radius,
 729   const double sigma,const double amount,const double threshold,
 730   ExceptionInfo *exception)
 731       Image *UnsharpMaskImageChannel(const Image *image,
 732   const ChannelType channel,const double radius,const double sigma,
 733   const double amount,const double threshold,ExceptionInfo *exception)
 734 </pre>
 735
 736 <p>A description of each parameter follows:</p></ol>
 737
 738 <h5>image</h5>
 739 <ol><p>the image.</p></ol>
 740
 741 <h5>channel</h5>
 742 <ol><p>the channel type.</p></ol>
 743
 744 <h5>radius</h5>
 745 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 746
 747 <h5>sigma</h5>
 748 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 749
 750 <h5>amount</h5>
 751 <ol><p>the percentage of the difference between the original and the blur image that is added back into the original.</p></ol>
 752
 753 <h5>threshold</h5>
 754 <ol><p>the threshold in pixels needed to apply the diffence amount.</p></ol>
 755
 756 <h5>exception</h5>
 757 <ol><p>return any errors or warnings in this structure.</p></ol>
 758
 759  </div>
 760 \r
 761 </div>\r
 762 \r
 763 <div id="linkbar">\r
 764     <span id="linkbar-west">&nbsp;</span>\r
 765     <span id="linkbar-center">\r
 766       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 767       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 768     </span>\r
 769     <span id="linkbar-east">&nbsp;</span>\r
 770   </div>\r
 771   <div class="footer">\r
 772     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 773     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 774   </div>\r
 775   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 776   <script type="text/javascript">\r
 777     var _gaq = _gaq || [];\r
 778     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 779     _gaq.push(['_trackPageview']);\r
 780 \r
 781     (function() {\r
 782       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 783       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 784       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 785     })();\r
 786   </script>\r
 787 </body>\r
 788 </html>\r