root/ImageMagick/trunk/www/api/effect.html

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