Home | History | Annotate | Download | only in api
      1 
      2 
      3 
      4 
      5 <!DOCTYPE html>
      6 <html lang="en">
      7 <head>
      8   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
      9     <title>ImageMagick: MagickCore, C API for ImageMagick: Add an Effect</title>
     10   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
     11   <meta name="application-name" content="ImageMagick"/>
     12   <meta name="description" content="ImageMagick is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bzier curves."/>
     13   <meta name="application-url" content="http://www.imagemagick.org"/>
     14   <meta name="generator" content="PHP"/>
     15   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, add, an, effect, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
     16   <meta name="rating" content="GENERAL"/>
     17   <meta name="robots" content="INDEX, FOLLOW"/>
     18   <meta name="generator" content="ImageMagick Studio LLC"/>
     19   <meta name="author" content="ImageMagick Studio LLC"/>
     20   <meta name="revisit-after" content="2 DAYS"/>
     21   <meta name="resource-type" content="document"/>
     22   <meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/>
     23   <meta name="distribution" content="Global"/>
     24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
     25   <link rel="icon" href="../image/wand.png"/>
     26   <link rel="shortcut icon" href="../image/wand.ico"/>
     27   <link rel="stylesheet" href="../css/magick.php"/>
     28 </head>
     29 <body>
     30 <div class="main">
     31 <div class="magick-masthead">
     32   <div class="container">
     33     <script async="async" src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
     34          style="display:block"
     35          data-ad-client="ca-pub-3129977114552745"
     36          data-ad-slot="6345125851"
     37          data-ad-format="auto"></ins>
     38     <script>
     39       (adsbygoogle = window.adsbygoogle || []).push({});
     40     </script>
     41     <nav class="magick-nav">
     42       <a class="magick-nav-item " href="../index.php">Home</a>
     43       <a class="magick-nav-item " href="../script/binary-releases.php">Download</a>
     44       <a class="magick-nav-item " href="../script/command-line-tools.php">Tools</a>
     45       <a class="magick-nav-item " href="../script/command-line-options.php">Options</a>
     46       <a class="magick-nav-item " href="../script/resources.php">Resources</a>
     47       <a class="magick-nav-item " href="../script/api.php">Develop</a>
     48       <a class="magick-nav-item " href="../script/search.php">Search</a>
     49       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
     50     </nav>
     51   </div>
     52 </div>
     53 <div class="container">
     54 <div class="magick-header">
     55 <p class="text-center"><a href="effect.php#AdaptiveBlurImage">AdaptiveBlurImage</a> &bull; <a href="effect.php#AdaptiveSharpenImage">AdaptiveSharpenImage</a> &bull; <a href="effect.php#BlurImage">BlurImage</a> &bull; <a href="effect.php#ConvolveImage">ConvolveImage</a> &bull; <a href="effect.php#DespeckleImage">DespeckleImage</a> &bull; <a href="effect.php#EdgeImage">EdgeImage</a> &bull; <a href="effect.php#EmbossImage">EmbossImage</a> &bull; <a href="effect.php#GaussianBlurImage">GaussianBlurImage</a> &bull; <a href="effect.php#KuwaharaImage">KuwaharaImage</a> &bull; <a href="effect.php#MotionBlurImage">MotionBlurImage</a> &bull; <a href="effect.php#PreviewImage">PreviewImage</a> &bull; <a href="effect.php#RotationalBlurImage">RotationalBlurImage</a> &bull; <a href="effect.php#SelectiveBlurImage">SelectiveBlurImage</a> &bull; <a href="effect.php#ShadeImage">ShadeImage</a> &bull; <a href="effect.php#SharpenImage">SharpenImage</a> &bull; <a href="effect.php#SpreadImage">SpreadImage</a> &bull; <a href="effect.php#UnsharpMaskImage">UnsharpMaskImage</a></p>
     56 
     57 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="AdaptiveBlurImage">AdaptiveBlurImage</a></h2>
     58 
     59 <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>
     60 
     61 <p>The format of the AdaptiveBlurImage method is:</p>
     62 
     63 <pre class="text">
     64 Image *AdaptiveBlurImage(const Image *image,const double radius,
     65   const double sigma,ExceptionInfo *exception)
     66 </pre>
     67 
     68 <p>A description of each parameter follows:</p>
     69 
     70 <dd>
     71 </dd>
     72 
     73 <dd> </dd>
     74 <dl class="dl-horizontal">
     75 <dt>image</dt>
     76 <dd>the image. </dd>
     77 
     78 <dd> </dd>
     79 <dt>radius</dt>
     80 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
     81 
     82 <dd> </dd>
     83 <dt>sigma</dt>
     84 <dd>the standard deviation of the Laplacian, in pixels. </dd>
     85 
     86 <dd> </dd>
     87 <dt>exception</dt>
     88 <dd>return any errors or warnings in this structure. </dd>
     89 
     90 <dd>  </dd>
     91 </dl>
     92 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="AdaptiveSharpenImage">AdaptiveSharpenImage</a></h2>
     93 
     94 <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>
     95 
     96 <p>The format of the AdaptiveSharpenImage method is:</p>
     97 
     98 <pre class="text">
     99 Image *AdaptiveSharpenImage(const Image *image,const double radius,
    100   const double sigma,ExceptionInfo *exception)
    101 </pre>
    102 
    103 <p>A description of each parameter follows:</p>
    104 
    105 <dd>
    106 </dd>
    107 
    108 <dd> </dd>
    109 <dl class="dl-horizontal">
    110 <dt>image</dt>
    111 <dd>the image. </dd>
    112 
    113 <dd> </dd>
    114 <dt>radius</dt>
    115 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    116 
    117 <dd> </dd>
    118 <dt>sigma</dt>
    119 <dd>the standard deviation of the Laplacian, in pixels. </dd>
    120 
    121 <dd> </dd>
    122 <dt>exception</dt>
    123 <dd>return any errors or warnings in this structure. </dd>
    124 
    125 <dd>  </dd>
    126 </dl>
    127 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="BlurImage">BlurImage</a></h2>
    128 
    129 <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>
    130 
    131 <p>The format of the BlurImage method is:</p>
    132 
    133 <pre class="text">
    134 Image *BlurImage(const Image *image,const double radius,
    135   const double sigma,ExceptionInfo *exception)
    136 </pre>
    137 
    138 <p>A description of each parameter follows:</p>
    139 
    140 <dd>
    141 </dd>
    142 
    143 <dd> </dd>
    144 <dl class="dl-horizontal">
    145 <dt>image</dt>
    146 <dd>the image. </dd>
    147 
    148 <dd> </dd>
    149 <dt>radius</dt>
    150 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    151 
    152 <dd> </dd>
    153 <dt>sigma</dt>
    154 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    155 
    156 <dd> </dd>
    157 <dt>exception</dt>
    158 <dd>return any errors or warnings in this structure. </dd>
    159 
    160 <dd>  </dd>
    161 </dl>
    162 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="ConvolveImage">ConvolveImage</a></h2>
    163 
    164 <p>ConvolveImage() applies a custom convolution kernel to the image.</p>
    165 
    166 <p>The format of the ConvolveImage method is:</p>
    167 
    168 <pre class="text">
    169 Image *ConvolveImage(const Image *image,const KernelInfo *kernel,
    170   ExceptionInfo *exception)
    171 </pre>
    172 
    173 <p>A description of each parameter follows:</p>
    174 
    175 <dd>
    176 </dd>
    177 
    178 <dd> </dd>
    179 <dl class="dl-horizontal">
    180 <dt>image</dt>
    181 <dd>the image. </dd>
    182 
    183 <dd> </dd>
    184 <dt>kernel</dt>
    185 <dd>the filtering kernel. </dd>
    186 
    187 <dd> </dd>
    188 <dt>exception</dt>
    189 <dd>return any errors or warnings in this structure. </dd>
    190 
    191 <dd>  </dd>
    192 </dl>
    193 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="DespeckleImage">DespeckleImage</a></h2>
    194 
    195 <p>DespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.  A speckle removing filter uses a complementary   hulling technique (raising pixels that are darker than their surrounding neighbors, then complementarily lowering pixels that are brighter than their surrounding neighbors) to reduce the speckle index of that image (reference Crimmins speckle removal).</p>
    196 
    197 <p>The format of the DespeckleImage method is:</p>
    198 
    199 <pre class="text">
    200 Image *DespeckleImage(const Image *image,ExceptionInfo *exception)
    201 </pre>
    202 
    203 <p>A description of each parameter follows:</p>
    204 
    205 <dd>
    206 </dd>
    207 
    208 <dd> </dd>
    209 <dl class="dl-horizontal">
    210 <dt>image</dt>
    211 <dd>the image. </dd>
    212 
    213 <dd> </dd>
    214 <dt>exception</dt>
    215 <dd>return any errors or warnings in this structure. </dd>
    216 
    217 <dd>  </dd>
    218 </dl>
    219 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="EdgeImage">EdgeImage</a></h2>
    220 
    221 <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>
    222 
    223 <p>The format of the EdgeImage method is:</p>
    224 
    225 <pre class="text">
    226 Image *EdgeImage(const Image *image,const double radius,
    227   ExceptionInfo *exception)
    228 </pre>
    229 
    230 <p>A description of each parameter follows:</p>
    231 
    232 <dd>
    233 </dd>
    234 
    235 <dd> </dd>
    236 <dl class="dl-horizontal">
    237 <dt>image</dt>
    238 <dd>the image. </dd>
    239 
    240 <dd> </dd>
    241 <dt>radius</dt>
    242 <dd>the radius of the pixel neighborhood. </dd>
    243 
    244 <dd> </dd>
    245 <dt>exception</dt>
    246 <dd>return any errors or warnings in this structure. </dd>
    247 
    248 <dd>  </dd>
    249 </dl>
    250 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="EmbossImage">EmbossImage</a></h2>
    251 
    252 <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>
    253 
    254 <p>The format of the EmbossImage method is:</p>
    255 
    256 <pre class="text">
    257 Image *EmbossImage(const Image *image,const double radius,
    258   const double sigma,ExceptionInfo *exception)
    259 </pre>
    260 
    261 <p>A description of each parameter follows:</p>
    262 
    263 <dd>
    264 </dd>
    265 
    266 <dd> </dd>
    267 <dl class="dl-horizontal">
    268 <dt>image</dt>
    269 <dd>the image. </dd>
    270 
    271 <dd> </dd>
    272 <dt>radius</dt>
    273 <dd>the radius of the pixel neighborhood. </dd>
    274 
    275 <dd> </dd>
    276 <dt>sigma</dt>
    277 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    278 
    279 <dd> </dd>
    280 <dt>exception</dt>
    281 <dd>return any errors or warnings in this structure. </dd>
    282 
    283 <dd>  </dd>
    284 </dl>
    285 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="GaussianBlurImage">GaussianBlurImage</a></h2>
    286 
    287 <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>
    288 
    289 <p>The format of the GaussianBlurImage method is:</p>
    290 
    291 <pre class="text">
    292 Image *GaussianBlurImage(const Image *image,onst double radius,
    293   const double sigma,ExceptionInfo *exception)
    294 </pre>
    295 
    296 <p>A description of each parameter follows:</p>
    297 
    298 <dd>
    299 </dd>
    300 
    301 <dd> </dd>
    302 <dl class="dl-horizontal">
    303 <dt>image</dt>
    304 <dd>the image. </dd>
    305 
    306 <dd> </dd>
    307 <dt>radius</dt>
    308 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    309 
    310 <dd> </dd>
    311 <dt>sigma</dt>
    312 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    313 
    314 <dd> </dd>
    315 <dt>exception</dt>
    316 <dd>return any errors or warnings in this structure. </dd>
    317 
    318 <dd>  </dd>
    319 </dl>
    320 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="KuwaharaImage">KuwaharaImage</a></h2>
    321 
    322 <p>KuwaharaImage() is an edge preserving noise reduction filter.</p>
    323 
    324 <p>The format of the KuwaharaImage method is:</p>
    325 
    326 <pre class="text">
    327 Image *KuwaharaImage(const Image *image,const double radius,
    328   const double sigma,ExceptionInfo *exception)
    329 </pre>
    330 
    331 <p>A description of each parameter follows:</p>
    332 
    333 <dd>
    334 </dd>
    335 
    336 <dd> </dd>
    337 <dl class="dl-horizontal">
    338 <dt>image</dt>
    339 <dd>the image. </dd>
    340 
    341 <dd> </dd>
    342 <dt>radius</dt>
    343 <dd>the square window radius. </dd>
    344 
    345 <dd> </dd>
    346 <dt>sigma</dt>
    347 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    348 
    349 <dd> </dd>
    350 <dt>exception</dt>
    351 <dd>return any errors or warnings in this structure. </dd>
    352 
    353 <dd>  </dd>
    354 </dl>
    355 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="MotionBlurImage">MotionBlurImage</a></h2>
    356 
    357 <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>
    358 
    359 <p>Andrew Protano contributed this effect.</p>
    360 
    361 <p>The format of the MotionBlurImage method is:</p>
    362 
    363 <pre class="text">
    364     Image *MotionBlurImage(const Image *image,const double radius,
    365 const double sigma,const double angle,ExceptionInfo *exception)
    366 </pre>
    367 
    368 <p>A description of each parameter follows:</p>
    369 
    370 <dd>
    371 </dd>
    372 
    373 <dd> </dd>
    374 <dl class="dl-horizontal">
    375 <dt>image</dt>
    376 <dd>the image. </dd>
    377 
    378 <dd> </dd>
    379 <dt>radius</dt>
    380 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    381 
    382 <dd> </dd>
    383 <dt>sigma</dt>
    384 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    385 
    386 <dd> </dd>
    387 <dt>angle</dt>
    388 <dd>Apply the effect along this angle. </dd>
    389 
    390 <dd> </dd>
    391 <dt>exception</dt>
    392 <dd>return any errors or warnings in this structure. </dd>
    393 
    394 <dd>  </dd>
    395 </dl>
    396 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="PreviewImage">PreviewImage</a></h2>
    397 
    398 <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>
    399 
    400 <p>The format of the PreviewImages method is:</p>
    401 
    402 <pre class="text">
    403 Image *PreviewImages(const Image *image,const PreviewType preview,
    404   ExceptionInfo *exception)
    405 </pre>
    406 
    407 <p>A description of each parameter follows:</p>
    408 
    409 <dd>
    410 </dd>
    411 
    412 <dd> </dd>
    413 <dl class="dl-horizontal">
    414 <dt>image</dt>
    415 <dd>the image. </dd>
    416 
    417 <dd> </dd>
    418 <dt>preview</dt>
    419 <dd>the image processing operation. </dd>
    420 
    421 <dd> </dd>
    422 <dt>exception</dt>
    423 <dd>return any errors or warnings in this structure. </dd>
    424 
    425 <dd>  </dd>
    426 </dl>
    427 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="RotationalBlurImage">RotationalBlurImage</a></h2>
    428 
    429 <p>RotationalBlurImage() applies a radial blur to the image.</p>
    430 
    431 <p>Andrew Protano contributed this effect.</p>
    432 
    433 <p>The format of the RotationalBlurImage method is:</p>
    434 
    435 <pre class="text">
    436     Image *RotationalBlurImage(const Image *image,const double angle,
    437 ExceptionInfo *exception)
    438 </pre>
    439 
    440 <p>A description of each parameter follows:</p>
    441 
    442 <dd>
    443 </dd>
    444 
    445 <dd> </dd>
    446 <dl class="dl-horizontal">
    447 <dt>image</dt>
    448 <dd>the image. </dd>
    449 
    450 <dd> </dd>
    451 <dt>angle</dt>
    452 <dd>the angle of the radial blur. </dd>
    453 
    454 <dd> </dd>
    455 <dt>blur</dt>
    456 <dd>the blur. </dd>
    457 
    458 <dd> </dd>
    459 <dt>exception</dt>
    460 <dd>return any errors or warnings in this structure. </dd>
    461 
    462 <dd>  </dd>
    463 </dl>
    464 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="SelectiveBlurImage">SelectiveBlurImage</a></h2>
    465 
    466 <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>
    467 
    468 <p>The format of the SelectiveBlurImage method is:</p>
    469 
    470 <pre class="text">
    471 Image *SelectiveBlurImage(const Image *image,const double radius,
    472   const double sigma,const double threshold,ExceptionInfo *exception)
    473 </pre>
    474 
    475 <p>A description of each parameter follows:</p>
    476 
    477 <dd>
    478 </dd>
    479 
    480 <dd> </dd>
    481 <dl class="dl-horizontal">
    482 <dt>image</dt>
    483 <dd>the image. </dd>
    484 
    485 <dd> </dd>
    486 <dt>radius</dt>
    487 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    488 
    489 <dd> </dd>
    490 <dt>sigma</dt>
    491 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    492 
    493 <dd> </dd>
    494 <dt>threshold</dt>
    495 <dd>only pixels within this contrast threshold are included in the blur operation. </dd>
    496 
    497 <dd> </dd>
    498 <dt>exception</dt>
    499 <dd>return any errors or warnings in this structure. </dd>
    500 
    501 <dd>  </dd>
    502 </dl>
    503 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="ShadeImage">ShadeImage</a></h2>
    504 
    505 <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>
    506 
    507 <p>The format of the ShadeImage method is:</p>
    508 
    509 <pre class="text">
    510 Image *ShadeImage(const Image *image,const MagickBooleanType gray,
    511   const double azimuth,const double elevation,ExceptionInfo *exception)
    512 </pre>
    513 
    514 <p>A description of each parameter follows:</p>
    515 
    516 <dd>
    517 </dd>
    518 
    519 <dd> </dd>
    520 <dl class="dl-horizontal">
    521 <dt>image</dt>
    522 <dd>the image. </dd>
    523 
    524 <dd> </dd>
    525 <dt>gray</dt>
    526 <dd>A value other than zero shades the intensity of each pixel. </dd>
    527 
    528 <dd> </dd>
    529 <dt>azimuth, elevation</dt>
    530 <dd> Define the light source direction. </dd>
    531 
    532 <dd> </dd>
    533 <dt>exception</dt>
    534 <dd>return any errors or warnings in this structure. </dd>
    535 
    536 <dd>  </dd>
    537 </dl>
    538 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="SharpenImage">SharpenImage</a></h2>
    539 
    540 <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>
    541 
    542 <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>
    543 
    544 <p>The format of the SharpenImage method is:</p>
    545 
    546 <pre class="text">
    547     Image *SharpenImage(const Image *image,const double radius,
    548 const double sigma,ExceptionInfo *exception)
    549 </pre>
    550 
    551 <p>A description of each parameter follows:</p>
    552 
    553 <dd>
    554 </dd>
    555 
    556 <dd> </dd>
    557 <dl class="dl-horizontal">
    558 <dt>image</dt>
    559 <dd>the image. </dd>
    560 
    561 <dd> </dd>
    562 <dt>radius</dt>
    563 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    564 
    565 <dd> </dd>
    566 <dt>sigma</dt>
    567 <dd>the standard deviation of the Laplacian, in pixels. </dd>
    568 
    569 <dd> </dd>
    570 <dt>exception</dt>
    571 <dd>return any errors or warnings in this structure. </dd>
    572 
    573 <dd>  </dd>
    574 </dl>
    575 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="SpreadImage">SpreadImage</a></h2>
    576 
    577 <p>SpreadImage() is a special effects method that randomly displaces each pixel in a square area defined by the radius parameter.</p>
    578 
    579 <p>The format of the SpreadImage method is:</p>
    580 
    581 <pre class="text">
    582 Image *SpreadImage(const Image *image,
    583   const PixelInterpolateMethod method,const double radius,
    584   ExceptionInfo *exception)
    585 </pre>
    586 
    587 <p>A description of each parameter follows:</p>
    588 
    589 <dd>
    590 </dd>
    591 
    592 <dd> </dd>
    593 <dl class="dl-horizontal">
    594 <dt>image</dt>
    595 <dd>the image. </dd>
    596 
    597 <dd> </dd>
    598 <dt>method</dt>
    599 <dd> intepolation method. </dd>
    600 
    601 <dd> </dd>
    602 <dt>radius</dt>
    603 <dd> choose a random pixel in a neighborhood of this extent. </dd>
    604 
    605 <dd> </dd>
    606 <dt>exception</dt>
    607 <dd>return any errors or warnings in this structure. </dd>
    608 
    609 <dd>  </dd>
    610 </dl>
    611 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/effect_8c.html" id="UnsharpMaskImage">UnsharpMaskImage</a></h2>
    612 
    613 <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>
    614 
    615 <p>The format of the UnsharpMaskImage method is:</p>
    616 
    617 <pre class="text">
    618     Image *UnsharpMaskImage(const Image *image,const double radius,
    619 const double sigma,const double amount,const double threshold,
    620 ExceptionInfo *exception)
    621 </pre>
    622 
    623 <p>A description of each parameter follows:</p>
    624 
    625 <dd>
    626 </dd>
    627 
    628 <dd> </dd>
    629 <dl class="dl-horizontal">
    630 <dt>image</dt>
    631 <dd>the image. </dd>
    632 
    633 <dd> </dd>
    634 <dt>radius</dt>
    635 <dd>the radius of the Gaussian, in pixels, not counting the center pixel. </dd>
    636 
    637 <dd> </dd>
    638 <dt>sigma</dt>
    639 <dd>the standard deviation of the Gaussian, in pixels. </dd>
    640 
    641 <dd> </dd>
    642 <dt>gain</dt>
    643 <dd>the percentage of the difference between the original and the blur image that is added back into the original. </dd>
    644 
    645 <dd> </dd>
    646 <dt>threshold</dt>
    647 <dd>the threshold in pixels needed to apply the diffence gain. </dd>
    648 
    649 <dd> </dd>
    650 <dt>exception</dt>
    651 <dd>return any errors or warnings in this structure. </dd>
    652 
    653 <dd>  </dd>
    654 </dl>
    655 </div>
    656   <footer class="magick-footer">
    657     <p><a href="../script/support.php">Donate</a> 
    658      <a href="../script/sitemap.php">Sitemap</a> 
    659     <a href="../script/links.php">Related</a> 
    660     <a href="../script/architecture.php">Architecture</a>
    661 </p>
    662     <p><a href="effect.php#">Back to top</a> 
    663     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 
    664     <a href="../script/contact.php">Contact Us</a></p>
    665         <p><small>  1999-2016 ImageMagick Studio LLC</small></p>
    666   </footer>
    667 </div><!-- /.container -->
    668 
    669   <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
    670   <script src="http://nextgen.imagemagick.org/js/magick.php"></script>
    671 </div>
    672 </body>
    673 </html>
    674