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