• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 Bézier 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> &#8226; <a href="effect.html#AdaptiveSharpenImage">AdaptiveSharpenImage</a> &#8226; <a href="effect.html#BlurImage">BlurImage</a> &#8226; <a href="effect.html#ConvolveImage">ConvolveImage</a> &#8226; <a href="effect.html#DespeckleImage">DespeckleImage</a> &#8226; <a href="effect.html#EdgeImage">EdgeImage</a> &#8226; <a href="effect.html#EmbossImage">EmbossImage</a> &#8226; <a href="effect.html#GaussianBlurImage">GaussianBlurImage</a> &#8226; <a href="effect.html#KuwaharaImage">KuwaharaImage</a> &#8226; <a href="effect.html#LocalContrastImage">LocalContrastImage</a> &#8226; <a href="effect.html#MotionBlurImage">MotionBlurImage</a> &#8226; <a href="effect.html#PreviewImage">PreviewImage</a> &#8226; <a href="effect.html#RotationalBlurImage">RotationalBlurImage</a> &#8226; <a href="effect.html#SelectiveBlurImage">SelectiveBlurImage</a> &#8226; <a href="effect.html#ShadeImage">ShadeImage</a> &#8226; <a href="effect.html#SharpenImage">SharpenImage</a> &#8226; <a href="effect.html#SpreadImage">SpreadImage</a> &#8226; <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">
68Image *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">
103Image *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">
138Image *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">
173Image *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">
204Image *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">
230Image *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">
261Image *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">
296Image *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">
331Image *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">
366Image *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,
404const 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">
442Image *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,
476ExceptionInfo *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">
510Image *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">
549Image *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,
587const 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">
621Image *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,
658const double sigma,const double amount,const double threshold,
659ExceptionInfo *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&amp;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