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="eastbar">\r
  46 \r
  47 <div class="menu">
  48   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  49 </div>
  50 <div class="sep"></div>\r
  51 <div class="menu">
  52   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  53 </div>
  54 <div class="sub">
  55     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  56 </div>
  57 <div class="sub">
  58     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  59 </div>
  60 <div class="sub">
  61     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  62 </div>
  63 <div class="menu">
  64   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  65 </div>
  66 <div class="sub">
  67     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  68 </div>
  69 <div class="sub">
  70     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  71 </div>
  72 <div class="sub">
  73     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  74 </div>
  75 <div class="sub">
  76     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  77 </div>
  78 <div class="menu">
  79   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
  80 </div>
  81 <div class="sep"></div>\r
  82 <div  class="menu">
  83    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
  90  </div>
  91 <div class="menu">
  92   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  93 </div>
  94 <div class="sub">
  95     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  96 </div>
  97 <div class="sub">
  98     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  99 </div>
 100 <div class="sub">
 101     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
 102 </div>
 103 <div class="menu">
 104   <a title="Resources" href="../../www/resources.html">Resources</a>
 105 </div>
 106 <div class="sep"></div>\r
 107 <div class="menu">
 108   <a title="Download" href="../../www/download.html">Download</a>
 109 </div>
 110 <div class="sep"></div>\r
 111 <div class="menu">
 112   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 113 </div>
 114 <div class="sep"></div>\r
 115 <div class="menu">
 116   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 117 </div>
 118 <div  class="sub">
 119     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 120 </div>
 121 <div class="sep"></div>\r
 122 <div  class="menu">
 123   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 124
 125 <div class="sponsbox">
 126 <div  class="sponsor">
 127   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 128 </div>
 129 <div  class="sponsor">
 130   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Kredit" href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 140 </div>
 141 <div  class="sponsor">
 142    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 143 </div>
 144 <div  class="sponsor">
 145    <a title="Sponsor: Webdesign" href="http://www.renehornig.com/" title="Webdesign">Webdesign</a><!-- 20110101000120 -->
 146 </div>
 147 </div>
 148 </div>
 149 \r
 150 \r
 151 </div>\r
 152 \r
 153 <div class="main">\r
 154 \r
 155 <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>
 156
 157 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 158 _8c.html" target="source" name="AdaptiveBlurImage">AdaptiveBlurImage</a></h2>
 159 <div class="doc-section">
 160
 161 <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>
 162
 163 <p>The format of the AdaptiveBlurImage method is:</p>
 164
 165 <pre class="code">
 166   Image *AdaptiveBlurImage(const Image *image,const double radius,
 167     const double sigma,ExceptionInfo *exception)
 168   Image *AdaptiveBlurImageChannel(const Image *image,
 169     const ChannelType channel,double radius,const double sigma,
 170     ExceptionInfo *exception)
 171 </pre>
 172
 173 <p>A description of each parameter follows:</p></ol>
 174
 175 <h5>image</h5>
 176 <ol><p>the image.</p></ol>
 177
 178 <h5>channel</h5>
 179 <ol><p>the channel type.</p></ol>
 180
 181 <h5>radius</h5>
 182 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 183
 184 <h5>sigma</h5>
 185 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 186
 187 <h5>exception</h5>
 188 <ol><p>return any errors or warnings in this structure.</p></ol>
 189
 190  </div>
 191 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 192 _8c.html" target="source" name="AdaptiveSharpenImage">AdaptiveSharpenImage</a></h2>
 193 <div class="doc-section">
 194
 195 <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>
 196
 197 <p>The format of the AdaptiveSharpenImage method is:</p>
 198
 199 <pre class="code">
 200   Image *AdaptiveSharpenImage(const Image *image,const double radius,
 201     const double sigma,ExceptionInfo *exception)
 202   Image *AdaptiveSharpenImageChannel(const Image *image,
 203     const ChannelType channel,double radius,const double sigma,
 204     ExceptionInfo *exception)
 205 </pre>
 206
 207 <p>A description of each parameter follows:</p></ol>
 208
 209 <h5>image</h5>
 210 <ol><p>the image.</p></ol>
 211
 212 <h5>channel</h5>
 213 <ol><p>the channel type.</p></ol>
 214
 215 <h5>radius</h5>
 216 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 217
 218 <h5>sigma</h5>
 219 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 220
 221 <h5>exception</h5>
 222 <ol><p>return any errors or warnings in this structure.</p></ol>
 223
 224  </div>
 225 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 226 _8c.html" target="source" name="BlurImage">BlurImage</a></h2>
 227 <div class="doc-section">
 228
 229 <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>
 230
 231 <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>
 232
 233 <p>The format of the BlurImage method is:</p>
 234
 235 <pre class="code">
 236   Image *BlurImage(const Image *image,const double radius,
 237     const double sigma,ExceptionInfo *exception)
 238   Image *BlurImageChannel(const Image *image,const ChannelType channel,
 239     const double radius,const double sigma,ExceptionInfo *exception)
 240 </pre>
 241
 242 <p>A description of each parameter follows:</p></ol>
 243
 244 <h5>image</h5>
 245 <ol><p>the image.</p></ol>
 246
 247 <h5>channel</h5>
 248 <ol><p>the channel type.</p></ol>
 249
 250 <h5>radius</h5>
 251 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 252
 253 <h5>sigma</h5>
 254 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 255
 256 <h5>exception</h5>
 257 <ol><p>return any errors or warnings in this structure.</p></ol>
 258
 259  </div>
 260 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 261 _8c.html" target="source" name="ConvolveImage">ConvolveImage</a></h2>
 262 <div class="doc-section">
 263
 264 <p>ConvolveImage() applies a custom convolution kernel to the image.</p></ol>
 265
 266 <p>The format of the ConvolveImage method is:</p>
 267
 268 <pre class="code">
 269   Image *ConvolveImage(const Image *image,const unsigned long order,
 270     const double *kernel,ExceptionInfo *exception)
 271   Image *ConvolveImageChannel(const Image *image,const ChannelType channel,
 272     const unsigned long order,const double *kernel,
 273     ExceptionInfo *exception)
 274 </pre>
 275
 276 <p>A description of each parameter follows:</p></ol>
 277
 278 <h5>image</h5>
 279 <ol><p>the image.</p></ol>
 280
 281 <h5>channel</h5>
 282 <ol><p>the channel type.</p></ol>
 283
 284 <h5>order</h5>
 285 <ol><p>the number of columns and rows in the filter kernel.</p></ol>
 286
 287 <h5>kernel</h5>
 288 <ol><p>An array of double representing the convolution kernel.</p></ol>
 289
 290 <h5>exception</h5>
 291 <ol><p>return any errors or warnings in this structure.</p></ol>
 292
 293  </div>
 294 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 295 _8c.html" target="source" name="DespeckleImage">DespeckleImage</a></h2>
 296 <div class="doc-section">
 297
 298 <p>DespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.</p></ol>
 299
 300 <p>The format of the DespeckleImage method is:</p>
 301
 302 <pre class="code">
 303   Image *DespeckleImage(const Image *image,ExceptionInfo *exception)
 304 </pre>
 305
 306 <p>A description of each parameter follows:</p></ol>
 307
 308 <h5>image</h5>
 309 <ol><p>the image.</p></ol>
 310
 311 <h5>exception</h5>
 312 <ol><p>return any errors or warnings in this structure.</p></ol>
 313
 314  </div>
 315 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 316 _8c.html" target="source" name="EdgeImage">EdgeImage</a></h2>
 317 <div class="doc-section">
 318
 319 <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>
 320
 321 <p>The format of the EdgeImage method is:</p>
 322
 323 <pre class="code">
 324   Image *EdgeImage(const Image *image,const double radius,
 325     ExceptionInfo *exception)
 326 </pre>
 327
 328 <p>A description of each parameter follows:</p></ol>
 329
 330 <h5>image</h5>
 331 <ol><p>the image.</p></ol>
 332
 333 <h5>radius</h5>
 334 <ol><p>the radius of the pixel neighborhood.</p></ol>
 335
 336 <h5>exception</h5>
 337 <ol><p>return any errors or warnings in this structure.</p></ol>
 338
 339  </div>
 340 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 341 _8c.html" target="source" name="EmbossImage">EmbossImage</a></h2>
 342 <div class="doc-section">
 343
 344 <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>
 345
 346 <p>The format of the EmbossImage method is:</p>
 347
 348 <pre class="code">
 349   Image *EmbossImage(const Image *image,const double radius,
 350     const double sigma,ExceptionInfo *exception)
 351 </pre>
 352
 353 <p>A description of each parameter follows:</p></ol>
 354
 355 <h5>image</h5>
 356 <ol><p>the image.</p></ol>
 357
 358 <h5>radius</h5>
 359 <ol><p>the radius of the pixel neighborhood.</p></ol>
 360
 361 <h5>sigma</h5>
 362 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 363
 364 <h5>exception</h5>
 365 <ol><p>return any errors or warnings in this structure.</p></ol>
 366
 367  </div>
 368 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 369 _8c.html" target="source" name="FilterImage">FilterImage</a></h2>
 370 <div class="doc-section">
 371
 372 <p>FilterImage() applies a custom convolution kernel to the image.</p></ol>
 373
 374 <p>The format of the FilterImage method is:</p>
 375
 376 <pre class="code">
 377   Image *FilterImage(const Image *image,const KernelInfo *kernel,
 378     ExceptionInfo *exception)
 379   Image *FilterImageChannel(const Image *image,const ChannelType channel,
 380     const KernelInfo *kernel,ExceptionInfo *exception)
 381 </pre>
 382
 383 <p>A description of each parameter follows:</p></ol>
 384
 385 <h5>image</h5>
 386 <ol><p>the image.</p></ol>
 387
 388 <h5>channel</h5>
 389 <ol><p>the channel type.</p></ol>
 390
 391 <h5>kernel</h5>
 392 <ol><p>the filtering kernel.</p></ol>
 393
 394 <h5>exception</h5>
 395 <ol><p>return any errors or warnings in this structure.</p></ol>
 396
 397  </div>
 398 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 399 _8c.html" target="source" name="GaussianBlurImage">GaussianBlurImage</a></h2>
 400 <div class="doc-section">
 401
 402 <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>
 403
 404 <p>The format of the GaussianBlurImage method is:</p>
 405
 406 <pre class="code">
 407   Image *GaussianBlurImage(const Image *image,onst double radius,
 408     const double sigma,ExceptionInfo *exception)
 409   Image *GaussianBlurImageChannel(const Image *image,
 410     const ChannelType channel,const double radius,const double sigma,
 411     ExceptionInfo *exception)
 412 </pre>
 413
 414 <p>A description of each parameter follows:</p></ol>
 415
 416 <h5>image</h5>
 417 <ol><p>the image.</p></ol>
 418
 419 <h5>channel</h5>
 420 <ol><p>the channel type.</p></ol>
 421
 422 <h5>radius</h5>
 423 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 424
 425 <h5>sigma</h5>
 426 <ol><p>the standard deviation of the Gaussian, in pixels.</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="MedianFilterImage">MedianFilterImage</a></h2>
 434 <div class="doc-section">
 435
 436 <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>
 437
 438 <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>
 439
 440 <p>The format of the MedianFilterImage method is:</p>
 441
 442 <pre class="code">
 443   Image *MedianFilterImage(const Image *image,const double radius,
 444     ExceptionInfo *exception)
 445 </pre>
 446
 447 <p>A description of each parameter follows:</p></ol>
 448
 449 <h5>image</h5>
 450 <ol><p>the image.</p></ol>
 451
 452 <h5>radius</h5>
 453 <ol><p>the radius of the pixel neighborhood.</p></ol>
 454
 455 <h5>exception</h5>
 456 <ol><p>return any errors or warnings in this structure.</p></ol>
 457
 458  </div>
 459 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 460 _8c.html" target="source" name="MotionBlurImage">MotionBlurImage</a></h2>
 461 <div class="doc-section">
 462
 463 <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>
 464
 465 <p>Andrew Protano contributed this effect.</p></ol>
 466
 467 <p>The format of the MotionBlurImage method is:</p>
 468
 469 <pre class="code">
 470       Image *MotionBlurImage(const Image *image,const double radius,
 471   const double sigma,const double angle,ExceptionInfo *exception)
 472       Image *MotionBlurImageChannel(const Image *image,const ChannelType channel,
 473   const double radius,const double sigma,const double angle,
 474   ExceptionInfo *exception)
 475 </pre>
 476
 477 <p>A description of each parameter follows:</p></ol>
 478
 479 <h5>image</h5>
 480 <ol><p>the image.</p></ol>
 481
 482 <h5>channel</h5>
 483 <ol><p>the channel type.</p></ol>
 484
 485 <h5>radius</h5>
 486 <ol><p>the radius of the Gaussian, in pixels, not counting the center</p>
 487 <h5>radius</h5>
 488 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 489
 490 <h5>sigma</h5>
 491 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 492
 493 <h5>angle</h5>
 494 <ol><p>Apply the effect along this angle.</p></ol>
 495
 496 <h5>exception</h5>
 497 <ol><p>return any errors or warnings in this structure.</p></ol>
 498
 499  </div>
 500 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 501 _8c.html" target="source" name="PreviewImage">PreviewImage</a></h2>
 502 <div class="doc-section">
 503
 504 <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>
 505
 506 <p>The format of the PreviewImages method is:</p>
 507
 508 <pre class="code">
 509   Image *PreviewImages(const Image *image,const PreviewType preview,
 510     ExceptionInfo *exception)
 511 </pre>
 512
 513 <p>A description of each parameter follows:</p></ol>
 514
 515 <h5>image</h5>
 516 <ol><p>the image.</p></ol>
 517
 518 <h5>preview</h5>
 519 <ol><p>the image processing operation.</p></ol>
 520
 521 <h5>exception</h5>
 522 <ol><p>return any errors or warnings in this structure.</p></ol>
 523
 524  </div>
 525 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 526 _8c.html" target="source" name="RadialBlurImage">RadialBlurImage</a></h2>
 527 <div class="doc-section">
 528
 529 <p>RadialBlurImage() applies a radial blur to the image.</p></ol>
 530
 531 <p>Andrew Protano contributed this effect.</p></ol>
 532
 533 <p>The format of the RadialBlurImage method is:</p>
 534
 535 <pre class="code">
 536       Image *RadialBlurImage(const Image *image,const double angle,
 537   ExceptionInfo *exception)
 538       Image *RadialBlurImageChannel(const Image *image,const ChannelType channel,
 539   const double angle,ExceptionInfo *exception)
 540 </pre>
 541
 542 <p>A description of each parameter follows:</p></ol>
 543
 544 <h5>image</h5>
 545 <ol><p>the image.</p></ol>
 546
 547 <h5>channel</h5>
 548 <ol><p>the channel type.</p></ol>
 549
 550 <h5>angle</h5>
 551 <ol><p>the angle of the radial blur.</p></ol>
 552
 553 <h5>exception</h5>
 554 <ol><p>return any errors or warnings in this structure.</p></ol>
 555
 556  </div>
 557 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 558 _8c.html" target="source" name="ReduceNoiseImage">ReduceNoiseImage</a></h2>
 559 <div class="doc-section">
 560
 561 <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>
 562
 563 <p>The format of the ReduceNoiseImage method is:</p>
 564
 565 <pre class="code">
 566   Image *ReduceNoiseImage(const Image *image,const double radius,
 567     ExceptionInfo *exception)
 568 </pre>
 569
 570 <p>A description of each parameter follows:</p></ol>
 571
 572 <h5>image</h5>
 573 <ol><p>the image.</p></ol>
 574
 575 <h5>radius</h5>
 576 <ol><p>the radius of the pixel neighborhood.</p></ol>
 577
 578 <h5>exception</h5>
 579 <ol><p>return any errors or warnings in this structure.</p></ol>
 580
 581  </div>
 582 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 583 _8c.html" target="source" name="SelectiveBlurImage">SelectiveBlurImage</a></h2>
 584 <div class="doc-section">
 585
 586 <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>
 587
 588 <p>The format of the SelectiveBlurImage method is:</p>
 589
 590 <pre class="code">
 591   Image *SelectiveBlurImage(const Image *image,const double radius,
 592     const double sigma,const double threshold,ExceptionInfo *exception)
 593   Image *SelectiveBlurImageChannel(const Image *image,
 594     const ChannelType channel,const double radius,const double sigma,
 595     const double threshold,ExceptionInfo *exception)
 596 </pre>
 597
 598 <p>A description of each parameter follows:</p></ol>
 599
 600 <h5>image</h5>
 601 <ol><p>the image.</p></ol>
 602
 603 <h5>channel</h5>
 604 <ol><p>the channel type.</p></ol>
 605
 606 <h5>radius</h5>
 607 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 608
 609 <h5>sigma</h5>
 610 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 611
 612 <h5>threshold</h5>
 613 <ol><p>only pixels within this contrast threshold are included in the blur operation.</p></ol>
 614
 615 <h5>exception</h5>
 616 <ol><p>return any errors or warnings in this structure.</p></ol>
 617
 618  </div>
 619 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 620 _8c.html" target="source" name="ShadeImage">ShadeImage</a></h2>
 621 <div class="doc-section">
 622
 623 <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>
 624
 625 <p>The format of the ShadeImage method is:</p>
 626
 627 <pre class="code">
 628   Image *ShadeImage(const Image *image,const MagickBooleanType gray,
 629     const double azimuth,const double elevation,ExceptionInfo *exception)
 630 </pre>
 631
 632 <p>A description of each parameter follows:</p></ol>
 633
 634 <h5>image</h5>
 635 <ol><p>the image.</p></ol>
 636
 637 <h5>gray</h5>
 638 <ol><p>A value other than zero shades the intensity of each pixel.</p></ol>
 639
 640 <h5>azimuth, elevation</h5>
 641 <ol><p>Define the light source direction.</p></ol>
 642
 643 <h5>exception</h5>
 644 <ol><p>return any errors or warnings in this structure.</p></ol>
 645
 646  </div>
 647 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 648 _8c.html" target="source" name="SharpenImage">SharpenImage</a></h2>
 649 <div class="doc-section">
 650
 651 <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>
 652
 653 <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>
 654
 655 <p>The format of the SharpenImage method is:</p>
 656
 657 <pre class="code">
 658       Image *SharpenImage(const Image *image,const double radius,
 659   const double sigma,ExceptionInfo *exception)
 660       Image *SharpenImageChannel(const Image *image,const ChannelType channel,
 661   const double radius,const double sigma,ExceptionInfo *exception)
 662 </pre>
 663
 664 <p>A description of each parameter follows:</p></ol>
 665
 666 <h5>image</h5>
 667 <ol><p>the image.</p></ol>
 668
 669 <h5>channel</h5>
 670 <ol><p>the channel type.</p></ol>
 671
 672 <h5>radius</h5>
 673 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 674
 675 <h5>sigma</h5>
 676 <ol><p>the standard deviation of the Laplacian, in pixels.</p></ol>
 677
 678 <h5>exception</h5>
 679 <ol><p>return any errors or warnings in this structure.</p></ol>
 680
 681  </div>
 682 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 683 _8c.html" target="source" name="SpreadImage">SpreadImage</a></h2>
 684 <div class="doc-section">
 685
 686 <p>SpreadImage() is a special effects method that randomly displaces each pixel in a block defined by the radius parameter.</p></ol>
 687
 688 <p>The format of the SpreadImage method is:</p>
 689
 690 <pre class="code">
 691   Image *SpreadImage(const Image *image,const double radius,
 692     ExceptionInfo *exception)
 693 </pre>
 694
 695 <p>A description of each parameter follows:</p></ol>
 696
 697 <h5>image</h5>
 698 <ol><p>the image.</p></ol>
 699
 700 <h5>radius</h5>
 701 <ol><p>Choose a random pixel in a neighborhood of this extent.</p></ol>
 702
 703 <h5>exception</h5>
 704 <ol><p>return any errors or warnings in this structure.</p></ol>
 705
 706  </div>
 707 <h2><a href="http://www.imagemagick.org/api/MagickCore/effect
 708 _8c.html" target="source" name="UnsharpMaskImage">UnsharpMaskImage</a></h2>
 709 <div class="doc-section">
 710
 711 <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>
 712
 713 <p>The format of the UnsharpMaskImage method is:</p>
 714
 715 <pre class="code">
 716       Image *UnsharpMaskImage(const Image *image,const double radius,
 717   const double sigma,const double amount,const double threshold,
 718   ExceptionInfo *exception)
 719       Image *UnsharpMaskImageChannel(const Image *image,
 720   const ChannelType channel,const double radius,const double sigma,
 721   const double amount,const double threshold,ExceptionInfo *exception)
 722 </pre>
 723
 724 <p>A description of each parameter follows:</p></ol>
 725
 726 <h5>image</h5>
 727 <ol><p>the image.</p></ol>
 728
 729 <h5>channel</h5>
 730 <ol><p>the channel type.</p></ol>
 731
 732 <h5>radius</h5>
 733 <ol><p>the radius of the Gaussian, in pixels, not counting the center pixel.</p></ol>
 734
 735 <h5>sigma</h5>
 736 <ol><p>the standard deviation of the Gaussian, in pixels.</p></ol>
 737
 738 <h5>amount</h5>
 739 <ol><p>the percentage of the difference between the original and the blur image that is added back into the original.</p></ol>
 740
 741 <h5>threshold</h5>
 742 <ol><p>the threshold in pixels needed to apply the diffence amount.</p></ol>
 743
 744 <h5>exception</h5>
 745 <ol><p>return any errors or warnings in this structure.</p></ol>
 746
 747  </div>
 748 \r
 749 </div>\r
 750 \r
 751 <div id="linkbar">\r
 752  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 753     <span id="linkbar-center">\r
 754       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 755     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 756     </span>\r
 757     <span id="linkbar-east">&nbsp;</span>\r
 758   </div>\r
 759   <div class="footer">\r
 760     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 761     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 762   </div>\r
 763   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 764 </body>\r
 765 </html>\r