MagickCore  7.0.10
visual-effects.c
Go to the documentation of this file.
1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % %
4 % %
5 % %
6 % V V IIIII SSSSS U U AAA L %
7 % V V I SS U U A A L %
8 % V V I SSS U U AAAAA L %
9 % V V I SS U U A A L %
10 % V IIIII SSSSS UUU A A LLLLL %
11 % %
12 % EEEEE FFFFF FFFFF EEEEE CCCC TTTTT SSSSS %
13 % E F F E C T SS %
14 % EEE FFF FFF EEE C T SSS %
15 % E F F E C T SS %
16 % EEEEE F F EEEEE CCCC T SSSSS %
17 % %
18 % %
19 % MagickCore Image Special Effects Methods %
20 % %
21 % Software Design %
22 % Cristy %
23 % October 1996 %
24 % %
25 % %
26 % %
27 % Copyright 1999-2020 ImageMagick Studio LLC, a non-profit organization %
28 % dedicated to making software imaging solutions freely available. %
29 % %
30 % You may not use this file except in compliance with the License. You may %
31 % obtain a copy of the License at %
32 % %
33 % https://imagemagick.org/script/license.php %
34 % %
35 % Unless required by applicable law or agreed to in writing, software %
36 % distributed under the License is distributed on an "AS IS" BASIS, %
37 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
38 % See the License for the specific language governing permissions and %
39 % limitations under the License. %
40 % %
41 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 %
43 %
44 %
45 */
46 
47 /*
48  Include declarations.
49 */
50 #include "MagickCore/studio.h"
52 #include "MagickCore/annotate.h"
53 #include "MagickCore/artifact.h"
54 #include "MagickCore/attribute.h"
55 #include "MagickCore/cache.h"
56 #include "MagickCore/cache-view.h"
57 #include "MagickCore/channel.h"
58 #include "MagickCore/color.h"
61 #include "MagickCore/composite.h"
62 #include "MagickCore/decorate.h"
63 #include "MagickCore/distort.h"
64 #include "MagickCore/draw.h"
65 #include "MagickCore/effect.h"
66 #include "MagickCore/enhance.h"
67 #include "MagickCore/exception.h"
69 #include "MagickCore/gem.h"
70 #include "MagickCore/gem-private.h"
71 #include "MagickCore/geometry.h"
72 #include "MagickCore/layer.h"
73 #include "MagickCore/list.h"
74 #include "MagickCore/log.h"
75 #include "MagickCore/image.h"
77 #include "MagickCore/magick.h"
78 #include "MagickCore/memory_.h"
80 #include "MagickCore/monitor.h"
82 #include "MagickCore/option.h"
83 #include "MagickCore/pixel.h"
85 #include "MagickCore/property.h"
86 #include "MagickCore/quantum.h"
88 #include "MagickCore/random_.h"
90 #include "MagickCore/resample.h"
92 #include "MagickCore/resize.h"
93 #include "MagickCore/resource_.h"
94 #include "MagickCore/splay-tree.h"
95 #include "MagickCore/statistic.h"
96 #include "MagickCore/string_.h"
99 #include "MagickCore/threshold.h"
100 #include "MagickCore/transform.h"
102 #include "MagickCore/utility.h"
104 
105 /*
106 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
107 % %
108 % %
109 % %
110 % A d d N o i s e I m a g e %
111 % %
112 % %
113 % %
114 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
115 %
116 % AddNoiseImage() adds random noise to the image.
117 %
118 % The format of the AddNoiseImage method is:
119 %
120 % Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
121 % const double attenuate,ExceptionInfo *exception)
122 %
123 % A description of each parameter follows:
124 %
125 % o image: the image.
126 %
127 % o channel: the channel type.
128 %
129 % o noise_type: The type of noise: Uniform, Gaussian, Multiplicative,
130 % Impulse, Laplacian, or Poisson.
131 %
132 % o attenuate: attenuate the random distribution.
133 %
134 % o exception: return any errors or warnings in this structure.
135 %
136 */
137 MagickExport Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
138  const double attenuate,ExceptionInfo *exception)
139 {
140 #define AddNoiseImageTag "AddNoise/Image"
141 
142  CacheView
143  *image_view,
144  *noise_view;
145 
146  Image
147  *noise_image;
148 
150  status;
151 
153  progress;
154 
155  RandomInfo
157 
158  ssize_t
159  y;
160 
161 #if defined(MAGICKCORE_OPENMP_SUPPORT)
162  unsigned long
163  key;
164 #endif
165 
166  /*
167  Initialize noise image attributes.
168  */
169  assert(image != (const Image *) NULL);
170  assert(image->signature == MagickCoreSignature);
171  if (image->debug != MagickFalse)
172  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
173  assert(exception != (ExceptionInfo *) NULL);
174  assert(exception->signature == MagickCoreSignature);
175 #if defined(MAGICKCORE_OPENCL_SUPPORT)
176  noise_image=AccelerateAddNoiseImage(image,noise_type,attenuate,exception);
177  if (noise_image != (Image *) NULL)
178  return(noise_image);
179 #endif
180  noise_image=CloneImage(image,0,0,MagickTrue,exception);
181  if (noise_image == (Image *) NULL)
182  return((Image *) NULL);
183  if (SetImageStorageClass(noise_image,DirectClass,exception) == MagickFalse)
184  {
185  noise_image=DestroyImage(noise_image);
186  return((Image *) NULL);
187  }
188  /*
189  Add noise in each row.
190  */
191  status=MagickTrue;
192  progress=0;
193  random_info=AcquireRandomInfoThreadSet();
194  image_view=AcquireVirtualCacheView(image,exception);
195  noise_view=AcquireAuthenticCacheView(noise_image,exception);
196 #if defined(MAGICKCORE_OPENMP_SUPPORT)
197  key=GetRandomSecretKey(random_info[0]);
198  #pragma omp parallel for schedule(static) shared(progress,status) \
199  magick_number_threads(image,noise_image,image->rows,key == ~0UL)
200 #endif
201  for (y=0; y < (ssize_t) image->rows; y++)
202  {
203  const int
204  id = GetOpenMPThreadId();
205 
207  sync;
208 
209  register const Quantum
210  *magick_restrict p;
211 
212  register ssize_t
213  x;
214 
215  register Quantum
216  *magick_restrict q;
217 
218  if (status == MagickFalse)
219  continue;
220  p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
221  q=QueueCacheViewAuthenticPixels(noise_view,0,y,noise_image->columns,1,
222  exception);
223  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
224  {
225  status=MagickFalse;
226  continue;
227  }
228  for (x=0; x < (ssize_t) image->columns; x++)
229  {
230  register ssize_t
231  i;
232 
233  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
234  {
235  PixelChannel channel = GetPixelChannelChannel(image,i);
236  PixelTrait traits = GetPixelChannelTraits(image,channel);
237  PixelTrait noise_traits=GetPixelChannelTraits(noise_image,channel);
238  if ((traits == UndefinedPixelTrait) ||
239  (noise_traits == UndefinedPixelTrait))
240  continue;
241  if ((noise_traits & CopyPixelTrait) != 0)
242  {
243  SetPixelChannel(noise_image,channel,p[i],q);
244  continue;
245  }
246  SetPixelChannel(noise_image,channel,ClampToQuantum(
247  GenerateDifferentialNoise(random_info[id],p[i],noise_type,attenuate)),
248  q);
249  }
250  p+=GetPixelChannels(image);
251  q+=GetPixelChannels(noise_image);
252  }
253  sync=SyncCacheViewAuthenticPixels(noise_view,exception);
254  if (sync == MagickFalse)
255  status=MagickFalse;
256  if (image->progress_monitor != (MagickProgressMonitor) NULL)
257  {
259  proceed;
260 
261 #if defined(MAGICKCORE_OPENMP_SUPPORT)
262  #pragma omp atomic
263 #endif
264  progress++;
265  proceed=SetImageProgress(image,AddNoiseImageTag,progress,image->rows);
266  if (proceed == MagickFalse)
267  status=MagickFalse;
268  }
269  }
270  noise_view=DestroyCacheView(noise_view);
271  image_view=DestroyCacheView(image_view);
272  random_info=DestroyRandomInfoThreadSet(random_info);
273  if (status == MagickFalse)
274  noise_image=DestroyImage(noise_image);
275  return(noise_image);
276 }
277 
278 /*
279 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
280 % %
281 % %
282 % %
283 % B l u e S h i f t I m a g e %
284 % %
285 % %
286 % %
287 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
288 %
289 % BlueShiftImage() mutes the colors of the image to simulate a scene at
290 % nighttime in the moonlight.
291 %
292 % The format of the BlueShiftImage method is:
293 %
294 % Image *BlueShiftImage(const Image *image,const double factor,
295 % ExceptionInfo *exception)
296 %
297 % A description of each parameter follows:
298 %
299 % o image: the image.
300 %
301 % o factor: the shift factor.
302 %
303 % o exception: return any errors or warnings in this structure.
304 %
305 */
306 MagickExport Image *BlueShiftImage(const Image *image,const double factor,
307  ExceptionInfo *exception)
308 {
309 #define BlueShiftImageTag "BlueShift/Image"
310 
311  CacheView
312  *image_view,
313  *shift_view;
314 
315  Image
316  *shift_image;
317 
319  status;
320 
322  progress;
323 
324  ssize_t
325  y;
326 
327  /*
328  Allocate blue shift image.
329  */
330  assert(image != (const Image *) NULL);
331  assert(image->signature == MagickCoreSignature);
332  if (image->debug != MagickFalse)
333  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
334  assert(exception != (ExceptionInfo *) NULL);
335  assert(exception->signature == MagickCoreSignature);
336  shift_image=CloneImage(image,0,0,MagickTrue,exception);
337  if (shift_image == (Image *) NULL)
338  return((Image *) NULL);
339  if (SetImageStorageClass(shift_image,DirectClass,exception) == MagickFalse)
340  {
341  shift_image=DestroyImage(shift_image);
342  return((Image *) NULL);
343  }
344  /*
345  Blue-shift DirectClass image.
346  */
347  status=MagickTrue;
348  progress=0;
349  image_view=AcquireVirtualCacheView(image,exception);
350  shift_view=AcquireAuthenticCacheView(shift_image,exception);
351 #if defined(MAGICKCORE_OPENMP_SUPPORT)
352  #pragma omp parallel for schedule(static) shared(progress,status) \
353  magick_number_threads(image,shift_image,image->rows,1)
354 #endif
355  for (y=0; y < (ssize_t) image->rows; y++)
356  {
358  sync;
359 
360  PixelInfo
361  pixel;
362 
363  Quantum
364  quantum;
365 
366  register const Quantum
367  *magick_restrict p;
368 
369  register ssize_t
370  x;
371 
372  register Quantum
373  *magick_restrict q;
374 
375  if (status == MagickFalse)
376  continue;
377  p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
378  q=QueueCacheViewAuthenticPixels(shift_view,0,y,shift_image->columns,1,
379  exception);
380  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
381  {
382  status=MagickFalse;
383  continue;
384  }
385  for (x=0; x < (ssize_t) image->columns; x++)
386  {
387  quantum=GetPixelRed(image,p);
388  if (GetPixelGreen(image,p) < quantum)
389  quantum=GetPixelGreen(image,p);
390  if (GetPixelBlue(image,p) < quantum)
391  quantum=GetPixelBlue(image,p);
392  pixel.red=0.5*(GetPixelRed(image,p)+factor*quantum);
393  pixel.green=0.5*(GetPixelGreen(image,p)+factor*quantum);
394  pixel.blue=0.5*(GetPixelBlue(image,p)+factor*quantum);
395  quantum=GetPixelRed(image,p);
396  if (GetPixelGreen(image,p) > quantum)
397  quantum=GetPixelGreen(image,p);
398  if (GetPixelBlue(image,p) > quantum)
399  quantum=GetPixelBlue(image,p);
400  pixel.red=0.5*(pixel.red+factor*quantum);
401  pixel.green=0.5*(pixel.green+factor*quantum);
402  pixel.blue=0.5*(pixel.blue+factor*quantum);
403  SetPixelRed(shift_image,ClampToQuantum(pixel.red),q);
404  SetPixelGreen(shift_image,ClampToQuantum(pixel.green),q);
405  SetPixelBlue(shift_image,ClampToQuantum(pixel.blue),q);
406  p+=GetPixelChannels(image);
407  q+=GetPixelChannels(shift_image);
408  }
409  sync=SyncCacheViewAuthenticPixels(shift_view,exception);
410  if (sync == MagickFalse)
411  status=MagickFalse;
412  if (image->progress_monitor != (MagickProgressMonitor) NULL)
413  {
415  proceed;
416 
417 #if defined(MAGICKCORE_OPENMP_SUPPORT)
418  #pragma omp atomic
419 #endif
420  progress++;
421  proceed=SetImageProgress(image,BlueShiftImageTag,progress,image->rows);
422  if (proceed == MagickFalse)
423  status=MagickFalse;
424  }
425  }
426  image_view=DestroyCacheView(image_view);
427  shift_view=DestroyCacheView(shift_view);
428  if (status == MagickFalse)
429  shift_image=DestroyImage(shift_image);
430  return(shift_image);
431 }
432 
433 /*
434 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
435 % %
436 % %
437 % %
438 % C h a r c o a l I m a g e %
439 % %
440 % %
441 % %
442 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
443 %
444 % CharcoalImage() creates a new image that is a copy of an existing one with
445 % the edge highlighted. It allocates the memory necessary for the new Image
446 % structure and returns a pointer to the new image.
447 %
448 % The format of the CharcoalImage method is:
449 %
450 % Image *CharcoalImage(const Image *image,const double radius,
451 % const double sigma,ExceptionInfo *exception)
452 %
453 % A description of each parameter follows:
454 %
455 % o image: the image.
456 %
457 % o radius: the radius of the pixel neighborhood.
458 %
459 % o sigma: the standard deviation of the Gaussian, in pixels.
460 %
461 % o exception: return any errors or warnings in this structure.
462 %
463 */
464 MagickExport Image *CharcoalImage(const Image *image,const double radius,
465  const double sigma,ExceptionInfo *exception)
466 {
467  Image
468  *charcoal_image,
469  *edge_image;
470 
472  status;
473 
474  assert(image != (Image *) NULL);
475  assert(image->signature == MagickCoreSignature);
476  if (image->debug != MagickFalse)
477  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
478  assert(exception != (ExceptionInfo *) NULL);
479  assert(exception->signature == MagickCoreSignature);
480  edge_image=EdgeImage(image,radius,exception);
481  if (edge_image == (Image *) NULL)
482  return((Image *) NULL);
483  edge_image->alpha_trait=UndefinedPixelTrait;
484  charcoal_image=(Image *) NULL;
485  status=ClampImage(edge_image,exception);
486  if (status != MagickFalse)
487  charcoal_image=BlurImage(edge_image,radius,sigma,exception);
488  edge_image=DestroyImage(edge_image);
489  if (charcoal_image == (Image *) NULL)
490  return((Image *) NULL);
491  status=NormalizeImage(charcoal_image,exception);
492  if (status != MagickFalse)
493  status=NegateImage(charcoal_image,MagickFalse,exception);
494  if (status != MagickFalse)
495  status=GrayscaleImage(charcoal_image,image->intensity,exception);
496  if (status == MagickFalse)
497  charcoal_image=DestroyImage(charcoal_image);
498  return(charcoal_image);
499 }
500 
501 /*
502 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
503 % %
504 % %
505 % %
506 % C o l o r i z e I m a g e %
507 % %
508 % %
509 % %
510 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
511 %
512 % ColorizeImage() blends the fill color with each pixel in the image.
513 % A percentage blend is specified with opacity. Control the application
514 % of different color components by specifying a different percentage for
515 % each component (e.g. 90/100/10 is 90% red, 100% green, and 10% blue).
516 %
517 % The format of the ColorizeImage method is:
518 %
519 % Image *ColorizeImage(const Image *image,const char *blend,
520 % const PixelInfo *colorize,ExceptionInfo *exception)
521 %
522 % A description of each parameter follows:
523 %
524 % o image: the image.
525 %
526 % o blend: A character string indicating the level of blending as a
527 % percentage.
528 %
529 % o colorize: A color value.
530 %
531 % o exception: return any errors or warnings in this structure.
532 %
533 */
534 MagickExport Image *ColorizeImage(const Image *image,const char *blend,
535  const PixelInfo *colorize,ExceptionInfo *exception)
536 {
537 #define ColorizeImageTag "Colorize/Image"
538 #define Colorize(pixel,blend_percentage,colorize) \
539  (((pixel)*(100.0-(blend_percentage))+(colorize)*(blend_percentage))/100.0)
540 
541  CacheView
542  *image_view;
543 
545  geometry_info;
546 
547  Image
548  *colorize_image;
549 
551  status;
552 
554  progress;
555 
557  flags;
558 
559  PixelInfo
560  blend_percentage;
561 
562  ssize_t
563  y;
564 
565  /*
566  Allocate colorized image.
567  */
568  assert(image != (const Image *) NULL);
569  assert(image->signature == MagickCoreSignature);
570  if (image->debug != MagickFalse)
571  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
572  assert(exception != (ExceptionInfo *) NULL);
573  assert(exception->signature == MagickCoreSignature);
574  colorize_image=CloneImage(image,0,0,MagickTrue,exception);
575  if (colorize_image == (Image *) NULL)
576  return((Image *) NULL);
577  if (SetImageStorageClass(colorize_image,DirectClass,exception) == MagickFalse)
578  {
579  colorize_image=DestroyImage(colorize_image);
580  return((Image *) NULL);
581  }
582  if ((IsGrayColorspace(colorize_image->colorspace) != MagickFalse) ||
583  (IsPixelInfoGray(colorize) != MagickFalse))
584  (void) SetImageColorspace(colorize_image,sRGBColorspace,exception);
585  if ((colorize_image->alpha_trait == UndefinedPixelTrait) &&
586  (colorize->alpha_trait != UndefinedPixelTrait))
587  (void) SetImageAlpha(colorize_image,OpaqueAlpha,exception);
588  if (blend == (const char *) NULL)
589  return(colorize_image);
590  GetPixelInfo(colorize_image,&blend_percentage);
591  flags=ParseGeometry(blend,&geometry_info);
592  blend_percentage.red=geometry_info.rho;
593  blend_percentage.green=geometry_info.rho;
594  blend_percentage.blue=geometry_info.rho;
595  blend_percentage.black=geometry_info.rho;
596  blend_percentage.alpha=(MagickRealType) TransparentAlpha;
597  if ((flags & SigmaValue) != 0)
598  blend_percentage.green=geometry_info.sigma;
599  if ((flags & XiValue) != 0)
600  blend_percentage.blue=geometry_info.xi;
601  if ((flags & PsiValue) != 0)
602  blend_percentage.alpha=geometry_info.psi;
603  if (blend_percentage.colorspace == CMYKColorspace)
604  {
605  if ((flags & PsiValue) != 0)
606  blend_percentage.black=geometry_info.psi;
607  if ((flags & ChiValue) != 0)
608  blend_percentage.alpha=geometry_info.chi;
609  }
610  /*
611  Colorize DirectClass image.
612  */
613  status=MagickTrue;
614  progress=0;
615  image_view=AcquireVirtualCacheView(colorize_image,exception);
616 #if defined(MAGICKCORE_OPENMP_SUPPORT)
617  #pragma omp parallel for schedule(static) shared(progress,status) \
618  magick_number_threads(colorize_image,colorize_image,colorize_image->rows,1)
619 #endif
620  for (y=0; y < (ssize_t) colorize_image->rows; y++)
621  {
623  sync;
624 
625  register Quantum
626  *magick_restrict q;
627 
628  register ssize_t
629  x;
630 
631  if (status == MagickFalse)
632  continue;
633  q=GetCacheViewAuthenticPixels(image_view,0,y,colorize_image->columns,1,
634  exception);
635  if (q == (Quantum *) NULL)
636  {
637  status=MagickFalse;
638  continue;
639  }
640  for (x=0; x < (ssize_t) colorize_image->columns; x++)
641  {
642  register ssize_t
643  i;
644 
645  for (i=0; i < (ssize_t) GetPixelChannels(colorize_image); i++)
646  {
647  PixelTrait traits = GetPixelChannelTraits(colorize_image,
648  (PixelChannel) i);
649  if (traits == UndefinedPixelTrait)
650  continue;
651  if ((traits & CopyPixelTrait) != 0)
652  continue;
653  SetPixelChannel(colorize_image,(PixelChannel) i,ClampToQuantum(
654  Colorize(q[i],GetPixelInfoChannel(&blend_percentage,(PixelChannel) i),
655  GetPixelInfoChannel(colorize,(PixelChannel) i))),q);
656  }
657  q+=GetPixelChannels(colorize_image);
658  }
659  sync=SyncCacheViewAuthenticPixels(image_view,exception);
660  if (sync == MagickFalse)
661  status=MagickFalse;
662  if (image->progress_monitor != (MagickProgressMonitor) NULL)
663  {
665  proceed;
666 
667 #if defined(MAGICKCORE_OPENMP_SUPPORT)
668  #pragma omp atomic
669 #endif
670  progress++;
671  proceed=SetImageProgress(image,ColorizeImageTag,progress,
672  colorize_image->rows);
673  if (proceed == MagickFalse)
674  status=MagickFalse;
675  }
676  }
677  image_view=DestroyCacheView(image_view);
678  if (status == MagickFalse)
679  colorize_image=DestroyImage(colorize_image);
680  return(colorize_image);
681 }
682 
683 /*
684 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
685 % %
686 % %
687 % %
688 % C o l o r M a t r i x I m a g e %
689 % %
690 % %
691 % %
692 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
693 %
694 % ColorMatrixImage() applies color transformation to an image. This method
695 % permits saturation changes, hue rotation, luminance to alpha, and various
696 % other effects. Although variable-sized transformation matrices can be used,
697 % typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA
698 % (or RGBA with offsets). The matrix is similar to those used by Adobe Flash
699 % except offsets are in column 6 rather than 5 (in support of CMYKA images)
700 % and offsets are normalized (divide Flash offset by 255).
701 %
702 % The format of the ColorMatrixImage method is:
703 %
704 % Image *ColorMatrixImage(const Image *image,
705 % const KernelInfo *color_matrix,ExceptionInfo *exception)
706 %
707 % A description of each parameter follows:
708 %
709 % o image: the image.
710 %
711 % o color_matrix: the color matrix.
712 %
713 % o exception: return any errors or warnings in this structure.
714 %
715 */
716 /* FUTURE: modify to make use of a MagickMatrix Mutliply function
717  That should be provided in "matrix.c"
718  (ASIDE: actually distorts should do this too but currently doesn't)
719 */
720 
722  const KernelInfo *color_matrix,ExceptionInfo *exception)
723 {
724 #define ColorMatrixImageTag "ColorMatrix/Image"
725 
726  CacheView
727  *color_view,
728  *image_view;
729 
730  double
731  ColorMatrix[6][6] =
732  {
733  { 1.0, 0.0, 0.0, 0.0, 0.0, 0.0 },
734  { 0.0, 1.0, 0.0, 0.0, 0.0, 0.0 },
735  { 0.0, 0.0, 1.0, 0.0, 0.0, 0.0 },
736  { 0.0, 0.0, 0.0, 1.0, 0.0, 0.0 },
737  { 0.0, 0.0, 0.0, 0.0, 1.0, 0.0 },
738  { 0.0, 0.0, 0.0, 0.0, 0.0, 1.0 }
739  };
740 
741  Image
742  *color_image;
743 
745  status;
746 
748  progress;
749 
750  register ssize_t
751  i;
752 
753  ssize_t
754  u,
755  v,
756  y;
757 
758  /*
759  Map given color_matrix, into a 6x6 matrix RGBKA and a constant
760  */
761  assert(image != (Image *) NULL);
762  assert(image->signature == MagickCoreSignature);
763  if (image->debug != MagickFalse)
764  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
765  assert(exception != (ExceptionInfo *) NULL);
766  assert(exception->signature == MagickCoreSignature);
767  i=0;
768  for (v=0; v < (ssize_t) color_matrix->height; v++)
769  for (u=0; u < (ssize_t) color_matrix->width; u++)
770  {
771  if ((v < 6) && (u < 6))
772  ColorMatrix[v][u]=color_matrix->values[i];
773  i++;
774  }
775  /*
776  Initialize color image.
777  */
778  color_image=CloneImage(image,0,0,MagickTrue,exception);
779  if (color_image == (Image *) NULL)
780  return((Image *) NULL);
781  if (SetImageStorageClass(color_image,DirectClass,exception) == MagickFalse)
782  {
783  color_image=DestroyImage(color_image);
784  return((Image *) NULL);
785  }
786  if (image->debug != MagickFalse)
787  {
788  char
789  format[MagickPathExtent],
790  *message;
791 
793  " ColorMatrix image with color matrix:");
794  message=AcquireString("");
795  for (v=0; v < 6; v++)
796  {
797  *message='\0';
798  (void) FormatLocaleString(format,MagickPathExtent,"%.20g: ",(double) v);
799  (void) ConcatenateString(&message,format);
800  for (u=0; u < 6; u++)
801  {
802  (void) FormatLocaleString(format,MagickPathExtent,"%+f ",
803  ColorMatrix[v][u]);
804  (void) ConcatenateString(&message,format);
805  }
806  (void) LogMagickEvent(TransformEvent,GetMagickModule(),"%s",message);
807  }
808  message=DestroyString(message);
809  }
810  /*
811  Apply the ColorMatrix to image.
812  */
813  status=MagickTrue;
814  progress=0;
815  image_view=AcquireVirtualCacheView(image,exception);
816  color_view=AcquireAuthenticCacheView(color_image,exception);
817 #if defined(MAGICKCORE_OPENMP_SUPPORT)
818  #pragma omp parallel for schedule(static) shared(progress,status) \
819  magick_number_threads(image,color_image,image->rows,1)
820 #endif
821  for (y=0; y < (ssize_t) image->rows; y++)
822  {
823  PixelInfo
824  pixel;
825 
826  register const Quantum
827  *magick_restrict p;
828 
829  register Quantum
830  *magick_restrict q;
831 
832  register ssize_t
833  x;
834 
835  if (status == MagickFalse)
836  continue;
837  p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
838  q=GetCacheViewAuthenticPixels(color_view,0,y,color_image->columns,1,
839  exception);
840  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
841  {
842  status=MagickFalse;
843  continue;
844  }
845  GetPixelInfo(image,&pixel);
846  for (x=0; x < (ssize_t) image->columns; x++)
847  {
848  register ssize_t
849  v;
850 
851  size_t
852  height;
853 
854  GetPixelInfoPixel(image,p,&pixel);
855  height=color_matrix->height > 6 ? 6UL : color_matrix->height;
856  for (v=0; v < (ssize_t) height; v++)
857  {
858  double
859  sum;
860 
861  sum=ColorMatrix[v][0]*GetPixelRed(image,p)+ColorMatrix[v][1]*
862  GetPixelGreen(image,p)+ColorMatrix[v][2]*GetPixelBlue(image,p);
863  if (image->colorspace == CMYKColorspace)
864  sum+=ColorMatrix[v][3]*GetPixelBlack(image,p);
865  if (image->alpha_trait != UndefinedPixelTrait)
866  sum+=ColorMatrix[v][4]*GetPixelAlpha(image,p);
867  sum+=QuantumRange*ColorMatrix[v][5];
868  switch (v)
869  {
870  case 0: pixel.red=sum; break;
871  case 1: pixel.green=sum; break;
872  case 2: pixel.blue=sum; break;
873  case 3: pixel.black=sum; break;
874  case 4: pixel.alpha=sum; break;
875  default: break;
876  }
877  }
878  SetPixelViaPixelInfo(color_image,&pixel,q);
879  p+=GetPixelChannels(image);
880  q+=GetPixelChannels(color_image);
881  }
882  if (SyncCacheViewAuthenticPixels(color_view,exception) == MagickFalse)
883  status=MagickFalse;
884  if (image->progress_monitor != (MagickProgressMonitor) NULL)
885  {
887  proceed;
888 
889 #if defined(MAGICKCORE_OPENMP_SUPPORT)
890  #pragma omp atomic
891 #endif
892  progress++;
893  proceed=SetImageProgress(image,ColorMatrixImageTag,progress,
894  image->rows);
895  if (proceed == MagickFalse)
896  status=MagickFalse;
897  }
898  }
899  color_view=DestroyCacheView(color_view);
900  image_view=DestroyCacheView(image_view);
901  if (status == MagickFalse)
902  color_image=DestroyImage(color_image);
903  return(color_image);
904 }
905 
906 /*
907 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
908 % %
909 % %
910 % %
911 % I m p l o d e I m a g e %
912 % %
913 % %
914 % %
915 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
916 %
917 % ImplodeImage() creates a new image that is a copy of an existing
918 % one with the image pixels "implode" by the specified percentage. It
919 % allocates the memory necessary for the new Image structure and returns a
920 % pointer to the new image.
921 %
922 % The format of the ImplodeImage method is:
923 %
924 % Image *ImplodeImage(const Image *image,const double amount,
925 % const PixelInterpolateMethod method,ExceptionInfo *exception)
926 %
927 % A description of each parameter follows:
928 %
929 % o implode_image: Method ImplodeImage returns a pointer to the image
930 % after it is implode. A null image is returned if there is a memory
931 % shortage.
932 %
933 % o image: the image.
934 %
935 % o amount: Define the extent of the implosion.
936 %
937 % o method: the pixel interpolation method.
938 %
939 % o exception: return any errors or warnings in this structure.
940 %
941 */
942 MagickExport Image *ImplodeImage(const Image *image,const double amount,
943  const PixelInterpolateMethod method,ExceptionInfo *exception)
944 {
945 #define ImplodeImageTag "Implode/Image"
946 
947  CacheView
948  *canvas_view,
949  *implode_view,
950  *interpolate_view;
951 
952  double
953  radius;
954 
955  Image
956  *canvas_image,
957  *implode_image;
958 
960  status;
961 
963  progress;
964 
965  PointInfo
966  center,
967  scale;
968 
969  ssize_t
970  y;
971 
972  /*
973  Initialize implode image attributes.
974  */
975  assert(image != (Image *) NULL);
976  assert(image->signature == MagickCoreSignature);
977  if (image->debug != MagickFalse)
978  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
979  assert(exception != (ExceptionInfo *) NULL);
980  assert(exception->signature == MagickCoreSignature);
981  canvas_image=CloneImage(image,0,0,MagickTrue,exception);
982  if (canvas_image == (Image *) NULL)
983  return((Image *) NULL);
984  if ((canvas_image->alpha_trait == UndefinedPixelTrait) &&
985  (canvas_image->background_color.alpha != OpaqueAlpha))
986  (void) SetImageAlphaChannel(canvas_image,OpaqueAlphaChannel,exception);
987  implode_image=CloneImage(canvas_image,0,0,MagickTrue,exception);
988  if (implode_image == (Image *) NULL)
989  {
990  canvas_image=DestroyImage(canvas_image);
991  return((Image *) NULL);
992  }
993  if (SetImageStorageClass(implode_image,DirectClass,exception) == MagickFalse)
994  {
995  canvas_image=DestroyImage(canvas_image);
996  implode_image=DestroyImage(implode_image);
997  return((Image *) NULL);
998  }
999  /*
1000  Compute scaling factor.
1001  */
1002  scale.x=1.0;
1003  scale.y=1.0;
1004  center.x=0.5*canvas_image->columns;
1005  center.y=0.5*canvas_image->rows;
1006  radius=center.x;
1007  if (canvas_image->columns > canvas_image->rows)
1008  scale.y=(double) canvas_image->columns/(double) canvas_image->rows;
1009  else
1010  if (canvas_image->columns < canvas_image->rows)
1011  {
1012  scale.x=(double) canvas_image->rows/(double) canvas_image->columns;
1013  radius=center.y;
1014  }
1015  /*
1016  Implode image.
1017  */
1018  status=MagickTrue;
1019  progress=0;
1020  canvas_view=AcquireVirtualCacheView(canvas_image,exception);
1021  interpolate_view=AcquireVirtualCacheView(canvas_image,exception);
1022  implode_view=AcquireAuthenticCacheView(implode_image,exception);
1023 #if defined(MAGICKCORE_OPENMP_SUPPORT)
1024  #pragma omp parallel for schedule(static) shared(progress,status) \
1025  magick_number_threads(canvas_image,implode_image,canvas_image->rows,1)
1026 #endif
1027  for (y=0; y < (ssize_t) canvas_image->rows; y++)
1028  {
1029  double
1030  distance;
1031 
1032  PointInfo
1033  delta;
1034 
1035  register const Quantum
1036  *magick_restrict p;
1037 
1038  register ssize_t
1039  x;
1040 
1041  register Quantum
1042  *magick_restrict q;
1043 
1044  if (status == MagickFalse)
1045  continue;
1046  p=GetCacheViewVirtualPixels(canvas_view,0,y,canvas_image->columns,1,
1047  exception);
1048  q=QueueCacheViewAuthenticPixels(implode_view,0,y,implode_image->columns,1,
1049  exception);
1050  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
1051  {
1052  status=MagickFalse;
1053  continue;
1054  }
1055  delta.y=scale.y*(double) (y-center.y);
1056  for (x=0; x < (ssize_t) canvas_image->columns; x++)
1057  {
1058  register ssize_t
1059  i;
1060 
1061  /*
1062  Determine if the pixel is within an ellipse.
1063  */
1064  delta.x=scale.x*(double) (x-center.x);
1065  distance=delta.x*delta.x+delta.y*delta.y;
1066  if (distance >= (radius*radius))
1067  for (i=0; i < (ssize_t) GetPixelChannels(canvas_image); i++)
1068  {
1069  PixelChannel channel = GetPixelChannelChannel(canvas_image,i);
1070  PixelTrait traits = GetPixelChannelTraits(canvas_image,channel);
1071  PixelTrait implode_traits = GetPixelChannelTraits(implode_image,
1072  channel);
1073  if ((traits == UndefinedPixelTrait) ||
1074  (implode_traits == UndefinedPixelTrait))
1075  continue;
1076  SetPixelChannel(implode_image,channel,p[i],q);
1077  }
1078  else
1079  {
1080  double
1081  factor;
1082 
1083  /*
1084  Implode the pixel.
1085  */
1086  factor=1.0;
1087  if (distance > 0.0)
1088  factor=pow(sin(MagickPI*sqrt((double) distance)/radius/2),-amount);
1089  status=InterpolatePixelChannels(canvas_image,interpolate_view,
1090  implode_image,method,(double) (factor*delta.x/scale.x+center.x),
1091  (double) (factor*delta.y/scale.y+center.y),q,exception);
1092  if (status == MagickFalse)
1093  break;
1094  }
1095  p+=GetPixelChannels(canvas_image);
1096  q+=GetPixelChannels(implode_image);
1097  }
1098  if (SyncCacheViewAuthenticPixels(implode_view,exception) == MagickFalse)
1099  status=MagickFalse;
1100  if (canvas_image->progress_monitor != (MagickProgressMonitor) NULL)
1101  {
1103  proceed;
1104 
1105 #if defined(MAGICKCORE_OPENMP_SUPPORT)
1106  #pragma omp atomic
1107 #endif
1108  progress++;
1109  proceed=SetImageProgress(canvas_image,ImplodeImageTag,progress,
1110  canvas_image->rows);
1111  if (proceed == MagickFalse)
1112  status=MagickFalse;
1113  }
1114  }
1115  implode_view=DestroyCacheView(implode_view);
1116  interpolate_view=DestroyCacheView(interpolate_view);
1117  canvas_view=DestroyCacheView(canvas_view);
1118  canvas_image=DestroyImage(canvas_image);
1119  if (status == MagickFalse)
1120  implode_image=DestroyImage(implode_image);
1121  return(implode_image);
1122 }
1123 
1124 /*
1125 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1126 % %
1127 % %
1128 % %
1129 % M o r p h I m a g e s %
1130 % %
1131 % %
1132 % %
1133 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1134 %
1135 % The MorphImages() method requires a minimum of two images. The first
1136 % image is transformed into the second by a number of intervening images
1137 % as specified by frames.
1138 %
1139 % The format of the MorphImage method is:
1140 %
1141 % Image *MorphImages(const Image *image,const size_t number_frames,
1142 % ExceptionInfo *exception)
1143 %
1144 % A description of each parameter follows:
1145 %
1146 % o image: the image.
1147 %
1148 % o number_frames: Define the number of in-between image to generate.
1149 % The more in-between frames, the smoother the morph.
1150 %
1151 % o exception: return any errors or warnings in this structure.
1152 %
1153 */
1154 MagickExport Image *MorphImages(const Image *image,const size_t number_frames,
1155  ExceptionInfo *exception)
1156 {
1157 #define MorphImageTag "Morph/Image"
1158 
1159  double
1160  alpha,
1161  beta;
1162 
1163  Image
1164  *morph_image,
1165  *morph_images;
1166 
1168  status;
1169 
1171  scene;
1172 
1173  register const Image
1174  *next;
1175 
1176  register ssize_t
1177  n;
1178 
1179  ssize_t
1180  y;
1181 
1182  /*
1183  Clone first frame in sequence.
1184  */
1185  assert(image != (Image *) NULL);
1186  assert(image->signature == MagickCoreSignature);
1187  if (image->debug != MagickFalse)
1188  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1189  assert(exception != (ExceptionInfo *) NULL);
1190  assert(exception->signature == MagickCoreSignature);
1191  morph_images=CloneImage(image,0,0,MagickTrue,exception);
1192  if (morph_images == (Image *) NULL)
1193  return((Image *) NULL);
1194  if (GetNextImageInList(image) == (Image *) NULL)
1195  {
1196  /*
1197  Morph single image.
1198  */
1199  for (n=1; n < (ssize_t) number_frames; n++)
1200  {
1201  morph_image=CloneImage(image,0,0,MagickTrue,exception);
1202  if (morph_image == (Image *) NULL)
1203  {
1204  morph_images=DestroyImageList(morph_images);
1205  return((Image *) NULL);
1206  }
1207  AppendImageToList(&morph_images,morph_image);
1208  if (image->progress_monitor != (MagickProgressMonitor) NULL)
1209  {
1211  proceed;
1212 
1214  number_frames);
1215  if (proceed == MagickFalse)
1216  status=MagickFalse;
1217  }
1218  }
1219  return(GetFirstImageInList(morph_images));
1220  }
1221  /*
1222  Morph image sequence.
1223  */
1224  status=MagickTrue;
1225  scene=0;
1226  next=image;
1227  for ( ; GetNextImageInList(next) != (Image *) NULL; next=GetNextImageInList(next))
1228  {
1229  for (n=0; n < (ssize_t) number_frames; n++)
1230  {
1231  CacheView
1232  *image_view,
1233  *morph_view;
1234 
1235  beta=(double) (n+1.0)/(double) (number_frames+1.0);
1236  alpha=1.0-beta;
1237  morph_image=ResizeImage(next,(size_t) (alpha*next->columns+beta*
1238  GetNextImageInList(next)->columns+0.5),(size_t) (alpha*next->rows+beta*
1239  GetNextImageInList(next)->rows+0.5),next->filter,exception);
1240  if (morph_image == (Image *) NULL)
1241  {
1242  morph_images=DestroyImageList(morph_images);
1243  return((Image *) NULL);
1244  }
1245  status=SetImageStorageClass(morph_image,DirectClass,exception);
1246  if (status == MagickFalse)
1247  {
1248  morph_image=DestroyImage(morph_image);
1249  return((Image *) NULL);
1250  }
1251  AppendImageToList(&morph_images,morph_image);
1252  morph_images=GetLastImageInList(morph_images);
1253  morph_image=ResizeImage(GetNextImageInList(next),morph_images->columns,
1254  morph_images->rows,GetNextImageInList(next)->filter,exception);
1255  if (morph_image == (Image *) NULL)
1256  {
1257  morph_images=DestroyImageList(morph_images);
1258  return((Image *) NULL);
1259  }
1260  image_view=AcquireVirtualCacheView(morph_image,exception);
1261  morph_view=AcquireAuthenticCacheView(morph_images,exception);
1262 #if defined(MAGICKCORE_OPENMP_SUPPORT)
1263  #pragma omp parallel for schedule(static) shared(status) \
1264  magick_number_threads(morph_image,morph_image,morph_image->rows,1)
1265 #endif
1266  for (y=0; y < (ssize_t) morph_images->rows; y++)
1267  {
1269  sync;
1270 
1271  register const Quantum
1272  *magick_restrict p;
1273 
1274  register ssize_t
1275  x;
1276 
1277  register Quantum
1278  *magick_restrict q;
1279 
1280  if (status == MagickFalse)
1281  continue;
1282  p=GetCacheViewVirtualPixels(image_view,0,y,morph_image->columns,1,
1283  exception);
1284  q=GetCacheViewAuthenticPixels(morph_view,0,y,morph_images->columns,1,
1285  exception);
1286  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
1287  {
1288  status=MagickFalse;
1289  continue;
1290  }
1291  for (x=0; x < (ssize_t) morph_images->columns; x++)
1292  {
1293  register ssize_t
1294  i;
1295 
1296  for (i=0; i < (ssize_t) GetPixelChannels(morph_image); i++)
1297  {
1298  PixelChannel channel = GetPixelChannelChannel(morph_image,i);
1299  PixelTrait traits = GetPixelChannelTraits(morph_image,channel);
1300  PixelTrait morph_traits=GetPixelChannelTraits(morph_images,channel);
1301  if ((traits == UndefinedPixelTrait) ||
1302  (morph_traits == UndefinedPixelTrait))
1303  continue;
1304  if ((morph_traits & CopyPixelTrait) != 0)
1305  {
1306  SetPixelChannel(morph_image,channel,p[i],q);
1307  continue;
1308  }
1309  SetPixelChannel(morph_image,channel,ClampToQuantum(alpha*
1310  GetPixelChannel(morph_images,channel,q)+beta*p[i]),q);
1311  }
1312  p+=GetPixelChannels(morph_image);
1313  q+=GetPixelChannels(morph_images);
1314  }
1315  sync=SyncCacheViewAuthenticPixels(morph_view,exception);
1316  if (sync == MagickFalse)
1317  status=MagickFalse;
1318  }
1319  morph_view=DestroyCacheView(morph_view);
1320  image_view=DestroyCacheView(image_view);
1321  morph_image=DestroyImage(morph_image);
1322  }
1323  if (n < (ssize_t) number_frames)
1324  break;
1325  /*
1326  Clone last frame in sequence.
1327  */
1328  morph_image=CloneImage(GetNextImageInList(next),0,0,MagickTrue,exception);
1329  if (morph_image == (Image *) NULL)
1330  {
1331  morph_images=DestroyImageList(morph_images);
1332  return((Image *) NULL);
1333  }
1334  AppendImageToList(&morph_images,morph_image);
1335  morph_images=GetLastImageInList(morph_images);
1336  if (image->progress_monitor != (MagickProgressMonitor) NULL)
1337  {
1339  proceed;
1340 
1341  proceed=SetImageProgress(image,MorphImageTag,scene,
1342  GetImageListLength(image));
1343  if (proceed == MagickFalse)
1344  status=MagickFalse;
1345  }
1346  scene++;
1347  }
1348  if (GetNextImageInList(next) != (Image *) NULL)
1349  {
1350  morph_images=DestroyImageList(morph_images);
1351  return((Image *) NULL);
1352  }
1353  return(GetFirstImageInList(morph_images));
1354 }
1355 
1356 /*
1357 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1358 % %
1359 % %
1360 % %
1361 % P l a s m a I m a g e %
1362 % %
1363 % %
1364 % %
1365 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1366 %
1367 % PlasmaImage() initializes an image with plasma fractal values. The image
1368 % must be initialized with a base color and the random number generator
1369 % seeded before this method is called.
1370 %
1371 % The format of the PlasmaImage method is:
1372 %
1373 % MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
1374 % size_t attenuate,size_t depth,ExceptionInfo *exception)
1375 %
1376 % A description of each parameter follows:
1377 %
1378 % o image: the image.
1379 %
1380 % o segment: Define the region to apply plasma fractals values.
1381 %
1382 % o attenuate: Define the plasma attenuation factor.
1383 %
1384 % o depth: Limit the plasma recursion depth.
1385 %
1386 % o exception: return any errors or warnings in this structure.
1387 %
1388 */
1389 
1391  const double pixel,const double noise)
1392 {
1394  plasma;
1395 
1396  plasma=pixel+noise*GetPseudoRandomValue(random_info)-noise/2.0;
1397  return(ClampToQuantum(plasma));
1398 }
1399 
1402  const SegmentInfo *magick_restrict segment,size_t attenuate,size_t depth,
1403  ExceptionInfo *exception)
1404 {
1405  double
1406  plasma;
1407 
1409  status;
1410 
1411  register const Quantum
1412  *magick_restrict u,
1413  *magick_restrict v;
1414 
1415  register Quantum
1416  *magick_restrict q;
1417 
1418  register ssize_t
1419  i;
1420 
1421  ssize_t
1422  x,
1423  x_mid,
1424  y,
1425  y_mid;
1426 
1427  if ((fabs(segment->x2-segment->x1) < MagickEpsilon) &&
1428  (fabs(segment->y2-segment->y1) < MagickEpsilon))
1429  return(MagickTrue);
1430  if (depth != 0)
1431  {
1432  SegmentInfo
1433  local_info;
1434 
1435  /*
1436  Divide the area into quadrants and recurse.
1437  */
1438  depth--;
1439  attenuate++;
1440  x_mid=(ssize_t) ceil((segment->x1+segment->x2)/2-0.5);
1441  y_mid=(ssize_t) ceil((segment->y1+segment->y2)/2-0.5);
1442  local_info=(*segment);
1443  local_info.x2=(double) x_mid;
1444  local_info.y2=(double) y_mid;
1445  status=PlasmaImageProxy(image,image_view,u_view,v_view,random_info,
1446  &local_info,attenuate,depth,exception);
1447  local_info=(*segment);
1448  local_info.y1=(double) y_mid;
1449  local_info.x2=(double) x_mid;
1450  status&=PlasmaImageProxy(image,image_view,u_view,v_view,random_info,
1451  &local_info,attenuate,depth,exception);
1452  local_info=(*segment);
1453  local_info.x1=(double) x_mid;
1454  local_info.y2=(double) y_mid;
1455  status&=PlasmaImageProxy(image,image_view,u_view,v_view,random_info,
1456  &local_info,attenuate,depth,exception);
1457  local_info=(*segment);
1458  local_info.x1=(double) x_mid;
1459  local_info.y1=(double) y_mid;
1460  status&=PlasmaImageProxy(image,image_view,u_view,v_view,random_info,
1461  &local_info,attenuate,depth,exception);
1462  return(status == 0 ? MagickFalse : MagickTrue);
1463  }
1464  x_mid=(ssize_t) ceil((segment->x1+segment->x2)/2-0.5);
1465  y_mid=(ssize_t) ceil((segment->y1+segment->y2)/2-0.5);
1466  if ((fabs(segment->x1-x_mid) < MagickEpsilon) &&
1467  (fabs(segment->x2-x_mid) < MagickEpsilon) &&
1468  (fabs(segment->y1-y_mid) < MagickEpsilon) &&
1469  (fabs(segment->y2-y_mid) < MagickEpsilon))
1470  return(MagickFalse);
1471  /*
1472  Average pixels and apply plasma.
1473  */
1474  status=MagickTrue;
1475  plasma=(double) QuantumRange/(2.0*attenuate);
1476  if ((fabs(segment->x1-x_mid) >= MagickEpsilon) ||
1477  (fabs(segment->x2-x_mid) >= MagickEpsilon))
1478  {
1479  /*
1480  Left pixel.
1481  */
1482  x=(ssize_t) ceil(segment->x1-0.5);
1483  u=GetCacheViewVirtualPixels(u_view,x,(ssize_t) ceil(segment->y1-0.5),1,1,
1484  exception);
1485  v=GetCacheViewVirtualPixels(v_view,x,(ssize_t) ceil(segment->y2-0.5),1,1,
1486  exception);
1487  q=QueueCacheViewAuthenticPixels(image_view,x,y_mid,1,1,exception);
1488  if ((u == (const Quantum *) NULL) || (v == (const Quantum *) NULL) ||
1489  (q == (Quantum *) NULL))
1490  return(MagickTrue);
1491  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
1492  {
1493  PixelChannel channel = GetPixelChannelChannel(image,i);
1494  PixelTrait traits = GetPixelChannelTraits(image,channel);
1495  if (traits == UndefinedPixelTrait)
1496  continue;
1497  q[i]=PlasmaPixel(random_info,((double) u[i]+v[i])/2.0,plasma);
1498  }
1499  status=SyncCacheViewAuthenticPixels(image_view,exception);
1500  if (fabs(segment->x1-segment->x2) >= MagickEpsilon)
1501  {
1502  /*
1503  Right pixel.
1504  */
1505  x=(ssize_t) ceil(segment->x2-0.5);
1506  u=GetCacheViewVirtualPixels(u_view,x,(ssize_t) ceil(segment->y1-0.5),
1507  1,1,exception);
1508  v=GetCacheViewVirtualPixels(v_view,x,(ssize_t) ceil(segment->y2-0.5),
1509  1,1,exception);
1510  q=QueueCacheViewAuthenticPixels(image_view,x,y_mid,1,1,exception);
1511  if ((u == (const Quantum *) NULL) || (v == (const Quantum *) NULL) ||
1512  (q == (Quantum *) NULL))
1513  return(MagickFalse);
1514  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
1515  {
1516  PixelChannel channel = GetPixelChannelChannel(image,i);
1517  PixelTrait traits = GetPixelChannelTraits(image,channel);
1518  if (traits == UndefinedPixelTrait)
1519  continue;
1520  q[i]=PlasmaPixel(random_info,((double) u[i]+v[i])/2.0,plasma);
1521  }
1522  status=SyncCacheViewAuthenticPixels(image_view,exception);
1523  }
1524  }
1525  if ((fabs(segment->y1-y_mid) >= MagickEpsilon) ||
1526  (fabs(segment->y2-y_mid) >= MagickEpsilon))
1527  {
1528  if ((fabs(segment->x1-x_mid) >= MagickEpsilon) ||
1529  (fabs(segment->y2-y_mid) >= MagickEpsilon))
1530  {
1531  /*
1532  Bottom pixel.
1533  */
1534  y=(ssize_t) ceil(segment->y2-0.5);
1535  u=GetCacheViewVirtualPixels(u_view,(ssize_t) ceil(segment->x1-0.5),y,
1536  1,1,exception);
1537  v=GetCacheViewVirtualPixels(v_view,(ssize_t) ceil(segment->x2-0.5),y,
1538  1,1,exception);
1539  q=QueueCacheViewAuthenticPixels(image_view,x_mid,y,1,1,exception);
1540  if ((u == (const Quantum *) NULL) || (v == (const Quantum *) NULL) ||
1541  (q == (Quantum *) NULL))
1542  return(MagickTrue);
1543  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
1544  {
1545  PixelChannel channel = GetPixelChannelChannel(image,i);
1546  PixelTrait traits = GetPixelChannelTraits(image,channel);
1547  if (traits == UndefinedPixelTrait)
1548  continue;
1549  q[i]=PlasmaPixel(random_info,((double) u[i]+v[i])/2.0,plasma);
1550  }
1551  status=SyncCacheViewAuthenticPixels(image_view,exception);
1552  }
1553  if (fabs(segment->y1-segment->y2) >= MagickEpsilon)
1554  {
1555  /*
1556  Top pixel.
1557  */
1558  y=(ssize_t) ceil(segment->y1-0.5);
1559  u=GetCacheViewVirtualPixels(u_view,(ssize_t) ceil(segment->x1-0.5),y,
1560  1,1,exception);
1561  v=GetCacheViewVirtualPixels(v_view,(ssize_t) ceil(segment->x2-0.5),y,
1562  1,1,exception);
1563  q=QueueCacheViewAuthenticPixels(image_view,x_mid,y,1,1,exception);
1564  if ((u == (const Quantum *) NULL) || (v == (const Quantum *) NULL) ||
1565  (q == (Quantum *) NULL))
1566  return(MagickTrue);
1567  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
1568  {
1569  PixelChannel channel = GetPixelChannelChannel(image,i);
1570  PixelTrait traits = GetPixelChannelTraits(image,channel);
1571  if (traits == UndefinedPixelTrait)
1572  continue;
1573  q[i]=PlasmaPixel(random_info,((double) u[i]+v[i])/2.0,plasma);
1574  }
1575  status=SyncCacheViewAuthenticPixels(image_view,exception);
1576  }
1577  }
1578  if ((fabs(segment->x1-segment->x2) >= MagickEpsilon) ||
1579  (fabs(segment->y1-segment->y2) >= MagickEpsilon))
1580  {
1581  /*
1582  Middle pixel.
1583  */
1584  x=(ssize_t) ceil(segment->x1-0.5);
1585  y=(ssize_t) ceil(segment->y1-0.5);
1586  u=GetCacheViewVirtualPixels(u_view,x,y,1,1,exception);
1587  x=(ssize_t) ceil(segment->x2-0.5);
1588  y=(ssize_t) ceil(segment->y2-0.5);
1589  v=GetCacheViewVirtualPixels(v_view,x,y,1,1,exception);
1590  q=QueueCacheViewAuthenticPixels(image_view,x_mid,y_mid,1,1,exception);
1591  if ((u == (const Quantum *) NULL) || (v == (const Quantum *) NULL) ||
1592  (q == (Quantum *) NULL))
1593  return(MagickTrue);
1594  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
1595  {
1596  PixelChannel channel = GetPixelChannelChannel(image,i);
1597  PixelTrait traits = GetPixelChannelTraits(image,channel);
1598  if (traits == UndefinedPixelTrait)
1599  continue;
1600  q[i]=PlasmaPixel(random_info,((double) u[i]+v[i])/2.0,plasma);
1601  }
1602  status=SyncCacheViewAuthenticPixels(image_view,exception);
1603  }
1604  if ((fabs(segment->x2-segment->x1) < 3.0) &&
1605  (fabs(segment->y2-segment->y1) < 3.0))
1606  return(status == 0 ? MagickFalse : MagickTrue);
1607  return(MagickFalse);
1608 }
1609 
1611  const SegmentInfo *segment,size_t attenuate,size_t depth,
1612  ExceptionInfo *exception)
1613 {
1614  CacheView
1615  *image_view,
1616  *u_view,
1617  *v_view;
1618 
1620  status;
1621 
1622  RandomInfo
1623  *random_info;
1624 
1625  assert(image != (Image *) NULL);
1626  if (image->debug != MagickFalse)
1627  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
1628  assert(image->signature == MagickCoreSignature);
1629  if (image->debug != MagickFalse)
1630  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
1631  if (SetImageStorageClass(image,DirectClass,exception) == MagickFalse)
1632  return(MagickFalse);
1633  image_view=AcquireAuthenticCacheView(image,exception);
1634  u_view=AcquireVirtualCacheView(image,exception);
1635  v_view=AcquireVirtualCacheView(image,exception);
1636  random_info=AcquireRandomInfo();
1637  status=PlasmaImageProxy(image,image_view,u_view,v_view,random_info,segment,
1638  attenuate,depth,exception);
1639  random_info=DestroyRandomInfo(random_info);
1640  v_view=DestroyCacheView(v_view);
1641  u_view=DestroyCacheView(u_view);
1642  image_view=DestroyCacheView(image_view);
1643  return(status);
1644 }
1645 
1646 /*
1647 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1648 % %
1649 % %
1650 % %
1651 % P o l a r o i d I m a g e %
1652 % %
1653 % %
1654 % %
1655 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1656 %
1657 % PolaroidImage() simulates a Polaroid picture.
1658 %
1659 % The format of the PolaroidImage method is:
1660 %
1661 % Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
1662 % const char *caption,const double angle,
1663 % const PixelInterpolateMethod method,ExceptionInfo exception)
1664 %
1665 % A description of each parameter follows:
1666 %
1667 % o image: the image.
1668 %
1669 % o draw_info: the draw info.
1670 %
1671 % o caption: the Polaroid caption.
1672 %
1673 % o angle: Apply the effect along this angle.
1674 %
1675 % o method: the pixel interpolation method.
1676 %
1677 % o exception: return any errors or warnings in this structure.
1678 %
1679 */
1680 MagickExport Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
1681  const char *caption,const double angle,const PixelInterpolateMethod method,
1682  ExceptionInfo *exception)
1683 {
1684  Image
1685  *bend_image,
1686  *caption_image,
1687  *flop_image,
1688  *picture_image,
1689  *polaroid_image,
1690  *rotate_image,
1691  *trim_image;
1692 
1693  size_t
1694  height;
1695 
1696  ssize_t
1697  quantum;
1698 
1699  /*
1700  Simulate a Polaroid picture.
1701  */
1702  assert(image != (Image *) NULL);
1703  assert(image->signature == MagickCoreSignature);
1704  if (image->debug != MagickFalse)
1705  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1706  assert(exception != (ExceptionInfo *) NULL);
1707  assert(exception->signature == MagickCoreSignature);
1708  quantum=(ssize_t) MagickMax(MagickMax((double) image->columns,(double)
1709  image->rows)/25.0,10.0);
1710  height=image->rows+2*quantum;
1711  caption_image=(Image *) NULL;
1712  if (caption != (const char *) NULL)
1713  {
1714  char
1715  *text;
1716 
1717  /*
1718  Generate caption image.
1719  */
1720  caption_image=CloneImage(image,image->columns,1,MagickTrue,exception);
1721  if (caption_image == (Image *) NULL)
1722  return((Image *) NULL);
1723  text=InterpretImageProperties((ImageInfo *) NULL,(Image *) image,caption,
1724  exception);
1725  if (text != (char *) NULL)
1726  {
1727  char
1728  geometry[MagickPathExtent];
1729 
1730  DrawInfo
1731  *annotate_info;
1732 
1734  status;
1735 
1736  ssize_t
1737  count;
1738 
1739  TypeMetric
1740  metrics;
1741 
1742  annotate_info=CloneDrawInfo((const ImageInfo *) NULL,draw_info);
1743  (void) CloneString(&annotate_info->text,text);
1744  count=FormatMagickCaption(caption_image,annotate_info,MagickTrue,
1745  &metrics,&text,exception);
1746  status=SetImageExtent(caption_image,image->columns,(size_t)
1747  ((count+1)*(metrics.ascent-metrics.descent)+0.5),exception);
1748  if (status == MagickFalse)
1749  caption_image=DestroyImage(caption_image);
1750  else
1751  {
1752  caption_image->background_color=image->border_color;
1753  (void) SetImageBackgroundColor(caption_image,exception);
1754  (void) CloneString(&annotate_info->text,text);
1755  (void) FormatLocaleString(geometry,MagickPathExtent,"+0+%.20g",
1756  metrics.ascent);
1757  if (annotate_info->gravity == UndefinedGravity)
1758  (void) CloneString(&annotate_info->geometry,AcquireString(
1759  geometry));
1760  (void) AnnotateImage(caption_image,annotate_info,exception);
1761  height+=caption_image->rows;
1762  }
1763  annotate_info=DestroyDrawInfo(annotate_info);
1764  text=DestroyString(text);
1765  }
1766  }
1767  picture_image=CloneImage(image,image->columns+2*quantum,height,MagickTrue,
1768  exception);
1769  if (picture_image == (Image *) NULL)
1770  {
1771  if (caption_image != (Image *) NULL)
1772  caption_image=DestroyImage(caption_image);
1773  return((Image *) NULL);
1774  }
1775  picture_image->background_color=image->border_color;
1776  (void) SetImageBackgroundColor(picture_image,exception);
1777  (void) CompositeImage(picture_image,image,OverCompositeOp,MagickTrue,quantum,
1778  quantum,exception);
1779  if (caption_image != (Image *) NULL)
1780  {
1781  (void) CompositeImage(picture_image,caption_image,OverCompositeOp,
1782  MagickTrue,quantum,(ssize_t) (image->rows+3*quantum/2),exception);
1783  caption_image=DestroyImage(caption_image);
1784  }
1785  (void) QueryColorCompliance("none",AllCompliance,
1786  &picture_image->background_color,exception);
1787  (void) SetImageAlphaChannel(picture_image,OpaqueAlphaChannel,exception);
1788  rotate_image=RotateImage(picture_image,90.0,exception);
1789  picture_image=DestroyImage(picture_image);
1790  if (rotate_image == (Image *) NULL)
1791  return((Image *) NULL);
1792  picture_image=rotate_image;
1793  bend_image=WaveImage(picture_image,0.01*picture_image->rows,2.0*
1794  picture_image->columns,method,exception);
1795  picture_image=DestroyImage(picture_image);
1796  if (bend_image == (Image *) NULL)
1797  return((Image *) NULL);
1798  picture_image=bend_image;
1799  rotate_image=RotateImage(picture_image,-90.0,exception);
1800  picture_image=DestroyImage(picture_image);
1801  if (rotate_image == (Image *) NULL)
1802  return((Image *) NULL);
1803  picture_image=rotate_image;
1804  picture_image->background_color=image->background_color;
1805  polaroid_image=ShadowImage(picture_image,80.0,2.0,quantum/3,quantum/3,
1806  exception);
1807  if (polaroid_image == (Image *) NULL)
1808  {
1809  picture_image=DestroyImage(picture_image);
1810  return(picture_image);
1811  }
1812  flop_image=FlopImage(polaroid_image,exception);
1813  polaroid_image=DestroyImage(polaroid_image);
1814  if (flop_image == (Image *) NULL)
1815  {
1816  picture_image=DestroyImage(picture_image);
1817  return(picture_image);
1818  }
1819  polaroid_image=flop_image;
1820  (void) CompositeImage(polaroid_image,picture_image,OverCompositeOp,
1821  MagickTrue,(ssize_t) (-0.01*picture_image->columns/2.0),0L,exception);
1822  picture_image=DestroyImage(picture_image);
1823  (void) QueryColorCompliance("none",AllCompliance,
1824  &polaroid_image->background_color,exception);
1825  rotate_image=RotateImage(polaroid_image,angle,exception);
1826  polaroid_image=DestroyImage(polaroid_image);
1827  if (rotate_image == (Image *) NULL)
1828  return((Image *) NULL);
1829  polaroid_image=rotate_image;
1830  trim_image=TrimImage(polaroid_image,exception);
1831  polaroid_image=DestroyImage(polaroid_image);
1832  if (trim_image == (Image *) NULL)
1833  return((Image *) NULL);
1834  polaroid_image=trim_image;
1835  return(polaroid_image);
1836 }
1837 
1838 /*
1839 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1840 % %
1841 % %
1842 % %
1843 % S e p i a T o n e I m a g e %
1844 % %
1845 % %
1846 % %
1847 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1848 %
1849 % MagickSepiaToneImage() applies a special effect to the image, similar to the
1850 % effect achieved in a photo darkroom by sepia toning. Threshold ranges from
1851 % 0 to QuantumRange and is a measure of the extent of the sepia toning. A
1852 % threshold of 80% is a good starting point for a reasonable tone.
1853 %
1854 % The format of the SepiaToneImage method is:
1855 %
1856 % Image *SepiaToneImage(const Image *image,const double threshold,
1857 % ExceptionInfo *exception)
1858 %
1859 % A description of each parameter follows:
1860 %
1861 % o image: the image.
1862 %
1863 % o threshold: the tone threshold.
1864 %
1865 % o exception: return any errors or warnings in this structure.
1866 %
1867 */
1868 MagickExport Image *SepiaToneImage(const Image *image,const double threshold,
1869  ExceptionInfo *exception)
1870 {
1871 #define SepiaToneImageTag "SepiaTone/Image"
1872 
1873  CacheView
1874  *image_view,
1875  *sepia_view;
1876 
1877  Image
1878  *sepia_image;
1879 
1881  status;
1882 
1884  progress;
1885 
1886  ssize_t
1887  y;
1888 
1889  /*
1890  Initialize sepia-toned image attributes.
1891  */
1892  assert(image != (const Image *) NULL);
1893  assert(image->signature == MagickCoreSignature);
1894  if (image->debug != MagickFalse)
1895  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1896  assert(exception != (ExceptionInfo *) NULL);
1897  assert(exception->signature == MagickCoreSignature);
1898  sepia_image=CloneImage(image,0,0,MagickTrue,exception);
1899  if (sepia_image == (Image *) NULL)
1900  return((Image *) NULL);
1901  if (SetImageStorageClass(sepia_image,DirectClass,exception) == MagickFalse)
1902  {
1903  sepia_image=DestroyImage(sepia_image);
1904  return((Image *) NULL);
1905  }
1906  /*
1907  Tone each row of the image.
1908  */
1909  status=MagickTrue;
1910  progress=0;
1911  image_view=AcquireVirtualCacheView(image,exception);
1912  sepia_view=AcquireAuthenticCacheView(sepia_image,exception);
1913 #if defined(MAGICKCORE_OPENMP_SUPPORT)
1914  #pragma omp parallel for schedule(static) shared(progress,status) \
1915  magick_number_threads(image,sepia_image,image->rows,1)
1916 #endif
1917  for (y=0; y < (ssize_t) image->rows; y++)
1918  {
1919  register const Quantum
1920  *magick_restrict p;
1921 
1922  register ssize_t
1923  x;
1924 
1925  register Quantum
1926  *magick_restrict q;
1927 
1928  if (status == MagickFalse)
1929  continue;
1930  p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
1931  q=GetCacheViewAuthenticPixels(sepia_view,0,y,sepia_image->columns,1,
1932  exception);
1933  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
1934  {
1935  status=MagickFalse;
1936  continue;
1937  }
1938  for (x=0; x < (ssize_t) image->columns; x++)
1939  {
1940  double
1941  intensity,
1942  tone;
1943 
1944  intensity=GetPixelIntensity(image,p);
1945  tone=intensity > threshold ? (double) QuantumRange : intensity+
1946  (double) QuantumRange-threshold;
1947  SetPixelRed(sepia_image,ClampToQuantum(tone),q);
1948  tone=intensity > (7.0*threshold/6.0) ? (double) QuantumRange :
1949  intensity+(double) QuantumRange-7.0*threshold/6.0;
1950  SetPixelGreen(sepia_image,ClampToQuantum(tone),q);
1951  tone=intensity < (threshold/6.0) ? 0 : intensity-threshold/6.0;
1952  SetPixelBlue(sepia_image,ClampToQuantum(tone),q);
1953  tone=threshold/7.0;
1954  if ((double) GetPixelGreen(image,q) < tone)
1955  SetPixelGreen(sepia_image,ClampToQuantum(tone),q);
1956  if ((double) GetPixelBlue(image,q) < tone)
1957  SetPixelBlue(sepia_image,ClampToQuantum(tone),q);
1958  SetPixelAlpha(sepia_image,GetPixelAlpha(image,p),q);
1959  p+=GetPixelChannels(image);
1960  q+=GetPixelChannels(sepia_image);
1961  }
1962  if (SyncCacheViewAuthenticPixels(sepia_view,exception) == MagickFalse)
1963  status=MagickFalse;
1964  if (image->progress_monitor != (MagickProgressMonitor) NULL)
1965  {
1967  proceed;
1968 
1969 #if defined(MAGICKCORE_OPENMP_SUPPORT)
1970  #pragma omp atomic
1971 #endif
1972  progress++;
1973  proceed=SetImageProgress(image,SepiaToneImageTag,progress,image->rows);
1974  if (proceed == MagickFalse)
1975  status=MagickFalse;
1976  }
1977  }
1978  sepia_view=DestroyCacheView(sepia_view);
1979  image_view=DestroyCacheView(image_view);
1980  (void) NormalizeImage(sepia_image,exception);
1981  (void) ContrastImage(sepia_image,MagickTrue,exception);
1982  if (status == MagickFalse)
1983  sepia_image=DestroyImage(sepia_image);
1984  return(sepia_image);
1985 }
1986 
1987 /*
1988 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1989 % %
1990 % %
1991 % %
1992 % S h a d o w I m a g e %
1993 % %
1994 % %
1995 % %
1996 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1997 %
1998 % ShadowImage() simulates a shadow from the specified image and returns it.
1999 %
2000 % The format of the ShadowImage method is:
2001 %
2002 % Image *ShadowImage(const Image *image,const double alpha,
2003 % const double sigma,const ssize_t x_offset,const ssize_t y_offset,
2004 % ExceptionInfo *exception)
2005 %
2006 % A description of each parameter follows:
2007 %
2008 % o image: the image.
2009 %
2010 % o alpha: percentage transparency.
2011 %
2012 % o sigma: the standard deviation of the Gaussian, in pixels.
2013 %
2014 % o x_offset: the shadow x-offset.
2015 %
2016 % o y_offset: the shadow y-offset.
2017 %
2018 % o exception: return any errors or warnings in this structure.
2019 %
2020 */
2021 MagickExport Image *ShadowImage(const Image *image,const double alpha,
2022  const double sigma,const ssize_t x_offset,const ssize_t y_offset,
2023  ExceptionInfo *exception)
2024 {
2025 #define ShadowImageTag "Shadow/Image"
2026 
2027  CacheView
2028  *image_view;
2029 
2030  ChannelType
2031  channel_mask;
2032 
2033  Image
2034  *border_image,
2035  *clone_image,
2036  *shadow_image;
2037 
2039  status;
2040 
2041  PixelInfo
2042  background_color;
2043 
2045  border_info;
2046 
2047  ssize_t
2048  y;
2049 
2050  assert(image != (Image *) NULL);
2051  assert(image->signature == MagickCoreSignature);
2052  if (image->debug != MagickFalse)
2053  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2054  assert(exception != (ExceptionInfo *) NULL);
2055  assert(exception->signature == MagickCoreSignature);
2056  clone_image=CloneImage(image,0,0,MagickTrue,exception);
2057  if (clone_image == (Image *) NULL)
2058  return((Image *) NULL);
2059  if (IsGrayColorspace(image->colorspace) != MagickFalse)
2060  (void) SetImageColorspace(clone_image,sRGBColorspace,exception);
2062  exception);
2063  border_info.width=(size_t) floor(2.0*sigma+0.5);
2064  border_info.height=(size_t) floor(2.0*sigma+0.5);
2065  border_info.x=0;
2066  border_info.y=0;
2067  (void) QueryColorCompliance("none",AllCompliance,&clone_image->border_color,
2068  exception);
2069  clone_image->alpha_trait=BlendPixelTrait;
2070  border_image=BorderImage(clone_image,&border_info,OverCompositeOp,exception);
2071  clone_image=DestroyImage(clone_image);
2072  if (border_image == (Image *) NULL)
2073  return((Image *) NULL);
2074  if (border_image->alpha_trait == UndefinedPixelTrait)
2075  (void) SetImageAlphaChannel(border_image,OpaqueAlphaChannel,exception);
2076  /*
2077  Shadow image.
2078  */
2079  status=MagickTrue;
2080  background_color=border_image->background_color;
2081  background_color.alpha_trait=BlendPixelTrait;
2082  image_view=AcquireAuthenticCacheView(border_image,exception);
2083  for (y=0; y < (ssize_t) border_image->rows; y++)
2084  {
2085  register Quantum
2086  *magick_restrict q;
2087 
2088  register ssize_t
2089  x;
2090 
2091  if (status == MagickFalse)
2092  continue;
2093  q=QueueCacheViewAuthenticPixels(image_view,0,y,border_image->columns,1,
2094  exception);
2095  if (q == (Quantum *) NULL)
2096  {
2097  status=MagickFalse;
2098  continue;
2099  }
2100  for (x=0; x < (ssize_t) border_image->columns; x++)
2101  {
2102  if (border_image->alpha_trait != UndefinedPixelTrait)
2103  background_color.alpha=GetPixelAlpha(border_image,q)*alpha/100.0;
2104  SetPixelViaPixelInfo(border_image,&background_color,q);
2105  q+=GetPixelChannels(border_image);
2106  }
2107  if (SyncCacheViewAuthenticPixels(image_view,exception) == MagickFalse)
2108  status=MagickFalse;
2109  }
2110  image_view=DestroyCacheView(image_view);
2111  if (status == MagickFalse)
2112  {
2113  border_image=DestroyImage(border_image);
2114  return((Image *) NULL);
2115  }
2116  channel_mask=SetImageChannelMask(border_image,AlphaChannel);
2117  shadow_image=BlurImage(border_image,0.0,sigma,exception);
2118  border_image=DestroyImage(border_image);
2119  if (shadow_image == (Image *) NULL)
2120  return((Image *) NULL);
2121  (void) SetPixelChannelMask(shadow_image,channel_mask);
2122  if (shadow_image->page.width == 0)
2123  shadow_image->page.width=shadow_image->columns;
2124  if (shadow_image->page.height == 0)
2125  shadow_image->page.height=shadow_image->rows;
2126  shadow_image->page.width+=x_offset-(ssize_t) border_info.width;
2127  shadow_image->page.height+=y_offset-(ssize_t) border_info.height;
2128  shadow_image->page.x+=x_offset-(ssize_t) border_info.width;
2129  shadow_image->page.y+=y_offset-(ssize_t) border_info.height;
2130  return(shadow_image);
2131 }
2132 
2133 /*
2134 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2135 % %
2136 % %
2137 % %
2138 % S k e t c h I m a g e %
2139 % %
2140 % %
2141 % %
2142 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2143 %
2144 % SketchImage() simulates a pencil sketch. We convolve the image with a
2145 % Gaussian operator of the given radius and standard deviation (sigma). For
2146 % reasonable results, radius should be larger than sigma. Use a radius of 0
2147 % and SketchImage() selects a suitable radius for you. Angle gives the angle
2148 % of the sketch.
2149 %
2150 % The format of the SketchImage method is:
2151 %
2152 % Image *SketchImage(const Image *image,const double radius,
2153 % const double sigma,const double angle,ExceptionInfo *exception)
2154 %
2155 % A description of each parameter follows:
2156 %
2157 % o image: the image.
2158 %
2159 % o radius: the radius of the Gaussian, in pixels, not counting the
2160 % center pixel.
2161 %
2162 % o sigma: the standard deviation of the Gaussian, in pixels.
2163 %
2164 % o angle: apply the effect along this angle.
2165 %
2166 % o exception: return any errors or warnings in this structure.
2167 %
2168 */
2169 MagickExport Image *SketchImage(const Image *image,const double radius,
2170  const double sigma,const double angle,ExceptionInfo *exception)
2171 {
2172  CacheView
2173  *random_view;
2174 
2175  Image
2176  *blend_image,
2177  *blur_image,
2178  *dodge_image,
2179  *random_image,
2180  *sketch_image;
2181 
2183  status;
2184 
2185  RandomInfo
2187 
2188  ssize_t
2189  y;
2190 
2191 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2192  unsigned long
2193  key;
2194 #endif
2195 
2196  /*
2197  Sketch image.
2198  */
2199  random_image=CloneImage(image,image->columns << 1,image->rows << 1,
2200  MagickTrue,exception);
2201  if (random_image == (Image *) NULL)
2202  return((Image *) NULL);
2203  status=MagickTrue;
2204  random_info=AcquireRandomInfoThreadSet();
2205  random_view=AcquireAuthenticCacheView(random_image,exception);
2206 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2207  key=GetRandomSecretKey(random_info[0]);
2208  #pragma omp parallel for schedule(static) shared(status) \
2209  magick_number_threads(random_image,random_image,random_image->rows,key == ~0UL)
2210 #endif
2211  for (y=0; y < (ssize_t) random_image->rows; y++)
2212  {
2213  const int
2214  id = GetOpenMPThreadId();
2215 
2216  register Quantum
2217  *magick_restrict q;
2218 
2219  register ssize_t
2220  x;
2221 
2222  if (status == MagickFalse)
2223  continue;
2224  q=QueueCacheViewAuthenticPixels(random_view,0,y,random_image->columns,1,
2225  exception);
2226  if (q == (Quantum *) NULL)
2227  {
2228  status=MagickFalse;
2229  continue;
2230  }
2231  for (x=0; x < (ssize_t) random_image->columns; x++)
2232  {
2233  double
2234  value;
2235 
2236  register ssize_t
2237  i;
2238 
2239  value=GetPseudoRandomValue(random_info[id]);
2240  for (i=0; i < (ssize_t) GetPixelChannels(random_image); i++)
2241  {
2242  PixelChannel channel = GetPixelChannelChannel(image,i);
2243  PixelTrait traits = GetPixelChannelTraits(image,channel);
2244  if (traits == UndefinedPixelTrait)
2245  continue;
2246  q[i]=ClampToQuantum(QuantumRange*value);
2247  }
2248  q+=GetPixelChannels(random_image);
2249  }
2250  if (SyncCacheViewAuthenticPixels(random_view,exception) == MagickFalse)
2251  status=MagickFalse;
2252  }
2253  random_view=DestroyCacheView(random_view);
2254  random_info=DestroyRandomInfoThreadSet(random_info);
2255  if (status == MagickFalse)
2256  {
2257  random_image=DestroyImage(random_image);
2258  return(random_image);
2259  }
2260  blur_image=MotionBlurImage(random_image,radius,sigma,angle,exception);
2261  random_image=DestroyImage(random_image);
2262  if (blur_image == (Image *) NULL)
2263  return((Image *) NULL);
2264  dodge_image=EdgeImage(blur_image,radius,exception);
2265  blur_image=DestroyImage(blur_image);
2266  if (dodge_image == (Image *) NULL)
2267  return((Image *) NULL);
2268  status=ClampImage(dodge_image,exception);
2269  if (status != MagickFalse)
2270  status=NormalizeImage(dodge_image,exception);
2271  if (status != MagickFalse)
2272  status=NegateImage(dodge_image,MagickFalse,exception);
2273  if (status != MagickFalse)
2274  status=TransformImage(&dodge_image,(char *) NULL,"50%",exception);
2275  sketch_image=CloneImage(image,0,0,MagickTrue,exception);
2276  if (sketch_image == (Image *) NULL)
2277  {
2278  dodge_image=DestroyImage(dodge_image);
2279  return((Image *) NULL);
2280  }
2281  (void) CompositeImage(sketch_image,dodge_image,ColorDodgeCompositeOp,
2282  MagickTrue,0,0,exception);
2283  dodge_image=DestroyImage(dodge_image);
2284  blend_image=CloneImage(image,0,0,MagickTrue,exception);
2285  if (blend_image == (Image *) NULL)
2286  {
2287  sketch_image=DestroyImage(sketch_image);
2288  return((Image *) NULL);
2289  }
2290  if (blend_image->alpha_trait != BlendPixelTrait)
2291  (void) SetImageAlpha(blend_image,TransparentAlpha,exception);
2292  (void) SetImageArtifact(blend_image,"compose:args","20x80");
2293  (void) CompositeImage(sketch_image,blend_image,BlendCompositeOp,MagickTrue,
2294  0,0,exception);
2295  blend_image=DestroyImage(blend_image);
2296  return(sketch_image);
2297 }
2298 
2299 /*
2300 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2301 % %
2302 % %
2303 % %
2304 % S o l a r i z e I m a g e %
2305 % %
2306 % %
2307 % %
2308 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2309 %
2310 % SolarizeImage() applies a special effect to the image, similar to the effect
2311 % achieved in a photo darkroom by selectively exposing areas of photo
2312 % sensitive paper to light. Threshold ranges from 0 to QuantumRange and is a
2313 % measure of the extent of the solarization.
2314 %
2315 % The format of the SolarizeImage method is:
2316 %
2317 % MagickBooleanType SolarizeImage(Image *image,const double threshold,
2318 % ExceptionInfo *exception)
2319 %
2320 % A description of each parameter follows:
2321 %
2322 % o image: the image.
2323 %
2324 % o threshold: Define the extent of the solarization.
2325 %
2326 % o exception: return any errors or warnings in this structure.
2327 %
2328 */
2330  const double threshold,ExceptionInfo *exception)
2331 {
2332 #define SolarizeImageTag "Solarize/Image"
2333 
2334  CacheView
2335  *image_view;
2336 
2338  status;
2339 
2341  progress;
2342 
2343  ssize_t
2344  y;
2345 
2346  assert(image != (Image *) NULL);
2347  assert(image->signature == MagickCoreSignature);
2348  if (image->debug != MagickFalse)
2349  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2350  if (IsGrayColorspace(image->colorspace) != MagickFalse)
2351  (void) SetImageColorspace(image,sRGBColorspace,exception);
2352  if (image->storage_class == PseudoClass)
2353  {
2354  register ssize_t
2355  i;
2356 
2357  /*
2358  Solarize colormap.
2359  */
2360  for (i=0; i < (ssize_t) image->colors; i++)
2361  {
2362  if ((double) image->colormap[i].red > threshold)
2363  image->colormap[i].red=QuantumRange-image->colormap[i].red;
2364  if ((double) image->colormap[i].green > threshold)
2365  image->colormap[i].green=QuantumRange-image->colormap[i].green;
2366  if ((double) image->colormap[i].blue > threshold)
2367  image->colormap[i].blue=QuantumRange-image->colormap[i].blue;
2368  }
2369  return(SyncImage(image,exception));
2370  }
2371  /*
2372  Solarize image.
2373  */
2374  status=MagickTrue;
2375  progress=0;
2376  image_view=AcquireAuthenticCacheView(image,exception);
2377 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2378  #pragma omp parallel for schedule(static) shared(progress,status) \
2379  magick_number_threads(image,image,image->rows,1)
2380 #endif
2381  for (y=0; y < (ssize_t) image->rows; y++)
2382  {
2383  register ssize_t
2384  x;
2385 
2386  register Quantum
2387  *magick_restrict q;
2388 
2389  if (status == MagickFalse)
2390  continue;
2391  q=GetCacheViewAuthenticPixels(image_view,0,y,image->columns,1,exception);
2392  if (q == (Quantum *) NULL)
2393  {
2394  status=MagickFalse;
2395  continue;
2396  }
2397  for (x=0; x < (ssize_t) image->columns; x++)
2398  {
2399  register ssize_t
2400  i;
2401 
2402  for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
2403  {
2404  PixelChannel channel = GetPixelChannelChannel(image,i);
2405  PixelTrait traits = GetPixelChannelTraits(image,channel);
2406  if ((traits & UpdatePixelTrait) == 0)
2407  continue;
2408  if ((double) q[i] > threshold)
2409  q[i]=QuantumRange-q[i];
2410  }
2411  q+=GetPixelChannels(image);
2412  }
2413  if (SyncCacheViewAuthenticPixels(image_view,exception) == MagickFalse)
2414  status=MagickFalse;
2415  if (image->progress_monitor != (MagickProgressMonitor) NULL)
2416  {
2418  proceed;
2419 
2420 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2421  #pragma omp atomic
2422 #endif
2423  progress++;
2424  proceed=SetImageProgress(image,SolarizeImageTag,progress,image->rows);
2425  if (proceed == MagickFalse)
2426  status=MagickFalse;
2427  }
2428  }
2429  image_view=DestroyCacheView(image_view);
2430  return(status);
2431 }
2432 
2433 /*
2434 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2435 % %
2436 % %
2437 % %
2438 % S t e g a n o I m a g e %
2439 % %
2440 % %
2441 % %
2442 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2443 %
2444 % SteganoImage() hides a digital watermark within the image. Recover
2445 % the hidden watermark later to prove that the authenticity of an image.
2446 % Offset defines the start position within the image to hide the watermark.
2447 %
2448 % The format of the SteganoImage method is:
2449 %
2450 % Image *SteganoImage(const Image *image,Image *watermark,
2451 % ExceptionInfo *exception)
2452 %
2453 % A description of each parameter follows:
2454 %
2455 % o image: the image.
2456 %
2457 % o watermark: the watermark image.
2458 %
2459 % o exception: return any errors or warnings in this structure.
2460 %
2461 */
2462 MagickExport Image *SteganoImage(const Image *image,const Image *watermark,
2463  ExceptionInfo *exception)
2464 {
2465 #define GetBit(alpha,i) ((((size_t) (alpha) >> (size_t) (i)) & 0x01) != 0)
2466 #define SetBit(alpha,i,set) (Quantum) ((set) != 0 ? (size_t) (alpha) \
2467  | (one << (size_t) (i)) : (size_t) (alpha) & ~(one << (size_t) (i)))
2468 #define SteganoImageTag "Stegano/Image"
2469 
2470  CacheView
2471  *stegano_view,
2472  *watermark_view;
2473 
2474  Image
2475  *stegano_image;
2476 
2477  int
2478  c;
2479 
2481  status;
2482 
2483  PixelInfo
2484  pixel;
2485 
2486  register Quantum
2487  *q;
2488 
2489  register ssize_t
2490  x;
2491 
2492  size_t
2493  depth,
2494  one;
2495 
2496  ssize_t
2497  i,
2498  j,
2499  k,
2500  y;
2501 
2502  /*
2503  Initialize steganographic image attributes.
2504  */
2505  assert(image != (const Image *) NULL);
2506  assert(image->signature == MagickCoreSignature);
2507  if (image->debug != MagickFalse)
2508  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2509  assert(watermark != (const Image *) NULL);
2510  assert(watermark->signature == MagickCoreSignature);
2511  assert(exception != (ExceptionInfo *) NULL);
2512  assert(exception->signature == MagickCoreSignature);
2513  one=1UL;
2514  stegano_image=CloneImage(image,0,0,MagickTrue,exception);
2515  if (stegano_image == (Image *) NULL)
2516  return((Image *) NULL);
2517  stegano_image->depth=MAGICKCORE_QUANTUM_DEPTH;
2518  if (SetImageStorageClass(stegano_image,DirectClass,exception) == MagickFalse)
2519  {
2520  stegano_image=DestroyImage(stegano_image);
2521  return((Image *) NULL);
2522  }
2523  /*
2524  Hide watermark in low-order bits of image.
2525  */
2526  c=0;
2527  i=0;
2528  j=0;
2529  depth=stegano_image->depth;
2530  k=stegano_image->offset;
2531  status=MagickTrue;
2532  watermark_view=AcquireVirtualCacheView(watermark,exception);
2533  stegano_view=AcquireAuthenticCacheView(stegano_image,exception);
2534  for (i=(ssize_t) depth-1; (i >= 0) && (j < (ssize_t) depth); i--)
2535  {
2536  for (y=0; (y < (ssize_t) watermark->rows) && (j < (ssize_t) depth); y++)
2537  {
2538  for (x=0; (x < (ssize_t) watermark->columns) && (j < (ssize_t) depth); x++)
2539  {
2540  ssize_t
2541  offset;
2542 
2543  (void) GetOneCacheViewVirtualPixelInfo(watermark_view,x,y,&pixel,
2544  exception);
2545  offset=k/(ssize_t) stegano_image->columns;
2546  if (offset >= (ssize_t) stegano_image->rows)
2547  break;
2548  q=GetCacheViewAuthenticPixels(stegano_view,k % (ssize_t)
2549  stegano_image->columns,k/(ssize_t) stegano_image->columns,1,1,
2550  exception);
2551  if (q == (Quantum *) NULL)
2552  break;
2553  switch (c)
2554  {
2555  case 0:
2556  {
2557  SetPixelRed(stegano_image,SetBit(GetPixelRed(stegano_image,q),j,
2558  GetBit(GetPixelInfoIntensity(stegano_image,&pixel),i)),q);
2559  break;
2560  }
2561  case 1:
2562  {
2563  SetPixelGreen(stegano_image,SetBit(GetPixelGreen(stegano_image,q),j,
2564  GetBit(GetPixelInfoIntensity(stegano_image,&pixel),i)),q);
2565  break;
2566  }
2567  case 2:
2568  {
2569  SetPixelBlue(stegano_image,SetBit(GetPixelBlue(stegano_image,q),j,
2570  GetBit(GetPixelInfoIntensity(stegano_image,&pixel),i)),q);
2571  break;
2572  }
2573  }
2574  if (SyncCacheViewAuthenticPixels(stegano_view,exception) == MagickFalse)
2575  break;
2576  c++;
2577  if (c == 3)
2578  c=0;
2579  k++;
2580  if (k == (ssize_t) (stegano_image->columns*stegano_image->columns))
2581  k=0;
2582  if (k == stegano_image->offset)
2583  j++;
2584  }
2585  }
2586  if (image->progress_monitor != (MagickProgressMonitor) NULL)
2587  {
2589  proceed;
2590 
2592  (depth-i),depth);
2593  if (proceed == MagickFalse)
2594  status=MagickFalse;
2595  }
2596  }
2597  stegano_view=DestroyCacheView(stegano_view);
2598  watermark_view=DestroyCacheView(watermark_view);
2599  if (status == MagickFalse)
2600  stegano_image=DestroyImage(stegano_image);
2601  return(stegano_image);
2602 }
2603 
2604 /*
2605 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2606 % %
2607 % %
2608 % %
2609 % S t e r e o A n a g l y p h I m a g e %
2610 % %
2611 % %
2612 % %
2613 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2614 %
2615 % StereoAnaglyphImage() combines two images and produces a single image that
2616 % is the composite of a left and right image of a stereo pair. Special
2617 % red-green stereo glasses are required to view this effect.
2618 %
2619 % The format of the StereoAnaglyphImage method is:
2620 %
2621 % Image *StereoImage(const Image *left_image,const Image *right_image,
2622 % ExceptionInfo *exception)
2623 % Image *StereoAnaglyphImage(const Image *left_image,
2624 % const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
2625 % ExceptionInfo *exception)
2626 %
2627 % A description of each parameter follows:
2628 %
2629 % o left_image: the left image.
2630 %
2631 % o right_image: the right image.
2632 %
2633 % o exception: return any errors or warnings in this structure.
2634 %
2635 % o x_offset: amount, in pixels, by which the left image is offset to the
2636 % right of the right image.
2637 %
2638 % o y_offset: amount, in pixels, by which the left image is offset to the
2639 % bottom of the right image.
2640 %
2641 %
2642 */
2644  const Image *right_image,ExceptionInfo *exception)
2645 {
2646  return(StereoAnaglyphImage(left_image,right_image,0,0,exception));
2647 }
2648 
2650  const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
2651  ExceptionInfo *exception)
2652 {
2653 #define StereoImageTag "Stereo/Image"
2654 
2655  const Image
2656  *image;
2657 
2658  Image
2659  *stereo_image;
2660 
2662  status;
2663 
2664  ssize_t
2665  y;
2666 
2667  assert(left_image != (const Image *) NULL);
2668  assert(left_image->signature == MagickCoreSignature);
2669  if (left_image->debug != MagickFalse)
2671  left_image->filename);
2672  assert(right_image != (const Image *) NULL);
2673  assert(right_image->signature == MagickCoreSignature);
2674  assert(exception != (ExceptionInfo *) NULL);
2675  assert(exception->signature == MagickCoreSignature);
2676  image=left_image;
2677  if ((left_image->columns != right_image->columns) ||
2678  (left_image->rows != right_image->rows))
2679  ThrowImageException(ImageError,"LeftAndRightImageSizesDiffer");
2680  /*
2681  Initialize stereo image attributes.
2682  */
2683  stereo_image=CloneImage(left_image,left_image->columns,left_image->rows,
2684  MagickTrue,exception);
2685  if (stereo_image == (Image *) NULL)
2686  return((Image *) NULL);
2687  if (SetImageStorageClass(stereo_image,DirectClass,exception) == MagickFalse)
2688  {
2689  stereo_image=DestroyImage(stereo_image);
2690  return((Image *) NULL);
2691  }
2692  (void) SetImageColorspace(stereo_image,sRGBColorspace,exception);
2693  /*
2694  Copy left image to red channel and right image to blue channel.
2695  */
2696  status=MagickTrue;
2697  for (y=0; y < (ssize_t) stereo_image->rows; y++)
2698  {
2699  register const Quantum
2700  *magick_restrict p,
2701  *magick_restrict q;
2702 
2703  register ssize_t
2704  x;
2705 
2706  register Quantum
2707  *magick_restrict r;
2708 
2709  p=GetVirtualPixels(left_image,-x_offset,y-y_offset,image->columns,1,
2710  exception);
2711  q=GetVirtualPixels(right_image,0,y,right_image->columns,1,exception);
2712  r=QueueAuthenticPixels(stereo_image,0,y,stereo_image->columns,1,exception);
2713  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL) ||
2714  (r == (Quantum *) NULL))
2715  break;
2716  for (x=0; x < (ssize_t) stereo_image->columns; x++)
2717  {
2718  SetPixelRed(stereo_image,GetPixelRed(left_image,p),r);
2719  SetPixelGreen(stereo_image,GetPixelGreen(right_image,q),r);
2720  SetPixelBlue(stereo_image,GetPixelBlue(right_image,q),r);
2721  if ((GetPixelAlphaTraits(stereo_image) & CopyPixelTrait) != 0)
2722  SetPixelAlpha(stereo_image,(GetPixelAlpha(left_image,p)+
2723  GetPixelAlpha(right_image,q))/2,r);
2724  p+=GetPixelChannels(left_image);
2725  q+=GetPixelChannels(right_image);
2726  r+=GetPixelChannels(stereo_image);
2727  }
2728  if (SyncAuthenticPixels(stereo_image,exception) == MagickFalse)
2729  break;
2730  if (image->progress_monitor != (MagickProgressMonitor) NULL)
2731  {
2733  proceed;
2734 
2736  stereo_image->rows);
2737  if (proceed == MagickFalse)
2738  status=MagickFalse;
2739  }
2740  }
2741  if (status == MagickFalse)
2742  stereo_image=DestroyImage(stereo_image);
2743  return(stereo_image);
2744 }
2745 
2746 /*
2747 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2748 % %
2749 % %
2750 % %
2751 % S w i r l I m a g e %
2752 % %
2753 % %
2754 % %
2755 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2756 %
2757 % SwirlImage() swirls the pixels about the center of the image, where
2758 % degrees indicates the sweep of the arc through which each pixel is moved.
2759 % You get a more dramatic effect as the degrees move from 1 to 360.
2760 %
2761 % The format of the SwirlImage method is:
2762 %
2763 % Image *SwirlImage(const Image *image,double degrees,
2764 % const PixelInterpolateMethod method,ExceptionInfo *exception)
2765 %
2766 % A description of each parameter follows:
2767 %
2768 % o image: the image.
2769 %
2770 % o degrees: Define the tightness of the swirling effect.
2771 %
2772 % o method: the pixel interpolation method.
2773 %
2774 % o exception: return any errors or warnings in this structure.
2775 %
2776 */
2777 MagickExport Image *SwirlImage(const Image *image,double degrees,
2778  const PixelInterpolateMethod method,ExceptionInfo *exception)
2779 {
2780 #define SwirlImageTag "Swirl/Image"
2781 
2782  CacheView
2783  *canvas_view,
2784  *interpolate_view,
2785  *swirl_view;
2786 
2787  double
2788  radius;
2789 
2790  Image
2791  *canvas_image,
2792  *swirl_image;
2793 
2795  status;
2796 
2798  progress;
2799 
2800  PointInfo
2801  center,
2802  scale;
2803 
2804  ssize_t
2805  y;
2806 
2807  /*
2808  Initialize swirl image attributes.
2809  */
2810  assert(image != (const Image *) NULL);
2811  assert(image->signature == MagickCoreSignature);
2812  if (image->debug != MagickFalse)
2813  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2814  assert(exception != (ExceptionInfo *) NULL);
2815  assert(exception->signature == MagickCoreSignature);
2816  canvas_image=CloneImage(image,0,0,MagickTrue,exception);
2817  if (canvas_image == (Image *) NULL)
2818  return((Image *) NULL);
2819  swirl_image=CloneImage(canvas_image,0,0,MagickTrue,exception);
2820  if (swirl_image == (Image *) NULL)
2821  {
2822  canvas_image=DestroyImage(canvas_image);
2823  return((Image *) NULL);
2824  }
2825  if (SetImageStorageClass(swirl_image,DirectClass,exception) == MagickFalse)
2826  {
2827  canvas_image=DestroyImage(canvas_image);
2828  swirl_image=DestroyImage(swirl_image);
2829  return((Image *) NULL);
2830  }
2831  if (swirl_image->background_color.alpha_trait != UndefinedPixelTrait)
2832  (void) SetImageAlphaChannel(swirl_image,OnAlphaChannel,exception);
2833  /*
2834  Compute scaling factor.
2835  */
2836  center.x=(double) canvas_image->columns/2.0;
2837  center.y=(double) canvas_image->rows/2.0;
2838  radius=MagickMax(center.x,center.y);
2839  scale.x=1.0;
2840  scale.y=1.0;
2841  if (canvas_image->columns > canvas_image->rows)
2842  scale.y=(double) canvas_image->columns/(double) canvas_image->rows;
2843  else
2844  if (canvas_image->columns < canvas_image->rows)
2845  scale.x=(double) canvas_image->rows/(double) canvas_image->columns;
2846  degrees=(double) DegreesToRadians(degrees);
2847  /*
2848  Swirl image.
2849  */
2850  status=MagickTrue;
2851  progress=0;
2852  canvas_view=AcquireVirtualCacheView(canvas_image,exception);
2853  interpolate_view=AcquireVirtualCacheView(image,exception);
2854  swirl_view=AcquireAuthenticCacheView(swirl_image,exception);
2855 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2856  #pragma omp parallel for schedule(static) shared(progress,status) \
2857  magick_number_threads(canvas_image,swirl_image,canvas_image->rows,1)
2858 #endif
2859  for (y=0; y < (ssize_t) canvas_image->rows; y++)
2860  {
2861  double
2862  distance;
2863 
2864  PointInfo
2865  delta;
2866 
2867  register const Quantum
2868  *magick_restrict p;
2869 
2870  register ssize_t
2871  x;
2872 
2873  register Quantum
2874  *magick_restrict q;
2875 
2876  if (status == MagickFalse)
2877  continue;
2878  p=GetCacheViewVirtualPixels(canvas_view,0,y,canvas_image->columns,1,
2879  exception);
2880  q=QueueCacheViewAuthenticPixels(swirl_view,0,y,swirl_image->columns,1,
2881  exception);
2882  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
2883  {
2884  status=MagickFalse;
2885  continue;
2886  }
2887  delta.y=scale.y*(double) (y-center.y);
2888  for (x=0; x < (ssize_t) canvas_image->columns; x++)
2889  {
2890  /*
2891  Determine if the pixel is within an ellipse.
2892  */
2893  delta.x=scale.x*(double) (x-center.x);
2894  distance=delta.x*delta.x+delta.y*delta.y;
2895  if (distance >= (radius*radius))
2896  {
2897  register ssize_t
2898  i;
2899 
2900  for (i=0; i < (ssize_t) GetPixelChannels(canvas_image); i++)
2901  {
2902  PixelChannel channel = GetPixelChannelChannel(canvas_image,i);
2903  PixelTrait traits = GetPixelChannelTraits(canvas_image,channel);
2904  PixelTrait swirl_traits = GetPixelChannelTraits(swirl_image,
2905  channel);
2906  if ((traits == UndefinedPixelTrait) ||
2907  (swirl_traits == UndefinedPixelTrait))
2908  continue;
2909  SetPixelChannel(swirl_image,channel,p[i],q);
2910  }
2911  }
2912  else
2913  {
2914  double
2915  cosine,
2916  factor,
2917  sine;
2918 
2919  /*
2920  Swirl the pixel.
2921  */
2922  factor=1.0-sqrt((double) distance)/radius;
2923  sine=sin((double) (degrees*factor*factor));
2924  cosine=cos((double) (degrees*factor*factor));
2925  status=InterpolatePixelChannels(canvas_image,interpolate_view,
2926  swirl_image,method,((cosine*delta.x-sine*delta.y)/scale.x+center.x),
2927  (double) ((sine*delta.x+cosine*delta.y)/scale.y+center.y),q,
2928  exception);
2929  if (status == MagickFalse)
2930  break;
2931  }
2932  p+=GetPixelChannels(canvas_image);
2933  q+=GetPixelChannels(swirl_image);
2934  }
2935  if (SyncCacheViewAuthenticPixels(swirl_view,exception) == MagickFalse)
2936  status=MagickFalse;
2937  if (canvas_image->progress_monitor != (MagickProgressMonitor) NULL)
2938  {
2940  proceed;
2941 
2942 #if defined(MAGICKCORE_OPENMP_SUPPORT)
2943  #pragma omp atomic
2944 #endif
2945  progress++;
2946  proceed=SetImageProgress(canvas_image,SwirlImageTag,progress,
2947  canvas_image->rows);
2948  if (proceed == MagickFalse)
2949  status=MagickFalse;
2950  }
2951  }
2952  swirl_view=DestroyCacheView(swirl_view);
2953  interpolate_view=DestroyCacheView(interpolate_view);
2954  canvas_view=DestroyCacheView(canvas_view);
2955  canvas_image=DestroyImage(canvas_image);
2956  if (status == MagickFalse)
2957  swirl_image=DestroyImage(swirl_image);
2958  return(swirl_image);
2959 }
2960 
2961 /*
2962 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2963 % %
2964 % %
2965 % %
2966 % T i n t I m a g e %
2967 % %
2968 % %
2969 % %
2970 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2971 %
2972 % TintImage() applies a color vector to each pixel in the image. The length
2973 % of the vector is 0 for black and white and at its maximum for the midtones.
2974 % The vector weighting function is f(x)=(1-(4.0*((x-0.5)*(x-0.5))))
2975 %
2976 % The format of the TintImage method is:
2977 %
2978 % Image *TintImage(const Image *image,const char *blend,
2979 % const PixelInfo *tint,ExceptionInfo *exception)
2980 %
2981 % A description of each parameter follows:
2982 %
2983 % o image: the image.
2984 %
2985 % o blend: A color value used for tinting.
2986 %
2987 % o tint: A color value used for tinting.
2988 %
2989 % o exception: return any errors or warnings in this structure.
2990 %
2991 */
2992 MagickExport Image *TintImage(const Image *image,const char *blend,
2993  const PixelInfo *tint,ExceptionInfo *exception)
2994 {
2995 #define TintImageTag "Tint/Image"
2996 
2997  CacheView
2998  *image_view,
2999  *tint_view;
3000 
3001  double
3002  intensity;
3003 
3004  GeometryInfo
3005  geometry_info;
3006 
3007  Image
3008  *tint_image;
3009 
3011  status;
3012 
3014  progress;
3015 
3016  PixelInfo
3017  color_vector;
3018 
3020  flags;
3021 
3022  ssize_t
3023  y;
3024 
3025  /*
3026  Allocate tint image.
3027  */
3028  assert(image != (const Image *) NULL);
3029  assert(image->signature == MagickCoreSignature);
3030  if (image->debug != MagickFalse)
3031  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3032  assert(exception != (ExceptionInfo *) NULL);
3033  assert(exception->signature == MagickCoreSignature);
3034  tint_image=CloneImage(image,0,0,MagickTrue,exception);
3035  if (tint_image == (Image *) NULL)
3036  return((Image *) NULL);
3037  if (SetImageStorageClass(tint_image,DirectClass,exception) == MagickFalse)
3038  {
3039  tint_image=DestroyImage(tint_image);
3040  return((Image *) NULL);
3041  }
3042  if ((IsGrayColorspace(image->colorspace) != MagickFalse) &&
3043  (IsPixelInfoGray(tint) == MagickFalse))
3044  (void) SetImageColorspace(tint_image,sRGBColorspace,exception);
3045  if (blend == (const char *) NULL)
3046  return(tint_image);
3047  /*
3048  Determine RGB values of the color.
3049  */
3050  GetPixelInfo(image,&color_vector);
3051  flags=ParseGeometry(blend,&geometry_info);
3052  color_vector.red=geometry_info.rho;
3053  color_vector.green=geometry_info.rho;
3054  color_vector.blue=geometry_info.rho;
3055  color_vector.alpha=(MagickRealType) OpaqueAlpha;
3056  if ((flags & SigmaValue) != 0)
3057  color_vector.green=geometry_info.sigma;
3058  if ((flags & XiValue) != 0)
3059  color_vector.blue=geometry_info.xi;
3060  if ((flags & PsiValue) != 0)
3061  color_vector.alpha=geometry_info.psi;
3062  if (image->colorspace == CMYKColorspace)
3063  {
3064  color_vector.black=geometry_info.rho;
3065  if ((flags & PsiValue) != 0)
3066  color_vector.black=geometry_info.psi;
3067  if ((flags & ChiValue) != 0)
3068  color_vector.alpha=geometry_info.chi;
3069  }
3070  intensity=(double) GetPixelInfoIntensity((const Image *) NULL,tint);
3071  color_vector.red=(double) (color_vector.red*tint->red/100.0-intensity);
3072  color_vector.green=(double) (color_vector.green*tint->green/100.0-intensity);
3073  color_vector.blue=(double) (color_vector.blue*tint->blue/100.0-intensity);
3074  color_vector.black=(double) (color_vector.black*tint->black/100.0-intensity);
3075  color_vector.alpha=(double) (color_vector.alpha*tint->alpha/100.0-intensity);
3076  /*
3077  Tint image.
3078  */
3079  status=MagickTrue;
3080  progress=0;
3081  image_view=AcquireVirtualCacheView(image,exception);
3082  tint_view=AcquireAuthenticCacheView(tint_image,exception);
3083 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3084  #pragma omp parallel for schedule(static) shared(progress,status) \
3085  magick_number_threads(image,tint_image,image->rows,1)
3086 #endif
3087  for (y=0; y < (ssize_t) image->rows; y++)
3088  {
3089  register const Quantum
3090  *magick_restrict p;
3091 
3092  register Quantum
3093  *magick_restrict q;
3094 
3095  register ssize_t
3096  x;
3097 
3098  if (status == MagickFalse)
3099  continue;
3100  p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
3101  q=QueueCacheViewAuthenticPixels(tint_view,0,y,tint_image->columns,1,
3102  exception);
3103  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
3104  {
3105  status=MagickFalse;
3106  continue;
3107  }
3108  for (x=0; x < (ssize_t) image->columns; x++)
3109  {
3110  PixelInfo
3111  pixel;
3112 
3113  double
3114  weight;
3115 
3116  GetPixelInfo(image,&pixel);
3117  weight=QuantumScale*GetPixelRed(image,p)-0.5;
3118  pixel.red=(MagickRealType) GetPixelRed(image,p)+color_vector.red*
3119  (1.0-(4.0*(weight*weight)));
3120  weight=QuantumScale*GetPixelGreen(image,p)-0.5;
3121  pixel.green=(MagickRealType) GetPixelGreen(image,p)+color_vector.green*
3122  (1.0-(4.0*(weight*weight)));
3123  weight=QuantumScale*GetPixelBlue(image,p)-0.5;
3124  pixel.blue=(MagickRealType) GetPixelBlue(image,p)+color_vector.blue*
3125  (1.0-(4.0*(weight*weight)));
3126  weight=QuantumScale*GetPixelBlack(image,p)-0.5;
3127  pixel.black=(MagickRealType) GetPixelBlack(image,p)+color_vector.black*
3128  (1.0-(4.0*(weight*weight)));
3129  pixel.alpha=(MagickRealType) GetPixelAlpha(image,p);
3130  SetPixelViaPixelInfo(tint_image,&pixel,q);
3131  p+=GetPixelChannels(image);
3132  q+=GetPixelChannels(tint_image);
3133  }
3134  if (SyncCacheViewAuthenticPixels(tint_view,exception) == MagickFalse)
3135  status=MagickFalse;
3136  if (image->progress_monitor != (MagickProgressMonitor) NULL)
3137  {
3139  proceed;
3140 
3141 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3142  #pragma omp atomic
3143 #endif
3144  progress++;
3145  proceed=SetImageProgress(image,TintImageTag,progress,image->rows);
3146  if (proceed == MagickFalse)
3147  status=MagickFalse;
3148  }
3149  }
3150  tint_view=DestroyCacheView(tint_view);
3151  image_view=DestroyCacheView(image_view);
3152  if (status == MagickFalse)
3153  tint_image=DestroyImage(tint_image);
3154  return(tint_image);
3155 }
3156 
3157 /*
3158 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3159 % %
3160 % %
3161 % %
3162 % V i g n e t t e I m a g e %
3163 % %
3164 % %
3165 % %
3166 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3167 %
3168 % VignetteImage() softens the edges of the image in vignette style.
3169 %
3170 % The format of the VignetteImage method is:
3171 %
3172 % Image *VignetteImage(const Image *image,const double radius,
3173 % const double sigma,const ssize_t x,const ssize_t y,
3174 % ExceptionInfo *exception)
3175 %
3176 % A description of each parameter follows:
3177 %
3178 % o image: the image.
3179 %
3180 % o radius: the radius of the pixel neighborhood.
3181 %
3182 % o sigma: the standard deviation of the Gaussian, in pixels.
3183 %
3184 % o x, y: Define the x and y ellipse offset.
3185 %
3186 % o exception: return any errors or warnings in this structure.
3187 %
3188 */
3189 MagickExport Image *VignetteImage(const Image *image,const double radius,
3190  const double sigma,const ssize_t x,const ssize_t y,ExceptionInfo *exception)
3191 {
3192  char
3193  ellipse[MagickPathExtent];
3194 
3195  DrawInfo
3196  *draw_info;
3197 
3198  Image
3199  *canvas,
3200  *blur_image,
3201  *oval_image,
3202  *vignette_image;
3203 
3204  assert(image != (Image *) NULL);
3205  assert(image->signature == MagickCoreSignature);
3206  if (image->debug != MagickFalse)
3207  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3208  assert(exception != (ExceptionInfo *) NULL);
3209  assert(exception->signature == MagickCoreSignature);
3210  canvas=CloneImage(image,0,0,MagickTrue,exception);
3211  if (canvas == (Image *) NULL)
3212  return((Image *) NULL);
3213  if (SetImageStorageClass(canvas,DirectClass,exception) == MagickFalse)
3214  {
3215  canvas=DestroyImage(canvas);
3216  return((Image *) NULL);
3217  }
3218  canvas->alpha_trait=BlendPixelTrait;
3219  oval_image=CloneImage(canvas,canvas->columns,canvas->rows,MagickTrue,
3220  exception);
3221  if (oval_image == (Image *) NULL)
3222  {
3223  canvas=DestroyImage(canvas);
3224  return((Image *) NULL);
3225  }
3226  (void) QueryColorCompliance("#000000",AllCompliance,
3227  &oval_image->background_color,exception);
3228  (void) SetImageBackgroundColor(oval_image,exception);
3229  draw_info=CloneDrawInfo((const ImageInfo *) NULL,(const DrawInfo *) NULL);
3230  (void) QueryColorCompliance("#ffffff",AllCompliance,&draw_info->fill,
3231  exception);
3232  (void) QueryColorCompliance("#ffffff",AllCompliance,&draw_info->stroke,
3233  exception);
3234  (void) FormatLocaleString(ellipse,MagickPathExtent,"ellipse %g,%g,%g,%g,"
3235  "0.0,360.0",image->columns/2.0,image->rows/2.0,image->columns/2.0-x,
3236  image->rows/2.0-y);
3237  draw_info->primitive=AcquireString(ellipse);
3238  (void) DrawImage(oval_image,draw_info,exception);
3239  draw_info=DestroyDrawInfo(draw_info);
3240  blur_image=BlurImage(oval_image,radius,sigma,exception);
3241  oval_image=DestroyImage(oval_image);
3242  if (blur_image == (Image *) NULL)
3243  {
3244  canvas=DestroyImage(canvas);
3245  return((Image *) NULL);
3246  }
3247  blur_image->alpha_trait=UndefinedPixelTrait;
3248  (void) CompositeImage(canvas,blur_image,IntensityCompositeOp,MagickTrue,
3249  0,0,exception);
3250  blur_image=DestroyImage(blur_image);
3251  vignette_image=MergeImageLayers(canvas,FlattenLayer,exception);
3252  canvas=DestroyImage(canvas);
3253  if (vignette_image != (Image *) NULL)
3254  (void) TransformImageColorspace(vignette_image,image->colorspace,exception);
3255  return(vignette_image);
3256 }
3257 
3258 /*
3259 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3260 % %
3261 % %
3262 % %
3263 % W a v e I m a g e %
3264 % %
3265 % %
3266 % %
3267 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3268 %
3269 % WaveImage() creates a "ripple" effect in the image by shifting the pixels
3270 % vertically along a sine wave whose amplitude and wavelength is specified
3271 % by the given parameters.
3272 %
3273 % The format of the WaveImage method is:
3274 %
3275 % Image *WaveImage(const Image *image,const double amplitude,
3276 % const double wave_length,const PixelInterpolateMethod method,
3277 % ExceptionInfo *exception)
3278 %
3279 % A description of each parameter follows:
3280 %
3281 % o image: the image.
3282 %
3283 % o amplitude, wave_length: Define the amplitude and wave length of the
3284 % sine wave.
3285 %
3286 % o interpolate: the pixel interpolation method.
3287 %
3288 % o exception: return any errors or warnings in this structure.
3289 %
3290 */
3291 MagickExport Image *WaveImage(const Image *image,const double amplitude,
3292  const double wave_length,const PixelInterpolateMethod method,
3293  ExceptionInfo *exception)
3294 {
3295 #define WaveImageTag "Wave/Image"
3296 
3297  CacheView
3298  *canvas_image_view,
3299  *wave_view;
3300 
3301  float
3302  *sine_map;
3303 
3304  Image
3305  *canvas_image,
3306  *wave_image;
3307 
3309  status;
3310 
3312  progress;
3313 
3314  register ssize_t
3315  i;
3316 
3317  ssize_t
3318  y;
3319 
3320  /*
3321  Initialize wave image attributes.
3322  */
3323  assert(image != (Image *) NULL);
3324  assert(image->signature == MagickCoreSignature);
3325  if (image->debug != MagickFalse)
3326  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3327  assert(exception != (ExceptionInfo *) NULL);
3328  assert(exception->signature == MagickCoreSignature);
3329  canvas_image=CloneImage(image,0,0,MagickTrue,exception);
3330  if (canvas_image == (Image *) NULL)
3331  return((Image *) NULL);
3332  if ((canvas_image->alpha_trait == UndefinedPixelTrait) &&
3333  (canvas_image->background_color.alpha != OpaqueAlpha))
3334  (void) SetImageAlpha(canvas_image,OpaqueAlpha,exception);
3335  wave_image=CloneImage(canvas_image,canvas_image->columns,(size_t)
3336  (canvas_image->rows+2.0*fabs(amplitude)),MagickTrue,exception);
3337  if (wave_image == (Image *) NULL)
3338  {
3339  canvas_image=DestroyImage(canvas_image);
3340  return((Image *) NULL);
3341  }
3342  if (SetImageStorageClass(wave_image,DirectClass,exception) == MagickFalse)
3343  {
3344  canvas_image=DestroyImage(canvas_image);
3345  wave_image=DestroyImage(wave_image);
3346  return((Image *) NULL);
3347  }
3348  /*
3349  Allocate sine map.
3350  */
3351  sine_map=(float *) AcquireQuantumMemory((size_t) wave_image->columns,
3352  sizeof(*sine_map));
3353  if (sine_map == (float *) NULL)
3354  {
3355  canvas_image=DestroyImage(canvas_image);
3356  wave_image=DestroyImage(wave_image);
3357  ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3358  }
3359  for (i=0; i < (ssize_t) wave_image->columns; i++)
3360  sine_map[i]=(float) fabs(amplitude)+amplitude*sin((double)
3361  ((2.0*MagickPI*i)/wave_length));
3362  /*
3363  Wave image.
3364  */
3365  status=MagickTrue;
3366  progress=0;
3367  canvas_image_view=AcquireVirtualCacheView(canvas_image,exception);
3368  wave_view=AcquireAuthenticCacheView(wave_image,exception);
3369  (void) SetCacheViewVirtualPixelMethod(canvas_image_view,
3371 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3372  #pragma omp parallel for schedule(static) shared(progress,status) \
3373  magick_number_threads(canvas_image,wave_image,wave_image->rows,1)
3374 #endif
3375  for (y=0; y < (ssize_t) wave_image->rows; y++)
3376  {
3377  register const Quantum
3378  *magick_restrict p;
3379 
3380  register Quantum
3381  *magick_restrict q;
3382 
3383  register ssize_t
3384  x;
3385 
3386  if (status == MagickFalse)
3387  continue;
3388  p=GetCacheViewVirtualPixels(canvas_image_view,0,y,canvas_image->columns,1,
3389  exception);
3390  q=QueueCacheViewAuthenticPixels(wave_view,0,y,wave_image->columns,1,
3391  exception);
3392  if ((p == (const Quantum *) NULL) || (q == (Quantum *) NULL))
3393  {
3394  status=MagickFalse;
3395  continue;
3396  }
3397  for (x=0; x < (ssize_t) wave_image->columns; x++)
3398  {
3399  status=InterpolatePixelChannels(canvas_image,canvas_image_view,
3400  wave_image,method,(double) x,(double) (y-sine_map[x]),q,exception);
3401  if (status == MagickFalse)
3402  break;
3403  p+=GetPixelChannels(canvas_image);
3404  q+=GetPixelChannels(wave_image);
3405  }
3406  if (SyncCacheViewAuthenticPixels(wave_view,exception) == MagickFalse)
3407  status=MagickFalse;
3408  if (image->progress_monitor != (MagickProgressMonitor) NULL)
3409  {
3411  proceed;
3412 
3413 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3414  #pragma omp atomic
3415 #endif
3416  progress++;
3417  proceed=SetImageProgress(canvas_image,WaveImageTag,progress,
3418  canvas_image->rows);
3419  if (proceed == MagickFalse)
3420  status=MagickFalse;
3421  }
3422  }
3423  wave_view=DestroyCacheView(wave_view);
3424  canvas_image_view=DestroyCacheView(canvas_image_view);
3425  canvas_image=DestroyImage(canvas_image);
3426  sine_map=(float *) RelinquishMagickMemory(sine_map);
3427  if (status == MagickFalse)
3428  wave_image=DestroyImage(wave_image);
3429  return(wave_image);
3430 }
3431 
3432 /*
3433 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3434 % %
3435 % %
3436 % %
3437 % W a v e l e t D e n o i s e I m a g e %
3438 % %
3439 % %
3440 % %
3441 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3442 %
3443 % WaveletDenoiseImage() removes noise from the image using a wavelet
3444 % transform. The wavelet transform is a fast hierarchical scheme for
3445 % processing an image using a set of consecutive lowpass and high_pass filters,
3446 % followed by a decimation. This results in a decomposition into different
3447 % scales which can be regarded as different “frequency bands”, determined by
3448 % the mother wavelet. Adapted from dcraw.c by David Coffin.
3449 %
3450 % The format of the WaveletDenoiseImage method is:
3451 %
3452 % Image *WaveletDenoiseImage(const Image *image,const double threshold,
3453 % const double softness,ExceptionInfo *exception)
3454 %
3455 % A description of each parameter follows:
3456 %
3457 % o image: the image.
3458 %
3459 % o threshold: set the threshold for smoothing.
3460 %
3461 % o softness: attenuate the smoothing threshold.
3462 %
3463 % o exception: return any errors or warnings in this structure.
3464 %
3465 */
3466 
3467 static inline void HatTransform(const float *magick_restrict pixels,
3468  const size_t stride,const size_t extent,const size_t scale,float *kernel)
3469 {
3470  const float
3471  *magick_restrict p,
3472  *magick_restrict q,
3473  *magick_restrict r;
3474 
3475  register ssize_t
3476  i;
3477 
3478  p=pixels;
3479  q=pixels+scale*stride;
3480  r=pixels+scale*stride;
3481  for (i=0; i < (ssize_t) scale; i++)
3482  {
3483  kernel[i]=0.25f*(*p+(*p)+(*q)+(*r));
3484  p+=stride;
3485  q-=stride;
3486  r+=stride;
3487  }
3488  for ( ; i < (ssize_t) (extent-scale); i++)
3489  {
3490  kernel[i]=0.25f*(2.0f*(*p)+*(p-scale*stride)+*(p+scale*stride));
3491  p+=stride;
3492  }
3493  q=p-scale*stride;
3494  r=pixels+stride*(extent-2);
3495  for ( ; i < (ssize_t) extent; i++)
3496  {
3497  kernel[i]=0.25f*(*p+(*p)+(*q)+(*r));
3498  p+=stride;
3499  q+=stride;
3500  r-=stride;
3501  }
3502 }
3503 
3505  const double threshold,const double softness,ExceptionInfo *exception)
3506 {
3507  CacheView
3508  *image_view,
3509  *noise_view;
3510 
3511  float
3512  *kernel,
3513  *pixels;
3514 
3515  Image
3516  *noise_image;
3517 
3519  status;
3520 
3522  number_pixels;
3523 
3524  MemoryInfo
3525  *pixels_info;
3526 
3527  ssize_t
3528  channel;
3529 
3530  static const float
3531  noise_levels[] = { 0.8002f, 0.2735f, 0.1202f, 0.0585f, 0.0291f, 0.0152f,
3532  0.0080f, 0.0044f };
3533 
3534  /*
3535  Initialize noise image attributes.
3536  */
3537  assert(image != (const Image *) NULL);
3538  assert(image->signature == MagickCoreSignature);
3539  if (image->debug != MagickFalse)
3540  (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
3541  assert(exception != (ExceptionInfo *) NULL);
3542  assert(exception->signature == MagickCoreSignature);
3543 #if defined(MAGICKCORE_OPENCL_SUPPORT)
3544  noise_image=AccelerateWaveletDenoiseImage(image,threshold,exception);
3545  if (noise_image != (Image *) NULL)
3546  return(noise_image);
3547 #endif
3548  noise_image=CloneImage(image,0,0,MagickTrue,exception);
3549  if (noise_image == (Image *) NULL)
3550  return((Image *) NULL);
3551  if (SetImageStorageClass(noise_image,DirectClass,exception) == MagickFalse)
3552  {
3553  noise_image=DestroyImage(noise_image);
3554  return((Image *) NULL);
3555  }
3557  ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3558  pixels_info=AcquireVirtualMemory(3*image->columns,image->rows*
3559  sizeof(*pixels));
3560  kernel=(float *) AcquireQuantumMemory(MagickMax(image->rows,image->columns)+1,
3561  GetOpenMPMaximumThreads()*sizeof(*kernel));
3562  if ((pixels_info == (MemoryInfo *) NULL) || (kernel == (float *) NULL))
3563  {
3564  if (kernel != (float *) NULL)
3565  kernel=(float *) RelinquishMagickMemory(kernel);
3566  if (pixels_info != (MemoryInfo *) NULL)
3567  pixels_info=RelinquishVirtualMemory(pixels_info);
3568  ThrowImageException(ResourceLimitError,"MemoryAllocationFailed");
3569  }
3570  pixels=(float *) GetVirtualMemoryBlob(pixels_info);
3571  status=MagickTrue;
3572  number_pixels=(MagickSizeType) image->columns*image->rows;
3573  image_view=AcquireAuthenticCacheView(image,exception);
3574  noise_view=AcquireAuthenticCacheView(noise_image,exception);
3575  for (channel=0; channel < (ssize_t) GetPixelChannels(image); channel++)
3576  {
3577  register ssize_t
3578  i;
3579 
3580  size_t
3581  high_pass,
3582  low_pass;
3583 
3584  ssize_t
3585  level,
3586  y;
3587 
3588  PixelChannel
3589  pixel_channel;
3590 
3591  PixelTrait
3592  traits;
3593 
3594  if (status == MagickFalse)
3595  continue;
3596  traits=GetPixelChannelTraits(image,(PixelChannel) channel);
3597  if (traits == UndefinedPixelTrait)
3598  continue;
3599  pixel_channel=GetPixelChannelChannel(image,channel);
3600  if ((pixel_channel != RedPixelChannel) &&
3601  (pixel_channel != GreenPixelChannel) &&
3602  (pixel_channel != BluePixelChannel))
3603  continue;
3604  /*
3605  Copy channel from image to wavelet pixel array.
3606  */
3607  i=0;
3608  for (y=0; y < (ssize_t) image->rows; y++)
3609  {
3610  register const Quantum
3611  *magick_restrict p;
3612 
3613  ssize_t
3614  x;
3615 
3616  p=GetCacheViewAuthenticPixels(image_view,0,y,image->columns,1,exception);
3617  if (p == (const Quantum *) NULL)
3618  {
3619  status=MagickFalse;
3620  break;
3621  }
3622  for (x=0; x < (ssize_t) image->columns; x++)
3623  {
3624  pixels[i++]=(float) p[channel];
3625  p+=GetPixelChannels(image);
3626  }
3627  }
3628  /*
3629  Low pass filter outputs are called approximation kernel & high pass
3630  filters are referred to as detail kernel. The detail kernel
3631  have high values in the noisy parts of the signal.
3632  */
3633  high_pass=0;
3634  for (level=0; level < 5; level++)
3635  {
3636  double
3637  magnitude;
3638 
3639  ssize_t
3640  x,
3641  y;
3642 
3643  low_pass=(size_t) (number_pixels*((level & 0x01)+1));
3644 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3645  #pragma omp parallel for schedule(static,1) \
3646  magick_number_threads(image,image,image->rows,1)
3647 #endif
3648  for (y=0; y < (ssize_t) image->rows; y++)
3649  {
3650  const int
3651  id = GetOpenMPThreadId();
3652 
3653  register float
3654  *magick_restrict p,
3655  *magick_restrict q;
3656 
3657  register ssize_t
3658  x;
3659 
3660  p=kernel+id*image->columns;
3661  q=pixels+y*image->columns;
3662  HatTransform(q+high_pass,1,image->columns,(size_t) (1UL << level),p);
3663  q+=low_pass;
3664  for (x=0; x < (ssize_t) image->columns; x++)
3665  *q++=(*p++);
3666  }
3667 #if defined(MAGICKCORE_OPENMP_SUPPORT)
3668  #pragma omp parallel for schedule(static,1) \
3669  magick_number_threads(image,image,image->columns,1)
3670 #endif
3671  for (x=0; x < (ssize_t) image->columns; x++)
3672  {
3673  const int
3674  id = GetOpenMPThreadId();
3675 
3676  register float
3677  *magick_restrict p,
3678  *magick_restrict q;
3679 
3680  register ssize_t
3681  y;
3682 
3683  p=kernel+id*image->rows;
3684  q=pixels+x+low_pass;
3685  HatTransform(q,image->columns,image->rows,(size_t) (1UL << level),p);
3686  for (y=0; y < (ssize_t) image->rows; y++)
3687  {
3688  *q=(*p++);
3689  q+=image->columns;
3690  }
3691  }
3692  /*
3693  To threshold, each coefficient is compared to a threshold value and
3694  attenuated / shrunk by some factor.
3695  */
3696  magnitude=threshold*noise_levels[level];
3697  for (i=0; i < (ssize_t) number_pixels; ++i)
3698  {
3699  pixels[high_pass+i]-=pixels[low_pass+i];
3700  if (pixels[high_pass+i] < -magnitude)
3701  pixels[high_pass+i]+=magnitude-softness*magnitude;
3702  else
3703  if (pixels[high_pass+i] > magnitude)
3704  pixels[high_pass+i]-=magnitude-softness*magnitude;
3705  else
3706  pixels[high_pass+i]*=softness;
3707  if (high_pass != 0)
3708  pixels[i]+=pixels[high_pass+i];
3709  }
3710  high_pass=low_pass;
3711  }
3712  /*
3713  Reconstruct image from the thresholded wavelet kernel.
3714  */
3715  i=0;
3716  for (y=0; y < (ssize_t) image->rows; y++)
3717  {
3719  sync;
3720 
3721  register Quantum
3722  *magick_restrict q;
3723 
3724  register ssize_t
3725  x;
3726 
3727  ssize_t
3728  offset;
3729 
3730  q=GetCacheViewAuthenticPixels(noise_view,0,y,noise_image->columns,1,
3731  exception);
3732  if (q == (Quantum *) NULL)
3733  {
3734  status=MagickFalse;
3735  break;
3736  }
3737  offset=GetPixelChannelOffset(noise_image,pixel_channel);
3738  for (x=0; x < (ssize_t) image->columns; x++)
3739  {
3741  pixel;
3742 
3743  pixel=(MagickRealType) pixels[i]+pixels[low_pass+i];
3744  q[offset]=ClampToQuantum(pixel);
3745  i++;
3746  q+=GetPixelChannels(noise_image);
3747  }
3748  sync=SyncCacheViewAuthenticPixels(noise_view,exception);
3749  if (sync == MagickFalse)
3750  status=MagickFalse;
3751  }
3752  if (image->progress_monitor != (MagickProgressMonitor) NULL)
3753  {
3755  proceed;
3756 
3758  channel,GetPixelChannels(image));
3759  if (proceed == MagickFalse)
3760  status=MagickFalse;
3761  }
3762  }
3763  noise_view=DestroyCacheView(noise_view);
3764  image_view=DestroyCacheView(image_view);
3765  kernel=(float *) RelinquishMagickMemory(kernel);
3766  pixels_info=RelinquishVirtualMemory(pixels_info);
3767  if (status == MagickFalse)
3768  noise_image=DestroyImage(noise_image);
3769  return(noise_image);
3770 }
double psi
Definition: geometry.h:106
size_t rows
Definition: image.h:172
#define magick_restrict
Definition: MagickCore.h:41
MagickExport Image * ResizeImage(const Image *image, const size_t columns, const size_t rows, const FilterType filter, ExceptionInfo *exception)
Definition: resize.c:3705
MagickExport Image * BlurImage(const Image *image, const double radius, const double sigma, ExceptionInfo *exception)
Definition: effect.c:770
#define ColorMatrixImageTag
PixelInfo fill
Definition: draw.h:214
MagickDoubleType MagickRealType
Definition: magick-type.h:124
MagickExport MagickBooleanType NegateImage(Image *image, const MagickBooleanType grayscale, ExceptionInfo *exception)
Definition: enhance.c:3905
PixelIntensityMethod intensity
Definition: image.h:222
MagickExport CacheView * DestroyCacheView(CacheView *cache_view)
Definition: cache-view.c:252
MagickExport Image * MotionBlurImage(const Image *image, const double radius, const double sigma, const double angle, ExceptionInfo *exception)
Definition: effect.c:2009
#define TransparentAlpha
Definition: image.h:26
MagickExport Image * TintImage(const Image *image, const char *blend, const PixelInfo *tint, ExceptionInfo *exception)
static ssize_t GetPixelChannelOffset(const Image *magick_restrict image, const PixelChannel channel)
char * primitive
Definition: draw.h:204
double x2
Definition: image.h:107
PixelInfo * colormap
Definition: image.h:179
MagickExport MemoryInfo * RelinquishVirtualMemory(MemoryInfo *memory_info)
Definition: memory.c:1190
MagickProgressMonitor progress_monitor
Definition: image.h:303
MagickExport MagickBooleanType SyncImage(Image *image, ExceptionInfo *exception)
Definition: image.c:3868
static Quantum GetPixelAlpha(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
GravityType gravity
Definition: draw.h:285
MagickExport MagickBooleanType TransformImageColorspace(Image *image, const ColorspaceType colorspace, ExceptionInfo *exception)
Definition: colorspace.c:1503
FilterType filter
Definition: image.h:219
PixelTrait alpha_trait
Definition: pixel.h:178
MagickExport Image * WaveletDenoiseImage(const Image *image, const double threshold, const double softness, ExceptionInfo *exception)
static PixelTrait GetPixelAlphaTraits(const Image *magick_restrict image)
static Quantum GetPixelRed(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
MagickExport Image * ColorMatrixImage(const Image *image, const KernelInfo *color_matrix, ExceptionInfo *exception)
MagickExport Image * FlopImage(const Image *image, ExceptionInfo *exception)
Definition: transform.c:1321
size_t height
Definition: morphology.h:108
#define SteganoImageTag
PixelInfo border_color
Definition: image.h:179
PixelInterpolateMethod
Definition: pixel.h:110
MagickExport MemoryInfo * AcquireVirtualMemory(const size_t count, const size_t quantum)
Definition: memory.c:670
PixelInfo stroke
Definition: draw.h:214
size_t signature
Definition: exception.h:123
static size_t GetOpenMPMaximumThreads(void)
double rho
Definition: geometry.h:106
MagickExport Image * PolaroidImage(const Image *image, const DrawInfo *draw_info, const char *caption, const double angle, const PixelInterpolateMethod method, ExceptionInfo *exception)
MagickExport MagickBooleanType GetOneCacheViewVirtualPixelInfo(const CacheView *cache_view, const ssize_t x, const ssize_t y, PixelInfo *pixel, ExceptionInfo *exception)
Definition: cache-view.c:846
MagickExport MagickBooleanType SetImageArtifact(Image *image, const char *artifact, const char *value)
Definition: artifact.c:445
#define OpaqueAlpha
Definition: image.h:25
MagickPrivate double GenerateDifferentialNoise(RandomInfo *, const Quantum, const NoiseType, const double)
Definition: gem.c:1494
static Quantum GetPixelChannel(const Image *magick_restrict image, const PixelChannel channel, const Quantum *magick_restrict pixel)
static void HatTransform(const float *magick_restrict pixels, const size_t stride, const size_t extent, const size_t scale, float *kernel)
MagickExport MagickBooleanType InterpolatePixelChannels(const Image *magick_restrict source, const CacheView_ *source_view, const Image *magick_restrict destination, const PixelInterpolateMethod method, const double x, const double y, Quantum *pixel, ExceptionInfo *exception)
Definition: pixel.c:4917
MagickRealType red
Definition: pixel.h:190
MagickExport MagickBooleanType SetImageAlpha(Image *image, const Quantum alpha, ExceptionInfo *exception)
Definition: image.c:2316
static RandomInfo ** DestroyRandomInfoThreadSet(RandomInfo **random_info)
static PixelTrait GetPixelChannelTraits(const Image *magick_restrict image, const PixelChannel channel)
#define MagickPI
Definition: image-private.h:40
MagickExport Image * SepiaToneImage(const Image *image, const double threshold, ExceptionInfo *exception)
#define TintImageTag
MagickExport ssize_t FormatLocaleString(char *magick_restrict string, const size_t length, const char *magick_restrict format,...)
Definition: locale.c:499
static void SetPixelViaPixelInfo(const Image *magick_restrict image, const PixelInfo *magick_restrict pixel_info, Quantum *magick_restrict pixel)
static MagickBooleanType IsGrayColorspace(const ColorspaceType colorspace)
MagickExport Image * MergeImageLayers(Image *image, const LayerMethod method, ExceptionInfo *exception)
Definition: layer.c:1924
static Quantum PlasmaPixel(RandomInfo *magick_restrict random_info, const double pixel, const double noise)
#define MAGICKCORE_QUANTUM_DEPTH
Definition: magick-type.h:32
MagickExport const Quantum * GetCacheViewVirtualPixels(const CacheView *cache_view, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: cache-view.c:651
MagickExport MagickBooleanType GrayscaleImage(Image *image, const PixelIntensityMethod method, ExceptionInfo *exception)
Definition: enhance.c:2462
static RandomInfo ** AcquireRandomInfoThreadSet(void)
NoiseType
MagickRealType alpha
Definition: pixel.h:190
MagickExport MagickBooleanType PlasmaImage(Image *image, const SegmentInfo *segment, size_t attenuate, size_t depth, ExceptionInfo *exception)
#define MagickEpsilon
Definition: magick-type.h:114
double sigma
Definition: geometry.h:106
ClassType storage_class
Definition: image.h:154
MagickExport MagickBooleanType CompositeImage(Image *image, const Image *composite, const CompositeOperator compose, const MagickBooleanType clip_to_self, const ssize_t x_offset, const ssize_t y_offset, ExceptionInfo *exception)
Definition: composite.c:528
size_t width
Definition: geometry.h:130
MagickExport MagickBooleanType AcquireMagickResource(const ResourceType type, const MagickSizeType size)
Definition: resource.c:188
Definition: log.h:52
ssize_t MagickOffsetType
Definition: magick-type.h:133
MagickExport unsigned long GetRandomSecretKey(const RandomInfo *random_info)
Definition: random.c:741
MagickExport void GetPixelInfo(const Image *image, PixelInfo *pixel)
Definition: pixel.c:2170
static Quantum ClampToQuantum(const MagickRealType quantum)
Definition: quantum.h:85
Definition: image.h:151
MagickExport RandomInfo * DestroyRandomInfo(RandomInfo *random_info)
Definition: random.c:274
MagickExport Image * ImplodeImage(const Image *image, const double amount, const PixelInterpolateMethod method, ExceptionInfo *exception)
MagickExport MagickBooleanType ContrastImage(Image *image, const MagickBooleanType sharpen, ExceptionInfo *exception)
Definition: enhance.c:1398
double x
Definition: geometry.h:123
#define MagickCoreSignature
MagickExport Quantum * GetCacheViewAuthenticPixels(CacheView *cache_view, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: cache-view.c:299
MagickExport ssize_t FormatMagickCaption(Image *image, DrawInfo *draw_info, const MagickBooleanType split, TypeMetric *metrics, char **caption, ExceptionInfo *exception)
Definition: annotate.c:588
MagickExport Image * GetFirstImageInList(const Image *images)
Definition: list.c:561
#define BlueShiftImageTag
MagickExport MagickBooleanType SetImageAlphaChannel(Image *image, const AlphaChannelOption alpha_type, ExceptionInfo *exception)
Definition: channel.c:974
MagickBooleanType
Definition: magick-type.h:169
unsigned int MagickStatusType
Definition: magick-type.h:125
MagickExport char * AcquireString(const char *source)
Definition: string.c:129
MagickExport MagickBooleanType AnnotateImage(Image *image, const DrawInfo *draw_info, ExceptionInfo *exception)
Definition: annotate.c:222
double x1
Definition: image.h:107
double descent
Definition: draw.h:372
MagickExport const Quantum * GetVirtualPixels(const Image *image, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: cache.c:3237
MagickExport MagickBooleanType NormalizeImage(Image *image, ExceptionInfo *exception)
Definition: enhance.c:4095
MagickExport void * AcquireQuantumMemory(const size_t count, const size_t quantum)
Definition: memory.c:634
MagickExport Image * AddNoiseImage(const Image *image, const NoiseType noise_type, const double attenuate, ExceptionInfo *exception)
static double DegreesToRadians(const double degrees)
Definition: image-private.h:53
double y
Definition: geometry.h:123
static int GetOpenMPThreadId(void)
#define StereoImageTag
MagickExport Image * VignetteImage(const Image *image, const double radius, const double sigma, const ssize_t x, const ssize_t y, ExceptionInfo *exception)
RectangleInfo page
Definition: image.h:212
#define ImplodeImageTag
size_t MagickSizeType
Definition: magick-type.h:134
#define MagickPathExtent
MagickExport Image * ShadowImage(const Image *image, const double alpha, const double sigma, const ssize_t x_offset, const ssize_t y_offset, ExceptionInfo *exception)
static Quantum GetPixelGreen(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
static void GetPixelInfoPixel(const Image *magick_restrict image, const Quantum *magick_restrict pixel, PixelInfo *magick_restrict pixel_info)
MagickExport MagickBooleanType DrawImage(Image *image, const DrawInfo *draw_info, ExceptionInfo *exception)
Definition: draw.c:4438
PixelTrait alpha_trait
Definition: image.h:280
MagickRealType blue
Definition: pixel.h:190
MagickExport ChannelType SetPixelChannelMask(Image *image, const ChannelType channel_mask)
Definition: pixel.c:6280
static Quantum GetPixelBlack(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
MagickExport ChannelType SetImageChannelMask(Image *image, const ChannelType channel_mask)
Definition: image.c:2479
MagickExport Quantum * QueueCacheViewAuthenticPixels(CacheView *cache_view, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: cache-view.c:977
#define WaveImageTag
MagickExport MagickRealType GetPixelInfoIntensity(const Image *magick_restrict image, const PixelInfo *magick_restrict pixel)
Definition: pixel.c:2224
MagickExport Image * SketchImage(const Image *image, const double radius, const double sigma, const double angle, ExceptionInfo *exception)
MagickExport VirtualPixelMethod SetImageVirtualPixelMethod(Image *image, const VirtualPixelMethod virtual_pixel_method, ExceptionInfo *exception)
Definition: image.c:3477
double y2
Definition: image.h:107
MagickExport MagickBooleanType LogMagickEvent(const LogEventType type, const char *module, const char *function, const size_t line, const char *format,...)
Definition: log.c:1660
MagickExport Image * RotateImage(const Image *image, const double degrees, ExceptionInfo *exception)
Definition: distort.c:2950
size_t width
Definition: morphology.h:108
MagickExport MagickBooleanType SetImageBackgroundColor(Image *image, ExceptionInfo *exception)
Definition: image.c:2395
size_t signature
Definition: image.h:354
MagickExport RandomInfo * AcquireRandomInfo(void)
Definition: random.c:163
#define QuantumScale
Definition: magick-type.h:119
#define MorphImageTag
size_t columns
Definition: image.h:172
ssize_t x
Definition: geometry.h:134
MagickExport DrawInfo * CloneDrawInfo(const ImageInfo *image_info, const DrawInfo *draw_info)
Definition: draw.c:269
MagickExport Image * GetLastImageInList(const Image *images)
Definition: list.c:737
size_t height
Definition: geometry.h:130
MagickExport Image * SwirlImage(const Image *image, double degrees, const PixelInterpolateMethod method, ExceptionInfo *exception)
MagickExport MagickBooleanType QueryColorCompliance(const char *name, const ComplianceType compliance, PixelInfo *color, ExceptionInfo *exception)
Definition: color.c:2180
ChannelType
Definition: pixel.h:33
static void SetPixelBlue(const Image *magick_restrict image, const Quantum blue, Quantum *magick_restrict pixel)
MagickExport MagickBooleanType SetImageStorageClass(Image *image, const ClassType storage_class, ExceptionInfo *exception)
Definition: image.c:2595
ssize_t offset
Definition: image.h:206
#define SetBit(alpha, i, set)
MagickExport Image * DestroyImageList(Image *images)
Definition: list.c:462
PixelChannel
Definition: pixel.h:67
#define Colorize(pixel, blend_percentage, colorize)
MagickExport MagickBooleanType SetImageExtent(Image *image, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: image.c:2637
MagickExport Image * StereoAnaglyphImage(const Image *left_image, const Image *right_image, const ssize_t x_offset, const ssize_t y_offset, ExceptionInfo *exception)
#define MagickMax(x, y)
Definition: image-private.h:36
size_t colors
Definition: image.h:172
#define GetBit(alpha, i)
static size_t GetPixelChannels(const Image *magick_restrict image)
char filename[MagickPathExtent]
Definition: image.h:319
#define ColorizeImageTag
#define GetMagickModule()
Definition: log.h:28
MagickExport Image * MorphImages(const Image *image, const size_t number_frames, ExceptionInfo *exception)
static MagickBooleanType PlasmaImageProxy(Image *image, CacheView *image_view, CacheView *u_view, CacheView *v_view, RandomInfo *magick_restrict random_info, const SegmentInfo *magick_restrict segment, size_t attenuate, size_t depth, ExceptionInfo *exception)
double chi
Definition: geometry.h:106
#define ThrowImageException(severity, tag)
static PixelChannel GetPixelChannelChannel(const Image *magick_restrict image, const ssize_t offset)
static MagickRealType GetPixelInfoChannel(const PixelInfo *magick_restrict pixel_info, const PixelChannel channel)
MagickExport CacheView * AcquireVirtualCacheView(const Image *image, ExceptionInfo *exception)
Definition: cache-view.c:149
MagickExport MagickBooleanType SetCacheViewVirtualPixelMethod(CacheView *magick_restrict cache_view, const VirtualPixelMethod virtual_pixel_method)
Definition: cache-view.c:1060
MagickExport char * InterpretImageProperties(ImageInfo *image_info, Image *image, const char *embed_text, ExceptionInfo *exception)
Definition: property.c:3493
char * geometry
Definition: draw.h:204
MagickExport MagickBooleanType SyncAuthenticPixels(Image *image, ExceptionInfo *exception)
Definition: cache.c:5441
unsigned short Quantum
Definition: magick-type.h:86
double xi
Definition: geometry.h:106
static MagickBooleanType IsPixelInfoGray(const PixelInfo *magick_restrict pixel)
MagickExport Image * BorderImage(const Image *image, const RectangleInfo *border_info, const CompositeOperator compose, ExceptionInfo *exception)
Definition: decorate.c:103
MagickExport MagickBooleanType SetImageColorspace(Image *image, const ColorspaceType colorspace, ExceptionInfo *exception)
Definition: colorspace.c:1312
MagickExport Image * SteganoImage(const Image *image, const Image *watermark, ExceptionInfo *exception)
MagickExport DrawInfo * DestroyDrawInfo(DrawInfo *draw_info)
Definition: draw.c:882
MagickExport Image * GetNextImageInList(const Image *images)
Definition: list.c:771
MagickRealType black
Definition: pixel.h:190
MagickExport char * DestroyString(char *string)
Definition: string.c:811
MagickExport Quantum * QueueAuthenticPixels(Image *image, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
Definition: cache.c:4307
MagickExport double GetPseudoRandomValue(RandomInfo *magick_restrict random_info)
Definition: random.c:610
MagickExport MagickStatusType ParseGeometry(const char *geometry, GeometryInfo *geometry_info)
Definition: geometry.c:853
static void SetPixelChannel(const Image *magick_restrict image, const PixelChannel channel, const Quantum quantum, Quantum *magick_restrict pixel)
MagickExport void AppendImageToList(Image **images, const Image *append)
Definition: list.c:78
#define SwirlImageTag
MagickExport Image * CharcoalImage(const Image *image, const double radius, const double sigma, ExceptionInfo *exception)
static void SetPixelAlpha(const Image *magick_restrict image, const Quantum alpha, Quantum *magick_restrict pixel)
MagickExport MagickBooleanType ConcatenateString(char **magick_restrict destination, const char *magick_restrict source)
Definition: string.c:492
char * text
Definition: draw.h:255
static RandomInfo * random_info
Definition: resource.c:113
MagickExport void * RelinquishMagickMemory(void *memory)
Definition: memory.c:1123
MagickExport Image * WaveImage(const Image *image, const double amplitude, const double wave_length, const PixelInterpolateMethod method, ExceptionInfo *exception)
double ascent
Definition: draw.h:372
MagickExport MagickBooleanType ClampImage(Image *image, ExceptionInfo *exception)
Definition: threshold.c:1089
MagickRealType green
Definition: pixel.h:190
MagickBooleanType(* MagickProgressMonitor)(const char *, const MagickOffsetType, const MagickSizeType, void *)
Definition: monitor.h:26
MagickExport Image * StereoImage(const Image *left_image, const Image *right_image, ExceptionInfo *exception)
MagickExport char * CloneString(char **destination, const char *source)
Definition: string.c:286
#define SepiaToneImageTag
static void SetPixelRed(const Image *magick_restrict image, const Quantum red, Quantum *magick_restrict pixel)
MagickExport Image * TrimImage(const Image *image, ExceptionInfo *exception)
Definition: transform.c:2403
MagickExport Image * BlueShiftImage(const Image *image, const double factor, ExceptionInfo *exception)
#define MagickExport
MagickExport MagickBooleanType SyncCacheViewAuthenticPixels(CacheView *magick_restrict cache_view, ExceptionInfo *exception)
Definition: cache-view.c:1100
ssize_t y
Definition: geometry.h:134
MagickExport MagickBooleanType SolarizeImage(Image *image, const double threshold, ExceptionInfo *exception)
MagickExport Image * ColorizeImage(const Image *image, const char *blend, const PixelInfo *colorize, ExceptionInfo *exception)
MagickExport CacheView * AcquireAuthenticCacheView(const Image *image, ExceptionInfo *exception)
Definition: cache-view.c:112
ColorspaceType colorspace
Definition: pixel.h:175
double y1
Definition: image.h:107
MagickExport Image * EdgeImage(const Image *image, const double radius, ExceptionInfo *exception)
Definition: effect.c:1185
static Quantum GetPixelBlue(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
PixelTrait
Definition: pixel.h:134
#define AddNoiseImageTag
MagickExport void * GetVirtualMemoryBlob(const MemoryInfo *memory_info)
Definition: memory.c:1051
MagickExport MagickRealType GetPixelIntensity(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel.c:2358
PixelInfo background_color
Definition: image.h:179
MagickExport size_t GetImageListLength(const Image *images)
Definition: list.c:696
#define SolarizeImageTag
MagickExport Image * DestroyImage(Image *image)
Definition: image.c:1160
MagickExport Image * CloneImage(const Image *image, const size_t columns, const size_t rows, const MagickBooleanType detach, ExceptionInfo *exception)
Definition: image.c:775
ColorspaceType colorspace
Definition: image.h:157
#define QuantumRange
Definition: magick-type.h:87
MagickExport MagickBooleanType SetImageProgress(const Image *image, const char *tag, const MagickOffsetType offset, const MagickSizeType extent)
Definition: monitor.c:136
MagickRealType * values
Definition: morphology.h:116
MagickBooleanType debug
Definition: image.h:334
static void SetPixelGreen(const Image *magick_restrict image, const Quantum green, Quantum *magick_restrict pixel)
size_t depth
Definition: image.h:172
MagickPrivate MagickBooleanType TransformImage(Image **, const char *, const char *, ExceptionInfo *)
Definition: transform.c:2040