blob: c6a37495904cff9065dbfcfda2250f9719bcb93b [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001/*
2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3% %
4% %
5% %
6% EEEEE FFFFF FFFFF EEEEE CCCC TTTTT %
7% E F F E C T %
8% EEE FFF FFF EEE C T %
9% E F F E C T %
10% EEEEE F F EEEEE CCCC T %
11% %
12% %
13% MagickCore Image Effects Methods %
14% %
15% Software Design %
16% John Cristy %
17% October 1996 %
18% %
19% %
cristy7e41fe82010-12-04 23:12:08 +000020% Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization %
cristy3ed852e2009-09-05 21:47:34 +000021% dedicated to making software imaging solutions freely available. %
22% %
23% You may not use this file except in compliance with the License. You may %
24% obtain a copy of the License at %
25% %
26% http://www.imagemagick.org/script/license.php %
27% %
28% Unless required by applicable law or agreed to in writing, software %
29% distributed under the License is distributed on an "AS IS" BASIS, %
30% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31% See the License for the specific language governing permissions and %
32% limitations under the License. %
33% %
34%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
35%
36%
37%
38*/
39
40/*
41 Include declarations.
42*/
43#include "magick/studio.h"
cristyd43a46b2010-01-21 02:13:41 +000044#include "magick/accelerate.h"
cristy3ed852e2009-09-05 21:47:34 +000045#include "magick/blob.h"
46#include "magick/cache-view.h"
47#include "magick/color.h"
48#include "magick/color-private.h"
49#include "magick/colorspace.h"
50#include "magick/constitute.h"
51#include "magick/decorate.h"
52#include "magick/draw.h"
53#include "magick/enhance.h"
54#include "magick/exception.h"
55#include "magick/exception-private.h"
56#include "magick/effect.h"
57#include "magick/fx.h"
58#include "magick/gem.h"
59#include "magick/geometry.h"
60#include "magick/image-private.h"
61#include "magick/list.h"
62#include "magick/log.h"
63#include "magick/memory_.h"
64#include "magick/monitor.h"
65#include "magick/monitor-private.h"
66#include "magick/montage.h"
cristy6771f1e2010-03-05 19:43:39 +000067#include "magick/morphology.h"
cristy3ed852e2009-09-05 21:47:34 +000068#include "magick/paint.h"
69#include "magick/pixel-private.h"
70#include "magick/property.h"
71#include "magick/quantize.h"
72#include "magick/quantum.h"
73#include "magick/random_.h"
74#include "magick/random-private.h"
75#include "magick/resample.h"
76#include "magick/resample-private.h"
77#include "magick/resize.h"
78#include "magick/resource_.h"
79#include "magick/segment.h"
80#include "magick/shear.h"
81#include "magick/signature-private.h"
82#include "magick/string_.h"
83#include "magick/thread-private.h"
84#include "magick/transform.h"
85#include "magick/threshold.h"
86
87/*
88%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
89% %
90% %
91% %
92% A d a p t i v e B l u r I m a g e %
93% %
94% %
95% %
96%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
97%
98% AdaptiveBlurImage() adaptively blurs the image by blurring less
99% intensely near image edges and more intensely far from edges. We blur the
100% image with a Gaussian operator of the given radius and standard deviation
101% (sigma). For reasonable results, radius should be larger than sigma. Use a
102% radius of 0 and AdaptiveBlurImage() selects a suitable radius for you.
103%
104% The format of the AdaptiveBlurImage method is:
105%
106% Image *AdaptiveBlurImage(const Image *image,const double radius,
107% const double sigma,ExceptionInfo *exception)
108% Image *AdaptiveBlurImageChannel(const Image *image,
109% const ChannelType channel,double radius,const double sigma,
110% ExceptionInfo *exception)
111%
112% A description of each parameter follows:
113%
114% o image: the image.
115%
116% o channel: the channel type.
117%
118% o radius: the radius of the Gaussian, in pixels, not counting the center
119% pixel.
120%
121% o sigma: the standard deviation of the Laplacian, in pixels.
122%
123% o exception: return any errors or warnings in this structure.
124%
125*/
126
127MagickExport Image *AdaptiveBlurImage(const Image *image,const double radius,
128 const double sigma,ExceptionInfo *exception)
129{
130 Image
131 *blur_image;
132
133 blur_image=AdaptiveBlurImageChannel(image,DefaultChannels,radius,sigma,
134 exception);
135 return(blur_image);
136}
137
138MagickExport Image *AdaptiveBlurImageChannel(const Image *image,
139 const ChannelType channel,const double radius,const double sigma,
140 ExceptionInfo *exception)
141{
142#define AdaptiveBlurImageTag "Convolve/Image"
143#define MagickSigma (fabs(sigma) <= MagickEpsilon ? 1.0 : sigma)
144
cristyc4c8d132010-01-07 01:58:38 +0000145 CacheView
146 *blur_view,
147 *edge_view,
148 *image_view;
149
cristy3ed852e2009-09-05 21:47:34 +0000150 double
cristy47e00502009-12-17 19:19:57 +0000151 **kernel,
152 normalize;
cristy3ed852e2009-09-05 21:47:34 +0000153
154 Image
155 *blur_image,
156 *edge_image,
157 *gaussian_image;
158
cristy3ed852e2009-09-05 21:47:34 +0000159 MagickBooleanType
160 status;
161
cristybb503372010-05-27 20:51:26 +0000162 MagickOffsetType
163 progress;
164
cristy3ed852e2009-09-05 21:47:34 +0000165 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +0000166 bias;
cristy3ed852e2009-09-05 21:47:34 +0000167
cristybb503372010-05-27 20:51:26 +0000168 register ssize_t
cristy47e00502009-12-17 19:19:57 +0000169 i;
cristy3ed852e2009-09-05 21:47:34 +0000170
cristybb503372010-05-27 20:51:26 +0000171 size_t
cristy3ed852e2009-09-05 21:47:34 +0000172 width;
173
cristybb503372010-05-27 20:51:26 +0000174 ssize_t
175 j,
176 k,
177 u,
178 v,
179 y;
180
cristy3ed852e2009-09-05 21:47:34 +0000181 assert(image != (const Image *) NULL);
182 assert(image->signature == MagickSignature);
183 if (image->debug != MagickFalse)
184 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
185 assert(exception != (ExceptionInfo *) NULL);
186 assert(exception->signature == MagickSignature);
187 blur_image=CloneImage(image,image->columns,image->rows,MagickTrue,exception);
188 if (blur_image == (Image *) NULL)
189 return((Image *) NULL);
190 if (fabs(sigma) <= MagickEpsilon)
191 return(blur_image);
192 if (SetImageStorageClass(blur_image,DirectClass) == MagickFalse)
193 {
194 InheritException(exception,&blur_image->exception);
195 blur_image=DestroyImage(blur_image);
196 return((Image *) NULL);
197 }
198 /*
199 Edge detect the image brighness channel, level, blur, and level again.
200 */
201 edge_image=EdgeImage(image,radius,exception);
202 if (edge_image == (Image *) NULL)
203 {
204 blur_image=DestroyImage(blur_image);
205 return((Image *) NULL);
206 }
207 (void) LevelImage(edge_image,"20%,95%");
208 gaussian_image=GaussianBlurImage(edge_image,radius,sigma,exception);
209 if (gaussian_image != (Image *) NULL)
210 {
211 edge_image=DestroyImage(edge_image);
212 edge_image=gaussian_image;
213 }
214 (void) LevelImage(edge_image,"10%,95%");
215 /*
216 Create a set of kernels from maximum (radius,sigma) to minimum.
217 */
218 width=GetOptimalKernelWidth2D(radius,sigma);
219 kernel=(double **) AcquireQuantumMemory((size_t) width,sizeof(*kernel));
220 if (kernel == (double **) NULL)
221 {
222 edge_image=DestroyImage(edge_image);
223 blur_image=DestroyImage(blur_image);
224 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
225 }
226 (void) ResetMagickMemory(kernel,0,(size_t) width*sizeof(*kernel));
cristybb503372010-05-27 20:51:26 +0000227 for (i=0; i < (ssize_t) width; i+=2)
cristy3ed852e2009-09-05 21:47:34 +0000228 {
229 kernel[i]=(double *) AcquireQuantumMemory((size_t) (width-i),(width-i)*
230 sizeof(**kernel));
231 if (kernel[i] == (double *) NULL)
232 break;
cristy47e00502009-12-17 19:19:57 +0000233 normalize=0.0;
cristybb503372010-05-27 20:51:26 +0000234 j=(ssize_t) (width-i)/2;
cristy47e00502009-12-17 19:19:57 +0000235 k=0;
236 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +0000237 {
cristy47e00502009-12-17 19:19:57 +0000238 for (u=(-j); u <= j; u++)
cristy3ed852e2009-09-05 21:47:34 +0000239 {
cristy4205a3c2010-09-12 20:19:59 +0000240 kernel[i][k]=(double) (exp(-((double) u*u+v*v)/(2.0*MagickSigma*
241 MagickSigma))/(2.0*MagickPI*MagickSigma*MagickSigma));
cristy47e00502009-12-17 19:19:57 +0000242 normalize+=kernel[i][k];
243 k++;
cristy3ed852e2009-09-05 21:47:34 +0000244 }
245 }
cristy3ed852e2009-09-05 21:47:34 +0000246 if (fabs(normalize) <= MagickEpsilon)
247 normalize=1.0;
248 normalize=1.0/normalize;
cristy47e00502009-12-17 19:19:57 +0000249 for (k=0; k < (j*j); k++)
250 kernel[i][k]=normalize*kernel[i][k];
cristy3ed852e2009-09-05 21:47:34 +0000251 }
cristybb503372010-05-27 20:51:26 +0000252 if (i < (ssize_t) width)
cristy3ed852e2009-09-05 21:47:34 +0000253 {
254 for (i-=2; i >= 0; i-=2)
255 kernel[i]=(double *) RelinquishMagickMemory(kernel[i]);
256 kernel=(double **) RelinquishMagickMemory(kernel);
257 edge_image=DestroyImage(edge_image);
258 blur_image=DestroyImage(blur_image);
259 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
260 }
261 /*
262 Adaptively blur image.
263 */
264 status=MagickTrue;
265 progress=0;
cristyddd82202009-11-03 20:14:50 +0000266 GetMagickPixelPacket(image,&bias);
267 SetMagickPixelPacketBias(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +0000268 image_view=AcquireCacheView(image);
269 edge_view=AcquireCacheView(edge_image);
270 blur_view=AcquireCacheView(blur_image);
cristyb5d5f722009-11-04 03:03:49 +0000271#if defined(MAGICKCORE_OPENMP_SUPPORT)
272 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +0000273#endif
cristybb503372010-05-27 20:51:26 +0000274 for (y=0; y < (ssize_t) blur_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +0000275 {
276 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000277 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +0000278
279 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000280 *restrict p,
281 *restrict r;
cristy3ed852e2009-09-05 21:47:34 +0000282
283 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000284 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +0000285
cristy3ed852e2009-09-05 21:47:34 +0000286 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000287 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +0000288
cristy117ff172010-08-15 21:35:32 +0000289 register ssize_t
290 x;
291
cristy3ed852e2009-09-05 21:47:34 +0000292 if (status == MagickFalse)
293 continue;
294 r=GetCacheViewVirtualPixels(edge_view,0,y,edge_image->columns,1,exception);
295 q=QueueCacheViewAuthenticPixels(blur_view,0,y,blur_image->columns,1,
296 exception);
297 if ((r == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
298 {
299 status=MagickFalse;
300 continue;
301 }
302 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +0000303 for (x=0; x < (ssize_t) blur_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +0000304 {
305 MagickPixelPacket
306 pixel;
307
308 MagickRealType
309 alpha,
310 gamma;
311
312 register const double
cristyc47d1f82009-11-26 01:44:43 +0000313 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +0000314
cristybb503372010-05-27 20:51:26 +0000315 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000316 i,
317 u,
318 v;
319
320 gamma=0.0;
cristybb503372010-05-27 20:51:26 +0000321 i=(ssize_t) ceil((double) width*QuantumScale*PixelIntensity(r)-0.5);
cristy3ed852e2009-09-05 21:47:34 +0000322 if (i < 0)
323 i=0;
324 else
cristybb503372010-05-27 20:51:26 +0000325 if (i > (ssize_t) width)
326 i=(ssize_t) width;
cristy3ed852e2009-09-05 21:47:34 +0000327 if ((i & 0x01) != 0)
328 i--;
cristya21afde2010-07-02 00:45:40 +0000329 p=GetCacheViewVirtualPixels(image_view,x-((ssize_t) (width-i)/2L),y-
330 (ssize_t) ((width-i)/2L),width-i,width-i,exception);
cristy3ed852e2009-09-05 21:47:34 +0000331 if (p == (const PixelPacket *) NULL)
332 break;
333 indexes=GetCacheViewVirtualIndexQueue(image_view);
cristyddd82202009-11-03 20:14:50 +0000334 pixel=bias;
cristy3ed852e2009-09-05 21:47:34 +0000335 k=kernel[i];
cristybb503372010-05-27 20:51:26 +0000336 for (v=0; v < (ssize_t) (width-i); v++)
cristy3ed852e2009-09-05 21:47:34 +0000337 {
cristybb503372010-05-27 20:51:26 +0000338 for (u=0; u < (ssize_t) (width-i); u++)
cristy3ed852e2009-09-05 21:47:34 +0000339 {
340 alpha=1.0;
341 if (((channel & OpacityChannel) != 0) &&
342 (image->matte != MagickFalse))
cristy46f08202010-01-10 04:04:21 +0000343 alpha=(MagickRealType) (QuantumScale*GetAlphaPixelComponent(p));
cristy3ed852e2009-09-05 21:47:34 +0000344 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000345 pixel.red+=(*k)*alpha*GetRedPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000346 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000347 pixel.green+=(*k)*alpha*GetGreenPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000348 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000349 pixel.blue+=(*k)*alpha*GetBluePixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000350 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000351 pixel.opacity+=(*k)*GetOpacityPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000352 if (((channel & IndexChannel) != 0) &&
353 (image->colorspace == CMYKColorspace))
354 pixel.index+=(*k)*alpha*indexes[x+(width-i)*v+u];
355 gamma+=(*k)*alpha;
356 k++;
357 p++;
358 }
359 }
360 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
361 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000362 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000363 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000364 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000365 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000366 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000367 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000368 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000369 if (((channel & IndexChannel) != 0) &&
370 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +0000371 blur_indexes[x]=ClampToQuantum(gamma*GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000372 q++;
373 r++;
374 }
375 if (SyncCacheViewAuthenticPixels(blur_view,exception) == MagickFalse)
376 status=MagickFalse;
377 if (image->progress_monitor != (MagickProgressMonitor) NULL)
378 {
379 MagickBooleanType
380 proceed;
381
cristyb5d5f722009-11-04 03:03:49 +0000382#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +0000383 #pragma omp critical (MagickCore_AdaptiveBlurImageChannel)
384#endif
385 proceed=SetImageProgress(image,AdaptiveBlurImageTag,progress++,
386 image->rows);
387 if (proceed == MagickFalse)
388 status=MagickFalse;
389 }
390 }
391 blur_image->type=image->type;
392 blur_view=DestroyCacheView(blur_view);
393 edge_view=DestroyCacheView(edge_view);
394 image_view=DestroyCacheView(image_view);
395 edge_image=DestroyImage(edge_image);
cristybb503372010-05-27 20:51:26 +0000396 for (i=0; i < (ssize_t) width; i+=2)
cristy3ed852e2009-09-05 21:47:34 +0000397 kernel[i]=(double *) RelinquishMagickMemory(kernel[i]);
398 kernel=(double **) RelinquishMagickMemory(kernel);
399 if (status == MagickFalse)
400 blur_image=DestroyImage(blur_image);
401 return(blur_image);
402}
403
404/*
405%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
406% %
407% %
408% %
409% A d a p t i v e S h a r p e n I m a g e %
410% %
411% %
412% %
413%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
414%
415% AdaptiveSharpenImage() adaptively sharpens the image by sharpening more
416% intensely near image edges and less intensely far from edges. We sharpen the
417% image with a Gaussian operator of the given radius and standard deviation
418% (sigma). For reasonable results, radius should be larger than sigma. Use a
419% radius of 0 and AdaptiveSharpenImage() selects a suitable radius for you.
420%
421% The format of the AdaptiveSharpenImage method is:
422%
423% Image *AdaptiveSharpenImage(const Image *image,const double radius,
424% const double sigma,ExceptionInfo *exception)
425% Image *AdaptiveSharpenImageChannel(const Image *image,
426% const ChannelType channel,double radius,const double sigma,
427% ExceptionInfo *exception)
428%
429% A description of each parameter follows:
430%
431% o image: the image.
432%
433% o channel: the channel type.
434%
435% o radius: the radius of the Gaussian, in pixels, not counting the center
436% pixel.
437%
438% o sigma: the standard deviation of the Laplacian, in pixels.
439%
440% o exception: return any errors or warnings in this structure.
441%
442*/
443
444MagickExport Image *AdaptiveSharpenImage(const Image *image,const double radius,
445 const double sigma,ExceptionInfo *exception)
446{
447 Image
448 *sharp_image;
449
450 sharp_image=AdaptiveSharpenImageChannel(image,DefaultChannels,radius,sigma,
451 exception);
452 return(sharp_image);
453}
454
455MagickExport Image *AdaptiveSharpenImageChannel(const Image *image,
456 const ChannelType channel,const double radius,const double sigma,
457 ExceptionInfo *exception)
458{
459#define AdaptiveSharpenImageTag "Convolve/Image"
460#define MagickSigma (fabs(sigma) <= MagickEpsilon ? 1.0 : sigma)
461
cristyc4c8d132010-01-07 01:58:38 +0000462 CacheView
463 *sharp_view,
464 *edge_view,
465 *image_view;
466
cristy3ed852e2009-09-05 21:47:34 +0000467 double
cristy47e00502009-12-17 19:19:57 +0000468 **kernel,
469 normalize;
cristy3ed852e2009-09-05 21:47:34 +0000470
471 Image
472 *sharp_image,
473 *edge_image,
474 *gaussian_image;
475
cristy3ed852e2009-09-05 21:47:34 +0000476 MagickBooleanType
477 status;
478
cristybb503372010-05-27 20:51:26 +0000479 MagickOffsetType
480 progress;
481
cristy3ed852e2009-09-05 21:47:34 +0000482 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +0000483 bias;
cristy3ed852e2009-09-05 21:47:34 +0000484
cristybb503372010-05-27 20:51:26 +0000485 register ssize_t
cristy47e00502009-12-17 19:19:57 +0000486 i;
cristy3ed852e2009-09-05 21:47:34 +0000487
cristybb503372010-05-27 20:51:26 +0000488 size_t
cristy3ed852e2009-09-05 21:47:34 +0000489 width;
490
cristybb503372010-05-27 20:51:26 +0000491 ssize_t
492 j,
493 k,
494 u,
495 v,
496 y;
497
cristy3ed852e2009-09-05 21:47:34 +0000498 assert(image != (const Image *) NULL);
499 assert(image->signature == MagickSignature);
500 if (image->debug != MagickFalse)
501 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
502 assert(exception != (ExceptionInfo *) NULL);
503 assert(exception->signature == MagickSignature);
504 sharp_image=CloneImage(image,0,0,MagickTrue,exception);
505 if (sharp_image == (Image *) NULL)
506 return((Image *) NULL);
507 if (fabs(sigma) <= MagickEpsilon)
508 return(sharp_image);
509 if (SetImageStorageClass(sharp_image,DirectClass) == MagickFalse)
510 {
511 InheritException(exception,&sharp_image->exception);
512 sharp_image=DestroyImage(sharp_image);
513 return((Image *) NULL);
514 }
515 /*
516 Edge detect the image brighness channel, level, sharp, and level again.
517 */
518 edge_image=EdgeImage(image,radius,exception);
519 if (edge_image == (Image *) NULL)
520 {
521 sharp_image=DestroyImage(sharp_image);
522 return((Image *) NULL);
523 }
524 (void) LevelImage(edge_image,"20%,95%");
525 gaussian_image=GaussianBlurImage(edge_image,radius,sigma,exception);
526 if (gaussian_image != (Image *) NULL)
527 {
528 edge_image=DestroyImage(edge_image);
529 edge_image=gaussian_image;
530 }
531 (void) LevelImage(edge_image,"10%,95%");
532 /*
533 Create a set of kernels from maximum (radius,sigma) to minimum.
534 */
535 width=GetOptimalKernelWidth2D(radius,sigma);
536 kernel=(double **) AcquireQuantumMemory((size_t) width,sizeof(*kernel));
537 if (kernel == (double **) NULL)
538 {
539 edge_image=DestroyImage(edge_image);
540 sharp_image=DestroyImage(sharp_image);
541 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
542 }
543 (void) ResetMagickMemory(kernel,0,(size_t) width*sizeof(*kernel));
cristybb503372010-05-27 20:51:26 +0000544 for (i=0; i < (ssize_t) width; i+=2)
cristy3ed852e2009-09-05 21:47:34 +0000545 {
546 kernel[i]=(double *) AcquireQuantumMemory((size_t) (width-i),(width-i)*
547 sizeof(**kernel));
548 if (kernel[i] == (double *) NULL)
549 break;
cristy47e00502009-12-17 19:19:57 +0000550 normalize=0.0;
cristybb503372010-05-27 20:51:26 +0000551 j=(ssize_t) (width-i)/2;
cristy47e00502009-12-17 19:19:57 +0000552 k=0;
553 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +0000554 {
cristy47e00502009-12-17 19:19:57 +0000555 for (u=(-j); u <= j; u++)
cristy3ed852e2009-09-05 21:47:34 +0000556 {
cristy4205a3c2010-09-12 20:19:59 +0000557 kernel[i][k]=(double) (-exp(-((double) u*u+v*v)/(2.0*MagickSigma*
558 MagickSigma))/(2.0*MagickPI*MagickSigma*MagickSigma));
cristy47e00502009-12-17 19:19:57 +0000559 normalize+=kernel[i][k];
560 k++;
cristy3ed852e2009-09-05 21:47:34 +0000561 }
562 }
cristy3ed852e2009-09-05 21:47:34 +0000563 if (fabs(normalize) <= MagickEpsilon)
564 normalize=1.0;
565 normalize=1.0/normalize;
cristy47e00502009-12-17 19:19:57 +0000566 for (k=0; k < (j*j); k++)
567 kernel[i][k]=normalize*kernel[i][k];
cristy3ed852e2009-09-05 21:47:34 +0000568 }
cristybb503372010-05-27 20:51:26 +0000569 if (i < (ssize_t) width)
cristy3ed852e2009-09-05 21:47:34 +0000570 {
571 for (i-=2; i >= 0; i-=2)
572 kernel[i]=(double *) RelinquishMagickMemory(kernel[i]);
573 kernel=(double **) RelinquishMagickMemory(kernel);
574 edge_image=DestroyImage(edge_image);
575 sharp_image=DestroyImage(sharp_image);
576 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
577 }
578 /*
579 Adaptively sharpen image.
580 */
581 status=MagickTrue;
582 progress=0;
cristyddd82202009-11-03 20:14:50 +0000583 GetMagickPixelPacket(image,&bias);
584 SetMagickPixelPacketBias(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +0000585 image_view=AcquireCacheView(image);
586 edge_view=AcquireCacheView(edge_image);
587 sharp_view=AcquireCacheView(sharp_image);
cristyb5d5f722009-11-04 03:03:49 +0000588#if defined(MAGICKCORE_OPENMP_SUPPORT)
589 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +0000590#endif
cristybb503372010-05-27 20:51:26 +0000591 for (y=0; y < (ssize_t) sharp_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +0000592 {
593 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000594 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +0000595
596 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000597 *restrict p,
598 *restrict r;
cristy3ed852e2009-09-05 21:47:34 +0000599
600 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000601 *restrict sharp_indexes;
cristy3ed852e2009-09-05 21:47:34 +0000602
cristy3ed852e2009-09-05 21:47:34 +0000603 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000604 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +0000605
cristy117ff172010-08-15 21:35:32 +0000606 register ssize_t
607 x;
608
cristy3ed852e2009-09-05 21:47:34 +0000609 if (status == MagickFalse)
610 continue;
611 r=GetCacheViewVirtualPixels(edge_view,0,y,edge_image->columns,1,exception);
612 q=QueueCacheViewAuthenticPixels(sharp_view,0,y,sharp_image->columns,1,
613 exception);
614 if ((r == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
615 {
616 status=MagickFalse;
617 continue;
618 }
619 sharp_indexes=GetCacheViewAuthenticIndexQueue(sharp_view);
cristybb503372010-05-27 20:51:26 +0000620 for (x=0; x < (ssize_t) sharp_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +0000621 {
622 MagickPixelPacket
623 pixel;
624
625 MagickRealType
626 alpha,
627 gamma;
628
629 register const double
cristyc47d1f82009-11-26 01:44:43 +0000630 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +0000631
cristybb503372010-05-27 20:51:26 +0000632 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000633 i,
634 u,
635 v;
636
637 gamma=0.0;
cristybb503372010-05-27 20:51:26 +0000638 i=(ssize_t) ceil((double) width*(QuantumRange-QuantumScale*
cristy1f9ce9f2010-04-28 11:55:12 +0000639 PixelIntensity(r))-0.5);
cristy3ed852e2009-09-05 21:47:34 +0000640 if (i < 0)
641 i=0;
642 else
cristybb503372010-05-27 20:51:26 +0000643 if (i > (ssize_t) width)
644 i=(ssize_t) width;
cristy3ed852e2009-09-05 21:47:34 +0000645 if ((i & 0x01) != 0)
646 i--;
cristy117ff172010-08-15 21:35:32 +0000647 p=GetCacheViewVirtualPixels(image_view,x-((ssize_t) (width-i)/2L),y-
648 (ssize_t) ((width-i)/2L),width-i,width-i,exception);
cristy3ed852e2009-09-05 21:47:34 +0000649 if (p == (const PixelPacket *) NULL)
650 break;
651 indexes=GetCacheViewVirtualIndexQueue(image_view);
652 k=kernel[i];
cristyddd82202009-11-03 20:14:50 +0000653 pixel=bias;
cristybb503372010-05-27 20:51:26 +0000654 for (v=0; v < (ssize_t) (width-i); v++)
cristy3ed852e2009-09-05 21:47:34 +0000655 {
cristybb503372010-05-27 20:51:26 +0000656 for (u=0; u < (ssize_t) (width-i); u++)
cristy3ed852e2009-09-05 21:47:34 +0000657 {
658 alpha=1.0;
659 if (((channel & OpacityChannel) != 0) &&
660 (image->matte != MagickFalse))
cristy46f08202010-01-10 04:04:21 +0000661 alpha=(MagickRealType) (QuantumScale*GetAlphaPixelComponent(p));
cristy3ed852e2009-09-05 21:47:34 +0000662 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000663 pixel.red+=(*k)*alpha*GetRedPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000664 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000665 pixel.green+=(*k)*alpha*GetGreenPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000666 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000667 pixel.blue+=(*k)*alpha*GetBluePixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000668 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000669 pixel.opacity+=(*k)*GetOpacityPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +0000670 if (((channel & IndexChannel) != 0) &&
671 (image->colorspace == CMYKColorspace))
672 pixel.index+=(*k)*alpha*indexes[x+(width-i)*v+u];
673 gamma+=(*k)*alpha;
674 k++;
675 p++;
676 }
677 }
678 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
679 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000680 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000681 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000682 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000683 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000684 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000685 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000686 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000687 if (((channel & IndexChannel) != 0) &&
688 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +0000689 sharp_indexes[x]=ClampToQuantum(gamma*GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000690 q++;
691 r++;
692 }
693 if (SyncCacheViewAuthenticPixels(sharp_view,exception) == MagickFalse)
694 status=MagickFalse;
695 if (image->progress_monitor != (MagickProgressMonitor) NULL)
696 {
697 MagickBooleanType
698 proceed;
699
cristyb5d5f722009-11-04 03:03:49 +0000700#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +0000701 #pragma omp critical (MagickCore_AdaptiveSharpenImageChannel)
702#endif
703 proceed=SetImageProgress(image,AdaptiveSharpenImageTag,progress++,
704 image->rows);
705 if (proceed == MagickFalse)
706 status=MagickFalse;
707 }
708 }
709 sharp_image->type=image->type;
710 sharp_view=DestroyCacheView(sharp_view);
711 edge_view=DestroyCacheView(edge_view);
712 image_view=DestroyCacheView(image_view);
713 edge_image=DestroyImage(edge_image);
cristybb503372010-05-27 20:51:26 +0000714 for (i=0; i < (ssize_t) width; i+=2)
cristy3ed852e2009-09-05 21:47:34 +0000715 kernel[i]=(double *) RelinquishMagickMemory(kernel[i]);
716 kernel=(double **) RelinquishMagickMemory(kernel);
717 if (status == MagickFalse)
718 sharp_image=DestroyImage(sharp_image);
719 return(sharp_image);
720}
721
722/*
723%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
724% %
725% %
726% %
727% B l u r I m a g e %
728% %
729% %
730% %
731%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
732%
733% BlurImage() blurs an image. We convolve the image with a Gaussian operator
734% of the given radius and standard deviation (sigma). For reasonable results,
735% the radius should be larger than sigma. Use a radius of 0 and BlurImage()
736% selects a suitable radius for you.
737%
738% BlurImage() differs from GaussianBlurImage() in that it uses a separable
739% kernel which is faster but mathematically equivalent to the non-separable
740% kernel.
741%
742% The format of the BlurImage method is:
743%
744% Image *BlurImage(const Image *image,const double radius,
745% const double sigma,ExceptionInfo *exception)
746% Image *BlurImageChannel(const Image *image,const ChannelType channel,
747% const double radius,const double sigma,ExceptionInfo *exception)
748%
749% A description of each parameter follows:
750%
751% o image: the image.
752%
753% o channel: the channel type.
754%
755% o radius: the radius of the Gaussian, in pixels, not counting the center
756% pixel.
757%
758% o sigma: the standard deviation of the Gaussian, in pixels.
759%
760% o exception: return any errors or warnings in this structure.
761%
762*/
763
764MagickExport Image *BlurImage(const Image *image,const double radius,
765 const double sigma,ExceptionInfo *exception)
766{
767 Image
768 *blur_image;
769
770 blur_image=BlurImageChannel(image,DefaultChannels,radius,sigma,exception);
771 return(blur_image);
772}
773
cristybb503372010-05-27 20:51:26 +0000774static double *GetBlurKernel(const size_t width,const double sigma)
cristy3ed852e2009-09-05 21:47:34 +0000775{
cristy3ed852e2009-09-05 21:47:34 +0000776 double
cristy47e00502009-12-17 19:19:57 +0000777 *kernel,
778 normalize;
cristy3ed852e2009-09-05 21:47:34 +0000779
cristy117ff172010-08-15 21:35:32 +0000780 register ssize_t
781 i;
782
cristybb503372010-05-27 20:51:26 +0000783 ssize_t
cristy47e00502009-12-17 19:19:57 +0000784 j,
785 k;
cristy3ed852e2009-09-05 21:47:34 +0000786
cristy3ed852e2009-09-05 21:47:34 +0000787 /*
788 Generate a 1-D convolution kernel.
789 */
790 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
791 kernel=(double *) AcquireQuantumMemory((size_t) width,sizeof(*kernel));
792 if (kernel == (double *) NULL)
793 return(0);
cristy3ed852e2009-09-05 21:47:34 +0000794 normalize=0.0;
cristybb503372010-05-27 20:51:26 +0000795 j=(ssize_t) width/2;
cristy47e00502009-12-17 19:19:57 +0000796 i=0;
797 for (k=(-j); k <= j; k++)
798 {
cristy4205a3c2010-09-12 20:19:59 +0000799 kernel[i]=(double) (exp(-((double) k*k)/(2.0*MagickSigma*MagickSigma))/
800 (MagickSQ2PI*MagickSigma));
cristy3ed852e2009-09-05 21:47:34 +0000801 normalize+=kernel[i];
cristy47e00502009-12-17 19:19:57 +0000802 i++;
803 }
cristybb503372010-05-27 20:51:26 +0000804 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +0000805 kernel[i]/=normalize;
806 return(kernel);
807}
808
809MagickExport Image *BlurImageChannel(const Image *image,
810 const ChannelType channel,const double radius,const double sigma,
811 ExceptionInfo *exception)
812{
813#define BlurImageTag "Blur/Image"
814
cristyc4c8d132010-01-07 01:58:38 +0000815 CacheView
816 *blur_view,
817 *image_view;
818
cristy3ed852e2009-09-05 21:47:34 +0000819 double
820 *kernel;
821
822 Image
823 *blur_image;
824
cristy3ed852e2009-09-05 21:47:34 +0000825 MagickBooleanType
826 status;
827
cristybb503372010-05-27 20:51:26 +0000828 MagickOffsetType
829 progress;
830
cristy3ed852e2009-09-05 21:47:34 +0000831 MagickPixelPacket
cristy3ed852e2009-09-05 21:47:34 +0000832 bias;
833
cristybb503372010-05-27 20:51:26 +0000834 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000835 i;
836
cristybb503372010-05-27 20:51:26 +0000837 size_t
cristy3ed852e2009-09-05 21:47:34 +0000838 width;
839
cristybb503372010-05-27 20:51:26 +0000840 ssize_t
841 x,
842 y;
843
cristy3ed852e2009-09-05 21:47:34 +0000844 /*
845 Initialize blur image attributes.
846 */
847 assert(image != (Image *) NULL);
848 assert(image->signature == MagickSignature);
849 if (image->debug != MagickFalse)
850 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
851 assert(exception != (ExceptionInfo *) NULL);
852 assert(exception->signature == MagickSignature);
853 blur_image=CloneImage(image,0,0,MagickTrue,exception);
854 if (blur_image == (Image *) NULL)
855 return((Image *) NULL);
856 if (fabs(sigma) <= MagickEpsilon)
857 return(blur_image);
858 if (SetImageStorageClass(blur_image,DirectClass) == MagickFalse)
859 {
860 InheritException(exception,&blur_image->exception);
861 blur_image=DestroyImage(blur_image);
862 return((Image *) NULL);
863 }
864 width=GetOptimalKernelWidth1D(radius,sigma);
865 kernel=GetBlurKernel(width,sigma);
866 if (kernel == (double *) NULL)
867 {
868 blur_image=DestroyImage(blur_image);
869 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
870 }
871 if (image->debug != MagickFalse)
872 {
873 char
874 format[MaxTextExtent],
875 *message;
876
877 register const double
878 *k;
879
880 (void) LogMagickEvent(TransformEvent,GetMagickModule(),
cristye8c25f92010-06-03 00:53:06 +0000881 " BlurImage with %.20g kernel:",(double) width);
cristy3ed852e2009-09-05 21:47:34 +0000882 message=AcquireString("");
883 k=kernel;
cristybb503372010-05-27 20:51:26 +0000884 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +0000885 {
886 *message='\0';
cristye8c25f92010-06-03 00:53:06 +0000887 (void) FormatMagickString(format,MaxTextExtent,"%.20g: ",(double) i);
cristy3ed852e2009-09-05 21:47:34 +0000888 (void) ConcatenateString(&message,format);
cristye7f51092010-01-17 00:39:37 +0000889 (void) FormatMagickString(format,MaxTextExtent,"%g ",*k++);
cristy3ed852e2009-09-05 21:47:34 +0000890 (void) ConcatenateString(&message,format);
891 (void) LogMagickEvent(TransformEvent,GetMagickModule(),"%s",message);
892 }
893 message=DestroyString(message);
894 }
895 /*
896 Blur rows.
897 */
898 status=MagickTrue;
899 progress=0;
cristyddd82202009-11-03 20:14:50 +0000900 GetMagickPixelPacket(image,&bias);
901 SetMagickPixelPacketBias(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +0000902 image_view=AcquireCacheView(image);
903 blur_view=AcquireCacheView(blur_image);
cristyb5d5f722009-11-04 03:03:49 +0000904#if defined(MAGICKCORE_OPENMP_SUPPORT)
905 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +0000906#endif
cristybb503372010-05-27 20:51:26 +0000907 for (y=0; y < (ssize_t) blur_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +0000908 {
909 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000910 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +0000911
912 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000913 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +0000914
915 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000916 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +0000917
cristy3ed852e2009-09-05 21:47:34 +0000918 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000919 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +0000920
cristy117ff172010-08-15 21:35:32 +0000921 register ssize_t
922 x;
923
cristy3ed852e2009-09-05 21:47:34 +0000924 if (status == MagickFalse)
925 continue;
cristy117ff172010-08-15 21:35:32 +0000926 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) width/2L),y,
927 image->columns+width,1,exception);
cristy3ed852e2009-09-05 21:47:34 +0000928 q=GetCacheViewAuthenticPixels(blur_view,0,y,blur_image->columns,1,
929 exception);
930 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
931 {
932 status=MagickFalse;
933 continue;
934 }
935 indexes=GetCacheViewVirtualIndexQueue(image_view);
936 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +0000937 for (x=0; x < (ssize_t) blur_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +0000938 {
939 MagickPixelPacket
940 pixel;
941
942 register const double
cristyc47d1f82009-11-26 01:44:43 +0000943 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +0000944
945 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +0000946 *restrict kernel_pixels;
cristy3ed852e2009-09-05 21:47:34 +0000947
cristybb503372010-05-27 20:51:26 +0000948 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000949 i;
950
cristyddd82202009-11-03 20:14:50 +0000951 pixel=bias;
cristy3ed852e2009-09-05 21:47:34 +0000952 k=kernel;
953 kernel_pixels=p;
954 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
955 {
cristybb503372010-05-27 20:51:26 +0000956 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +0000957 {
958 pixel.red+=(*k)*kernel_pixels->red;
959 pixel.green+=(*k)*kernel_pixels->green;
960 pixel.blue+=(*k)*kernel_pixels->blue;
961 k++;
962 kernel_pixels++;
963 }
964 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000965 SetRedPixelComponent(q,ClampRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000966 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000967 SetGreenPixelComponent(q,ClampGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000968 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +0000969 SetBluePixelComponent(q,ClampBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000970 if ((channel & OpacityChannel) != 0)
971 {
972 k=kernel;
973 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +0000974 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +0000975 {
976 pixel.opacity+=(*k)*kernel_pixels->opacity;
977 k++;
978 kernel_pixels++;
979 }
cristyce70c172010-01-07 17:15:30 +0000980 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +0000981 }
982 if (((channel & IndexChannel) != 0) &&
983 (image->colorspace == CMYKColorspace))
984 {
985 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +0000986 *restrict kernel_indexes;
cristy3ed852e2009-09-05 21:47:34 +0000987
988 k=kernel;
989 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +0000990 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +0000991 {
992 pixel.index+=(*k)*(*kernel_indexes);
993 k++;
994 kernel_indexes++;
995 }
cristyce70c172010-01-07 17:15:30 +0000996 blur_indexes[x]=ClampToQuantum(pixel.index);
cristy3ed852e2009-09-05 21:47:34 +0000997 }
998 }
999 else
1000 {
1001 MagickRealType
1002 alpha,
1003 gamma;
1004
1005 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00001006 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001007 {
cristy46f08202010-01-10 04:04:21 +00001008 alpha=(MagickRealType) (QuantumScale*
1009 GetAlphaPixelComponent(kernel_pixels));
cristy3ed852e2009-09-05 21:47:34 +00001010 pixel.red+=(*k)*alpha*kernel_pixels->red;
1011 pixel.green+=(*k)*alpha*kernel_pixels->green;
1012 pixel.blue+=(*k)*alpha*kernel_pixels->blue;
1013 gamma+=(*k)*alpha;
1014 k++;
1015 kernel_pixels++;
1016 }
1017 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
1018 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001019 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001020 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001021 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001022 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001023 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001024 if ((channel & OpacityChannel) != 0)
1025 {
1026 k=kernel;
1027 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00001028 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001029 {
1030 pixel.opacity+=(*k)*kernel_pixels->opacity;
1031 k++;
1032 kernel_pixels++;
1033 }
cristyce70c172010-01-07 17:15:30 +00001034 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001035 }
1036 if (((channel & IndexChannel) != 0) &&
1037 (image->colorspace == CMYKColorspace))
1038 {
1039 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00001040 *restrict kernel_indexes;
cristy3ed852e2009-09-05 21:47:34 +00001041
1042 k=kernel;
1043 kernel_pixels=p;
1044 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00001045 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001046 {
cristy46f08202010-01-10 04:04:21 +00001047 alpha=(MagickRealType) (QuantumScale*
1048 GetAlphaPixelComponent(kernel_pixels));
cristy3ed852e2009-09-05 21:47:34 +00001049 pixel.index+=(*k)*alpha*(*kernel_indexes);
1050 k++;
1051 kernel_pixels++;
1052 kernel_indexes++;
1053 }
cristy46f08202010-01-10 04:04:21 +00001054 blur_indexes[x]=ClampToQuantum(gamma*
1055 GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001056 }
1057 }
1058 p++;
1059 q++;
1060 }
1061 if (SyncCacheViewAuthenticPixels(blur_view,exception) == MagickFalse)
1062 status=MagickFalse;
1063 if (image->progress_monitor != (MagickProgressMonitor) NULL)
1064 {
1065 MagickBooleanType
1066 proceed;
1067
cristyb5d5f722009-11-04 03:03:49 +00001068#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00001069 #pragma omp critical (MagickCore_BlurImageChannel)
1070#endif
1071 proceed=SetImageProgress(image,BlurImageTag,progress++,blur_image->rows+
1072 blur_image->columns);
1073 if (proceed == MagickFalse)
1074 status=MagickFalse;
1075 }
1076 }
1077 blur_view=DestroyCacheView(blur_view);
1078 image_view=DestroyCacheView(image_view);
1079 /*
1080 Blur columns.
1081 */
1082 image_view=AcquireCacheView(blur_image);
1083 blur_view=AcquireCacheView(blur_image);
cristyb5d5f722009-11-04 03:03:49 +00001084#if defined(MAGICKCORE_OPENMP_SUPPORT)
1085 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00001086#endif
cristybb503372010-05-27 20:51:26 +00001087 for (x=0; x < (ssize_t) blur_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00001088 {
1089 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00001090 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00001091
1092 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00001093 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00001094
1095 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00001096 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +00001097
cristy3ed852e2009-09-05 21:47:34 +00001098 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00001099 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00001100
cristy117ff172010-08-15 21:35:32 +00001101 register ssize_t
1102 y;
1103
cristy3ed852e2009-09-05 21:47:34 +00001104 if (status == MagickFalse)
1105 continue;
cristy117ff172010-08-15 21:35:32 +00001106 p=GetCacheViewVirtualPixels(image_view,x,-((ssize_t) width/2L),1,
1107 image->rows+width,exception);
cristy3ed852e2009-09-05 21:47:34 +00001108 q=GetCacheViewAuthenticPixels(blur_view,x,0,1,blur_image->rows,exception);
1109 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
1110 {
1111 status=MagickFalse;
1112 continue;
1113 }
1114 indexes=GetCacheViewVirtualIndexQueue(image_view);
1115 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +00001116 for (y=0; y < (ssize_t) blur_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00001117 {
1118 MagickPixelPacket
1119 pixel;
1120
1121 register const double
cristyc47d1f82009-11-26 01:44:43 +00001122 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +00001123
1124 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00001125 *restrict kernel_pixels;
cristy3ed852e2009-09-05 21:47:34 +00001126
cristybb503372010-05-27 20:51:26 +00001127 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00001128 i;
1129
cristyddd82202009-11-03 20:14:50 +00001130 pixel=bias;
cristy3ed852e2009-09-05 21:47:34 +00001131 k=kernel;
1132 kernel_pixels=p;
1133 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
1134 {
cristybb503372010-05-27 20:51:26 +00001135 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001136 {
1137 pixel.red+=(*k)*kernel_pixels->red;
1138 pixel.green+=(*k)*kernel_pixels->green;
1139 pixel.blue+=(*k)*kernel_pixels->blue;
1140 k++;
1141 kernel_pixels++;
1142 }
1143 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001144 SetRedPixelComponent(q,ClampRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001145 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001146 SetGreenPixelComponent(q,ClampGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001147 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001148 SetBluePixelComponent(q,ClampBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001149 if ((channel & OpacityChannel) != 0)
1150 {
1151 k=kernel;
1152 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00001153 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001154 {
1155 pixel.opacity+=(*k)*kernel_pixels->opacity;
1156 k++;
1157 kernel_pixels++;
1158 }
cristyce70c172010-01-07 17:15:30 +00001159 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001160 }
1161 if (((channel & IndexChannel) != 0) &&
1162 (image->colorspace == CMYKColorspace))
1163 {
1164 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00001165 *restrict kernel_indexes;
cristy3ed852e2009-09-05 21:47:34 +00001166
1167 k=kernel;
1168 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00001169 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001170 {
1171 pixel.index+=(*k)*(*kernel_indexes);
1172 k++;
1173 kernel_indexes++;
1174 }
cristyce70c172010-01-07 17:15:30 +00001175 blur_indexes[y]=ClampToQuantum(pixel.index);
cristy3ed852e2009-09-05 21:47:34 +00001176 }
1177 }
1178 else
1179 {
1180 MagickRealType
1181 alpha,
1182 gamma;
1183
1184 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00001185 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001186 {
cristy46f08202010-01-10 04:04:21 +00001187 alpha=(MagickRealType) (QuantumScale*
1188 GetAlphaPixelComponent(kernel_pixels));
cristy3ed852e2009-09-05 21:47:34 +00001189 pixel.red+=(*k)*alpha*kernel_pixels->red;
1190 pixel.green+=(*k)*alpha*kernel_pixels->green;
1191 pixel.blue+=(*k)*alpha*kernel_pixels->blue;
1192 gamma+=(*k)*alpha;
1193 k++;
1194 kernel_pixels++;
1195 }
1196 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
1197 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001198 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001199 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001200 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001201 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001202 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001203 if ((channel & OpacityChannel) != 0)
1204 {
1205 k=kernel;
1206 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00001207 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001208 {
1209 pixel.opacity+=(*k)*kernel_pixels->opacity;
1210 k++;
1211 kernel_pixels++;
1212 }
cristyce70c172010-01-07 17:15:30 +00001213 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001214 }
1215 if (((channel & IndexChannel) != 0) &&
1216 (image->colorspace == CMYKColorspace))
1217 {
1218 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00001219 *restrict kernel_indexes;
cristy3ed852e2009-09-05 21:47:34 +00001220
1221 k=kernel;
1222 kernel_pixels=p;
1223 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00001224 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00001225 {
cristy46f08202010-01-10 04:04:21 +00001226 alpha=(MagickRealType) (QuantumScale*
1227 GetAlphaPixelComponent(kernel_pixels));
cristy3ed852e2009-09-05 21:47:34 +00001228 pixel.index+=(*k)*alpha*(*kernel_indexes);
1229 k++;
1230 kernel_pixels++;
1231 kernel_indexes++;
1232 }
cristy46f08202010-01-10 04:04:21 +00001233 blur_indexes[y]=ClampToQuantum(gamma*
1234 GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00001235 }
1236 }
1237 p++;
1238 q++;
1239 }
1240 if (SyncCacheViewAuthenticPixels(blur_view,exception) == MagickFalse)
1241 status=MagickFalse;
1242 if (image->progress_monitor != (MagickProgressMonitor) NULL)
1243 {
1244 MagickBooleanType
1245 proceed;
1246
cristyb5d5f722009-11-04 03:03:49 +00001247#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00001248 #pragma omp critical (MagickCore_BlurImageChannel)
1249#endif
1250 proceed=SetImageProgress(image,BlurImageTag,progress++,blur_image->rows+
1251 blur_image->columns);
1252 if (proceed == MagickFalse)
1253 status=MagickFalse;
1254 }
1255 }
1256 blur_view=DestroyCacheView(blur_view);
1257 image_view=DestroyCacheView(image_view);
1258 kernel=(double *) RelinquishMagickMemory(kernel);
1259 if (status == MagickFalse)
1260 blur_image=DestroyImage(blur_image);
1261 blur_image->type=image->type;
1262 return(blur_image);
1263}
1264
1265/*
1266%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1267% %
1268% %
1269% %
cristyfccdab92009-11-30 16:43:57 +00001270% C o n v o l v e I m a g e %
1271% %
1272% %
1273% %
1274%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1275%
1276% ConvolveImage() applies a custom convolution kernel to the image.
1277%
1278% The format of the ConvolveImage method is:
1279%
cristybb503372010-05-27 20:51:26 +00001280% Image *ConvolveImage(const Image *image,const size_t order,
cristyfccdab92009-11-30 16:43:57 +00001281% const double *kernel,ExceptionInfo *exception)
1282% Image *ConvolveImageChannel(const Image *image,const ChannelType channel,
cristy117ff172010-08-15 21:35:32 +00001283% const size_t order,const double *kernel,ExceptionInfo *exception)
cristyfccdab92009-11-30 16:43:57 +00001284%
1285% A description of each parameter follows:
1286%
1287% o image: the image.
1288%
1289% o channel: the channel type.
1290%
1291% o order: the number of columns and rows in the filter kernel.
1292%
1293% o kernel: An array of double representing the convolution kernel.
1294%
1295% o exception: return any errors or warnings in this structure.
1296%
1297*/
1298
cristybb503372010-05-27 20:51:26 +00001299MagickExport Image *ConvolveImage(const Image *image,const size_t order,
cristyfccdab92009-11-30 16:43:57 +00001300 const double *kernel,ExceptionInfo *exception)
1301{
1302 Image
1303 *convolve_image;
1304
1305 convolve_image=ConvolveImageChannel(image,DefaultChannels,order,kernel,
1306 exception);
1307 return(convolve_image);
1308}
1309
1310MagickExport Image *ConvolveImageChannel(const Image *image,
cristybb503372010-05-27 20:51:26 +00001311 const ChannelType channel,const size_t order,const double *kernel,
cristyfccdab92009-11-30 16:43:57 +00001312 ExceptionInfo *exception)
1313{
1314#define ConvolveImageTag "Convolve/Image"
1315
cristyc4c8d132010-01-07 01:58:38 +00001316 CacheView
1317 *convolve_view,
1318 *image_view;
1319
cristyfccdab92009-11-30 16:43:57 +00001320 double
1321 *normal_kernel;
1322
1323 Image
1324 *convolve_image;
1325
cristyfccdab92009-11-30 16:43:57 +00001326 MagickBooleanType
1327 status;
1328
cristybb503372010-05-27 20:51:26 +00001329 MagickOffsetType
1330 progress;
1331
cristyfccdab92009-11-30 16:43:57 +00001332 MagickPixelPacket
1333 bias;
1334
1335 MagickRealType
1336 gamma;
1337
cristybb503372010-05-27 20:51:26 +00001338 register ssize_t
cristyfccdab92009-11-30 16:43:57 +00001339 i;
1340
cristybb503372010-05-27 20:51:26 +00001341 size_t
cristyfccdab92009-11-30 16:43:57 +00001342 width;
1343
cristybb503372010-05-27 20:51:26 +00001344 ssize_t
1345 y;
1346
cristyfccdab92009-11-30 16:43:57 +00001347 /*
1348 Initialize convolve image attributes.
1349 */
1350 assert(image != (Image *) NULL);
1351 assert(image->signature == MagickSignature);
1352 if (image->debug != MagickFalse)
1353 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1354 assert(exception != (ExceptionInfo *) NULL);
1355 assert(exception->signature == MagickSignature);
1356 width=order;
1357 if ((width % 2) == 0)
1358 ThrowImageException(OptionError,"KernelWidthMustBeAnOddNumber");
1359 convolve_image=CloneImage(image,0,0,MagickTrue,exception);
1360 if (convolve_image == (Image *) NULL)
1361 return((Image *) NULL);
1362 if (SetImageStorageClass(convolve_image,DirectClass) == MagickFalse)
1363 {
1364 InheritException(exception,&convolve_image->exception);
1365 convolve_image=DestroyImage(convolve_image);
1366 return((Image *) NULL);
1367 }
1368 if (image->debug != MagickFalse)
1369 {
1370 char
1371 format[MaxTextExtent],
1372 *message;
1373
cristy117ff172010-08-15 21:35:32 +00001374 register const double
1375 *k;
1376
cristybb503372010-05-27 20:51:26 +00001377 ssize_t
cristyfccdab92009-11-30 16:43:57 +00001378 u,
1379 v;
1380
cristyfccdab92009-11-30 16:43:57 +00001381 (void) LogMagickEvent(TransformEvent,GetMagickModule(),
cristye8c25f92010-06-03 00:53:06 +00001382 " ConvolveImage with %.20gx%.20g kernel:",(double) width,(double)
1383 width);
cristyfccdab92009-11-30 16:43:57 +00001384 message=AcquireString("");
1385 k=kernel;
cristybb503372010-05-27 20:51:26 +00001386 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001387 {
1388 *message='\0';
cristye8c25f92010-06-03 00:53:06 +00001389 (void) FormatMagickString(format,MaxTextExtent,"%.20g: ",(double) v);
cristyfccdab92009-11-30 16:43:57 +00001390 (void) ConcatenateString(&message,format);
cristybb503372010-05-27 20:51:26 +00001391 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001392 {
cristye7f51092010-01-17 00:39:37 +00001393 (void) FormatMagickString(format,MaxTextExtent,"%g ",*k++);
cristyfccdab92009-11-30 16:43:57 +00001394 (void) ConcatenateString(&message,format);
1395 }
1396 (void) LogMagickEvent(TransformEvent,GetMagickModule(),"%s",message);
1397 }
1398 message=DestroyString(message);
1399 }
1400 /*
1401 Normalize kernel.
1402 */
1403 normal_kernel=(double *) AcquireQuantumMemory(width*width,
1404 sizeof(*normal_kernel));
1405 if (normal_kernel == (double *) NULL)
1406 {
1407 convolve_image=DestroyImage(convolve_image);
1408 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
1409 }
1410 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00001411 for (i=0; i < (ssize_t) (width*width); i++)
cristyfccdab92009-11-30 16:43:57 +00001412 gamma+=kernel[i];
1413 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
cristybb503372010-05-27 20:51:26 +00001414 for (i=0; i < (ssize_t) (width*width); i++)
cristyfccdab92009-11-30 16:43:57 +00001415 normal_kernel[i]=gamma*kernel[i];
1416 /*
1417 Convolve image.
1418 */
1419 status=MagickTrue;
1420 progress=0;
1421 GetMagickPixelPacket(image,&bias);
1422 SetMagickPixelPacketBias(image,&bias);
1423 image_view=AcquireCacheView(image);
1424 convolve_view=AcquireCacheView(convolve_image);
1425#if defined(MAGICKCORE_OPENMP_SUPPORT)
1426 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
1427#endif
cristybb503372010-05-27 20:51:26 +00001428 for (y=0; y < (ssize_t) image->rows; y++)
cristyfccdab92009-11-30 16:43:57 +00001429 {
1430 MagickBooleanType
1431 sync;
1432
1433 register const IndexPacket
1434 *restrict indexes;
1435
1436 register const PixelPacket
1437 *restrict p;
1438
1439 register IndexPacket
1440 *restrict convolve_indexes;
1441
cristyfccdab92009-11-30 16:43:57 +00001442 register PixelPacket
1443 *restrict q;
1444
cristy117ff172010-08-15 21:35:32 +00001445 register ssize_t
1446 x;
1447
cristyfccdab92009-11-30 16:43:57 +00001448 if (status == MagickFalse)
1449 continue;
cristyce889302010-06-30 19:16:36 +00001450 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) width/2L),y-(ssize_t)
1451 (width/2L),image->columns+width,width,exception);
cristyfccdab92009-11-30 16:43:57 +00001452 q=GetCacheViewAuthenticPixels(convolve_view,0,y,convolve_image->columns,1,
1453 exception);
1454 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
1455 {
1456 status=MagickFalse;
1457 continue;
1458 }
1459 indexes=GetCacheViewVirtualIndexQueue(image_view);
1460 convolve_indexes=GetCacheViewAuthenticIndexQueue(convolve_view);
cristybb503372010-05-27 20:51:26 +00001461 for (x=0; x < (ssize_t) image->columns; x++)
cristyfccdab92009-11-30 16:43:57 +00001462 {
cristyfccdab92009-11-30 16:43:57 +00001463 MagickPixelPacket
1464 pixel;
1465
1466 register const double
1467 *restrict k;
1468
1469 register const PixelPacket
1470 *restrict kernel_pixels;
1471
cristybb503372010-05-27 20:51:26 +00001472 register ssize_t
cristyfccdab92009-11-30 16:43:57 +00001473 u;
1474
cristy117ff172010-08-15 21:35:32 +00001475 ssize_t
1476 v;
1477
cristyfccdab92009-11-30 16:43:57 +00001478 pixel=bias;
1479 k=normal_kernel;
1480 kernel_pixels=p;
1481 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
1482 {
cristybb503372010-05-27 20:51:26 +00001483 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001484 {
cristybb503372010-05-27 20:51:26 +00001485 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001486 {
1487 pixel.red+=(*k)*kernel_pixels[u].red;
1488 pixel.green+=(*k)*kernel_pixels[u].green;
1489 pixel.blue+=(*k)*kernel_pixels[u].blue;
1490 k++;
1491 }
1492 kernel_pixels+=image->columns+width;
1493 }
1494 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001495 SetRedPixelComponent(q,ClampRedPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001496 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001497 SetGreenPixelComponent(q,ClampGreenPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001498 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001499 SetBluePixelComponent(q,ClampBluePixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001500 if ((channel & OpacityChannel) != 0)
1501 {
1502 k=normal_kernel;
1503 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00001504 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001505 {
cristybb503372010-05-27 20:51:26 +00001506 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001507 {
1508 pixel.opacity+=(*k)*kernel_pixels[u].opacity;
1509 k++;
1510 }
1511 kernel_pixels+=image->columns+width;
1512 }
cristyce70c172010-01-07 17:15:30 +00001513 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001514 }
1515 if (((channel & IndexChannel) != 0) &&
1516 (image->colorspace == CMYKColorspace))
1517 {
1518 register const IndexPacket
1519 *restrict kernel_indexes;
1520
1521 k=normal_kernel;
1522 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00001523 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001524 {
cristybb503372010-05-27 20:51:26 +00001525 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001526 {
1527 pixel.index+=(*k)*kernel_indexes[u];
1528 k++;
1529 }
1530 kernel_indexes+=image->columns+width;
1531 }
cristyce70c172010-01-07 17:15:30 +00001532 convolve_indexes[x]=ClampToQuantum(pixel.index);
cristyfccdab92009-11-30 16:43:57 +00001533 }
1534 }
1535 else
1536 {
1537 MagickRealType
1538 alpha,
1539 gamma;
1540
1541 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00001542 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001543 {
cristybb503372010-05-27 20:51:26 +00001544 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001545 {
1546 alpha=(MagickRealType) (QuantumScale*(QuantumRange-
1547 kernel_pixels[u].opacity));
1548 pixel.red+=(*k)*alpha*kernel_pixels[u].red;
1549 pixel.green+=(*k)*alpha*kernel_pixels[u].green;
1550 pixel.blue+=(*k)*alpha*kernel_pixels[u].blue;
cristyfccdab92009-11-30 16:43:57 +00001551 gamma+=(*k)*alpha;
1552 k++;
1553 }
1554 kernel_pixels+=image->columns+width;
1555 }
1556 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
1557 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001558 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001559 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001560 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001561 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00001562 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001563 if ((channel & OpacityChannel) != 0)
1564 {
1565 k=normal_kernel;
1566 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00001567 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001568 {
cristybb503372010-05-27 20:51:26 +00001569 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001570 {
1571 pixel.opacity+=(*k)*kernel_pixels[u].opacity;
1572 k++;
1573 }
1574 kernel_pixels+=image->columns+width;
1575 }
cristyce70c172010-01-07 17:15:30 +00001576 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001577 }
1578 if (((channel & IndexChannel) != 0) &&
1579 (image->colorspace == CMYKColorspace))
1580 {
1581 register const IndexPacket
1582 *restrict kernel_indexes;
1583
1584 k=normal_kernel;
1585 kernel_pixels=p;
1586 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00001587 for (v=0; v < (ssize_t) width; v++)
cristyfccdab92009-11-30 16:43:57 +00001588 {
cristybb503372010-05-27 20:51:26 +00001589 for (u=0; u < (ssize_t) width; u++)
cristyfccdab92009-11-30 16:43:57 +00001590 {
1591 alpha=(MagickRealType) (QuantumScale*(QuantumRange-
1592 kernel_pixels[u].opacity));
1593 pixel.index+=(*k)*alpha*kernel_indexes[u];
1594 k++;
1595 }
1596 kernel_pixels+=image->columns+width;
1597 kernel_indexes+=image->columns+width;
1598 }
cristy24b06da2010-01-09 23:05:56 +00001599 convolve_indexes[x]=ClampToQuantum(gamma*
1600 GetIndexPixelComponent(&pixel));
cristyfccdab92009-11-30 16:43:57 +00001601 }
1602 }
1603 p++;
1604 q++;
1605 }
1606 sync=SyncCacheViewAuthenticPixels(convolve_view,exception);
1607 if (sync == MagickFalse)
1608 status=MagickFalse;
1609 if (image->progress_monitor != (MagickProgressMonitor) NULL)
1610 {
1611 MagickBooleanType
1612 proceed;
1613
1614#if defined(MAGICKCORE_OPENMP_SUPPORT)
1615 #pragma omp critical (MagickCore_ConvolveImageChannel)
1616#endif
1617 proceed=SetImageProgress(image,ConvolveImageTag,progress++,image->rows);
1618 if (proceed == MagickFalse)
1619 status=MagickFalse;
1620 }
1621 }
1622 convolve_image->type=image->type;
1623 convolve_view=DestroyCacheView(convolve_view);
1624 image_view=DestroyCacheView(image_view);
1625 normal_kernel=(double *) RelinquishMagickMemory(normal_kernel);
1626 if (status == MagickFalse)
1627 convolve_image=DestroyImage(convolve_image);
1628 return(convolve_image);
1629}
1630
1631/*
1632%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1633% %
1634% %
1635% %
cristy3ed852e2009-09-05 21:47:34 +00001636% D e s p e c k l e I m a g e %
1637% %
1638% %
1639% %
1640%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1641%
1642% DespeckleImage() reduces the speckle noise in an image while perserving the
1643% edges of the original image.
1644%
1645% The format of the DespeckleImage method is:
1646%
1647% Image *DespeckleImage(const Image *image,ExceptionInfo *exception)
1648%
1649% A description of each parameter follows:
1650%
1651% o image: the image.
1652%
1653% o exception: return any errors or warnings in this structure.
1654%
1655*/
1656
cristybb503372010-05-27 20:51:26 +00001657static void Hull(const ssize_t x_offset,const ssize_t y_offset,
1658 const size_t columns,const size_t rows,Quantum *f,Quantum *g,
cristy3ed852e2009-09-05 21:47:34 +00001659 const int polarity)
1660{
cristy3ed852e2009-09-05 21:47:34 +00001661 MagickRealType
1662 v;
1663
cristy3ed852e2009-09-05 21:47:34 +00001664 register Quantum
1665 *p,
1666 *q,
1667 *r,
1668 *s;
1669
cristy117ff172010-08-15 21:35:32 +00001670 register ssize_t
1671 x;
1672
1673 ssize_t
1674 y;
1675
cristy3ed852e2009-09-05 21:47:34 +00001676 assert(f != (Quantum *) NULL);
1677 assert(g != (Quantum *) NULL);
1678 p=f+(columns+2);
1679 q=g+(columns+2);
cristybb503372010-05-27 20:51:26 +00001680 r=p+(y_offset*((ssize_t) columns+2)+x_offset);
1681 for (y=0; y < (ssize_t) rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00001682 {
1683 p++;
1684 q++;
1685 r++;
1686 if (polarity > 0)
cristybb503372010-05-27 20:51:26 +00001687 for (x=(ssize_t) columns; x != 0; x--)
cristy3ed852e2009-09-05 21:47:34 +00001688 {
1689 v=(MagickRealType) (*p);
1690 if ((MagickRealType) *r >= (v+(MagickRealType) ScaleCharToQuantum(2)))
1691 v+=ScaleCharToQuantum(1);
1692 *q=(Quantum) v;
1693 p++;
1694 q++;
1695 r++;
1696 }
1697 else
cristybb503372010-05-27 20:51:26 +00001698 for (x=(ssize_t) columns; x != 0; x--)
cristy3ed852e2009-09-05 21:47:34 +00001699 {
1700 v=(MagickRealType) (*p);
1701 if ((MagickRealType) *r <= (v-(MagickRealType) ScaleCharToQuantum(2)))
cristybb503372010-05-27 20:51:26 +00001702 v-=(ssize_t) ScaleCharToQuantum(1);
cristy3ed852e2009-09-05 21:47:34 +00001703 *q=(Quantum) v;
1704 p++;
1705 q++;
1706 r++;
1707 }
1708 p++;
1709 q++;
1710 r++;
1711 }
1712 p=f+(columns+2);
1713 q=g+(columns+2);
cristybb503372010-05-27 20:51:26 +00001714 r=q+(y_offset*((ssize_t) columns+2)+x_offset);
1715 s=q-(y_offset*((ssize_t) columns+2)+x_offset);
1716 for (y=0; y < (ssize_t) rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00001717 {
1718 p++;
1719 q++;
1720 r++;
1721 s++;
1722 if (polarity > 0)
cristybb503372010-05-27 20:51:26 +00001723 for (x=(ssize_t) columns; x != 0; x--)
cristy3ed852e2009-09-05 21:47:34 +00001724 {
1725 v=(MagickRealType) (*q);
1726 if (((MagickRealType) *s >=
1727 (v+(MagickRealType) ScaleCharToQuantum(2))) &&
1728 ((MagickRealType) *r > v))
1729 v+=ScaleCharToQuantum(1);
1730 *p=(Quantum) v;
1731 p++;
1732 q++;
1733 r++;
1734 s++;
1735 }
1736 else
cristybb503372010-05-27 20:51:26 +00001737 for (x=(ssize_t) columns; x != 0; x--)
cristy3ed852e2009-09-05 21:47:34 +00001738 {
1739 v=(MagickRealType) (*q);
1740 if (((MagickRealType) *s <=
1741 (v-(MagickRealType) ScaleCharToQuantum(2))) &&
1742 ((MagickRealType) *r < v))
1743 v-=(MagickRealType) ScaleCharToQuantum(1);
1744 *p=(Quantum) v;
1745 p++;
1746 q++;
1747 r++;
1748 s++;
1749 }
1750 p++;
1751 q++;
1752 r++;
1753 s++;
1754 }
1755}
1756
1757MagickExport Image *DespeckleImage(const Image *image,ExceptionInfo *exception)
1758{
1759#define DespeckleImageTag "Despeckle/Image"
1760
cristy2407fc22009-09-11 00:55:25 +00001761 CacheView
1762 *despeckle_view,
1763 *image_view;
1764
cristy3ed852e2009-09-05 21:47:34 +00001765 Image
1766 *despeckle_image;
1767
cristy3ed852e2009-09-05 21:47:34 +00001768 MagickBooleanType
1769 status;
1770
cristya58c3172011-02-19 19:23:11 +00001771 register ssize_t
1772 i;
1773
cristy3ed852e2009-09-05 21:47:34 +00001774 Quantum
cristy65b9f392011-02-22 14:22:54 +00001775 *restrict buffers,
1776 *restrict pixels;
cristy3ed852e2009-09-05 21:47:34 +00001777
1778 size_t
cristya58c3172011-02-19 19:23:11 +00001779 length,
1780 number_channels;
cristy117ff172010-08-15 21:35:32 +00001781
cristybb503372010-05-27 20:51:26 +00001782 static const ssize_t
cristy691a29e2009-09-11 00:44:10 +00001783 X[4] = {0, 1, 1,-1},
1784 Y[4] = {1, 0, 1, 1};
cristy3ed852e2009-09-05 21:47:34 +00001785
cristy3ed852e2009-09-05 21:47:34 +00001786 /*
1787 Allocate despeckled image.
1788 */
1789 assert(image != (const Image *) NULL);
1790 assert(image->signature == MagickSignature);
1791 if (image->debug != MagickFalse)
1792 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1793 assert(exception != (ExceptionInfo *) NULL);
1794 assert(exception->signature == MagickSignature);
1795 despeckle_image=CloneImage(image,image->columns,image->rows,MagickTrue,
1796 exception);
1797 if (despeckle_image == (Image *) NULL)
1798 return((Image *) NULL);
1799 if (SetImageStorageClass(despeckle_image,DirectClass) == MagickFalse)
1800 {
1801 InheritException(exception,&despeckle_image->exception);
1802 despeckle_image=DestroyImage(despeckle_image);
1803 return((Image *) NULL);
1804 }
1805 /*
1806 Allocate image buffers.
1807 */
1808 length=(size_t) ((image->columns+2)*(image->rows+2));
cristy65b9f392011-02-22 14:22:54 +00001809 pixels=(Quantum *) AcquireQuantumMemory(length,2*sizeof(*pixels));
1810 buffers=(Quantum *) AcquireQuantumMemory(length,2*sizeof(*pixels));
1811 if ((pixels == (Quantum *) NULL) || (buffers == (Quantum *) NULL))
cristy3ed852e2009-09-05 21:47:34 +00001812 {
cristy65b9f392011-02-22 14:22:54 +00001813 if (buffers != (Quantum *) NULL)
1814 buffers=(Quantum *) RelinquishMagickMemory(buffers);
1815 if (pixels != (Quantum *) NULL)
1816 pixels=(Quantum *) RelinquishMagickMemory(pixels);
cristy3ed852e2009-09-05 21:47:34 +00001817 despeckle_image=DestroyImage(despeckle_image);
1818 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
1819 }
1820 /*
1821 Reduce speckle in the image.
1822 */
1823 status=MagickTrue;
cristy109695a2011-02-19 19:38:14 +00001824 number_channels=(size_t) (image->colorspace == CMYKColorspace ? 5 : 4);
cristy3ed852e2009-09-05 21:47:34 +00001825 image_view=AcquireCacheView(image);
1826 despeckle_view=AcquireCacheView(despeckle_image);
cristy8df3d002011-02-19 19:40:59 +00001827 for (i=0; i < (ssize_t) number_channels; i++)
cristy3ed852e2009-09-05 21:47:34 +00001828 {
cristy3ed852e2009-09-05 21:47:34 +00001829 register Quantum
1830 *buffer,
1831 *pixel;
1832
cristyc1488b52011-02-19 18:54:15 +00001833 register ssize_t
cristya58c3172011-02-19 19:23:11 +00001834 k,
cristyc1488b52011-02-19 18:54:15 +00001835 x;
1836
cristy117ff172010-08-15 21:35:32 +00001837 ssize_t
1838 j,
1839 y;
1840
cristy3ed852e2009-09-05 21:47:34 +00001841 if (status == MagickFalse)
1842 continue;
cristy65b9f392011-02-22 14:22:54 +00001843 pixel=pixels;
cristy3ed852e2009-09-05 21:47:34 +00001844 (void) ResetMagickMemory(pixel,0,length*sizeof(*pixel));
cristy65b9f392011-02-22 14:22:54 +00001845 buffer=buffers;
cristybb503372010-05-27 20:51:26 +00001846 j=(ssize_t) image->columns+2;
1847 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00001848 {
cristya58c3172011-02-19 19:23:11 +00001849 register const IndexPacket
1850 *restrict indexes;
1851
cristy3ed852e2009-09-05 21:47:34 +00001852 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00001853 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00001854
1855 p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
1856 if (p == (const PixelPacket *) NULL)
1857 break;
cristya58c3172011-02-19 19:23:11 +00001858 indexes=GetCacheViewVirtualIndexQueue(image_view);
cristy3ed852e2009-09-05 21:47:34 +00001859 j++;
cristybb503372010-05-27 20:51:26 +00001860 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00001861 {
cristya58c3172011-02-19 19:23:11 +00001862 switch (i)
cristy3ed852e2009-09-05 21:47:34 +00001863 {
cristyce70c172010-01-07 17:15:30 +00001864 case 0: pixel[j]=GetRedPixelComponent(p); break;
1865 case 1: pixel[j]=GetGreenPixelComponent(p); break;
1866 case 2: pixel[j]=GetBluePixelComponent(p); break;
1867 case 3: pixel[j]=GetOpacityPixelComponent(p); break;
cristya58c3172011-02-19 19:23:11 +00001868 case 4: pixel[j]=GetBlackPixelComponent(indexes,x); break;
cristy3ed852e2009-09-05 21:47:34 +00001869 default: break;
1870 }
1871 p++;
1872 j++;
1873 }
1874 j++;
1875 }
cristy3ed852e2009-09-05 21:47:34 +00001876 (void) ResetMagickMemory(buffer,0,length*sizeof(*buffer));
cristya58c3172011-02-19 19:23:11 +00001877 for (k=0; k < 4; k++)
cristy3ed852e2009-09-05 21:47:34 +00001878 {
cristya58c3172011-02-19 19:23:11 +00001879 Hull(X[k],Y[k],image->columns,image->rows,pixel,buffer,1);
1880 Hull(-X[k],-Y[k],image->columns,image->rows,pixel,buffer,1);
1881 Hull(-X[k],-Y[k],image->columns,image->rows,pixel,buffer,-1);
1882 Hull(X[k],Y[k],image->columns,image->rows,pixel,buffer,-1);
cristy3ed852e2009-09-05 21:47:34 +00001883 }
cristybb503372010-05-27 20:51:26 +00001884 j=(ssize_t) image->columns+2;
1885 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00001886 {
1887 MagickBooleanType
1888 sync;
1889
cristya58c3172011-02-19 19:23:11 +00001890 register IndexPacket
1891 *restrict indexes;
1892
cristy3ed852e2009-09-05 21:47:34 +00001893 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00001894 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00001895
1896 q=GetCacheViewAuthenticPixels(despeckle_view,0,y,despeckle_image->columns,
1897 1,exception);
1898 if (q == (PixelPacket *) NULL)
1899 break;
cristya58c3172011-02-19 19:23:11 +00001900 indexes=GetCacheViewAuthenticIndexQueue(image_view);
cristy3ed852e2009-09-05 21:47:34 +00001901 j++;
cristybb503372010-05-27 20:51:26 +00001902 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00001903 {
cristya58c3172011-02-19 19:23:11 +00001904 switch (i)
cristy3ed852e2009-09-05 21:47:34 +00001905 {
1906 case 0: q->red=pixel[j]; break;
1907 case 1: q->green=pixel[j]; break;
1908 case 2: q->blue=pixel[j]; break;
1909 case 3: q->opacity=pixel[j]; break;
cristya58c3172011-02-19 19:23:11 +00001910 case 4: indexes[x]=pixel[j]; break;
cristy3ed852e2009-09-05 21:47:34 +00001911 default: break;
1912 }
1913 q++;
1914 j++;
1915 }
1916 sync=SyncCacheViewAuthenticPixels(despeckle_view,exception);
1917 if (sync == MagickFalse)
1918 {
1919 status=MagickFalse;
1920 break;
1921 }
1922 j++;
1923 }
1924 if (image->progress_monitor != (MagickProgressMonitor) NULL)
1925 {
1926 MagickBooleanType
1927 proceed;
1928
cristya58c3172011-02-19 19:23:11 +00001929 proceed=SetImageProgress(image,DespeckleImageTag,(MagickOffsetType) i,
1930 number_channels);
cristy3ed852e2009-09-05 21:47:34 +00001931 if (proceed == MagickFalse)
1932 status=MagickFalse;
1933 }
1934 }
1935 despeckle_view=DestroyCacheView(despeckle_view);
1936 image_view=DestroyCacheView(image_view);
cristy65b9f392011-02-22 14:22:54 +00001937 buffers=(Quantum *) RelinquishMagickMemory(buffers);
1938 pixels=(Quantum *) RelinquishMagickMemory(pixels);
cristy3ed852e2009-09-05 21:47:34 +00001939 despeckle_image->type=image->type;
1940 if (status == MagickFalse)
1941 despeckle_image=DestroyImage(despeckle_image);
1942 return(despeckle_image);
1943}
1944
1945/*
1946%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1947% %
1948% %
1949% %
1950% E d g e I m a g e %
1951% %
1952% %
1953% %
1954%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1955%
1956% EdgeImage() finds edges in an image. Radius defines the radius of the
1957% convolution filter. Use a radius of 0 and EdgeImage() selects a suitable
1958% radius for you.
1959%
1960% The format of the EdgeImage method is:
1961%
1962% Image *EdgeImage(const Image *image,const double radius,
1963% ExceptionInfo *exception)
1964%
1965% A description of each parameter follows:
1966%
1967% o image: the image.
1968%
1969% o radius: the radius of the pixel neighborhood.
1970%
1971% o exception: return any errors or warnings in this structure.
1972%
1973*/
1974MagickExport Image *EdgeImage(const Image *image,const double radius,
1975 ExceptionInfo *exception)
1976{
1977 Image
1978 *edge_image;
1979
1980 double
1981 *kernel;
1982
cristybb503372010-05-27 20:51:26 +00001983 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00001984 i;
1985
cristybb503372010-05-27 20:51:26 +00001986 size_t
cristy3ed852e2009-09-05 21:47:34 +00001987 width;
1988
1989 assert(image != (const Image *) NULL);
1990 assert(image->signature == MagickSignature);
1991 if (image->debug != MagickFalse)
1992 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1993 assert(exception != (ExceptionInfo *) NULL);
1994 assert(exception->signature == MagickSignature);
1995 width=GetOptimalKernelWidth1D(radius,0.5);
1996 kernel=(double *) AcquireQuantumMemory((size_t) width,width*sizeof(*kernel));
1997 if (kernel == (double *) NULL)
1998 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
cristybb503372010-05-27 20:51:26 +00001999 for (i=0; i < (ssize_t) (width*width); i++)
cristy3ed852e2009-09-05 21:47:34 +00002000 kernel[i]=(-1.0);
2001 kernel[i/2]=(double) (width*width-1.0);
2002 edge_image=ConvolveImage(image,width,kernel,exception);
2003 kernel=(double *) RelinquishMagickMemory(kernel);
2004 return(edge_image);
2005}
2006
2007/*
2008%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2009% %
2010% %
2011% %
2012% E m b o s s I m a g e %
2013% %
2014% %
2015% %
2016%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2017%
2018% EmbossImage() returns a grayscale image with a three-dimensional effect.
2019% We convolve the image with a Gaussian operator of the given radius and
2020% standard deviation (sigma). For reasonable results, radius should be
2021% larger than sigma. Use a radius of 0 and Emboss() selects a suitable
2022% radius for you.
2023%
2024% The format of the EmbossImage method is:
2025%
2026% Image *EmbossImage(const Image *image,const double radius,
2027% const double sigma,ExceptionInfo *exception)
2028%
2029% A description of each parameter follows:
2030%
2031% o image: the image.
2032%
2033% o radius: the radius of the pixel neighborhood.
2034%
2035% o sigma: the standard deviation of the Gaussian, in pixels.
2036%
2037% o exception: return any errors or warnings in this structure.
2038%
2039*/
2040MagickExport Image *EmbossImage(const Image *image,const double radius,
2041 const double sigma,ExceptionInfo *exception)
2042{
2043 double
2044 *kernel;
2045
2046 Image
2047 *emboss_image;
2048
cristybb503372010-05-27 20:51:26 +00002049 register ssize_t
cristy47e00502009-12-17 19:19:57 +00002050 i;
2051
cristybb503372010-05-27 20:51:26 +00002052 size_t
cristy3ed852e2009-09-05 21:47:34 +00002053 width;
2054
cristy117ff172010-08-15 21:35:32 +00002055 ssize_t
2056 j,
2057 k,
2058 u,
2059 v;
2060
cristy3ed852e2009-09-05 21:47:34 +00002061 assert(image != (Image *) NULL);
2062 assert(image->signature == MagickSignature);
2063 if (image->debug != MagickFalse)
2064 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2065 assert(exception != (ExceptionInfo *) NULL);
2066 assert(exception->signature == MagickSignature);
2067 width=GetOptimalKernelWidth2D(radius,sigma);
2068 kernel=(double *) AcquireQuantumMemory((size_t) width,width*sizeof(*kernel));
2069 if (kernel == (double *) NULL)
2070 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
cristybb503372010-05-27 20:51:26 +00002071 j=(ssize_t) width/2;
cristy47e00502009-12-17 19:19:57 +00002072 k=j;
2073 i=0;
2074 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +00002075 {
cristy47e00502009-12-17 19:19:57 +00002076 for (u=(-j); u <= j; u++)
cristy3ed852e2009-09-05 21:47:34 +00002077 {
cristy4205a3c2010-09-12 20:19:59 +00002078 kernel[i]=(double) (((u < 0) || (v < 0) ? -8.0 : 8.0)*
cristy47e00502009-12-17 19:19:57 +00002079 exp(-((double) u*u+v*v)/(2.0*MagickSigma*MagickSigma))/
cristy4205a3c2010-09-12 20:19:59 +00002080 (2.0*MagickPI*MagickSigma*MagickSigma));
cristy47e00502009-12-17 19:19:57 +00002081 if (u != k)
cristy3ed852e2009-09-05 21:47:34 +00002082 kernel[i]=0.0;
2083 i++;
2084 }
cristy47e00502009-12-17 19:19:57 +00002085 k--;
cristy3ed852e2009-09-05 21:47:34 +00002086 }
2087 emboss_image=ConvolveImage(image,width,kernel,exception);
2088 if (emboss_image != (Image *) NULL)
2089 (void) EqualizeImage(emboss_image);
2090 kernel=(double *) RelinquishMagickMemory(kernel);
2091 return(emboss_image);
2092}
2093
2094/*
2095%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2096% %
2097% %
2098% %
cristy56a9e512010-01-06 18:18:55 +00002099% F i l t e r I m a g e %
2100% %
2101% %
2102% %
2103%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2104%
2105% FilterImage() applies a custom convolution kernel to the image.
2106%
2107% The format of the FilterImage method is:
2108%
cristy2be15382010-01-21 02:38:03 +00002109% Image *FilterImage(const Image *image,const KernelInfo *kernel,
cristy56a9e512010-01-06 18:18:55 +00002110% ExceptionInfo *exception)
2111% Image *FilterImageChannel(const Image *image,const ChannelType channel,
cristy2be15382010-01-21 02:38:03 +00002112% const KernelInfo *kernel,ExceptionInfo *exception)
cristy56a9e512010-01-06 18:18:55 +00002113%
2114% A description of each parameter follows:
2115%
2116% o image: the image.
2117%
2118% o channel: the channel type.
2119%
2120% o kernel: the filtering kernel.
2121%
2122% o exception: return any errors or warnings in this structure.
2123%
2124*/
2125
cristy2be15382010-01-21 02:38:03 +00002126MagickExport Image *FilterImage(const Image *image,const KernelInfo *kernel,
cristy56a9e512010-01-06 18:18:55 +00002127 ExceptionInfo *exception)
2128{
2129 Image
2130 *filter_image;
2131
2132 filter_image=FilterImageChannel(image,DefaultChannels,kernel,exception);
2133 return(filter_image);
2134}
2135
2136MagickExport Image *FilterImageChannel(const Image *image,
cristy2be15382010-01-21 02:38:03 +00002137 const ChannelType channel,const KernelInfo *kernel,ExceptionInfo *exception)
cristy56a9e512010-01-06 18:18:55 +00002138{
2139#define FilterImageTag "Filter/Image"
2140
2141 CacheView
2142 *filter_view,
2143 *image_view;
2144
cristy56a9e512010-01-06 18:18:55 +00002145 Image
2146 *filter_image;
2147
cristy56a9e512010-01-06 18:18:55 +00002148 MagickBooleanType
2149 status;
2150
cristybb503372010-05-27 20:51:26 +00002151 MagickOffsetType
2152 progress;
2153
cristy56a9e512010-01-06 18:18:55 +00002154 MagickPixelPacket
2155 bias;
2156
cristybb503372010-05-27 20:51:26 +00002157 ssize_t
2158 y;
2159
cristy56a9e512010-01-06 18:18:55 +00002160 /*
2161 Initialize filter image attributes.
2162 */
2163 assert(image != (Image *) NULL);
2164 assert(image->signature == MagickSignature);
2165 if (image->debug != MagickFalse)
2166 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2167 assert(exception != (ExceptionInfo *) NULL);
2168 assert(exception->signature == MagickSignature);
2169 if ((kernel->width % 2) == 0)
2170 ThrowImageException(OptionError,"KernelWidthMustBeAnOddNumber");
2171 filter_image=CloneImage(image,0,0,MagickTrue,exception);
2172 if (filter_image == (Image *) NULL)
2173 return((Image *) NULL);
2174 if (SetImageStorageClass(filter_image,DirectClass) == MagickFalse)
2175 {
2176 InheritException(exception,&filter_image->exception);
2177 filter_image=DestroyImage(filter_image);
2178 return((Image *) NULL);
2179 }
2180 if (image->debug != MagickFalse)
2181 {
2182 char
2183 format[MaxTextExtent],
2184 *message;
2185
cristy117ff172010-08-15 21:35:32 +00002186 register const double
2187 *k;
2188
cristybb503372010-05-27 20:51:26 +00002189 ssize_t
cristy56a9e512010-01-06 18:18:55 +00002190 u,
2191 v;
2192
cristy56a9e512010-01-06 18:18:55 +00002193 (void) LogMagickEvent(TransformEvent,GetMagickModule(),
cristye8c25f92010-06-03 00:53:06 +00002194 " FilterImage with %.20gx%.20g kernel:",(double) kernel->width,(double)
2195 kernel->height);
cristy56a9e512010-01-06 18:18:55 +00002196 message=AcquireString("");
2197 k=kernel->values;
cristybb503372010-05-27 20:51:26 +00002198 for (v=0; v < (ssize_t) kernel->height; v++)
cristy56a9e512010-01-06 18:18:55 +00002199 {
2200 *message='\0';
cristye8c25f92010-06-03 00:53:06 +00002201 (void) FormatMagickString(format,MaxTextExtent,"%.20g: ",(double) v);
cristy56a9e512010-01-06 18:18:55 +00002202 (void) ConcatenateString(&message,format);
cristybb503372010-05-27 20:51:26 +00002203 for (u=0; u < (ssize_t) kernel->width; u++)
cristy56a9e512010-01-06 18:18:55 +00002204 {
cristye7f51092010-01-17 00:39:37 +00002205 (void) FormatMagickString(format,MaxTextExtent,"%g ",*k++);
cristy56a9e512010-01-06 18:18:55 +00002206 (void) ConcatenateString(&message,format);
2207 }
2208 (void) LogMagickEvent(TransformEvent,GetMagickModule(),"%s",message);
2209 }
2210 message=DestroyString(message);
2211 }
cristy36826ab2010-03-06 01:29:30 +00002212 status=AccelerateConvolveImage(image,kernel,filter_image,exception);
cristyd43a46b2010-01-21 02:13:41 +00002213 if (status == MagickTrue)
2214 return(filter_image);
cristy56a9e512010-01-06 18:18:55 +00002215 /*
2216 Filter image.
2217 */
2218 status=MagickTrue;
2219 progress=0;
2220 GetMagickPixelPacket(image,&bias);
2221 SetMagickPixelPacketBias(image,&bias);
2222 image_view=AcquireCacheView(image);
2223 filter_view=AcquireCacheView(filter_image);
2224#if defined(MAGICKCORE_OPENMP_SUPPORT)
2225 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
2226#endif
cristybb503372010-05-27 20:51:26 +00002227 for (y=0; y < (ssize_t) image->rows; y++)
cristy56a9e512010-01-06 18:18:55 +00002228 {
2229 MagickBooleanType
2230 sync;
2231
2232 register const IndexPacket
2233 *restrict indexes;
2234
2235 register const PixelPacket
2236 *restrict p;
2237
2238 register IndexPacket
2239 *restrict filter_indexes;
2240
cristy56a9e512010-01-06 18:18:55 +00002241 register PixelPacket
2242 *restrict q;
2243
cristy117ff172010-08-15 21:35:32 +00002244 register ssize_t
2245 x;
2246
cristy56a9e512010-01-06 18:18:55 +00002247 if (status == MagickFalse)
2248 continue;
cristybb503372010-05-27 20:51:26 +00002249 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) kernel->width/2L),
cristy117ff172010-08-15 21:35:32 +00002250 y-(ssize_t) (kernel->height/2L),image->columns+kernel->width,
2251 kernel->height,exception);
cristy56a9e512010-01-06 18:18:55 +00002252 q=GetCacheViewAuthenticPixels(filter_view,0,y,filter_image->columns,1,
2253 exception);
2254 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
2255 {
2256 status=MagickFalse;
2257 continue;
2258 }
2259 indexes=GetCacheViewVirtualIndexQueue(image_view);
2260 filter_indexes=GetCacheViewAuthenticIndexQueue(filter_view);
cristybb503372010-05-27 20:51:26 +00002261 for (x=0; x < (ssize_t) image->columns; x++)
cristy56a9e512010-01-06 18:18:55 +00002262 {
cristy56a9e512010-01-06 18:18:55 +00002263 MagickPixelPacket
2264 pixel;
2265
2266 register const double
2267 *restrict k;
2268
2269 register const PixelPacket
2270 *restrict kernel_pixels;
2271
cristybb503372010-05-27 20:51:26 +00002272 register ssize_t
cristy56a9e512010-01-06 18:18:55 +00002273 u;
2274
cristy117ff172010-08-15 21:35:32 +00002275 ssize_t
2276 v;
2277
cristy56a9e512010-01-06 18:18:55 +00002278 pixel=bias;
cristy36826ab2010-03-06 01:29:30 +00002279 k=kernel->values;
cristy56a9e512010-01-06 18:18:55 +00002280 kernel_pixels=p;
2281 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
2282 {
cristybb503372010-05-27 20:51:26 +00002283 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002284 {
cristybb503372010-05-27 20:51:26 +00002285 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002286 {
2287 pixel.red+=(*k)*kernel_pixels[u].red;
2288 pixel.green+=(*k)*kernel_pixels[u].green;
2289 pixel.blue+=(*k)*kernel_pixels[u].blue;
2290 k++;
2291 }
cristy36826ab2010-03-06 01:29:30 +00002292 kernel_pixels+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002293 }
2294 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002295 SetRedPixelComponent(q,ClampRedPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002296 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002297 SetGreenPixelComponent(q,ClampGreenPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002298 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002299 SetBluePixelComponent(q,ClampBluePixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002300 if ((channel & OpacityChannel) != 0)
2301 {
cristy36826ab2010-03-06 01:29:30 +00002302 k=kernel->values;
cristy56a9e512010-01-06 18:18:55 +00002303 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00002304 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002305 {
cristybb503372010-05-27 20:51:26 +00002306 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002307 {
2308 pixel.opacity+=(*k)*kernel_pixels[u].opacity;
2309 k++;
2310 }
cristy36826ab2010-03-06 01:29:30 +00002311 kernel_pixels+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002312 }
cristyce70c172010-01-07 17:15:30 +00002313 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002314 }
2315 if (((channel & IndexChannel) != 0) &&
2316 (image->colorspace == CMYKColorspace))
2317 {
2318 register const IndexPacket
2319 *restrict kernel_indexes;
2320
cristy36826ab2010-03-06 01:29:30 +00002321 k=kernel->values;
cristy56a9e512010-01-06 18:18:55 +00002322 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00002323 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002324 {
cristybb503372010-05-27 20:51:26 +00002325 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002326 {
2327 pixel.index+=(*k)*kernel_indexes[u];
2328 k++;
2329 }
cristy36826ab2010-03-06 01:29:30 +00002330 kernel_indexes+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002331 }
cristyce70c172010-01-07 17:15:30 +00002332 filter_indexes[x]=ClampToQuantum(pixel.index);
cristy56a9e512010-01-06 18:18:55 +00002333 }
2334 }
2335 else
2336 {
2337 MagickRealType
2338 alpha,
2339 gamma;
2340
2341 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00002342 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002343 {
cristybb503372010-05-27 20:51:26 +00002344 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002345 {
2346 alpha=(MagickRealType) (QuantumScale*(QuantumRange-
2347 kernel_pixels[u].opacity));
2348 pixel.red+=(*k)*alpha*kernel_pixels[u].red;
2349 pixel.green+=(*k)*alpha*kernel_pixels[u].green;
2350 pixel.blue+=(*k)*alpha*kernel_pixels[u].blue;
2351 gamma+=(*k)*alpha;
2352 k++;
2353 }
cristy36826ab2010-03-06 01:29:30 +00002354 kernel_pixels+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002355 }
2356 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
2357 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002358 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002359 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002360 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002361 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00002362 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002363 if ((channel & OpacityChannel) != 0)
2364 {
cristy36826ab2010-03-06 01:29:30 +00002365 k=kernel->values;
cristy56a9e512010-01-06 18:18:55 +00002366 kernel_pixels=p;
cristybb503372010-05-27 20:51:26 +00002367 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002368 {
cristybb503372010-05-27 20:51:26 +00002369 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002370 {
2371 pixel.opacity+=(*k)*kernel_pixels[u].opacity;
2372 k++;
2373 }
cristy36826ab2010-03-06 01:29:30 +00002374 kernel_pixels+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002375 }
cristyce70c172010-01-07 17:15:30 +00002376 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002377 }
2378 if (((channel & IndexChannel) != 0) &&
2379 (image->colorspace == CMYKColorspace))
2380 {
2381 register const IndexPacket
2382 *restrict kernel_indexes;
2383
cristy36826ab2010-03-06 01:29:30 +00002384 k=kernel->values;
cristy56a9e512010-01-06 18:18:55 +00002385 kernel_pixels=p;
2386 kernel_indexes=indexes;
cristybb503372010-05-27 20:51:26 +00002387 for (v=0; v < (ssize_t) kernel->width; v++)
cristy56a9e512010-01-06 18:18:55 +00002388 {
cristybb503372010-05-27 20:51:26 +00002389 for (u=0; u < (ssize_t) kernel->height; u++)
cristy56a9e512010-01-06 18:18:55 +00002390 {
2391 alpha=(MagickRealType) (QuantumScale*(QuantumRange-
2392 kernel_pixels[u].opacity));
2393 pixel.index+=(*k)*alpha*kernel_indexes[u];
2394 k++;
2395 }
cristy36826ab2010-03-06 01:29:30 +00002396 kernel_pixels+=image->columns+kernel->width;
2397 kernel_indexes+=image->columns+kernel->width;
cristy56a9e512010-01-06 18:18:55 +00002398 }
cristy2115aea2010-01-09 23:16:08 +00002399 filter_indexes[x]=ClampToQuantum(gamma*
2400 GetIndexPixelComponent(&pixel));
cristy56a9e512010-01-06 18:18:55 +00002401 }
2402 }
2403 p++;
2404 q++;
2405 }
2406 sync=SyncCacheViewAuthenticPixels(filter_view,exception);
2407 if (sync == MagickFalse)
2408 status=MagickFalse;
2409 if (image->progress_monitor != (MagickProgressMonitor) NULL)
2410 {
2411 MagickBooleanType
2412 proceed;
2413
2414#if defined(MAGICKCORE_OPENMP_SUPPORT)
2415 #pragma omp critical (MagickCore_FilterImageChannel)
2416#endif
2417 proceed=SetImageProgress(image,FilterImageTag,progress++,image->rows);
2418 if (proceed == MagickFalse)
2419 status=MagickFalse;
2420 }
2421 }
2422 filter_image->type=image->type;
2423 filter_view=DestroyCacheView(filter_view);
2424 image_view=DestroyCacheView(image_view);
cristy56a9e512010-01-06 18:18:55 +00002425 if (status == MagickFalse)
2426 filter_image=DestroyImage(filter_image);
2427 return(filter_image);
2428}
2429
2430/*
2431%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2432% %
2433% %
2434% %
cristy3ed852e2009-09-05 21:47:34 +00002435% G a u s s i a n B l u r I m a g e %
2436% %
2437% %
2438% %
2439%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2440%
2441% GaussianBlurImage() blurs an image. We convolve the image with a
2442% Gaussian operator of the given radius and standard deviation (sigma).
2443% For reasonable results, the radius should be larger than sigma. Use a
2444% radius of 0 and GaussianBlurImage() selects a suitable radius for you
2445%
2446% The format of the GaussianBlurImage method is:
2447%
2448% Image *GaussianBlurImage(const Image *image,onst double radius,
2449% const double sigma,ExceptionInfo *exception)
2450% Image *GaussianBlurImageChannel(const Image *image,
2451% const ChannelType channel,const double radius,const double sigma,
2452% ExceptionInfo *exception)
2453%
2454% A description of each parameter follows:
2455%
2456% o image: the image.
2457%
2458% o channel: the channel type.
2459%
2460% o radius: the radius of the Gaussian, in pixels, not counting the center
2461% pixel.
2462%
2463% o sigma: the standard deviation of the Gaussian, in pixels.
2464%
2465% o exception: return any errors or warnings in this structure.
2466%
2467*/
2468
2469MagickExport Image *GaussianBlurImage(const Image *image,const double radius,
2470 const double sigma,ExceptionInfo *exception)
2471{
2472 Image
2473 *blur_image;
2474
2475 blur_image=GaussianBlurImageChannel(image,DefaultChannels,radius,sigma,
2476 exception);
2477 return(blur_image);
2478}
2479
2480MagickExport Image *GaussianBlurImageChannel(const Image *image,
2481 const ChannelType channel,const double radius,const double sigma,
2482 ExceptionInfo *exception)
2483{
2484 double
2485 *kernel;
2486
2487 Image
2488 *blur_image;
2489
cristybb503372010-05-27 20:51:26 +00002490 register ssize_t
cristy47e00502009-12-17 19:19:57 +00002491 i;
2492
cristybb503372010-05-27 20:51:26 +00002493 size_t
cristy3ed852e2009-09-05 21:47:34 +00002494 width;
2495
cristy117ff172010-08-15 21:35:32 +00002496 ssize_t
2497 j,
2498 u,
2499 v;
2500
cristy3ed852e2009-09-05 21:47:34 +00002501 assert(image != (const Image *) NULL);
2502 assert(image->signature == MagickSignature);
2503 if (image->debug != MagickFalse)
2504 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2505 assert(exception != (ExceptionInfo *) NULL);
2506 assert(exception->signature == MagickSignature);
2507 width=GetOptimalKernelWidth2D(radius,sigma);
2508 kernel=(double *) AcquireQuantumMemory((size_t) width,width*sizeof(*kernel));
2509 if (kernel == (double *) NULL)
2510 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
cristybb503372010-05-27 20:51:26 +00002511 j=(ssize_t) width/2;
cristy3ed852e2009-09-05 21:47:34 +00002512 i=0;
cristy47e00502009-12-17 19:19:57 +00002513 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +00002514 {
cristy47e00502009-12-17 19:19:57 +00002515 for (u=(-j); u <= j; u++)
cristy4205a3c2010-09-12 20:19:59 +00002516 kernel[i++]=(double) (exp(-((double) u*u+v*v)/(2.0*MagickSigma*
2517 MagickSigma))/(2.0*MagickPI*MagickSigma*MagickSigma));
cristy3ed852e2009-09-05 21:47:34 +00002518 }
2519 blur_image=ConvolveImageChannel(image,channel,width,kernel,exception);
2520 kernel=(double *) RelinquishMagickMemory(kernel);
2521 return(blur_image);
2522}
2523
2524/*
2525%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2526% %
2527% %
2528% %
2529% M e d i a n F i l t e r I m a g e %
2530% %
2531% %
2532% %
2533%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2534%
2535% MedianFilterImage() applies a digital filter that improves the quality
2536% of a noisy image. Each pixel is replaced by the median in a set of
2537% neighboring pixels as defined by radius.
2538%
2539% The algorithm was contributed by Mike Edmonds and implements an insertion
2540% sort for selecting median color-channel values. For more on this algorithm
2541% see "Skip Lists: A probabilistic Alternative to Balanced Trees" by William
2542% Pugh in the June 1990 of Communications of the ACM.
2543%
2544% The format of the MedianFilterImage method is:
2545%
2546% Image *MedianFilterImage(const Image *image,const double radius,
2547% ExceptionInfo *exception)
2548%
2549% A description of each parameter follows:
2550%
2551% o image: the image.
2552%
2553% o radius: the radius of the pixel neighborhood.
2554%
2555% o exception: return any errors or warnings in this structure.
2556%
2557*/
2558
2559#define MedianListChannels 5
2560
2561typedef struct _MedianListNode
2562{
cristybb503372010-05-27 20:51:26 +00002563 size_t
cristy3ed852e2009-09-05 21:47:34 +00002564 next[9],
2565 count,
2566 signature;
2567} MedianListNode;
2568
2569typedef struct _MedianSkipList
2570{
cristybb503372010-05-27 20:51:26 +00002571 ssize_t
cristy3ed852e2009-09-05 21:47:34 +00002572 level;
2573
2574 MedianListNode
2575 *nodes;
2576} MedianSkipList;
2577
2578typedef struct _MedianPixelList
2579{
cristybb503372010-05-27 20:51:26 +00002580 size_t
cristy3ed852e2009-09-05 21:47:34 +00002581 center,
2582 seed,
2583 signature;
2584
2585 MedianSkipList
2586 lists[MedianListChannels];
2587} MedianPixelList;
2588
2589static MedianPixelList *DestroyMedianPixelList(MedianPixelList *pixel_list)
2590{
cristybb503372010-05-27 20:51:26 +00002591 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00002592 i;
2593
2594 if (pixel_list == (MedianPixelList *) NULL)
2595 return((MedianPixelList *) NULL);
2596 for (i=0; i < MedianListChannels; i++)
2597 if (pixel_list->lists[i].nodes != (MedianListNode *) NULL)
2598 pixel_list->lists[i].nodes=(MedianListNode *) RelinquishMagickMemory(
2599 pixel_list->lists[i].nodes);
cristyb41ee102010-10-04 16:46:15 +00002600 pixel_list=(MedianPixelList *) RelinquishMagickMemory(pixel_list);
cristy3ed852e2009-09-05 21:47:34 +00002601 return(pixel_list);
2602}
2603
2604static MedianPixelList **DestroyMedianPixelListThreadSet(
2605 MedianPixelList **pixel_list)
2606{
cristybb503372010-05-27 20:51:26 +00002607 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00002608 i;
2609
2610 assert(pixel_list != (MedianPixelList **) NULL);
cristybb503372010-05-27 20:51:26 +00002611 for (i=0; i < (ssize_t) GetOpenMPMaximumThreads(); i++)
cristy3ed852e2009-09-05 21:47:34 +00002612 if (pixel_list[i] != (MedianPixelList *) NULL)
2613 pixel_list[i]=DestroyMedianPixelList(pixel_list[i]);
cristyb41ee102010-10-04 16:46:15 +00002614 pixel_list=(MedianPixelList **) RelinquishMagickMemory(pixel_list);
cristy3ed852e2009-09-05 21:47:34 +00002615 return(pixel_list);
2616}
2617
cristybb503372010-05-27 20:51:26 +00002618static MedianPixelList *AcquireMedianPixelList(const size_t width)
cristy3ed852e2009-09-05 21:47:34 +00002619{
2620 MedianPixelList
2621 *pixel_list;
2622
cristybb503372010-05-27 20:51:26 +00002623 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00002624 i;
2625
cristy73bd4a52010-10-05 11:24:23 +00002626 pixel_list=(MedianPixelList *) AcquireMagickMemory(sizeof(*pixel_list));
cristy3ed852e2009-09-05 21:47:34 +00002627 if (pixel_list == (MedianPixelList *) NULL)
2628 return(pixel_list);
2629 (void) ResetMagickMemory((void *) pixel_list,0,sizeof(*pixel_list));
2630 pixel_list->center=width*width/2;
2631 for (i=0; i < MedianListChannels; i++)
2632 {
2633 pixel_list->lists[i].nodes=(MedianListNode *) AcquireQuantumMemory(65537UL,
2634 sizeof(*pixel_list->lists[i].nodes));
2635 if (pixel_list->lists[i].nodes == (MedianListNode *) NULL)
2636 return(DestroyMedianPixelList(pixel_list));
2637 (void) ResetMagickMemory(pixel_list->lists[i].nodes,0,65537UL*
2638 sizeof(*pixel_list->lists[i].nodes));
2639 }
2640 pixel_list->signature=MagickSignature;
2641 return(pixel_list);
2642}
2643
cristy117ff172010-08-15 21:35:32 +00002644static MedianPixelList **AcquireMedianPixelListThreadSet(const size_t width)
cristy3ed852e2009-09-05 21:47:34 +00002645{
cristy3ed852e2009-09-05 21:47:34 +00002646 MedianPixelList
2647 **pixel_list;
2648
cristy117ff172010-08-15 21:35:32 +00002649 register ssize_t
2650 i;
2651
cristybb503372010-05-27 20:51:26 +00002652 size_t
cristy3ed852e2009-09-05 21:47:34 +00002653 number_threads;
2654
2655 number_threads=GetOpenMPMaximumThreads();
cristyb41ee102010-10-04 16:46:15 +00002656 pixel_list=(MedianPixelList **) AcquireQuantumMemory(number_threads,
cristy3ed852e2009-09-05 21:47:34 +00002657 sizeof(*pixel_list));
2658 if (pixel_list == (MedianPixelList **) NULL)
2659 return((MedianPixelList **) NULL);
2660 (void) ResetMagickMemory(pixel_list,0,number_threads*sizeof(*pixel_list));
cristybb503372010-05-27 20:51:26 +00002661 for (i=0; i < (ssize_t) number_threads; i++)
cristy3ed852e2009-09-05 21:47:34 +00002662 {
2663 pixel_list[i]=AcquireMedianPixelList(width);
2664 if (pixel_list[i] == (MedianPixelList *) NULL)
2665 return(DestroyMedianPixelListThreadSet(pixel_list));
2666 }
2667 return(pixel_list);
2668}
2669
2670static void AddNodeMedianPixelList(MedianPixelList *pixel_list,
cristybb503372010-05-27 20:51:26 +00002671 const ssize_t channel,const size_t color)
cristy3ed852e2009-09-05 21:47:34 +00002672{
cristy3ed852e2009-09-05 21:47:34 +00002673 register MedianSkipList
2674 *list;
2675
cristy117ff172010-08-15 21:35:32 +00002676 register ssize_t
2677 level;
2678
cristybb503372010-05-27 20:51:26 +00002679 size_t
cristy3ed852e2009-09-05 21:47:34 +00002680 search,
2681 update[9];
2682
2683 /*
2684 Initialize the node.
2685 */
2686 list=pixel_list->lists+channel;
2687 list->nodes[color].signature=pixel_list->signature;
2688 list->nodes[color].count=1;
2689 /*
cristy33c53022010-06-25 12:17:27 +00002690 Determine where it belongs in the list.
cristy3ed852e2009-09-05 21:47:34 +00002691 */
2692 search=65536UL;
2693 for (level=list->level; level >= 0; level--)
2694 {
2695 while (list->nodes[search].next[level] < color)
2696 search=list->nodes[search].next[level];
2697 update[level]=search;
2698 }
2699 /*
2700 Generate a pseudo-random level for this node.
2701 */
2702 for (level=0; ; level++)
2703 {
2704 pixel_list->seed=(pixel_list->seed*42893621L)+1L;
2705 if ((pixel_list->seed & 0x300) != 0x300)
2706 break;
2707 }
2708 if (level > 8)
2709 level=8;
2710 if (level > (list->level+2))
2711 level=list->level+2;
2712 /*
2713 If we're raising the list's level, link back to the root node.
2714 */
2715 while (level > list->level)
2716 {
2717 list->level++;
2718 update[list->level]=65536UL;
2719 }
2720 /*
2721 Link the node into the skip-list.
2722 */
2723 do
2724 {
2725 list->nodes[color].next[level]=list->nodes[update[level]].next[level];
2726 list->nodes[update[level]].next[level]=color;
2727 }
2728 while (level-- > 0);
2729}
2730
2731static MagickPixelPacket GetMedianPixelList(MedianPixelList *pixel_list)
2732{
2733 MagickPixelPacket
2734 pixel;
2735
cristy3ed852e2009-09-05 21:47:34 +00002736 register MedianSkipList
2737 *list;
2738
cristy117ff172010-08-15 21:35:32 +00002739 register ssize_t
2740 channel;
2741
cristybb503372010-05-27 20:51:26 +00002742 size_t
cristy3ed852e2009-09-05 21:47:34 +00002743 center,
2744 color,
2745 count;
2746
2747 unsigned short
2748 channels[MedianListChannels];
2749
2750 /*
2751 Find the median value for each of the color.
2752 */
2753 center=pixel_list->center;
2754 for (channel=0; channel < 5; channel++)
2755 {
2756 list=pixel_list->lists+channel;
2757 color=65536UL;
2758 count=0;
2759 do
2760 {
2761 color=list->nodes[color].next[0];
2762 count+=list->nodes[color].count;
2763 }
2764 while (count <= center);
2765 channels[channel]=(unsigned short) color;
2766 }
2767 GetMagickPixelPacket((const Image *) NULL,&pixel);
2768 pixel.red=(MagickRealType) ScaleShortToQuantum(channels[0]);
2769 pixel.green=(MagickRealType) ScaleShortToQuantum(channels[1]);
2770 pixel.blue=(MagickRealType) ScaleShortToQuantum(channels[2]);
2771 pixel.opacity=(MagickRealType) ScaleShortToQuantum(channels[3]);
2772 pixel.index=(MagickRealType) ScaleShortToQuantum(channels[4]);
2773 return(pixel);
2774}
2775
2776static inline void InsertMedianPixelList(const Image *image,
2777 const PixelPacket *pixel,const IndexPacket *indexes,
2778 MedianPixelList *pixel_list)
2779{
cristybb503372010-05-27 20:51:26 +00002780 size_t
cristy3ed852e2009-09-05 21:47:34 +00002781 signature;
2782
2783 unsigned short
2784 index;
2785
2786 index=ScaleQuantumToShort(pixel->red);
2787 signature=pixel_list->lists[0].nodes[index].signature;
2788 if (signature == pixel_list->signature)
2789 pixel_list->lists[0].nodes[index].count++;
2790 else
2791 AddNodeMedianPixelList(pixel_list,0,index);
2792 index=ScaleQuantumToShort(pixel->green);
2793 signature=pixel_list->lists[1].nodes[index].signature;
2794 if (signature == pixel_list->signature)
2795 pixel_list->lists[1].nodes[index].count++;
2796 else
2797 AddNodeMedianPixelList(pixel_list,1,index);
2798 index=ScaleQuantumToShort(pixel->blue);
2799 signature=pixel_list->lists[2].nodes[index].signature;
2800 if (signature == pixel_list->signature)
2801 pixel_list->lists[2].nodes[index].count++;
2802 else
2803 AddNodeMedianPixelList(pixel_list,2,index);
2804 index=ScaleQuantumToShort(pixel->opacity);
2805 signature=pixel_list->lists[3].nodes[index].signature;
2806 if (signature == pixel_list->signature)
2807 pixel_list->lists[3].nodes[index].count++;
2808 else
2809 AddNodeMedianPixelList(pixel_list,3,index);
2810 if (image->colorspace == CMYKColorspace)
2811 index=ScaleQuantumToShort(*indexes);
2812 signature=pixel_list->lists[4].nodes[index].signature;
2813 if (signature == pixel_list->signature)
2814 pixel_list->lists[4].nodes[index].count++;
2815 else
2816 AddNodeMedianPixelList(pixel_list,4,index);
2817}
2818
2819static void ResetMedianPixelList(MedianPixelList *pixel_list)
2820{
2821 int
2822 level;
2823
cristy3ed852e2009-09-05 21:47:34 +00002824 register MedianListNode
2825 *root;
2826
2827 register MedianSkipList
2828 *list;
2829
cristy117ff172010-08-15 21:35:32 +00002830 register ssize_t
2831 channel;
2832
cristy3ed852e2009-09-05 21:47:34 +00002833 /*
2834 Reset the skip-list.
2835 */
2836 for (channel=0; channel < 5; channel++)
2837 {
2838 list=pixel_list->lists+channel;
2839 root=list->nodes+65536UL;
2840 list->level=0;
2841 for (level=0; level < 9; level++)
2842 root->next[level]=65536UL;
2843 }
2844 pixel_list->seed=pixel_list->signature++;
2845}
2846
2847MagickExport Image *MedianFilterImage(const Image *image,const double radius,
2848 ExceptionInfo *exception)
2849{
2850#define MedianFilterImageTag "MedianFilter/Image"
2851
cristyc4c8d132010-01-07 01:58:38 +00002852 CacheView
2853 *image_view,
2854 *median_view;
2855
cristy3ed852e2009-09-05 21:47:34 +00002856 Image
2857 *median_image;
2858
cristy3ed852e2009-09-05 21:47:34 +00002859 MagickBooleanType
2860 status;
2861
cristybb503372010-05-27 20:51:26 +00002862 MagickOffsetType
2863 progress;
2864
cristy3ed852e2009-09-05 21:47:34 +00002865 MedianPixelList
cristyfa112112010-01-04 17:48:07 +00002866 **restrict pixel_list;
cristy3ed852e2009-09-05 21:47:34 +00002867
cristybb503372010-05-27 20:51:26 +00002868 size_t
cristy3ed852e2009-09-05 21:47:34 +00002869 width;
2870
cristybb503372010-05-27 20:51:26 +00002871 ssize_t
2872 y;
2873
cristy3ed852e2009-09-05 21:47:34 +00002874 /*
2875 Initialize median image attributes.
2876 */
2877 assert(image != (Image *) NULL);
2878 assert(image->signature == MagickSignature);
2879 if (image->debug != MagickFalse)
2880 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2881 assert(exception != (ExceptionInfo *) NULL);
2882 assert(exception->signature == MagickSignature);
2883 width=GetOptimalKernelWidth2D(radius,0.5);
2884 if ((image->columns < width) || (image->rows < width))
2885 ThrowImageException(OptionError,"ImageSmallerThanKernelRadius");
2886 median_image=CloneImage(image,image->columns,image->rows,MagickTrue,
2887 exception);
2888 if (median_image == (Image *) NULL)
2889 return((Image *) NULL);
2890 if (SetImageStorageClass(median_image,DirectClass) == MagickFalse)
2891 {
2892 InheritException(exception,&median_image->exception);
2893 median_image=DestroyImage(median_image);
2894 return((Image *) NULL);
2895 }
2896 pixel_list=AcquireMedianPixelListThreadSet(width);
2897 if (pixel_list == (MedianPixelList **) NULL)
2898 {
2899 median_image=DestroyImage(median_image);
2900 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
2901 }
2902 /*
2903 Median filter each image row.
2904 */
2905 status=MagickTrue;
2906 progress=0;
2907 image_view=AcquireCacheView(image);
2908 median_view=AcquireCacheView(median_image);
cristyb5d5f722009-11-04 03:03:49 +00002909#if defined(MAGICKCORE_OPENMP_SUPPORT)
2910 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00002911#endif
cristybb503372010-05-27 20:51:26 +00002912 for (y=0; y < (ssize_t) median_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00002913 {
cristy5c9e6f22010-09-17 17:31:01 +00002914 const int
2915 id = GetOpenMPThreadId();
cristy6ebe97c2010-07-03 01:17:28 +00002916
cristy3ed852e2009-09-05 21:47:34 +00002917 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00002918 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00002919
2920 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00002921 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00002922
2923 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00002924 *restrict median_indexes;
cristy3ed852e2009-09-05 21:47:34 +00002925
cristy3ed852e2009-09-05 21:47:34 +00002926 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00002927 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00002928
cristy117ff172010-08-15 21:35:32 +00002929 register ssize_t
2930 x;
2931
cristy3ed852e2009-09-05 21:47:34 +00002932 if (status == MagickFalse)
2933 continue;
cristy6ebe97c2010-07-03 01:17:28 +00002934 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) width/2L),y-(ssize_t)
2935 (width/2L),image->columns+width,width,exception);
cristy3ed852e2009-09-05 21:47:34 +00002936 q=QueueCacheViewAuthenticPixels(median_view,0,y,median_image->columns,1,
2937 exception);
2938 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
2939 {
2940 status=MagickFalse;
2941 continue;
2942 }
2943 indexes=GetCacheViewVirtualIndexQueue(image_view);
2944 median_indexes=GetCacheViewAuthenticIndexQueue(median_view);
cristybb503372010-05-27 20:51:26 +00002945 for (x=0; x < (ssize_t) median_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00002946 {
2947 MagickPixelPacket
2948 pixel;
2949
cristy3ed852e2009-09-05 21:47:34 +00002950 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00002951 *restrict s;
cristy3ed852e2009-09-05 21:47:34 +00002952
cristy117ff172010-08-15 21:35:32 +00002953 register const PixelPacket
2954 *restrict r;
2955
cristybb503372010-05-27 20:51:26 +00002956 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00002957 u,
2958 v;
2959
2960 r=p;
2961 s=indexes+x;
2962 ResetMedianPixelList(pixel_list[id]);
cristybb503372010-05-27 20:51:26 +00002963 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00002964 {
cristybb503372010-05-27 20:51:26 +00002965 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00002966 InsertMedianPixelList(image,r+u,s+u,pixel_list[id]);
2967 r+=image->columns+width;
2968 s+=image->columns+width;
2969 }
2970 pixel=GetMedianPixelList(pixel_list[id]);
2971 SetPixelPacket(median_image,&pixel,q,median_indexes+x);
2972 p++;
2973 q++;
2974 }
2975 if (SyncCacheViewAuthenticPixels(median_view,exception) == MagickFalse)
2976 status=MagickFalse;
2977 if (image->progress_monitor != (MagickProgressMonitor) NULL)
2978 {
2979 MagickBooleanType
2980 proceed;
2981
cristyb5d5f722009-11-04 03:03:49 +00002982#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00002983 #pragma omp critical (MagickCore_MedianFilterImage)
2984#endif
2985 proceed=SetImageProgress(image,MedianFilterImageTag,progress++,
2986 image->rows);
2987 if (proceed == MagickFalse)
2988 status=MagickFalse;
2989 }
2990 }
2991 median_view=DestroyCacheView(median_view);
2992 image_view=DestroyCacheView(image_view);
2993 pixel_list=DestroyMedianPixelListThreadSet(pixel_list);
2994 return(median_image);
2995}
2996
2997/*
2998%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2999% %
3000% %
3001% %
3002% M o t i o n B l u r I m a g e %
3003% %
3004% %
3005% %
3006%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3007%
3008% MotionBlurImage() simulates motion blur. We convolve the image with a
3009% Gaussian operator of the given radius and standard deviation (sigma).
3010% For reasonable results, radius should be larger than sigma. Use a
3011% radius of 0 and MotionBlurImage() selects a suitable radius for you.
3012% Angle gives the angle of the blurring motion.
3013%
3014% Andrew Protano contributed this effect.
3015%
3016% The format of the MotionBlurImage method is:
3017%
3018% Image *MotionBlurImage(const Image *image,const double radius,
3019% const double sigma,const double angle,ExceptionInfo *exception)
3020% Image *MotionBlurImageChannel(const Image *image,const ChannelType channel,
3021% const double radius,const double sigma,const double angle,
3022% ExceptionInfo *exception)
3023%
3024% A description of each parameter follows:
3025%
3026% o image: the image.
3027%
3028% o channel: the channel type.
3029%
3030% o radius: the radius of the Gaussian, in pixels, not counting the center
3031% o radius: the radius of the Gaussian, in pixels, not counting
3032% the center pixel.
3033%
3034% o sigma: the standard deviation of the Gaussian, in pixels.
3035%
cristycee97112010-05-28 00:44:52 +00003036% o angle: Apply the effect along this angle.
cristy3ed852e2009-09-05 21:47:34 +00003037%
3038% o exception: return any errors or warnings in this structure.
3039%
3040*/
3041
cristybb503372010-05-27 20:51:26 +00003042static double *GetMotionBlurKernel(const size_t width,const double sigma)
cristy3ed852e2009-09-05 21:47:34 +00003043{
cristy3ed852e2009-09-05 21:47:34 +00003044 double
cristy47e00502009-12-17 19:19:57 +00003045 *kernel,
cristy3ed852e2009-09-05 21:47:34 +00003046 normalize;
3047
cristybb503372010-05-27 20:51:26 +00003048 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003049 i;
3050
3051 /*
cristy47e00502009-12-17 19:19:57 +00003052 Generate a 1-D convolution kernel.
cristy3ed852e2009-09-05 21:47:34 +00003053 */
3054 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
3055 kernel=(double *) AcquireQuantumMemory((size_t) width,sizeof(*kernel));
3056 if (kernel == (double *) NULL)
3057 return(kernel);
cristy3ed852e2009-09-05 21:47:34 +00003058 normalize=0.0;
cristybb503372010-05-27 20:51:26 +00003059 for (i=0; i < (ssize_t) width; i++)
cristy47e00502009-12-17 19:19:57 +00003060 {
cristy4205a3c2010-09-12 20:19:59 +00003061 kernel[i]=(double) (exp((-((double) i*i)/(double) (2.0*MagickSigma*
3062 MagickSigma)))/(MagickSQ2PI*MagickSigma));
cristy3ed852e2009-09-05 21:47:34 +00003063 normalize+=kernel[i];
cristy47e00502009-12-17 19:19:57 +00003064 }
cristybb503372010-05-27 20:51:26 +00003065 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00003066 kernel[i]/=normalize;
3067 return(kernel);
3068}
3069
3070MagickExport Image *MotionBlurImage(const Image *image,const double radius,
3071 const double sigma,const double angle,ExceptionInfo *exception)
3072{
3073 Image
3074 *motion_blur;
3075
3076 motion_blur=MotionBlurImageChannel(image,DefaultChannels,radius,sigma,angle,
3077 exception);
3078 return(motion_blur);
3079}
3080
3081MagickExport Image *MotionBlurImageChannel(const Image *image,
3082 const ChannelType channel,const double radius,const double sigma,
3083 const double angle,ExceptionInfo *exception)
3084{
cristyc4c8d132010-01-07 01:58:38 +00003085 CacheView
3086 *blur_view,
3087 *image_view;
3088
cristy3ed852e2009-09-05 21:47:34 +00003089 double
3090 *kernel;
3091
3092 Image
3093 *blur_image;
3094
cristy3ed852e2009-09-05 21:47:34 +00003095 MagickBooleanType
3096 status;
3097
cristybb503372010-05-27 20:51:26 +00003098 MagickOffsetType
3099 progress;
3100
cristy3ed852e2009-09-05 21:47:34 +00003101 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +00003102 bias;
cristy3ed852e2009-09-05 21:47:34 +00003103
3104 OffsetInfo
3105 *offset;
3106
3107 PointInfo
3108 point;
3109
cristybb503372010-05-27 20:51:26 +00003110 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003111 i;
3112
cristybb503372010-05-27 20:51:26 +00003113 size_t
cristy3ed852e2009-09-05 21:47:34 +00003114 width;
3115
cristybb503372010-05-27 20:51:26 +00003116 ssize_t
3117 y;
3118
cristy3ed852e2009-09-05 21:47:34 +00003119 assert(image != (Image *) NULL);
3120 assert(image->signature == MagickSignature);
3121 if (image->debug != MagickFalse)
3122 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3123 assert(exception != (ExceptionInfo *) NULL);
3124 width=GetOptimalKernelWidth1D(radius,sigma);
3125 kernel=GetMotionBlurKernel(width,sigma);
3126 if (kernel == (double *) NULL)
3127 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3128 offset=(OffsetInfo *) AcquireQuantumMemory(width,sizeof(*offset));
3129 if (offset == (OffsetInfo *) NULL)
3130 {
3131 kernel=(double *) RelinquishMagickMemory(kernel);
3132 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3133 }
3134 blur_image=CloneImage(image,0,0,MagickTrue,exception);
3135 if (blur_image == (Image *) NULL)
3136 {
3137 kernel=(double *) RelinquishMagickMemory(kernel);
3138 offset=(OffsetInfo *) RelinquishMagickMemory(offset);
3139 return((Image *) NULL);
3140 }
3141 if (SetImageStorageClass(blur_image,DirectClass) == MagickFalse)
3142 {
3143 kernel=(double *) RelinquishMagickMemory(kernel);
3144 offset=(OffsetInfo *) RelinquishMagickMemory(offset);
3145 InheritException(exception,&blur_image->exception);
3146 blur_image=DestroyImage(blur_image);
3147 return((Image *) NULL);
3148 }
3149 point.x=(double) width*sin(DegreesToRadians(angle));
3150 point.y=(double) width*cos(DegreesToRadians(angle));
cristybb503372010-05-27 20:51:26 +00003151 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00003152 {
cristybb503372010-05-27 20:51:26 +00003153 offset[i].x=(ssize_t) ceil((double) (i*point.y)/hypot(point.x,point.y)-0.5);
3154 offset[i].y=(ssize_t) ceil((double) (i*point.x)/hypot(point.x,point.y)-0.5);
cristy3ed852e2009-09-05 21:47:34 +00003155 }
3156 /*
3157 Motion blur image.
3158 */
3159 status=MagickTrue;
3160 progress=0;
cristyddd82202009-11-03 20:14:50 +00003161 GetMagickPixelPacket(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +00003162 image_view=AcquireCacheView(image);
3163 blur_view=AcquireCacheView(blur_image);
cristyb557a152011-02-22 12:14:30 +00003164#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy09d81172010-10-21 16:15:05 +00003165 #pragma omp parallel for schedule(dynamic,4) shared(progress,status) omp_throttle(1)
cristy3ed852e2009-09-05 21:47:34 +00003166#endif
cristybb503372010-05-27 20:51:26 +00003167 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00003168 {
3169 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00003170 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +00003171
cristy3ed852e2009-09-05 21:47:34 +00003172 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00003173 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00003174
cristy117ff172010-08-15 21:35:32 +00003175 register ssize_t
3176 x;
3177
cristy3ed852e2009-09-05 21:47:34 +00003178 if (status == MagickFalse)
3179 continue;
3180 q=GetCacheViewAuthenticPixels(blur_view,0,y,blur_image->columns,1,
3181 exception);
3182 if (q == (PixelPacket *) NULL)
3183 {
3184 status=MagickFalse;
3185 continue;
3186 }
3187 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +00003188 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00003189 {
3190 MagickPixelPacket
3191 qixel;
3192
3193 PixelPacket
3194 pixel;
3195
cristy117ff172010-08-15 21:35:32 +00003196 register const IndexPacket
3197 *restrict indexes;
3198
cristy3ed852e2009-09-05 21:47:34 +00003199 register double
cristyc47d1f82009-11-26 01:44:43 +00003200 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +00003201
cristybb503372010-05-27 20:51:26 +00003202 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003203 i;
3204
cristy3ed852e2009-09-05 21:47:34 +00003205 k=kernel;
cristyddd82202009-11-03 20:14:50 +00003206 qixel=bias;
cristy3ed852e2009-09-05 21:47:34 +00003207 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
3208 {
cristybb503372010-05-27 20:51:26 +00003209 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00003210 {
3211 (void) GetOneCacheViewVirtualPixel(image_view,x+offset[i].x,y+
3212 offset[i].y,&pixel,exception);
3213 qixel.red+=(*k)*pixel.red;
3214 qixel.green+=(*k)*pixel.green;
3215 qixel.blue+=(*k)*pixel.blue;
3216 qixel.opacity+=(*k)*pixel.opacity;
3217 if (image->colorspace == CMYKColorspace)
3218 {
3219 indexes=GetCacheViewVirtualIndexQueue(image_view);
3220 qixel.index+=(*k)*(*indexes);
3221 }
3222 k++;
3223 }
3224 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003225 q->red=ClampToQuantum(qixel.red);
cristy3ed852e2009-09-05 21:47:34 +00003226 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003227 q->green=ClampToQuantum(qixel.green);
cristy3ed852e2009-09-05 21:47:34 +00003228 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003229 q->blue=ClampToQuantum(qixel.blue);
cristy3ed852e2009-09-05 21:47:34 +00003230 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003231 q->opacity=ClampToQuantum(qixel.opacity);
cristy3ed852e2009-09-05 21:47:34 +00003232 if (((channel & IndexChannel) != 0) &&
3233 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +00003234 blur_indexes[x]=(IndexPacket) ClampToQuantum(qixel.index);
cristy3ed852e2009-09-05 21:47:34 +00003235 }
3236 else
3237 {
3238 MagickRealType
3239 alpha,
3240 gamma;
3241
3242 alpha=0.0;
3243 gamma=0.0;
cristybb503372010-05-27 20:51:26 +00003244 for (i=0; i < (ssize_t) width; i++)
cristy3ed852e2009-09-05 21:47:34 +00003245 {
3246 (void) GetOneCacheViewVirtualPixel(image_view,x+offset[i].x,y+
3247 offset[i].y,&pixel,exception);
cristy8a7ea362010-03-10 20:31:43 +00003248 alpha=(MagickRealType) (QuantumScale*
3249 GetAlphaPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00003250 qixel.red+=(*k)*alpha*pixel.red;
3251 qixel.green+=(*k)*alpha*pixel.green;
3252 qixel.blue+=(*k)*alpha*pixel.blue;
3253 qixel.opacity+=(*k)*pixel.opacity;
3254 if (image->colorspace == CMYKColorspace)
3255 {
3256 indexes=GetCacheViewVirtualIndexQueue(image_view);
3257 qixel.index+=(*k)*alpha*(*indexes);
3258 }
3259 gamma+=(*k)*alpha;
3260 k++;
3261 }
3262 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
3263 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003264 q->red=ClampToQuantum(gamma*qixel.red);
cristy3ed852e2009-09-05 21:47:34 +00003265 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003266 q->green=ClampToQuantum(gamma*qixel.green);
cristy3ed852e2009-09-05 21:47:34 +00003267 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003268 q->blue=ClampToQuantum(gamma*qixel.blue);
cristy3ed852e2009-09-05 21:47:34 +00003269 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00003270 q->opacity=ClampToQuantum(qixel.opacity);
cristy3ed852e2009-09-05 21:47:34 +00003271 if (((channel & IndexChannel) != 0) &&
3272 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +00003273 blur_indexes[x]=(IndexPacket) ClampToQuantum(gamma*qixel.index);
cristy3ed852e2009-09-05 21:47:34 +00003274 }
3275 q++;
3276 }
3277 if (SyncCacheViewAuthenticPixels(blur_view,exception) == MagickFalse)
3278 status=MagickFalse;
3279 if (image->progress_monitor != (MagickProgressMonitor) NULL)
3280 {
3281 MagickBooleanType
3282 proceed;
3283
cristyb557a152011-02-22 12:14:30 +00003284#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00003285 #pragma omp critical (MagickCore_MotionBlurImageChannel)
3286#endif
3287 proceed=SetImageProgress(image,BlurImageTag,progress++,image->rows);
3288 if (proceed == MagickFalse)
3289 status=MagickFalse;
3290 }
3291 }
3292 blur_view=DestroyCacheView(blur_view);
3293 image_view=DestroyCacheView(image_view);
3294 kernel=(double *) RelinquishMagickMemory(kernel);
3295 offset=(OffsetInfo *) RelinquishMagickMemory(offset);
3296 if (status == MagickFalse)
3297 blur_image=DestroyImage(blur_image);
3298 return(blur_image);
3299}
3300
3301/*
3302%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3303% %
3304% %
3305% %
3306% P r e v i e w I m a g e %
3307% %
3308% %
3309% %
3310%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3311%
3312% PreviewImage() tiles 9 thumbnails of the specified image with an image
3313% processing operation applied with varying parameters. This may be helpful
3314% pin-pointing an appropriate parameter for a particular image processing
3315% operation.
3316%
3317% The format of the PreviewImages method is:
3318%
3319% Image *PreviewImages(const Image *image,const PreviewType preview,
3320% ExceptionInfo *exception)
3321%
3322% A description of each parameter follows:
3323%
3324% o image: the image.
3325%
3326% o preview: the image processing operation.
3327%
3328% o exception: return any errors or warnings in this structure.
3329%
3330*/
3331MagickExport Image *PreviewImage(const Image *image,const PreviewType preview,
3332 ExceptionInfo *exception)
3333{
3334#define NumberTiles 9
3335#define PreviewImageTag "Preview/Image"
3336#define DefaultPreviewGeometry "204x204+10+10"
3337
3338 char
3339 factor[MaxTextExtent],
3340 label[MaxTextExtent];
3341
3342 double
3343 degrees,
3344 gamma,
3345 percentage,
3346 radius,
3347 sigma,
3348 threshold;
3349
3350 Image
3351 *images,
3352 *montage_image,
3353 *preview_image,
3354 *thumbnail;
3355
3356 ImageInfo
3357 *preview_info;
3358
cristy3ed852e2009-09-05 21:47:34 +00003359 MagickBooleanType
3360 proceed;
3361
3362 MontageInfo
3363 *montage_info;
3364
3365 QuantizeInfo
3366 quantize_info;
3367
3368 RectangleInfo
3369 geometry;
3370
cristybb503372010-05-27 20:51:26 +00003371 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003372 i,
3373 x;
3374
cristybb503372010-05-27 20:51:26 +00003375 size_t
cristy3ed852e2009-09-05 21:47:34 +00003376 colors;
3377
cristy117ff172010-08-15 21:35:32 +00003378 ssize_t
3379 y;
3380
cristy3ed852e2009-09-05 21:47:34 +00003381 /*
3382 Open output image file.
3383 */
3384 assert(image != (Image *) NULL);
3385 assert(image->signature == MagickSignature);
3386 if (image->debug != MagickFalse)
3387 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3388 colors=2;
3389 degrees=0.0;
3390 gamma=(-0.2f);
3391 preview_info=AcquireImageInfo();
3392 SetGeometry(image,&geometry);
3393 (void) ParseMetaGeometry(DefaultPreviewGeometry,&geometry.x,&geometry.y,
3394 &geometry.width,&geometry.height);
3395 images=NewImageList();
3396 percentage=12.5;
3397 GetQuantizeInfo(&quantize_info);
3398 radius=0.0;
3399 sigma=1.0;
3400 threshold=0.0;
3401 x=0;
3402 y=0;
3403 for (i=0; i < NumberTiles; i++)
3404 {
3405 thumbnail=ThumbnailImage(image,geometry.width,geometry.height,exception);
3406 if (thumbnail == (Image *) NULL)
3407 break;
3408 (void) SetImageProgressMonitor(thumbnail,(MagickProgressMonitor) NULL,
3409 (void *) NULL);
3410 (void) SetImageProperty(thumbnail,"label",DefaultTileLabel);
3411 if (i == (NumberTiles/2))
3412 {
3413 (void) QueryColorDatabase("#dfdfdf",&thumbnail->matte_color,exception);
3414 AppendImageToList(&images,thumbnail);
3415 continue;
3416 }
3417 switch (preview)
3418 {
3419 case RotatePreview:
3420 {
3421 degrees+=45.0;
3422 preview_image=RotateImage(thumbnail,degrees,exception);
cristye7f51092010-01-17 00:39:37 +00003423 (void) FormatMagickString(label,MaxTextExtent,"rotate %g",degrees);
cristy3ed852e2009-09-05 21:47:34 +00003424 break;
3425 }
3426 case ShearPreview:
3427 {
3428 degrees+=5.0;
3429 preview_image=ShearImage(thumbnail,degrees,degrees,exception);
cristye7f51092010-01-17 00:39:37 +00003430 (void) FormatMagickString(label,MaxTextExtent,"shear %gx%g",
cristy3ed852e2009-09-05 21:47:34 +00003431 degrees,2.0*degrees);
3432 break;
3433 }
3434 case RollPreview:
3435 {
cristybb503372010-05-27 20:51:26 +00003436 x=(ssize_t) ((i+1)*thumbnail->columns)/NumberTiles;
3437 y=(ssize_t) ((i+1)*thumbnail->rows)/NumberTiles;
cristy3ed852e2009-09-05 21:47:34 +00003438 preview_image=RollImage(thumbnail,x,y,exception);
cristye8c25f92010-06-03 00:53:06 +00003439 (void) FormatMagickString(label,MaxTextExtent,"roll %+.20gx%+.20g",
3440 (double) x,(double) y);
cristy3ed852e2009-09-05 21:47:34 +00003441 break;
3442 }
3443 case HuePreview:
3444 {
3445 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3446 if (preview_image == (Image *) NULL)
3447 break;
cristye7f51092010-01-17 00:39:37 +00003448 (void) FormatMagickString(factor,MaxTextExtent,"100,100,%g",
cristy3ed852e2009-09-05 21:47:34 +00003449 2.0*percentage);
3450 (void) ModulateImage(preview_image,factor);
3451 (void) FormatMagickString(label,MaxTextExtent,"modulate %s",factor);
3452 break;
3453 }
3454 case SaturationPreview:
3455 {
3456 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3457 if (preview_image == (Image *) NULL)
3458 break;
cristye7f51092010-01-17 00:39:37 +00003459 (void) FormatMagickString(factor,MaxTextExtent,"100,%g",
cristy8cd5b312010-01-07 01:10:24 +00003460 2.0*percentage);
cristy3ed852e2009-09-05 21:47:34 +00003461 (void) ModulateImage(preview_image,factor);
3462 (void) FormatMagickString(label,MaxTextExtent,"modulate %s",factor);
3463 break;
3464 }
3465 case BrightnessPreview:
3466 {
3467 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3468 if (preview_image == (Image *) NULL)
3469 break;
cristye7f51092010-01-17 00:39:37 +00003470 (void) FormatMagickString(factor,MaxTextExtent,"%g",2.0*percentage);
cristy3ed852e2009-09-05 21:47:34 +00003471 (void) ModulateImage(preview_image,factor);
3472 (void) FormatMagickString(label,MaxTextExtent,"modulate %s",factor);
3473 break;
3474 }
3475 case GammaPreview:
3476 default:
3477 {
3478 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3479 if (preview_image == (Image *) NULL)
3480 break;
3481 gamma+=0.4f;
3482 (void) GammaImageChannel(preview_image,DefaultChannels,gamma);
cristye7f51092010-01-17 00:39:37 +00003483 (void) FormatMagickString(label,MaxTextExtent,"gamma %g",gamma);
cristy3ed852e2009-09-05 21:47:34 +00003484 break;
3485 }
3486 case SpiffPreview:
3487 {
3488 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3489 if (preview_image != (Image *) NULL)
3490 for (x=0; x < i; x++)
3491 (void) ContrastImage(preview_image,MagickTrue);
cristye8c25f92010-06-03 00:53:06 +00003492 (void) FormatMagickString(label,MaxTextExtent,"contrast (%.20g)",
3493 (double) i+1);
cristy3ed852e2009-09-05 21:47:34 +00003494 break;
3495 }
3496 case DullPreview:
3497 {
3498 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3499 if (preview_image == (Image *) NULL)
3500 break;
3501 for (x=0; x < i; x++)
3502 (void) ContrastImage(preview_image,MagickFalse);
cristye8c25f92010-06-03 00:53:06 +00003503 (void) FormatMagickString(label,MaxTextExtent,"+contrast (%.20g)",
3504 (double) i+1);
cristy3ed852e2009-09-05 21:47:34 +00003505 break;
3506 }
3507 case GrayscalePreview:
3508 {
3509 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3510 if (preview_image == (Image *) NULL)
3511 break;
3512 colors<<=1;
3513 quantize_info.number_colors=colors;
3514 quantize_info.colorspace=GRAYColorspace;
3515 (void) QuantizeImage(&quantize_info,preview_image);
3516 (void) FormatMagickString(label,MaxTextExtent,
cristye8c25f92010-06-03 00:53:06 +00003517 "-colorspace gray -colors %.20g",(double) colors);
cristy3ed852e2009-09-05 21:47:34 +00003518 break;
3519 }
3520 case QuantizePreview:
3521 {
3522 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3523 if (preview_image == (Image *) NULL)
3524 break;
3525 colors<<=1;
3526 quantize_info.number_colors=colors;
3527 (void) QuantizeImage(&quantize_info,preview_image);
cristye8c25f92010-06-03 00:53:06 +00003528 (void) FormatMagickString(label,MaxTextExtent,"colors %.20g",(double)
3529 colors);
cristy3ed852e2009-09-05 21:47:34 +00003530 break;
3531 }
3532 case DespecklePreview:
3533 {
3534 for (x=0; x < (i-1); x++)
3535 {
3536 preview_image=DespeckleImage(thumbnail,exception);
3537 if (preview_image == (Image *) NULL)
3538 break;
3539 thumbnail=DestroyImage(thumbnail);
3540 thumbnail=preview_image;
3541 }
3542 preview_image=DespeckleImage(thumbnail,exception);
3543 if (preview_image == (Image *) NULL)
3544 break;
cristye8c25f92010-06-03 00:53:06 +00003545 (void) FormatMagickString(label,MaxTextExtent,"despeckle (%.20g)",
3546 (double) i+1);
cristy3ed852e2009-09-05 21:47:34 +00003547 break;
3548 }
3549 case ReduceNoisePreview:
3550 {
3551 preview_image=ReduceNoiseImage(thumbnail,radius,exception);
cristye7f51092010-01-17 00:39:37 +00003552 (void) FormatMagickString(label,MaxTextExtent,"noise %g",radius);
cristy3ed852e2009-09-05 21:47:34 +00003553 break;
3554 }
3555 case AddNoisePreview:
3556 {
3557 switch ((int) i)
3558 {
3559 case 0:
3560 {
3561 (void) CopyMagickString(factor,"uniform",MaxTextExtent);
3562 break;
3563 }
3564 case 1:
3565 {
3566 (void) CopyMagickString(factor,"gaussian",MaxTextExtent);
3567 break;
3568 }
3569 case 2:
3570 {
3571 (void) CopyMagickString(factor,"multiplicative",MaxTextExtent);
3572 break;
3573 }
3574 case 3:
3575 {
3576 (void) CopyMagickString(factor,"impulse",MaxTextExtent);
3577 break;
3578 }
3579 case 4:
3580 {
3581 (void) CopyMagickString(factor,"laplacian",MaxTextExtent);
3582 break;
3583 }
3584 case 5:
3585 {
3586 (void) CopyMagickString(factor,"Poisson",MaxTextExtent);
3587 break;
3588 }
3589 default:
3590 {
3591 (void) CopyMagickString(thumbnail->magick,"NULL",MaxTextExtent);
3592 break;
3593 }
3594 }
3595 preview_image=ReduceNoiseImage(thumbnail,(double) i,exception);
3596 (void) FormatMagickString(label,MaxTextExtent,"+noise %s",factor);
3597 break;
3598 }
3599 case SharpenPreview:
3600 {
3601 preview_image=SharpenImage(thumbnail,radius,sigma,exception);
cristye7f51092010-01-17 00:39:37 +00003602 (void) FormatMagickString(label,MaxTextExtent,"sharpen %gx%g",
cristy8cd5b312010-01-07 01:10:24 +00003603 radius,sigma);
cristy3ed852e2009-09-05 21:47:34 +00003604 break;
3605 }
3606 case BlurPreview:
3607 {
3608 preview_image=BlurImage(thumbnail,radius,sigma,exception);
cristye7f51092010-01-17 00:39:37 +00003609 (void) FormatMagickString(label,MaxTextExtent,"blur %gx%g",radius,
cristy3ed852e2009-09-05 21:47:34 +00003610 sigma);
3611 break;
3612 }
3613 case ThresholdPreview:
3614 {
3615 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3616 if (preview_image == (Image *) NULL)
3617 break;
3618 (void) BilevelImage(thumbnail,
3619 (double) (percentage*((MagickRealType) QuantumRange+1.0))/100.0);
cristye7f51092010-01-17 00:39:37 +00003620 (void) FormatMagickString(label,MaxTextExtent,"threshold %g",
cristy3ed852e2009-09-05 21:47:34 +00003621 (double) (percentage*((MagickRealType) QuantumRange+1.0))/100.0);
3622 break;
3623 }
3624 case EdgeDetectPreview:
3625 {
3626 preview_image=EdgeImage(thumbnail,radius,exception);
cristye7f51092010-01-17 00:39:37 +00003627 (void) FormatMagickString(label,MaxTextExtent,"edge %g",radius);
cristy3ed852e2009-09-05 21:47:34 +00003628 break;
3629 }
3630 case SpreadPreview:
3631 {
3632 preview_image=SpreadImage(thumbnail,radius,exception);
cristye7f51092010-01-17 00:39:37 +00003633 (void) FormatMagickString(label,MaxTextExtent,"spread %g",
cristy8cd5b312010-01-07 01:10:24 +00003634 radius+0.5);
cristy3ed852e2009-09-05 21:47:34 +00003635 break;
3636 }
3637 case SolarizePreview:
3638 {
3639 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3640 if (preview_image == (Image *) NULL)
3641 break;
3642 (void) SolarizeImage(preview_image,(double) QuantumRange*
3643 percentage/100.0);
cristye7f51092010-01-17 00:39:37 +00003644 (void) FormatMagickString(label,MaxTextExtent,"solarize %g",
cristy3ed852e2009-09-05 21:47:34 +00003645 (QuantumRange*percentage)/100.0);
3646 break;
3647 }
3648 case ShadePreview:
3649 {
3650 degrees+=10.0;
3651 preview_image=ShadeImage(thumbnail,MagickTrue,degrees,degrees,
3652 exception);
cristye7f51092010-01-17 00:39:37 +00003653 (void) FormatMagickString(label,MaxTextExtent,"shade %gx%g",
cristy8cd5b312010-01-07 01:10:24 +00003654 degrees,degrees);
cristy3ed852e2009-09-05 21:47:34 +00003655 break;
3656 }
3657 case RaisePreview:
3658 {
3659 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3660 if (preview_image == (Image *) NULL)
3661 break;
cristybb503372010-05-27 20:51:26 +00003662 geometry.width=(size_t) (2*i+2);
3663 geometry.height=(size_t) (2*i+2);
cristy3ed852e2009-09-05 21:47:34 +00003664 geometry.x=i/2;
3665 geometry.y=i/2;
3666 (void) RaiseImage(preview_image,&geometry,MagickTrue);
cristye8c25f92010-06-03 00:53:06 +00003667 (void) FormatMagickString(label,MaxTextExtent,
cristy6d8abba2010-06-03 01:10:47 +00003668 "raise %.20gx%.20g%+.20g%+.20g",(double) geometry.width,(double)
cristye8c25f92010-06-03 00:53:06 +00003669 geometry.height,(double) geometry.x,(double) geometry.y);
cristy3ed852e2009-09-05 21:47:34 +00003670 break;
3671 }
3672 case SegmentPreview:
3673 {
3674 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3675 if (preview_image == (Image *) NULL)
3676 break;
3677 threshold+=0.4f;
3678 (void) SegmentImage(preview_image,RGBColorspace,MagickFalse,threshold,
3679 threshold);
cristye7f51092010-01-17 00:39:37 +00003680 (void) FormatMagickString(label,MaxTextExtent,"segment %gx%g",
cristy3ed852e2009-09-05 21:47:34 +00003681 threshold,threshold);
3682 break;
3683 }
3684 case SwirlPreview:
3685 {
3686 preview_image=SwirlImage(thumbnail,degrees,exception);
cristye7f51092010-01-17 00:39:37 +00003687 (void) FormatMagickString(label,MaxTextExtent,"swirl %g",degrees);
cristy3ed852e2009-09-05 21:47:34 +00003688 degrees+=45.0;
3689 break;
3690 }
3691 case ImplodePreview:
3692 {
3693 degrees+=0.1f;
3694 preview_image=ImplodeImage(thumbnail,degrees,exception);
cristye7f51092010-01-17 00:39:37 +00003695 (void) FormatMagickString(label,MaxTextExtent,"implode %g",degrees);
cristy3ed852e2009-09-05 21:47:34 +00003696 break;
3697 }
3698 case WavePreview:
3699 {
3700 degrees+=5.0f;
3701 preview_image=WaveImage(thumbnail,0.5*degrees,2.0*degrees,exception);
cristye7f51092010-01-17 00:39:37 +00003702 (void) FormatMagickString(label,MaxTextExtent,"wave %gx%g",
cristy8cd5b312010-01-07 01:10:24 +00003703 0.5*degrees,2.0*degrees);
cristy3ed852e2009-09-05 21:47:34 +00003704 break;
3705 }
3706 case OilPaintPreview:
3707 {
3708 preview_image=OilPaintImage(thumbnail,(double) radius,exception);
cristye7f51092010-01-17 00:39:37 +00003709 (void) FormatMagickString(label,MaxTextExtent,"paint %g",radius);
cristy3ed852e2009-09-05 21:47:34 +00003710 break;
3711 }
3712 case CharcoalDrawingPreview:
3713 {
3714 preview_image=CharcoalImage(thumbnail,(double) radius,(double) sigma,
3715 exception);
cristye7f51092010-01-17 00:39:37 +00003716 (void) FormatMagickString(label,MaxTextExtent,"charcoal %gx%g",
cristy8cd5b312010-01-07 01:10:24 +00003717 radius,sigma);
cristy3ed852e2009-09-05 21:47:34 +00003718 break;
3719 }
3720 case JPEGPreview:
3721 {
3722 char
3723 filename[MaxTextExtent];
3724
3725 int
3726 file;
3727
3728 MagickBooleanType
3729 status;
3730
3731 preview_image=CloneImage(thumbnail,0,0,MagickTrue,exception);
3732 if (preview_image == (Image *) NULL)
3733 break;
cristybb503372010-05-27 20:51:26 +00003734 preview_info->quality=(size_t) percentage;
cristye8c25f92010-06-03 00:53:06 +00003735 (void) FormatMagickString(factor,MaxTextExtent,"%.20g",(double)
3736 preview_info->quality);
cristy3ed852e2009-09-05 21:47:34 +00003737 file=AcquireUniqueFileResource(filename);
3738 if (file != -1)
3739 file=close(file)-1;
3740 (void) FormatMagickString(preview_image->filename,MaxTextExtent,
3741 "jpeg:%s",filename);
3742 status=WriteImage(preview_info,preview_image);
3743 if (status != MagickFalse)
3744 {
3745 Image
3746 *quality_image;
3747
3748 (void) CopyMagickString(preview_info->filename,
3749 preview_image->filename,MaxTextExtent);
3750 quality_image=ReadImage(preview_info,exception);
3751 if (quality_image != (Image *) NULL)
3752 {
3753 preview_image=DestroyImage(preview_image);
3754 preview_image=quality_image;
3755 }
3756 }
3757 (void) RelinquishUniqueFileResource(preview_image->filename);
3758 if ((GetBlobSize(preview_image)/1024) >= 1024)
cristye7f51092010-01-17 00:39:37 +00003759 (void) FormatMagickString(label,MaxTextExtent,"quality %s\n%gmb ",
cristy3ed852e2009-09-05 21:47:34 +00003760 factor,(double) ((MagickOffsetType) GetBlobSize(preview_image))/
3761 1024.0/1024.0);
3762 else
3763 if (GetBlobSize(preview_image) >= 1024)
cristy8cd5b312010-01-07 01:10:24 +00003764 (void) FormatMagickString(label,MaxTextExtent,
cristye7f51092010-01-17 00:39:37 +00003765 "quality %s\n%gkb ",factor,(double) ((MagickOffsetType)
cristy8cd5b312010-01-07 01:10:24 +00003766 GetBlobSize(preview_image))/1024.0);
cristy3ed852e2009-09-05 21:47:34 +00003767 else
cristye8c25f92010-06-03 00:53:06 +00003768 (void) FormatMagickString(label,MaxTextExtent,"quality %s\n%.20gb ",
3769 factor,(double) GetBlobSize(thumbnail));
cristy3ed852e2009-09-05 21:47:34 +00003770 break;
3771 }
3772 }
3773 thumbnail=DestroyImage(thumbnail);
3774 percentage+=12.5;
3775 radius+=0.5;
3776 sigma+=0.25;
3777 if (preview_image == (Image *) NULL)
3778 break;
3779 (void) DeleteImageProperty(preview_image,"label");
3780 (void) SetImageProperty(preview_image,"label",label);
3781 AppendImageToList(&images,preview_image);
cristybb503372010-05-27 20:51:26 +00003782 proceed=SetImageProgress(image,PreviewImageTag,(MagickOffsetType) i,
3783 NumberTiles);
cristy3ed852e2009-09-05 21:47:34 +00003784 if (proceed == MagickFalse)
3785 break;
3786 }
3787 if (images == (Image *) NULL)
3788 {
3789 preview_info=DestroyImageInfo(preview_info);
3790 return((Image *) NULL);
3791 }
3792 /*
3793 Create the montage.
3794 */
3795 montage_info=CloneMontageInfo(preview_info,(MontageInfo *) NULL);
3796 (void) CopyMagickString(montage_info->filename,image->filename,MaxTextExtent);
3797 montage_info->shadow=MagickTrue;
3798 (void) CloneString(&montage_info->tile,"3x3");
3799 (void) CloneString(&montage_info->geometry,DefaultPreviewGeometry);
3800 (void) CloneString(&montage_info->frame,DefaultTileFrame);
3801 montage_image=MontageImages(images,montage_info,exception);
3802 montage_info=DestroyMontageInfo(montage_info);
3803 images=DestroyImageList(images);
3804 if (montage_image == (Image *) NULL)
3805 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3806 if (montage_image->montage != (char *) NULL)
3807 {
3808 /*
3809 Free image directory.
3810 */
3811 montage_image->montage=(char *) RelinquishMagickMemory(
3812 montage_image->montage);
3813 if (image->directory != (char *) NULL)
3814 montage_image->directory=(char *) RelinquishMagickMemory(
3815 montage_image->directory);
3816 }
3817 preview_info=DestroyImageInfo(preview_info);
3818 return(montage_image);
3819}
3820
3821/*
3822%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3823% %
3824% %
3825% %
3826% R a d i a l B l u r I m a g e %
3827% %
3828% %
3829% %
3830%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3831%
3832% RadialBlurImage() applies a radial blur to the image.
3833%
3834% Andrew Protano contributed this effect.
3835%
3836% The format of the RadialBlurImage method is:
3837%
3838% Image *RadialBlurImage(const Image *image,const double angle,
3839% ExceptionInfo *exception)
3840% Image *RadialBlurImageChannel(const Image *image,const ChannelType channel,
3841% const double angle,ExceptionInfo *exception)
3842%
3843% A description of each parameter follows:
3844%
3845% o image: the image.
3846%
3847% o channel: the channel type.
3848%
3849% o angle: the angle of the radial blur.
3850%
3851% o exception: return any errors or warnings in this structure.
3852%
3853*/
3854
3855MagickExport Image *RadialBlurImage(const Image *image,const double angle,
3856 ExceptionInfo *exception)
3857{
3858 Image
3859 *blur_image;
3860
3861 blur_image=RadialBlurImageChannel(image,DefaultChannels,angle,exception);
3862 return(blur_image);
3863}
3864
3865MagickExport Image *RadialBlurImageChannel(const Image *image,
3866 const ChannelType channel,const double angle,ExceptionInfo *exception)
3867{
cristyc4c8d132010-01-07 01:58:38 +00003868 CacheView
3869 *blur_view,
3870 *image_view;
3871
cristy3ed852e2009-09-05 21:47:34 +00003872 Image
3873 *blur_image;
3874
cristy3ed852e2009-09-05 21:47:34 +00003875 MagickBooleanType
3876 status;
3877
cristybb503372010-05-27 20:51:26 +00003878 MagickOffsetType
3879 progress;
3880
cristy3ed852e2009-09-05 21:47:34 +00003881 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +00003882 bias;
cristy3ed852e2009-09-05 21:47:34 +00003883
3884 MagickRealType
3885 blur_radius,
3886 *cos_theta,
3887 offset,
3888 *sin_theta,
3889 theta;
3890
3891 PointInfo
3892 blur_center;
3893
cristybb503372010-05-27 20:51:26 +00003894 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003895 i;
3896
cristybb503372010-05-27 20:51:26 +00003897 size_t
cristy3ed852e2009-09-05 21:47:34 +00003898 n;
3899
cristybb503372010-05-27 20:51:26 +00003900 ssize_t
3901 y;
3902
cristy3ed852e2009-09-05 21:47:34 +00003903 /*
3904 Allocate blur image.
3905 */
3906 assert(image != (Image *) NULL);
3907 assert(image->signature == MagickSignature);
3908 if (image->debug != MagickFalse)
3909 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3910 assert(exception != (ExceptionInfo *) NULL);
3911 assert(exception->signature == MagickSignature);
3912 blur_image=CloneImage(image,0,0,MagickTrue,exception);
3913 if (blur_image == (Image *) NULL)
3914 return((Image *) NULL);
3915 if (SetImageStorageClass(blur_image,DirectClass) == MagickFalse)
3916 {
3917 InheritException(exception,&blur_image->exception);
3918 blur_image=DestroyImage(blur_image);
3919 return((Image *) NULL);
3920 }
3921 blur_center.x=(double) image->columns/2.0;
3922 blur_center.y=(double) image->rows/2.0;
3923 blur_radius=hypot(blur_center.x,blur_center.y);
cristy117ff172010-08-15 21:35:32 +00003924 n=(size_t) fabs(4.0*DegreesToRadians(angle)*sqrt((double) blur_radius)+2UL);
cristy3ed852e2009-09-05 21:47:34 +00003925 theta=DegreesToRadians(angle)/(MagickRealType) (n-1);
3926 cos_theta=(MagickRealType *) AcquireQuantumMemory((size_t) n,
3927 sizeof(*cos_theta));
3928 sin_theta=(MagickRealType *) AcquireQuantumMemory((size_t) n,
3929 sizeof(*sin_theta));
3930 if ((cos_theta == (MagickRealType *) NULL) ||
3931 (sin_theta == (MagickRealType *) NULL))
3932 {
3933 blur_image=DestroyImage(blur_image);
3934 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3935 }
3936 offset=theta*(MagickRealType) (n-1)/2.0;
cristybb503372010-05-27 20:51:26 +00003937 for (i=0; i < (ssize_t) n; i++)
cristy3ed852e2009-09-05 21:47:34 +00003938 {
3939 cos_theta[i]=cos((double) (theta*i-offset));
3940 sin_theta[i]=sin((double) (theta*i-offset));
3941 }
3942 /*
3943 Radial blur image.
3944 */
3945 status=MagickTrue;
3946 progress=0;
cristyddd82202009-11-03 20:14:50 +00003947 GetMagickPixelPacket(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +00003948 image_view=AcquireCacheView(image);
3949 blur_view=AcquireCacheView(blur_image);
cristyb5d5f722009-11-04 03:03:49 +00003950#if defined(MAGICKCORE_OPENMP_SUPPORT)
3951 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00003952#endif
cristybb503372010-05-27 20:51:26 +00003953 for (y=0; y < (ssize_t) blur_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00003954 {
3955 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00003956 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00003957
3958 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00003959 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +00003960
cristy3ed852e2009-09-05 21:47:34 +00003961 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00003962 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00003963
cristy117ff172010-08-15 21:35:32 +00003964 register ssize_t
3965 x;
3966
cristy3ed852e2009-09-05 21:47:34 +00003967 if (status == MagickFalse)
3968 continue;
3969 q=GetCacheViewAuthenticPixels(blur_view,0,y,blur_image->columns,1,
3970 exception);
3971 if (q == (PixelPacket *) NULL)
3972 {
3973 status=MagickFalse;
3974 continue;
3975 }
3976 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +00003977 for (x=0; x < (ssize_t) blur_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00003978 {
3979 MagickPixelPacket
3980 qixel;
3981
3982 MagickRealType
3983 normalize,
3984 radius;
3985
3986 PixelPacket
3987 pixel;
3988
3989 PointInfo
3990 center;
3991
cristybb503372010-05-27 20:51:26 +00003992 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00003993 i;
3994
cristybb503372010-05-27 20:51:26 +00003995 size_t
cristy3ed852e2009-09-05 21:47:34 +00003996 step;
3997
3998 center.x=(double) x-blur_center.x;
3999 center.y=(double) y-blur_center.y;
4000 radius=hypot((double) center.x,center.y);
4001 if (radius == 0)
4002 step=1;
4003 else
4004 {
cristybb503372010-05-27 20:51:26 +00004005 step=(size_t) (blur_radius/radius);
cristy3ed852e2009-09-05 21:47:34 +00004006 if (step == 0)
4007 step=1;
4008 else
4009 if (step >= n)
4010 step=n-1;
4011 }
4012 normalize=0.0;
cristyddd82202009-11-03 20:14:50 +00004013 qixel=bias;
cristy3ed852e2009-09-05 21:47:34 +00004014 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
4015 {
cristyeaedf062010-05-29 22:36:02 +00004016 for (i=0; i < (ssize_t) n; i+=(ssize_t) step)
cristy3ed852e2009-09-05 21:47:34 +00004017 {
cristyeaedf062010-05-29 22:36:02 +00004018 (void) GetOneCacheViewVirtualPixel(image_view,(ssize_t)
4019 (blur_center.x+center.x*cos_theta[i]-center.y*sin_theta[i]+0.5),
4020 (ssize_t) (blur_center.y+center.x*sin_theta[i]+center.y*
4021 cos_theta[i]+0.5),&pixel,exception);
cristy3ed852e2009-09-05 21:47:34 +00004022 qixel.red+=pixel.red;
4023 qixel.green+=pixel.green;
4024 qixel.blue+=pixel.blue;
4025 qixel.opacity+=pixel.opacity;
4026 if (image->colorspace == CMYKColorspace)
4027 {
4028 indexes=GetCacheViewVirtualIndexQueue(image_view);
4029 qixel.index+=(*indexes);
4030 }
4031 normalize+=1.0;
4032 }
4033 normalize=1.0/(fabs((double) normalize) <= MagickEpsilon ? 1.0 :
4034 normalize);
4035 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004036 q->red=ClampToQuantum(normalize*qixel.red);
cristy3ed852e2009-09-05 21:47:34 +00004037 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004038 q->green=ClampToQuantum(normalize*qixel.green);
cristy3ed852e2009-09-05 21:47:34 +00004039 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004040 q->blue=ClampToQuantum(normalize*qixel.blue);
cristy3ed852e2009-09-05 21:47:34 +00004041 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004042 q->opacity=ClampToQuantum(normalize*qixel.opacity);
cristy3ed852e2009-09-05 21:47:34 +00004043 if (((channel & IndexChannel) != 0) &&
4044 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +00004045 blur_indexes[x]=(IndexPacket) ClampToQuantum(normalize*qixel.index);
cristy3ed852e2009-09-05 21:47:34 +00004046 }
4047 else
4048 {
4049 MagickRealType
4050 alpha,
4051 gamma;
4052
4053 alpha=1.0;
4054 gamma=0.0;
cristyeaedf062010-05-29 22:36:02 +00004055 for (i=0; i < (ssize_t) n; i+=(ssize_t) step)
cristy3ed852e2009-09-05 21:47:34 +00004056 {
cristyeaedf062010-05-29 22:36:02 +00004057 (void) GetOneCacheViewVirtualPixel(image_view,(ssize_t)
4058 (blur_center.x+center.x*cos_theta[i]-center.y*sin_theta[i]+0.5),
4059 (ssize_t) (blur_center.y+center.x*sin_theta[i]+center.y*
4060 cos_theta[i]+0.5),&pixel,exception);
cristy46f08202010-01-10 04:04:21 +00004061 alpha=(MagickRealType) (QuantumScale*
4062 GetAlphaPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004063 qixel.red+=alpha*pixel.red;
4064 qixel.green+=alpha*pixel.green;
4065 qixel.blue+=alpha*pixel.blue;
4066 qixel.opacity+=pixel.opacity;
4067 if (image->colorspace == CMYKColorspace)
4068 {
4069 indexes=GetCacheViewVirtualIndexQueue(image_view);
4070 qixel.index+=alpha*(*indexes);
4071 }
4072 gamma+=alpha;
4073 normalize+=1.0;
4074 }
4075 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
4076 normalize=1.0/(fabs((double) normalize) <= MagickEpsilon ? 1.0 :
4077 normalize);
4078 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004079 q->red=ClampToQuantum(gamma*qixel.red);
cristy3ed852e2009-09-05 21:47:34 +00004080 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004081 q->green=ClampToQuantum(gamma*qixel.green);
cristy3ed852e2009-09-05 21:47:34 +00004082 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004083 q->blue=ClampToQuantum(gamma*qixel.blue);
cristy3ed852e2009-09-05 21:47:34 +00004084 if ((channel & OpacityChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004085 q->opacity=ClampToQuantum(normalize*qixel.opacity);
cristy3ed852e2009-09-05 21:47:34 +00004086 if (((channel & IndexChannel) != 0) &&
4087 (image->colorspace == CMYKColorspace))
cristyce70c172010-01-07 17:15:30 +00004088 blur_indexes[x]=(IndexPacket) ClampToQuantum(gamma*qixel.index);
cristy3ed852e2009-09-05 21:47:34 +00004089 }
4090 q++;
4091 }
4092 if (SyncCacheViewAuthenticPixels(blur_view,exception) == MagickFalse)
4093 status=MagickFalse;
4094 if (image->progress_monitor != (MagickProgressMonitor) NULL)
4095 {
4096 MagickBooleanType
4097 proceed;
4098
cristyb5d5f722009-11-04 03:03:49 +00004099#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00004100 #pragma omp critical (MagickCore_RadialBlurImageChannel)
4101#endif
4102 proceed=SetImageProgress(image,BlurImageTag,progress++,image->rows);
4103 if (proceed == MagickFalse)
4104 status=MagickFalse;
4105 }
4106 }
4107 blur_view=DestroyCacheView(blur_view);
4108 image_view=DestroyCacheView(image_view);
4109 cos_theta=(MagickRealType *) RelinquishMagickMemory(cos_theta);
4110 sin_theta=(MagickRealType *) RelinquishMagickMemory(sin_theta);
4111 if (status == MagickFalse)
4112 blur_image=DestroyImage(blur_image);
4113 return(blur_image);
4114}
4115
4116/*
4117%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4118% %
4119% %
4120% %
4121% R e d u c e N o i s e I m a g e %
4122% %
4123% %
4124% %
4125%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4126%
4127% ReduceNoiseImage() smooths the contours of an image while still preserving
4128% edge information. The algorithm works by replacing each pixel with its
4129% neighbor closest in value. A neighbor is defined by radius. Use a radius
4130% of 0 and ReduceNoise() selects a suitable radius for you.
4131%
4132% The format of the ReduceNoiseImage method is:
4133%
4134% Image *ReduceNoiseImage(const Image *image,const double radius,
4135% ExceptionInfo *exception)
4136%
4137% A description of each parameter follows:
4138%
4139% o image: the image.
4140%
4141% o radius: the radius of the pixel neighborhood.
4142%
4143% o exception: return any errors or warnings in this structure.
4144%
4145*/
4146
4147static MagickPixelPacket GetNonpeakMedianPixelList(MedianPixelList *pixel_list)
4148{
4149 MagickPixelPacket
4150 pixel;
4151
cristy3ed852e2009-09-05 21:47:34 +00004152 register MedianSkipList
4153 *list;
4154
cristy117ff172010-08-15 21:35:32 +00004155 register ssize_t
4156 channel;
4157
cristybb503372010-05-27 20:51:26 +00004158 size_t
cristy3ed852e2009-09-05 21:47:34 +00004159 center,
4160 color,
4161 count,
4162 previous,
4163 next;
4164
4165 unsigned short
4166 channels[5];
4167
4168 /*
4169 Finds the median value for each of the color.
4170 */
4171 center=pixel_list->center;
4172 for (channel=0; channel < 5; channel++)
4173 {
4174 list=pixel_list->lists+channel;
4175 color=65536UL;
4176 next=list->nodes[color].next[0];
4177 count=0;
4178 do
4179 {
4180 previous=color;
4181 color=next;
4182 next=list->nodes[color].next[0];
4183 count+=list->nodes[color].count;
4184 }
4185 while (count <= center);
4186 if ((previous == 65536UL) && (next != 65536UL))
4187 color=next;
4188 else
4189 if ((previous != 65536UL) && (next == 65536UL))
4190 color=previous;
4191 channels[channel]=(unsigned short) color;
4192 }
4193 GetMagickPixelPacket((const Image *) NULL,&pixel);
4194 pixel.red=(MagickRealType) ScaleShortToQuantum(channels[0]);
4195 pixel.green=(MagickRealType) ScaleShortToQuantum(channels[1]);
4196 pixel.blue=(MagickRealType) ScaleShortToQuantum(channels[2]);
4197 pixel.opacity=(MagickRealType) ScaleShortToQuantum(channels[3]);
4198 pixel.index=(MagickRealType) ScaleShortToQuantum(channels[4]);
4199 return(pixel);
4200}
4201
4202MagickExport Image *ReduceNoiseImage(const Image *image,const double radius,
4203 ExceptionInfo *exception)
4204{
4205#define ReduceNoiseImageTag "ReduceNoise/Image"
4206
cristyfa112112010-01-04 17:48:07 +00004207 CacheView
4208 *image_view,
4209 *noise_view;
4210
cristy3ed852e2009-09-05 21:47:34 +00004211 Image
4212 *noise_image;
4213
cristy3ed852e2009-09-05 21:47:34 +00004214 MagickBooleanType
4215 status;
4216
cristybb503372010-05-27 20:51:26 +00004217 MagickOffsetType
4218 progress;
4219
cristy3ed852e2009-09-05 21:47:34 +00004220 MedianPixelList
cristyfa112112010-01-04 17:48:07 +00004221 **restrict pixel_list;
cristy3ed852e2009-09-05 21:47:34 +00004222
cristybb503372010-05-27 20:51:26 +00004223 size_t
cristy3ed852e2009-09-05 21:47:34 +00004224 width;
4225
cristybb503372010-05-27 20:51:26 +00004226 ssize_t
4227 y;
4228
cristy3ed852e2009-09-05 21:47:34 +00004229 /*
4230 Initialize noise image attributes.
4231 */
4232 assert(image != (Image *) NULL);
4233 assert(image->signature == MagickSignature);
4234 if (image->debug != MagickFalse)
4235 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
4236 assert(exception != (ExceptionInfo *) NULL);
4237 assert(exception->signature == MagickSignature);
4238 width=GetOptimalKernelWidth2D(radius,0.5);
4239 if ((image->columns < width) || (image->rows < width))
4240 ThrowImageException(OptionError,"ImageSmallerThanKernelRadius");
4241 noise_image=CloneImage(image,image->columns,image->rows,MagickTrue,
4242 exception);
4243 if (noise_image == (Image *) NULL)
4244 return((Image *) NULL);
4245 if (SetImageStorageClass(noise_image,DirectClass) == MagickFalse)
4246 {
4247 InheritException(exception,&noise_image->exception);
4248 noise_image=DestroyImage(noise_image);
4249 return((Image *) NULL);
4250 }
4251 pixel_list=AcquireMedianPixelListThreadSet(width);
4252 if (pixel_list == (MedianPixelList **) NULL)
4253 {
4254 noise_image=DestroyImage(noise_image);
4255 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
4256 }
4257 /*
4258 Reduce noise image.
4259 */
4260 status=MagickTrue;
4261 progress=0;
4262 image_view=AcquireCacheView(image);
4263 noise_view=AcquireCacheView(noise_image);
cristyb5d5f722009-11-04 03:03:49 +00004264#if defined(MAGICKCORE_OPENMP_SUPPORT)
4265 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00004266#endif
cristybb503372010-05-27 20:51:26 +00004267 for (y=0; y < (ssize_t) noise_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00004268 {
cristy5c9e6f22010-09-17 17:31:01 +00004269 const int
4270 id = GetOpenMPThreadId();
cristy6ebe97c2010-07-03 01:17:28 +00004271
cristy3ed852e2009-09-05 21:47:34 +00004272 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00004273 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00004274
4275 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004276 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00004277
4278 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00004279 *restrict noise_indexes;
cristy3ed852e2009-09-05 21:47:34 +00004280
cristy3ed852e2009-09-05 21:47:34 +00004281 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004282 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00004283
cristy117ff172010-08-15 21:35:32 +00004284 register ssize_t
4285 x;
4286
cristy3ed852e2009-09-05 21:47:34 +00004287 if (status == MagickFalse)
4288 continue;
cristy6ebe97c2010-07-03 01:17:28 +00004289 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) width/2L),y-(ssize_t)
4290 (width/2L),image->columns+width,width,exception);
cristy3ed852e2009-09-05 21:47:34 +00004291 q=QueueCacheViewAuthenticPixels(noise_view,0,y,noise_image->columns,1,
4292 exception);
4293 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
4294 {
4295 status=MagickFalse;
4296 continue;
4297 }
4298 indexes=GetCacheViewVirtualIndexQueue(image_view);
4299 noise_indexes=GetCacheViewAuthenticIndexQueue(noise_view);
cristybb503372010-05-27 20:51:26 +00004300 for (x=0; x < (ssize_t) noise_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00004301 {
4302 MagickPixelPacket
4303 pixel;
4304
4305 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004306 *restrict r;
cristy3ed852e2009-09-05 21:47:34 +00004307
4308 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00004309 *restrict s;
cristy3ed852e2009-09-05 21:47:34 +00004310
cristybb503372010-05-27 20:51:26 +00004311 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00004312 u,
4313 v;
4314
4315 r=p;
4316 s=indexes+x;
4317 ResetMedianPixelList(pixel_list[id]);
cristybb503372010-05-27 20:51:26 +00004318 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004319 {
cristybb503372010-05-27 20:51:26 +00004320 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004321 InsertMedianPixelList(image,r+u,s+u,pixel_list[id]);
4322 r+=image->columns+width;
4323 s+=image->columns+width;
4324 }
4325 pixel=GetNonpeakMedianPixelList(pixel_list[id]);
4326 SetPixelPacket(noise_image,&pixel,q,noise_indexes+x);
4327 p++;
4328 q++;
4329 }
4330 if (SyncCacheViewAuthenticPixels(noise_view,exception) == MagickFalse)
4331 status=MagickFalse;
4332 if (image->progress_monitor != (MagickProgressMonitor) NULL)
4333 {
4334 MagickBooleanType
4335 proceed;
4336
cristyb5d5f722009-11-04 03:03:49 +00004337#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00004338 #pragma omp critical (MagickCore_ReduceNoiseImage)
4339#endif
4340 proceed=SetImageProgress(image,ReduceNoiseImageTag,progress++,
4341 image->rows);
4342 if (proceed == MagickFalse)
4343 status=MagickFalse;
4344 }
4345 }
4346 noise_view=DestroyCacheView(noise_view);
4347 image_view=DestroyCacheView(image_view);
4348 pixel_list=DestroyMedianPixelListThreadSet(pixel_list);
4349 return(noise_image);
4350}
4351
4352/*
4353%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4354% %
4355% %
4356% %
4357% S e l e c t i v e B l u r I m a g e %
4358% %
4359% %
4360% %
4361%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4362%
4363% SelectiveBlurImage() selectively blur pixels within a contrast threshold.
4364% It is similar to the unsharpen mask that sharpens everything with contrast
4365% above a certain threshold.
4366%
4367% The format of the SelectiveBlurImage method is:
4368%
4369% Image *SelectiveBlurImage(const Image *image,const double radius,
4370% const double sigma,const double threshold,ExceptionInfo *exception)
4371% Image *SelectiveBlurImageChannel(const Image *image,
4372% const ChannelType channel,const double radius,const double sigma,
4373% const double threshold,ExceptionInfo *exception)
4374%
4375% A description of each parameter follows:
4376%
4377% o image: the image.
4378%
4379% o channel: the channel type.
4380%
4381% o radius: the radius of the Gaussian, in pixels, not counting the center
4382% pixel.
4383%
4384% o sigma: the standard deviation of the Gaussian, in pixels.
4385%
4386% o threshold: only pixels within this contrast threshold are included
4387% in the blur operation.
4388%
4389% o exception: return any errors or warnings in this structure.
4390%
4391*/
4392
4393static inline MagickBooleanType SelectiveContrast(const PixelPacket *p,
4394 const PixelPacket *q,const double threshold)
4395{
4396 if (fabs(PixelIntensity(p)-PixelIntensity(q)) < threshold)
4397 return(MagickTrue);
4398 return(MagickFalse);
4399}
4400
4401MagickExport Image *SelectiveBlurImage(const Image *image,const double radius,
4402 const double sigma,const double threshold,ExceptionInfo *exception)
4403{
4404 Image
4405 *blur_image;
4406
4407 blur_image=SelectiveBlurImageChannel(image,DefaultChannels,radius,sigma,
4408 threshold,exception);
4409 return(blur_image);
4410}
4411
4412MagickExport Image *SelectiveBlurImageChannel(const Image *image,
4413 const ChannelType channel,const double radius,const double sigma,
4414 const double threshold,ExceptionInfo *exception)
4415{
4416#define SelectiveBlurImageTag "SelectiveBlur/Image"
4417
cristy47e00502009-12-17 19:19:57 +00004418 CacheView
4419 *blur_view,
4420 *image_view;
4421
cristy3ed852e2009-09-05 21:47:34 +00004422 double
cristy3ed852e2009-09-05 21:47:34 +00004423 *kernel;
4424
4425 Image
4426 *blur_image;
4427
cristy3ed852e2009-09-05 21:47:34 +00004428 MagickBooleanType
4429 status;
4430
cristybb503372010-05-27 20:51:26 +00004431 MagickOffsetType
4432 progress;
4433
cristy3ed852e2009-09-05 21:47:34 +00004434 MagickPixelPacket
cristy3ed852e2009-09-05 21:47:34 +00004435 bias;
4436
cristybb503372010-05-27 20:51:26 +00004437 register ssize_t
cristy47e00502009-12-17 19:19:57 +00004438 i;
cristy3ed852e2009-09-05 21:47:34 +00004439
cristybb503372010-05-27 20:51:26 +00004440 size_t
cristy3ed852e2009-09-05 21:47:34 +00004441 width;
4442
cristybb503372010-05-27 20:51:26 +00004443 ssize_t
4444 j,
4445 u,
4446 v,
4447 y;
4448
cristy3ed852e2009-09-05 21:47:34 +00004449 /*
4450 Initialize blur image attributes.
4451 */
4452 assert(image != (Image *) NULL);
4453 assert(image->signature == MagickSignature);
4454 if (image->debug != MagickFalse)
4455 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
4456 assert(exception != (ExceptionInfo *) NULL);
4457 assert(exception->signature == MagickSignature);
4458 width=GetOptimalKernelWidth1D(radius,sigma);
4459 kernel=(double *) AcquireQuantumMemory((size_t) width,width*sizeof(*kernel));
4460 if (kernel == (double *) NULL)
4461 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
cristybb503372010-05-27 20:51:26 +00004462 j=(ssize_t) width/2;
cristy3ed852e2009-09-05 21:47:34 +00004463 i=0;
cristy47e00502009-12-17 19:19:57 +00004464 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +00004465 {
cristy47e00502009-12-17 19:19:57 +00004466 for (u=(-j); u <= j; u++)
cristy4205a3c2010-09-12 20:19:59 +00004467 kernel[i++]=(double) (exp(-((double) u*u+v*v)/(2.0*MagickSigma*
4468 MagickSigma))/(2.0*MagickPI*MagickSigma*MagickSigma));
cristy3ed852e2009-09-05 21:47:34 +00004469 }
4470 if (image->debug != MagickFalse)
4471 {
4472 char
4473 format[MaxTextExtent],
4474 *message;
4475
cristy117ff172010-08-15 21:35:32 +00004476 register const double
4477 *k;
4478
cristybb503372010-05-27 20:51:26 +00004479 ssize_t
cristy3ed852e2009-09-05 21:47:34 +00004480 u,
4481 v;
4482
cristy3ed852e2009-09-05 21:47:34 +00004483 (void) LogMagickEvent(TransformEvent,GetMagickModule(),
cristye8c25f92010-06-03 00:53:06 +00004484 " SelectiveBlurImage with %.20gx%.20g kernel:",(double) width,(double)
4485 width);
cristy3ed852e2009-09-05 21:47:34 +00004486 message=AcquireString("");
4487 k=kernel;
cristybb503372010-05-27 20:51:26 +00004488 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004489 {
4490 *message='\0';
cristye8c25f92010-06-03 00:53:06 +00004491 (void) FormatMagickString(format,MaxTextExtent,"%.20g: ",(double) v);
cristy3ed852e2009-09-05 21:47:34 +00004492 (void) ConcatenateString(&message,format);
cristybb503372010-05-27 20:51:26 +00004493 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004494 {
4495 (void) FormatMagickString(format,MaxTextExtent,"%+f ",*k++);
4496 (void) ConcatenateString(&message,format);
4497 }
4498 (void) LogMagickEvent(TransformEvent,GetMagickModule(),"%s",message);
4499 }
4500 message=DestroyString(message);
4501 }
4502 blur_image=CloneImage(image,0,0,MagickTrue,exception);
4503 if (blur_image == (Image *) NULL)
4504 return((Image *) NULL);
4505 if (SetImageStorageClass(blur_image,DirectClass) == MagickFalse)
4506 {
4507 InheritException(exception,&blur_image->exception);
4508 blur_image=DestroyImage(blur_image);
4509 return((Image *) NULL);
4510 }
4511 /*
4512 Threshold blur image.
4513 */
4514 status=MagickTrue;
4515 progress=0;
cristyddd82202009-11-03 20:14:50 +00004516 GetMagickPixelPacket(image,&bias);
4517 SetMagickPixelPacketBias(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +00004518 image_view=AcquireCacheView(image);
4519 blur_view=AcquireCacheView(blur_image);
cristyb5d5f722009-11-04 03:03:49 +00004520#if defined(MAGICKCORE_OPENMP_SUPPORT)
4521 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00004522#endif
cristybb503372010-05-27 20:51:26 +00004523 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00004524 {
4525 MagickBooleanType
4526 sync;
4527
4528 MagickRealType
4529 gamma;
4530
4531 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00004532 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00004533
4534 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004535 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00004536
4537 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00004538 *restrict blur_indexes;
cristy3ed852e2009-09-05 21:47:34 +00004539
cristy3ed852e2009-09-05 21:47:34 +00004540 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004541 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00004542
cristy117ff172010-08-15 21:35:32 +00004543 register ssize_t
4544 x;
4545
cristy3ed852e2009-09-05 21:47:34 +00004546 if (status == MagickFalse)
4547 continue;
cristy117ff172010-08-15 21:35:32 +00004548 p=GetCacheViewVirtualPixels(image_view,-((ssize_t) width/2L),y-(ssize_t)
4549 (width/2L),image->columns+width,width,exception);
cristy3ed852e2009-09-05 21:47:34 +00004550 q=GetCacheViewAuthenticPixels(blur_view,0,y,blur_image->columns,1,
4551 exception);
4552 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
4553 {
4554 status=MagickFalse;
4555 continue;
4556 }
4557 indexes=GetCacheViewVirtualIndexQueue(image_view);
4558 blur_indexes=GetCacheViewAuthenticIndexQueue(blur_view);
cristybb503372010-05-27 20:51:26 +00004559 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00004560 {
cristy3ed852e2009-09-05 21:47:34 +00004561 MagickPixelPacket
4562 pixel;
4563
4564 register const double
cristyc47d1f82009-11-26 01:44:43 +00004565 *restrict k;
cristy3ed852e2009-09-05 21:47:34 +00004566
cristybb503372010-05-27 20:51:26 +00004567 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +00004568 u;
4569
cristy117ff172010-08-15 21:35:32 +00004570 ssize_t
4571 j,
4572 v;
4573
cristyddd82202009-11-03 20:14:50 +00004574 pixel=bias;
cristy3ed852e2009-09-05 21:47:34 +00004575 k=kernel;
4576 gamma=0.0;
4577 j=0;
4578 if (((channel & OpacityChannel) == 0) || (image->matte == MagickFalse))
4579 {
cristybb503372010-05-27 20:51:26 +00004580 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004581 {
cristybb503372010-05-27 20:51:26 +00004582 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004583 {
4584 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4585 {
4586 pixel.red+=(*k)*(p+u+j)->red;
4587 pixel.green+=(*k)*(p+u+j)->green;
4588 pixel.blue+=(*k)*(p+u+j)->blue;
4589 gamma+=(*k);
4590 k++;
4591 }
4592 }
cristyd99b0962010-05-29 23:14:26 +00004593 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004594 }
4595 if (gamma != 0.0)
4596 {
4597 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
4598 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004599 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004600 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004601 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004602 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004603 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004604 }
4605 if ((channel & OpacityChannel) != 0)
4606 {
4607 gamma=0.0;
4608 j=0;
cristybb503372010-05-27 20:51:26 +00004609 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004610 {
cristybb503372010-05-27 20:51:26 +00004611 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004612 {
4613 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4614 {
4615 pixel.opacity+=(*k)*(p+u+j)->opacity;
4616 gamma+=(*k);
4617 k++;
4618 }
4619 }
cristyeaedf062010-05-29 22:36:02 +00004620 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004621 }
4622 if (gamma != 0.0)
4623 {
4624 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 :
4625 gamma);
cristyce70c172010-01-07 17:15:30 +00004626 SetOpacityPixelComponent(q,ClampToQuantum(gamma*
4627 GetOpacityPixelComponent(&pixel)));
cristy3ed852e2009-09-05 21:47:34 +00004628 }
4629 }
4630 if (((channel & IndexChannel) != 0) &&
4631 (image->colorspace == CMYKColorspace))
4632 {
4633 gamma=0.0;
4634 j=0;
cristybb503372010-05-27 20:51:26 +00004635 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004636 {
cristybb503372010-05-27 20:51:26 +00004637 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004638 {
4639 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4640 {
4641 pixel.index+=(*k)*indexes[x+u+j];
4642 gamma+=(*k);
4643 k++;
4644 }
4645 }
cristyeaedf062010-05-29 22:36:02 +00004646 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004647 }
4648 if (gamma != 0.0)
4649 {
4650 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 :
4651 gamma);
cristy6db48122010-01-11 00:18:07 +00004652 blur_indexes[x]=ClampToQuantum(gamma*
4653 GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004654 }
4655 }
4656 }
4657 else
4658 {
4659 MagickRealType
4660 alpha;
4661
cristybb503372010-05-27 20:51:26 +00004662 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004663 {
cristybb503372010-05-27 20:51:26 +00004664 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004665 {
4666 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4667 {
cristy46f08202010-01-10 04:04:21 +00004668 alpha=(MagickRealType) (QuantumScale*
4669 GetAlphaPixelComponent(p+u+j));
cristy3ed852e2009-09-05 21:47:34 +00004670 pixel.red+=(*k)*alpha*(p+u+j)->red;
4671 pixel.green+=(*k)*alpha*(p+u+j)->green;
4672 pixel.blue+=(*k)*alpha*(p+u+j)->blue;
4673 pixel.opacity+=(*k)*(p+u+j)->opacity;
4674 gamma+=(*k)*alpha;
4675 k++;
4676 }
4677 }
cristyeaedf062010-05-29 22:36:02 +00004678 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004679 }
4680 if (gamma != 0.0)
4681 {
4682 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
4683 if ((channel & RedChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004684 q->red=ClampToQuantum(gamma*GetRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004685 if ((channel & GreenChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004686 q->green=ClampToQuantum(gamma*GetGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004687 if ((channel & BlueChannel) != 0)
cristyce70c172010-01-07 17:15:30 +00004688 q->blue=ClampToQuantum(gamma*GetBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004689 }
4690 if ((channel & OpacityChannel) != 0)
4691 {
4692 gamma=0.0;
4693 j=0;
cristybb503372010-05-27 20:51:26 +00004694 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004695 {
cristybb503372010-05-27 20:51:26 +00004696 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004697 {
4698 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4699 {
4700 pixel.opacity+=(*k)*(p+u+j)->opacity;
4701 gamma+=(*k);
4702 k++;
4703 }
4704 }
cristyeaedf062010-05-29 22:36:02 +00004705 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004706 }
4707 if (gamma != 0.0)
4708 {
4709 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 :
4710 gamma);
cristy6db48122010-01-11 00:18:07 +00004711 SetOpacityPixelComponent(q,
4712 ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004713 }
4714 }
4715 if (((channel & IndexChannel) != 0) &&
4716 (image->colorspace == CMYKColorspace))
4717 {
4718 gamma=0.0;
4719 j=0;
cristybb503372010-05-27 20:51:26 +00004720 for (v=0; v < (ssize_t) width; v++)
cristy3ed852e2009-09-05 21:47:34 +00004721 {
cristybb503372010-05-27 20:51:26 +00004722 for (u=0; u < (ssize_t) width; u++)
cristy3ed852e2009-09-05 21:47:34 +00004723 {
4724 if (SelectiveContrast(p+u+j,q,threshold) != MagickFalse)
4725 {
cristy46f08202010-01-10 04:04:21 +00004726 alpha=(MagickRealType) (QuantumScale*
4727 GetAlphaPixelComponent(p+u+j));
cristy3ed852e2009-09-05 21:47:34 +00004728 pixel.index+=(*k)*alpha*indexes[x+u+j];
4729 gamma+=(*k);
4730 k++;
4731 }
4732 }
cristyeaedf062010-05-29 22:36:02 +00004733 j+=(ssize_t) (image->columns+width);
cristy3ed852e2009-09-05 21:47:34 +00004734 }
4735 if (gamma != 0.0)
4736 {
4737 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 :
4738 gamma);
cristy6db48122010-01-11 00:18:07 +00004739 blur_indexes[x]=ClampToQuantum(gamma*
4740 GetIndexPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00004741 }
4742 }
4743 }
4744 p++;
4745 q++;
4746 }
4747 sync=SyncCacheViewAuthenticPixels(blur_view,exception);
4748 if (sync == MagickFalse)
4749 status=MagickFalse;
4750 if (image->progress_monitor != (MagickProgressMonitor) NULL)
4751 {
4752 MagickBooleanType
4753 proceed;
4754
cristyb5d5f722009-11-04 03:03:49 +00004755#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00004756 #pragma omp critical (MagickCore_SelectiveBlurImageChannel)
4757#endif
4758 proceed=SetImageProgress(image,SelectiveBlurImageTag,progress++,
4759 image->rows);
4760 if (proceed == MagickFalse)
4761 status=MagickFalse;
4762 }
4763 }
4764 blur_image->type=image->type;
4765 blur_view=DestroyCacheView(blur_view);
4766 image_view=DestroyCacheView(image_view);
4767 kernel=(double *) RelinquishMagickMemory(kernel);
4768 if (status == MagickFalse)
4769 blur_image=DestroyImage(blur_image);
4770 return(blur_image);
4771}
4772
4773/*
4774%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4775% %
4776% %
4777% %
4778% S h a d e I m a g e %
4779% %
4780% %
4781% %
4782%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4783%
4784% ShadeImage() shines a distant light on an image to create a
4785% three-dimensional effect. You control the positioning of the light with
4786% azimuth and elevation; azimuth is measured in degrees off the x axis
4787% and elevation is measured in pixels above the Z axis.
4788%
4789% The format of the ShadeImage method is:
4790%
4791% Image *ShadeImage(const Image *image,const MagickBooleanType gray,
4792% const double azimuth,const double elevation,ExceptionInfo *exception)
4793%
4794% A description of each parameter follows:
4795%
4796% o image: the image.
4797%
4798% o gray: A value other than zero shades the intensity of each pixel.
4799%
4800% o azimuth, elevation: Define the light source direction.
4801%
4802% o exception: return any errors or warnings in this structure.
4803%
4804*/
4805MagickExport Image *ShadeImage(const Image *image,const MagickBooleanType gray,
4806 const double azimuth,const double elevation,ExceptionInfo *exception)
4807{
4808#define ShadeImageTag "Shade/Image"
4809
cristyc4c8d132010-01-07 01:58:38 +00004810 CacheView
4811 *image_view,
4812 *shade_view;
4813
cristy3ed852e2009-09-05 21:47:34 +00004814 Image
4815 *shade_image;
4816
cristy3ed852e2009-09-05 21:47:34 +00004817 MagickBooleanType
4818 status;
4819
cristybb503372010-05-27 20:51:26 +00004820 MagickOffsetType
4821 progress;
4822
cristy3ed852e2009-09-05 21:47:34 +00004823 PrimaryInfo
4824 light;
4825
cristybb503372010-05-27 20:51:26 +00004826 ssize_t
4827 y;
4828
cristy3ed852e2009-09-05 21:47:34 +00004829 /*
4830 Initialize shaded image attributes.
4831 */
4832 assert(image != (const Image *) NULL);
4833 assert(image->signature == MagickSignature);
4834 if (image->debug != MagickFalse)
4835 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
4836 assert(exception != (ExceptionInfo *) NULL);
4837 assert(exception->signature == MagickSignature);
4838 shade_image=CloneImage(image,image->columns,image->rows,MagickTrue,exception);
4839 if (shade_image == (Image *) NULL)
4840 return((Image *) NULL);
4841 if (SetImageStorageClass(shade_image,DirectClass) == MagickFalse)
4842 {
4843 InheritException(exception,&shade_image->exception);
4844 shade_image=DestroyImage(shade_image);
4845 return((Image *) NULL);
4846 }
4847 /*
4848 Compute the light vector.
4849 */
4850 light.x=(double) QuantumRange*cos(DegreesToRadians(azimuth))*
4851 cos(DegreesToRadians(elevation));
4852 light.y=(double) QuantumRange*sin(DegreesToRadians(azimuth))*
4853 cos(DegreesToRadians(elevation));
4854 light.z=(double) QuantumRange*sin(DegreesToRadians(elevation));
4855 /*
4856 Shade image.
4857 */
4858 status=MagickTrue;
4859 progress=0;
4860 image_view=AcquireCacheView(image);
4861 shade_view=AcquireCacheView(shade_image);
cristyb5d5f722009-11-04 03:03:49 +00004862#if defined(MAGICKCORE_OPENMP_SUPPORT)
4863 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00004864#endif
cristybb503372010-05-27 20:51:26 +00004865 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00004866 {
4867 MagickRealType
4868 distance,
4869 normal_distance,
4870 shade;
4871
4872 PrimaryInfo
4873 normal;
4874
4875 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004876 *restrict p,
4877 *restrict s0,
4878 *restrict s1,
4879 *restrict s2;
cristy3ed852e2009-09-05 21:47:34 +00004880
cristy3ed852e2009-09-05 21:47:34 +00004881 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00004882 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00004883
cristy117ff172010-08-15 21:35:32 +00004884 register ssize_t
4885 x;
4886
cristy3ed852e2009-09-05 21:47:34 +00004887 if (status == MagickFalse)
4888 continue;
4889 p=GetCacheViewVirtualPixels(image_view,-1,y-1,image->columns+2,3,exception);
4890 q=QueueCacheViewAuthenticPixels(shade_view,0,y,shade_image->columns,1,
4891 exception);
4892 if ((p == (PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
4893 {
4894 status=MagickFalse;
4895 continue;
4896 }
4897 /*
4898 Shade this row of pixels.
4899 */
4900 normal.z=2.0*(double) QuantumRange; /* constant Z of surface normal */
4901 s0=p+1;
4902 s1=s0+image->columns+2;
4903 s2=s1+image->columns+2;
cristybb503372010-05-27 20:51:26 +00004904 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00004905 {
4906 /*
4907 Determine the surface normal and compute shading.
4908 */
4909 normal.x=(double) (PixelIntensity(s0-1)+PixelIntensity(s1-1)+
4910 PixelIntensity(s2-1)-PixelIntensity(s0+1)-PixelIntensity(s1+1)-
4911 PixelIntensity(s2+1));
4912 normal.y=(double) (PixelIntensity(s2-1)+PixelIntensity(s2)+
4913 PixelIntensity(s2+1)-PixelIntensity(s0-1)-PixelIntensity(s0)-
4914 PixelIntensity(s0+1));
4915 if ((normal.x == 0.0) && (normal.y == 0.0))
4916 shade=light.z;
4917 else
4918 {
4919 shade=0.0;
4920 distance=normal.x*light.x+normal.y*light.y+normal.z*light.z;
4921 if (distance > MagickEpsilon)
4922 {
4923 normal_distance=
4924 normal.x*normal.x+normal.y*normal.y+normal.z*normal.z;
4925 if (normal_distance > (MagickEpsilon*MagickEpsilon))
4926 shade=distance/sqrt((double) normal_distance);
4927 }
4928 }
4929 if (gray != MagickFalse)
4930 {
4931 q->red=(Quantum) shade;
4932 q->green=(Quantum) shade;
4933 q->blue=(Quantum) shade;
4934 }
4935 else
4936 {
cristyce70c172010-01-07 17:15:30 +00004937 q->red=ClampToQuantum(QuantumScale*shade*s1->red);
4938 q->green=ClampToQuantum(QuantumScale*shade*s1->green);
4939 q->blue=ClampToQuantum(QuantumScale*shade*s1->blue);
cristy3ed852e2009-09-05 21:47:34 +00004940 }
4941 q->opacity=s1->opacity;
4942 s0++;
4943 s1++;
4944 s2++;
4945 q++;
4946 }
4947 if (SyncCacheViewAuthenticPixels(shade_view,exception) == MagickFalse)
4948 status=MagickFalse;
4949 if (image->progress_monitor != (MagickProgressMonitor) NULL)
4950 {
4951 MagickBooleanType
4952 proceed;
4953
cristyb5d5f722009-11-04 03:03:49 +00004954#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00004955 #pragma omp critical (MagickCore_ShadeImage)
4956#endif
4957 proceed=SetImageProgress(image,ShadeImageTag,progress++,image->rows);
4958 if (proceed == MagickFalse)
4959 status=MagickFalse;
4960 }
4961 }
4962 shade_view=DestroyCacheView(shade_view);
4963 image_view=DestroyCacheView(image_view);
4964 if (status == MagickFalse)
4965 shade_image=DestroyImage(shade_image);
4966 return(shade_image);
4967}
4968
4969/*
4970%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4971% %
4972% %
4973% %
4974% S h a r p e n I m a g e %
4975% %
4976% %
4977% %
4978%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4979%
4980% SharpenImage() sharpens the image. We convolve the image with a Gaussian
4981% operator of the given radius and standard deviation (sigma). For
4982% reasonable results, radius should be larger than sigma. Use a radius of 0
4983% and SharpenImage() selects a suitable radius for you.
4984%
4985% Using a separable kernel would be faster, but the negative weights cancel
4986% out on the corners of the kernel producing often undesirable ringing in the
4987% filtered result; this can be avoided by using a 2D gaussian shaped image
4988% sharpening kernel instead.
4989%
4990% The format of the SharpenImage method is:
4991%
4992% Image *SharpenImage(const Image *image,const double radius,
4993% const double sigma,ExceptionInfo *exception)
4994% Image *SharpenImageChannel(const Image *image,const ChannelType channel,
4995% const double radius,const double sigma,ExceptionInfo *exception)
4996%
4997% A description of each parameter follows:
4998%
4999% o image: the image.
5000%
5001% o channel: the channel type.
5002%
5003% o radius: the radius of the Gaussian, in pixels, not counting the center
5004% pixel.
5005%
5006% o sigma: the standard deviation of the Laplacian, in pixels.
5007%
5008% o exception: return any errors or warnings in this structure.
5009%
5010*/
5011
5012MagickExport Image *SharpenImage(const Image *image,const double radius,
5013 const double sigma,ExceptionInfo *exception)
5014{
5015 Image
5016 *sharp_image;
5017
5018 sharp_image=SharpenImageChannel(image,DefaultChannels,radius,sigma,exception);
5019 return(sharp_image);
5020}
5021
5022MagickExport Image *SharpenImageChannel(const Image *image,
5023 const ChannelType channel,const double radius,const double sigma,
5024 ExceptionInfo *exception)
5025{
5026 double
cristy47e00502009-12-17 19:19:57 +00005027 *kernel,
5028 normalize;
cristy3ed852e2009-09-05 21:47:34 +00005029
5030 Image
5031 *sharp_image;
5032
cristybb503372010-05-27 20:51:26 +00005033 register ssize_t
cristy47e00502009-12-17 19:19:57 +00005034 i;
5035
cristybb503372010-05-27 20:51:26 +00005036 size_t
cristy3ed852e2009-09-05 21:47:34 +00005037 width;
5038
cristy117ff172010-08-15 21:35:32 +00005039 ssize_t
5040 j,
5041 u,
5042 v;
5043
cristy3ed852e2009-09-05 21:47:34 +00005044 assert(image != (const Image *) NULL);
5045 assert(image->signature == MagickSignature);
5046 if (image->debug != MagickFalse)
5047 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
5048 assert(exception != (ExceptionInfo *) NULL);
5049 assert(exception->signature == MagickSignature);
5050 width=GetOptimalKernelWidth2D(radius,sigma);
5051 kernel=(double *) AcquireQuantumMemory((size_t) width*width,sizeof(*kernel));
5052 if (kernel == (double *) NULL)
5053 ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
cristy3ed852e2009-09-05 21:47:34 +00005054 normalize=0.0;
cristybb503372010-05-27 20:51:26 +00005055 j=(ssize_t) width/2;
cristy47e00502009-12-17 19:19:57 +00005056 i=0;
5057 for (v=(-j); v <= j; v++)
cristy3ed852e2009-09-05 21:47:34 +00005058 {
cristy47e00502009-12-17 19:19:57 +00005059 for (u=(-j); u <= j; u++)
cristy3ed852e2009-09-05 21:47:34 +00005060 {
cristy4205a3c2010-09-12 20:19:59 +00005061 kernel[i]=(double) (-exp(-((double) u*u+v*v)/(2.0*MagickSigma*
5062 MagickSigma))/(2.0*MagickPI*MagickSigma*MagickSigma));
cristy3ed852e2009-09-05 21:47:34 +00005063 normalize+=kernel[i];
5064 i++;
5065 }
5066 }
5067 kernel[i/2]=(double) ((-2.0)*normalize);
5068 sharp_image=ConvolveImageChannel(image,channel,width,kernel,exception);
5069 kernel=(double *) RelinquishMagickMemory(kernel);
5070 return(sharp_image);
5071}
5072
5073/*
5074%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5075% %
5076% %
5077% %
5078% S p r e a d I m a g e %
5079% %
5080% %
5081% %
5082%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5083%
5084% SpreadImage() is a special effects method that randomly displaces each
5085% pixel in a block defined by the radius parameter.
5086%
5087% The format of the SpreadImage method is:
5088%
5089% Image *SpreadImage(const Image *image,const double radius,
5090% ExceptionInfo *exception)
5091%
5092% A description of each parameter follows:
5093%
5094% o image: the image.
5095%
5096% o radius: Choose a random pixel in a neighborhood of this extent.
5097%
5098% o exception: return any errors or warnings in this structure.
5099%
5100*/
5101MagickExport Image *SpreadImage(const Image *image,const double radius,
5102 ExceptionInfo *exception)
5103{
5104#define SpreadImageTag "Spread/Image"
5105
cristyfa112112010-01-04 17:48:07 +00005106 CacheView
5107 *image_view;
5108
cristy3ed852e2009-09-05 21:47:34 +00005109 Image
5110 *spread_image;
5111
cristy3ed852e2009-09-05 21:47:34 +00005112 MagickBooleanType
5113 status;
5114
cristybb503372010-05-27 20:51:26 +00005115 MagickOffsetType
5116 progress;
5117
cristy3ed852e2009-09-05 21:47:34 +00005118 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +00005119 bias;
cristy3ed852e2009-09-05 21:47:34 +00005120
5121 RandomInfo
cristyfa112112010-01-04 17:48:07 +00005122 **restrict random_info;
cristy3ed852e2009-09-05 21:47:34 +00005123
5124 ResampleFilter
cristyfa112112010-01-04 17:48:07 +00005125 **restrict resample_filter;
cristy3ed852e2009-09-05 21:47:34 +00005126
cristybb503372010-05-27 20:51:26 +00005127 size_t
cristy3ed852e2009-09-05 21:47:34 +00005128 width;
5129
cristybb503372010-05-27 20:51:26 +00005130 ssize_t
5131 y;
5132
cristy3ed852e2009-09-05 21:47:34 +00005133 /*
5134 Initialize spread image attributes.
5135 */
5136 assert(image != (Image *) NULL);
5137 assert(image->signature == MagickSignature);
5138 if (image->debug != MagickFalse)
5139 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
5140 assert(exception != (ExceptionInfo *) NULL);
5141 assert(exception->signature == MagickSignature);
5142 spread_image=CloneImage(image,image->columns,image->rows,MagickTrue,
5143 exception);
5144 if (spread_image == (Image *) NULL)
5145 return((Image *) NULL);
5146 if (SetImageStorageClass(spread_image,DirectClass) == MagickFalse)
5147 {
5148 InheritException(exception,&spread_image->exception);
5149 spread_image=DestroyImage(spread_image);
5150 return((Image *) NULL);
5151 }
5152 /*
5153 Spread image.
5154 */
5155 status=MagickTrue;
5156 progress=0;
cristyddd82202009-11-03 20:14:50 +00005157 GetMagickPixelPacket(spread_image,&bias);
cristy3ed852e2009-09-05 21:47:34 +00005158 width=GetOptimalKernelWidth1D(radius,0.5);
cristyb2a11ae2010-02-22 00:53:36 +00005159 resample_filter=AcquireResampleFilterThreadSet(image,
5160 UndefinedVirtualPixelMethod,MagickTrue,exception);
cristy3ed852e2009-09-05 21:47:34 +00005161 random_info=AcquireRandomInfoThreadSet();
5162 image_view=AcquireCacheView(spread_image);
cristyb557a152011-02-22 12:14:30 +00005163#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy09d81172010-10-21 16:15:05 +00005164 #pragma omp parallel for schedule(dynamic,4) shared(progress,status) omp_throttle(1)
cristy3ed852e2009-09-05 21:47:34 +00005165#endif
cristybb503372010-05-27 20:51:26 +00005166 for (y=0; y < (ssize_t) spread_image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00005167 {
cristy5c9e6f22010-09-17 17:31:01 +00005168 const int
5169 id = GetOpenMPThreadId();
cristy6ebe97c2010-07-03 01:17:28 +00005170
cristy3ed852e2009-09-05 21:47:34 +00005171 MagickPixelPacket
5172 pixel;
5173
5174 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00005175 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00005176
cristy3ed852e2009-09-05 21:47:34 +00005177 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00005178 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00005179
cristy117ff172010-08-15 21:35:32 +00005180 register ssize_t
5181 x;
5182
cristy3ed852e2009-09-05 21:47:34 +00005183 if (status == MagickFalse)
5184 continue;
5185 q=QueueCacheViewAuthenticPixels(image_view,0,y,spread_image->columns,1,
5186 exception);
5187 if (q == (PixelPacket *) NULL)
5188 {
5189 status=MagickFalse;
5190 continue;
5191 }
5192 indexes=GetCacheViewAuthenticIndexQueue(image_view);
cristyddd82202009-11-03 20:14:50 +00005193 pixel=bias;
cristybb503372010-05-27 20:51:26 +00005194 for (x=0; x < (ssize_t) spread_image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00005195 {
5196 (void) ResamplePixelColor(resample_filter[id],(double) x+width*
5197 (GetPseudoRandomValue(random_info[id])-0.5),(double) y+width*
5198 (GetPseudoRandomValue(random_info[id])-0.5),&pixel);
5199 SetPixelPacket(spread_image,&pixel,q,indexes+x);
5200 q++;
5201 }
5202 if (SyncCacheViewAuthenticPixels(image_view,exception) == MagickFalse)
5203 status=MagickFalse;
5204 if (image->progress_monitor != (MagickProgressMonitor) NULL)
5205 {
5206 MagickBooleanType
5207 proceed;
5208
cristyb557a152011-02-22 12:14:30 +00005209#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00005210 #pragma omp critical (MagickCore_SpreadImage)
5211#endif
5212 proceed=SetImageProgress(image,SpreadImageTag,progress++,image->rows);
5213 if (proceed == MagickFalse)
5214 status=MagickFalse;
5215 }
5216 }
5217 image_view=DestroyCacheView(image_view);
5218 random_info=DestroyRandomInfoThreadSet(random_info);
5219 resample_filter=DestroyResampleFilterThreadSet(resample_filter);
5220 return(spread_image);
5221}
5222
5223/*
5224%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5225% %
5226% %
5227% %
5228% U n s h a r p M a s k I m a g e %
5229% %
5230% %
5231% %
5232%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5233%
5234% UnsharpMaskImage() sharpens one or more image channels. We convolve the
5235% image with a Gaussian operator of the given radius and standard deviation
5236% (sigma). For reasonable results, radius should be larger than sigma. Use a
5237% radius of 0 and UnsharpMaskImage() selects a suitable radius for you.
5238%
5239% The format of the UnsharpMaskImage method is:
5240%
5241% Image *UnsharpMaskImage(const Image *image,const double radius,
5242% const double sigma,const double amount,const double threshold,
5243% ExceptionInfo *exception)
5244% Image *UnsharpMaskImageChannel(const Image *image,
5245% const ChannelType channel,const double radius,const double sigma,
5246% const double amount,const double threshold,ExceptionInfo *exception)
5247%
5248% A description of each parameter follows:
5249%
5250% o image: the image.
5251%
5252% o channel: the channel type.
5253%
5254% o radius: the radius of the Gaussian, in pixels, not counting the center
5255% pixel.
5256%
5257% o sigma: the standard deviation of the Gaussian, in pixels.
5258%
5259% o amount: the percentage of the difference between the original and the
5260% blur image that is added back into the original.
5261%
5262% o threshold: the threshold in pixels needed to apply the diffence amount.
5263%
5264% o exception: return any errors or warnings in this structure.
5265%
5266*/
5267
5268MagickExport Image *UnsharpMaskImage(const Image *image,const double radius,
5269 const double sigma,const double amount,const double threshold,
5270 ExceptionInfo *exception)
5271{
5272 Image
5273 *sharp_image;
5274
5275 sharp_image=UnsharpMaskImageChannel(image,DefaultChannels,radius,sigma,amount,
5276 threshold,exception);
5277 return(sharp_image);
5278}
5279
5280MagickExport Image *UnsharpMaskImageChannel(const Image *image,
5281 const ChannelType channel,const double radius,const double sigma,
5282 const double amount,const double threshold,ExceptionInfo *exception)
5283{
5284#define SharpenImageTag "Sharpen/Image"
5285
cristyc4c8d132010-01-07 01:58:38 +00005286 CacheView
5287 *image_view,
5288 *unsharp_view;
5289
cristy3ed852e2009-09-05 21:47:34 +00005290 Image
5291 *unsharp_image;
5292
cristy3ed852e2009-09-05 21:47:34 +00005293 MagickBooleanType
5294 status;
5295
cristybb503372010-05-27 20:51:26 +00005296 MagickOffsetType
5297 progress;
5298
cristy3ed852e2009-09-05 21:47:34 +00005299 MagickPixelPacket
cristyddd82202009-11-03 20:14:50 +00005300 bias;
cristy3ed852e2009-09-05 21:47:34 +00005301
5302 MagickRealType
5303 quantum_threshold;
5304
cristybb503372010-05-27 20:51:26 +00005305 ssize_t
5306 y;
5307
cristy3ed852e2009-09-05 21:47:34 +00005308 assert(image != (const Image *) NULL);
5309 assert(image->signature == MagickSignature);
5310 if (image->debug != MagickFalse)
5311 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
5312 assert(exception != (ExceptionInfo *) NULL);
5313 unsharp_image=BlurImageChannel(image,channel,radius,sigma,exception);
5314 if (unsharp_image == (Image *) NULL)
5315 return((Image *) NULL);
5316 quantum_threshold=(MagickRealType) QuantumRange*threshold;
5317 /*
5318 Unsharp-mask image.
5319 */
5320 status=MagickTrue;
5321 progress=0;
cristyddd82202009-11-03 20:14:50 +00005322 GetMagickPixelPacket(image,&bias);
cristy3ed852e2009-09-05 21:47:34 +00005323 image_view=AcquireCacheView(image);
5324 unsharp_view=AcquireCacheView(unsharp_image);
cristyb5d5f722009-11-04 03:03:49 +00005325#if defined(MAGICKCORE_OPENMP_SUPPORT)
5326 #pragma omp parallel for schedule(dynamic,4) shared(progress,status)
cristy3ed852e2009-09-05 21:47:34 +00005327#endif
cristybb503372010-05-27 20:51:26 +00005328 for (y=0; y < (ssize_t) image->rows; y++)
cristy3ed852e2009-09-05 21:47:34 +00005329 {
5330 MagickPixelPacket
5331 pixel;
5332
5333 register const IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00005334 *restrict indexes;
cristy3ed852e2009-09-05 21:47:34 +00005335
5336 register const PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00005337 *restrict p;
cristy3ed852e2009-09-05 21:47:34 +00005338
5339 register IndexPacket
cristyc47d1f82009-11-26 01:44:43 +00005340 *restrict unsharp_indexes;
cristy3ed852e2009-09-05 21:47:34 +00005341
cristy3ed852e2009-09-05 21:47:34 +00005342 register PixelPacket
cristyc47d1f82009-11-26 01:44:43 +00005343 *restrict q;
cristy3ed852e2009-09-05 21:47:34 +00005344
cristy117ff172010-08-15 21:35:32 +00005345 register ssize_t
5346 x;
5347
cristy3ed852e2009-09-05 21:47:34 +00005348 if (status == MagickFalse)
5349 continue;
5350 p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
5351 q=GetCacheViewAuthenticPixels(unsharp_view,0,y,unsharp_image->columns,1,
5352 exception);
5353 if ((p == (const PixelPacket *) NULL) || (q == (PixelPacket *) NULL))
5354 {
5355 status=MagickFalse;
5356 continue;
5357 }
5358 indexes=GetCacheViewVirtualIndexQueue(image_view);
5359 unsharp_indexes=GetCacheViewAuthenticIndexQueue(unsharp_view);
cristyddd82202009-11-03 20:14:50 +00005360 pixel=bias;
cristybb503372010-05-27 20:51:26 +00005361 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +00005362 {
5363 if ((channel & RedChannel) != 0)
5364 {
5365 pixel.red=p->red-(MagickRealType) q->red;
5366 if (fabs(2.0*pixel.red) < quantum_threshold)
cristyce70c172010-01-07 17:15:30 +00005367 pixel.red=(MagickRealType) GetRedPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +00005368 else
5369 pixel.red=(MagickRealType) p->red+(pixel.red*amount);
cristyce70c172010-01-07 17:15:30 +00005370 SetRedPixelComponent(q,ClampRedPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00005371 }
5372 if ((channel & GreenChannel) != 0)
5373 {
5374 pixel.green=p->green-(MagickRealType) q->green;
5375 if (fabs(2.0*pixel.green) < quantum_threshold)
cristyce70c172010-01-07 17:15:30 +00005376 pixel.green=(MagickRealType) GetGreenPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +00005377 else
5378 pixel.green=(MagickRealType) p->green+(pixel.green*amount);
cristyce70c172010-01-07 17:15:30 +00005379 SetGreenPixelComponent(q,ClampGreenPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00005380 }
5381 if ((channel & BlueChannel) != 0)
5382 {
5383 pixel.blue=p->blue-(MagickRealType) q->blue;
5384 if (fabs(2.0*pixel.blue) < quantum_threshold)
cristyce70c172010-01-07 17:15:30 +00005385 pixel.blue=(MagickRealType) GetBluePixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +00005386 else
5387 pixel.blue=(MagickRealType) p->blue+(pixel.blue*amount);
cristyce70c172010-01-07 17:15:30 +00005388 SetBluePixelComponent(q,ClampBluePixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00005389 }
5390 if ((channel & OpacityChannel) != 0)
5391 {
5392 pixel.opacity=p->opacity-(MagickRealType) q->opacity;
5393 if (fabs(2.0*pixel.opacity) < quantum_threshold)
cristyce70c172010-01-07 17:15:30 +00005394 pixel.opacity=(MagickRealType) GetOpacityPixelComponent(p);
cristy3ed852e2009-09-05 21:47:34 +00005395 else
5396 pixel.opacity=p->opacity+(pixel.opacity*amount);
cristyce70c172010-01-07 17:15:30 +00005397 SetOpacityPixelComponent(q,ClampOpacityPixelComponent(&pixel));
cristy3ed852e2009-09-05 21:47:34 +00005398 }
5399 if (((channel & IndexChannel) != 0) &&
5400 (image->colorspace == CMYKColorspace))
5401 {
5402 pixel.index=unsharp_indexes[x]-(MagickRealType) indexes[x];
5403 if (fabs(2.0*pixel.index) < quantum_threshold)
cristyb557a152011-02-22 12:14:30 +00005404 pixel.index=(MagickRealType) indexes[x];
cristy3ed852e2009-09-05 21:47:34 +00005405 else
cristyb557a152011-02-22 12:14:30 +00005406 pixel.index=(MagickRealType) indexes[x]+(pixel.index*amount);
cristyce70c172010-01-07 17:15:30 +00005407 unsharp_indexes[x]=ClampToQuantum(pixel.index);
cristy3ed852e2009-09-05 21:47:34 +00005408 }
5409 p++;
5410 q++;
5411 }
5412 if (SyncCacheViewAuthenticPixels(unsharp_view,exception) == MagickFalse)
5413 status=MagickFalse;
5414 if (image->progress_monitor != (MagickProgressMonitor) NULL)
5415 {
5416 MagickBooleanType
5417 proceed;
5418
cristyb5d5f722009-11-04 03:03:49 +00005419#if defined(MAGICKCORE_OPENMP_SUPPORT)
cristy3ed852e2009-09-05 21:47:34 +00005420 #pragma omp critical (MagickCore_UnsharpMaskImageChannel)
5421#endif
5422 proceed=SetImageProgress(image,SharpenImageTag,progress++,image->rows);
5423 if (proceed == MagickFalse)
5424 status=MagickFalse;
5425 }
5426 }
5427 unsharp_image->type=image->type;
5428 unsharp_view=DestroyCacheView(unsharp_view);
5429 image_view=DestroyCacheView(image_view);
5430 if (status == MagickFalse)
5431 unsharp_image=DestroyImage(unsharp_image);
5432 return(unsharp_image);
5433}