2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % M M OOO GGGGG RRRR IIIII FFFFF Y Y %
7 % MM MM O O G R R I F Y Y %
8 % M M M O O G GGG RRRR I FFF Y %
9 % M M O O G G R R I F Y %
10 % M M OOO GGGG R R IIIII F Y %
13 % MagickWand Module Methods %
20 % Copyright 1999-2010 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
28 % Unless required by applicable law or agreed to in writing, software %
29 % distributed under the License is distributed on an "AS IS" BASIS, %
30 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31 % See the License for the specific language governing permissions and %
32 % limitations under the License. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
36 % Use the mogrify program to resize an image, blur, crop, despeckle, dither,
37 % draw on, flip, join, re-sample, and much more. This tool is similiar to
38 % convert except that the original image file is overwritten (unless you
39 % change the file suffix with the -format option) with any changes you
47 #include "wand/studio.h"
48 #include "wand/MagickWand.h"
49 #include "wand/mogrify-private.h"
50 #include "magick/monitor-private.h"
51 #include "magick/thread-private.h"
52 #include "magick/string-private.h"
57 #define UndefinedCompressionQuality 0UL
63 BackgroundColor[] = "#fff", /* white */
64 BorderColor[] = "#dfdfdf", /* gray */
65 MatteColor[] = "#bdbdbd"; /* gray */
68 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
72 + M a g i c k C o m m a n d G e n e s i s %
76 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
78 % MagickCommandGenesis() applies image processing options to an image as
79 % prescribed by command line options.
81 % The format of the MagickCommandGenesis method is:
83 % MagickBooleanType MagickCommandGenesis(ImageInfo *image_info,
84 % MagickCommand command,const int argc,const char **argv,Image **image)
86 % A description of each parameter follows:
88 % o image_info: the image info.
90 % o command: the magick command.
92 % o argc: Specifies a pointer to an integer describing the number of
93 % elements in the argument vector.
95 % o argv: Specifies a pointer to a text array containing the command line
100 % o exception: return any errors or warnings in this structure.
103 WandExport MagickBooleanType MagickCommandGenesis(ImageInfo *image_info,
104 MagickCommand command,int argc,char **argv,char **metadata,
105 ExceptionInfo *exception)
129 (void) setlocale(LC_ALL,"");
130 (void) setlocale(LC_NUMERIC,"C");
131 concurrent=MagickFalse;
135 regard_warnings=MagickFalse;
136 for (i=1; i < (ssize_t) (argc-1); i++)
139 if ((strlen(option) == 1) || ((*option != '-') && (*option != '+')))
141 if (LocaleCompare("bench",option+1) == 0)
142 iterations=StringToUnsignedLong(argv[++i]);
143 if (LocaleCompare("concurrent",option+1) == 0)
144 concurrent=MagickTrue;
145 if (LocaleCompare("debug",option+1) == 0)
146 (void) SetLogEventMask(argv[++i]);
147 if (LocaleCompare("duration",option+1) == 0)
148 duration=StringToDouble(argv[++i]);
149 if (LocaleCompare("regard-warnings",option+1) == 0)
150 regard_warnings=MagickTrue;
152 timer=AcquireTimerInfo();
153 if (concurrent == MagickFalse)
155 for (i=0; i < (ssize_t) iterations; i++)
157 if (status != MagickFalse)
161 if (GetElapsedTime(timer) > duration)
163 (void) ContinueTimer(timer);
165 status=command(image_info,argc,argv,metadata,exception);
166 if (exception->severity != UndefinedException)
168 if ((exception->severity > ErrorException) ||
169 (regard_warnings != MagickFalse))
171 CatchException(exception);
173 if ((metadata != (char **) NULL) && (*metadata != (char *) NULL))
175 (void) fputs(*metadata,stdout);
176 (void) fputc('\n',stdout);
177 *metadata=DestroyString(*metadata);
184 #if defined(MAGICKCORE_OPENMP_SUPPORT)
185 # pragma omp parallel for shared(status)
187 for (i=0; i < (ssize_t) iterations; i++)
189 if (status != MagickFalse)
193 if (GetElapsedTime(timer) > duration)
195 (void) ContinueTimer(timer);
197 status=command(image_info,argc,argv,metadata,exception);
198 #if defined(MAGICKCORE_OPENMP_SUPPORT)
199 # pragma omp critical (MagickCore_CommandGenesis)
202 if (exception->severity != UndefinedException)
204 if ((exception->severity > ErrorException) ||
205 (regard_warnings != MagickFalse))
207 CatchException(exception);
209 if ((metadata != (char **) NULL) && (*metadata != (char *) NULL))
211 (void) fputs(*metadata,stdout);
212 (void) fputc('\n',stdout);
213 *metadata=DestroyString(*metadata);
220 elapsed_time=GetElapsedTime(timer);
221 user_time=GetUserTime(timer);
222 (void) fprintf(stderr,
223 "Performance: %.20gi %gips %0.3fu %.20g:%02g.%03g\n",(double)
224 iterations,1.0*iterations/elapsed_time,user_time,(double)
225 (elapsed_time/60.0),floor(fmod(elapsed_time,60.0)),(double)
226 (1000.0*(elapsed_time-floor(elapsed_time))));
227 (void) fflush(stderr);
229 timer=DestroyTimerInfo(timer);
234 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
238 + M o g r i f y I m a g e %
242 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
244 % MogrifyImage() applies image processing options to an image as prescribed
245 % by command line options.
247 % The format of the MogrifyImage method is:
249 % MagickBooleanType MogrifyImage(ImageInfo *image_info,const int argc,
250 % const char **argv,Image **image)
252 % A description of each parameter follows:
254 % o image_info: the image info..
256 % o argc: Specifies a pointer to an integer describing the number of
257 % elements in the argument vector.
259 % o argv: Specifies a pointer to a text array containing the command line
262 % o image: the image.
264 % o exception: return any errors or warnings in this structure.
268 static inline Image *GetImageCache(const ImageInfo *image_info,const char *path,
269 ExceptionInfo *exception)
283 (void) FormatMagickString(key,MaxTextExtent,"cache:%s",path);
284 sans_exception=AcquireExceptionInfo();
285 image=(Image *) GetImageRegistry(ImageRegistryType,key,sans_exception);
286 sans_exception=DestroyExceptionInfo(sans_exception);
287 if (image != (Image *) NULL)
289 read_info=CloneImageInfo(image_info);
290 (void) CopyMagickString(read_info->filename,path,MaxTextExtent);
291 image=ReadImage(read_info,exception);
292 read_info=DestroyImageInfo(read_info);
293 if (image != (Image *) NULL)
294 (void) SetImageRegistry(ImageRegistryType,key,image,exception);
298 static MagickBooleanType IsPathWritable(const char *path)
300 if (IsPathAccessible(path) == MagickFalse)
302 if (access(path,W_OK) != 0)
307 static inline ssize_t MagickMax(const ssize_t x,const ssize_t y)
314 static MagickBooleanType MonitorProgress(const char *text,
315 const MagickOffsetType offset,const MagickSizeType extent,
316 void *wand_unused(client_data))
319 message[MaxTextExtent],
330 (void) CopyMagickMemory(tag,text,MaxTextExtent);
332 if (p != (char *) NULL)
334 (void) FormatMagickString(message,MaxTextExtent,"Monitor/%s",tag);
335 locale_message=GetLocaleMessage(message);
336 if (locale_message == message)
338 if (p == (char *) NULL)
339 (void) fprintf(stderr,"%s: %ld of %lu, %02ld%% complete\r",locale_message,
340 (long) offset,(unsigned long) extent,(long) (100L*offset/(extent-1)));
342 (void) fprintf(stderr,"%s[%s]: %ld of %lu, %02ld%% complete\r",
343 locale_message,p+1,(long) offset,(unsigned long) extent,(long)
344 (100L*offset/(extent-1)));
345 if (offset == (MagickOffsetType) (extent-1))
346 (void) fprintf(stderr,"\n");
347 (void) fflush(stderr);
351 static Image *SparseColorOption(const Image *image,const ChannelType channel,
352 const SparseColorMethod method,const char *arguments,
353 const MagickBooleanType color_from_image,ExceptionInfo *exception)
359 token[MaxTextExtent];
385 assert(image != (Image *) NULL);
386 assert(image->signature == MagickSignature);
387 if (image->debug != MagickFalse)
388 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
389 assert(exception != (ExceptionInfo *) NULL);
390 assert(exception->signature == MagickSignature);
392 Limit channels according to image - and add up number of color channel.
395 if (image->colorspace != CMYKColorspace)
396 channels=(ChannelType) (channels & ~IndexChannel); /* no index channel */
397 if (image->matte == MagickFalse)
398 channels=(ChannelType) (channels & ~OpacityChannel); /* no alpha channel */
400 if ((channels & RedChannel) != 0)
402 if ((channels & GreenChannel) != 0)
404 if ((channels & BlueChannel) != 0)
406 if ((channels & IndexChannel) != 0)
408 if ((channels & OpacityChannel) != 0)
411 Read string, to determine number of arguments needed,
417 GetMagickToken(p,&p,token);
418 if ( token[0] == ',' ) continue;
419 if ( isalpha((int) token[0]) || token[0] == '#' ) {
420 if ( color_from_image ) {
421 (void) ThrowMagickException(exception,GetMagickModule(),
422 OptionError, "InvalidArgument", "`%s': %s", "sparse-color",
423 "Color arg given, when colors are coming from image");
424 return( (Image *)NULL);
426 x += number_colors; /* color argument */
429 x++; /* floating point argument */
433 if ( color_from_image ) {
434 /* just the control points are being given */
435 error = ( x % 2 != 0 ) ? MagickTrue : MagickFalse;
436 number_arguments=(x/2)*(2+number_colors);
439 /* control points and color values */
440 error = ( x % (2+number_colors) != 0 ) ? MagickTrue : MagickFalse;
444 (void) ThrowMagickException(exception,GetMagickModule(),
445 OptionError, "InvalidArgument", "`%s': %s", "sparse-color",
446 "Invalid number of Arguments");
447 return( (Image *)NULL);
450 /* Allocate and fill in the floating point arguments */
451 sparse_arguments=(double *) AcquireQuantumMemory(number_arguments,
452 sizeof(*sparse_arguments));
453 if (sparse_arguments == (double *) NULL) {
454 (void) ThrowMagickException(exception,GetMagickModule(),ResourceLimitError,
455 "MemoryAllocationFailed","%s","SparseColorOption");
456 return( (Image *)NULL);
458 (void) ResetMagickMemory(sparse_arguments,0,number_arguments*
459 sizeof(*sparse_arguments));
462 while( *p != '\0' && x < number_arguments ) {
464 token[0]=','; while ( token[0] == ',' ) GetMagickToken(p,&p,token);
465 if ( token[0] == '\0' ) break;
466 if ( isalpha((int) token[0]) || token[0] == '#' ) {
467 (void) ThrowMagickException(exception,GetMagickModule(),
468 OptionError, "InvalidArgument", "`%s': %s", "sparse-color",
469 "Color found, instead of X-coord");
473 sparse_arguments[x++]=StringToDouble(token);
475 token[0]=','; while ( token[0] == ',' ) GetMagickToken(p,&p,token);
476 if ( token[0] == '\0' ) break;
477 if ( isalpha((int) token[0]) || token[0] == '#' ) {
478 (void) ThrowMagickException(exception,GetMagickModule(),
479 OptionError, "InvalidArgument", "`%s': %s", "sparse-color",
480 "Color found, instead of Y-coord");
484 sparse_arguments[x++]=StringToDouble(token);
485 /* color values for this control point */
487 if ( (color_from_image ) {
488 /* get color from image */
494 /* color name or function given in string argument */
495 token[0]=','; while ( token[0] == ',' ) GetMagickToken(p,&p,token);
496 if ( token[0] == '\0' ) break;
497 if ( isalpha((int) token[0]) || token[0] == '#' ) {
498 /* Color string given */
499 (void) QueryMagickColor(token,&color,exception);
500 if ( channels & RedChannel )
501 sparse_arguments[x++] = QuantumScale*color.red;
502 if ( channels & GreenChannel )
503 sparse_arguments[x++] = QuantumScale*color.green;
504 if ( channels & BlueChannel )
505 sparse_arguments[x++] = QuantumScale*color.blue;
506 if ( channels & IndexChannel )
507 sparse_arguments[x++] = QuantumScale*color.index;
508 if ( channels & OpacityChannel )
509 sparse_arguments[x++] = QuantumScale*color.opacity;
513 /* the color name/function/value was not found - error */
516 /* Colors given as a set of floating point values - experimental */
517 /* NB: token contains the first floating point value to use! */
518 if ( channels & RedChannel ) {
519 while ( token[0] == ',' ) GetMagickToken(p,&p,token);
520 if ( token[0] == '\0' || isalpha((int)token[0]) || token[0] == '#' )
522 sparse_arguments[x++]=StringToDouble(token);
523 token[0] = ','; /* used this token - get another */
525 if ( channels & GreenChannel ) {
526 while ( token[0] == ',' ) GetMagickToken(p,&p,token);
527 if ( token[0] == '\0' || isalpha((int)token[0]) || token[0] == '#' )
529 sparse_arguments[x++]=StringToDouble(token);
530 token[0] = ','; /* used this token - get another */
532 if ( channels & BlueChannel ) {
533 while ( token[0] == ',' ) GetMagickToken(p,&p,token);
534 if ( token[0] == '\0' || isalpha((int)token[0]) || token[0] == '#' )
536 sparse_arguments[x++]=StringToDouble(token);
537 token[0] = ','; /* used this token - get another */
539 if ( channels & IndexChannel ) {
540 while ( token[0] == ',' ) GetMagickToken(p,&p,token);
541 if ( token[0] == '\0' || isalpha((int)token[0]) || token[0] == '#' )
543 sparse_arguments[x++]=StringToDouble(token);
544 token[0] = ','; /* used this token - get another */
546 if ( channels & OpacityChannel ) {
547 while ( token[0] == ',' ) GetMagickToken(p,&p,token);
548 if ( token[0] == '\0' || isalpha((int)token[0]) || token[0] == '#' )
550 sparse_arguments[x++]=StringToDouble(token);
551 token[0] = ','; /* used this token - get another */
557 if ( number_arguments != x && !error ) {
558 (void) ThrowMagickException(exception,GetMagickModule(),OptionError,
559 "InvalidArgument","`%s': %s","sparse-color","Argument Parsing Error");
560 sparse_arguments=(double *) RelinquishMagickMemory(sparse_arguments);
561 return( (Image *)NULL);
564 return( (Image *)NULL);
566 /* Call the Interpolation function with the parsed arguments */
567 sparse_image=SparseColorImage(image,channels,method,number_arguments,
568 sparse_arguments,exception);
569 sparse_arguments=(double *) RelinquishMagickMemory(sparse_arguments);
570 return( sparse_image );
573 WandExport MagickBooleanType MogrifyImage(ImageInfo *image_info,const int argc,
574 const char **argv,Image **image,ExceptionInfo *exception)
618 Initialize method variables.
620 assert(image_info != (const ImageInfo *) NULL);
621 assert(image_info->signature == MagickSignature);
622 assert(image != (Image **) NULL);
623 assert((*image)->signature == MagickSignature);
624 if ((*image)->debug != MagickFalse)
625 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",(*image)->filename);
628 mogrify_info=CloneImageInfo(image_info);
629 draw_info=CloneDrawInfo(mogrify_info,(DrawInfo *) NULL);
630 quantize_info=AcquireQuantizeInfo(mogrify_info);
631 SetGeometryInfo(&geometry_info);
632 GetMagickPixelPacket(*image,&fill);
633 SetMagickPixelPacket(*image,&(*image)->background_color,(IndexPacket *) NULL,
635 channel=mogrify_info->channel;
636 format=GetImageOption(mogrify_info,"format");
637 SetGeometry(*image,®ion_geometry);
638 region_image=NewImageList();
640 Transmogrify the image.
642 for (i=0; i < (ssize_t) argc; i++)
645 if (IsMagickOption(option) == MagickFalse)
647 count=MagickMax(ParseMagickOption(MagickCommandOptions,MagickFalse,option),
649 if ((i+count) >= (ssize_t) argc)
651 status=MogrifyImageInfo(mogrify_info,(int) count+1,argv+i,exception);
656 if (LocaleCompare("adaptive-blur",option+1) == 0)
664 (void) SyncImageSettings(mogrify_info,*image);
665 flags=ParseGeometry(argv[i+1],&geometry_info);
666 if ((flags & SigmaValue) == 0)
667 geometry_info.sigma=1.0;
668 blur_image=AdaptiveBlurImageChannel(*image,channel,
669 geometry_info.rho,geometry_info.sigma,exception);
670 if (blur_image == (Image *) NULL)
672 *image=DestroyImage(*image);
676 if (LocaleCompare("adaptive-resize",option+1) == 0)
682 Adaptive resize image.
684 (void) SyncImageSettings(mogrify_info,*image);
685 (void) ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
686 resize_image=AdaptiveResizeImage(*image,geometry.width,
687 geometry.height,exception);
688 if (resize_image == (Image *) NULL)
690 *image=DestroyImage(*image);
694 if (LocaleCompare("adaptive-sharpen",option+1) == 0)
700 Adaptive sharpen image.
702 (void) SyncImageSettings(mogrify_info,*image);
703 flags=ParseGeometry(argv[i+1],&geometry_info);
704 if ((flags & SigmaValue) == 0)
705 geometry_info.sigma=1.0;
706 sharp_image=AdaptiveSharpenImageChannel(*image,channel,
707 geometry_info.rho,geometry_info.sigma,exception);
708 if (sharp_image == (Image *) NULL)
710 *image=DestroyImage(*image);
714 if (LocaleCompare("affine",option+1) == 0)
721 GetAffineMatrix(&draw_info->affine);
724 (void) ParseAffineGeometry(argv[i+1],&draw_info->affine,exception);
727 if (LocaleCompare("alpha",option+1) == 0)
732 (void) SyncImageSettings(mogrify_info,*image);
733 alpha_type=(AlphaChannelType) ParseMagickOption(MagickAlphaOptions,
734 MagickFalse,argv[i+1]);
735 (void) SetImageAlphaChannel(*image,alpha_type);
736 InheritException(exception,&(*image)->exception);
739 if (LocaleCompare("annotate",option+1) == 0)
743 geometry[MaxTextExtent];
748 (void) SyncImageSettings(mogrify_info,*image);
749 SetGeometryInfo(&geometry_info);
750 flags=ParseGeometry(argv[i+1],&geometry_info);
751 if ((flags & SigmaValue) == 0)
752 geometry_info.sigma=geometry_info.rho;
753 text=InterpretImageProperties(mogrify_info,*image,argv[i+2]);
754 InheritException(exception,&(*image)->exception);
755 if (text == (char *) NULL)
757 (void) CloneString(&draw_info->text,text);
758 text=DestroyString(text);
759 (void) FormatMagickString(geometry,MaxTextExtent,"%+f%+f",
760 geometry_info.xi,geometry_info.psi);
761 (void) CloneString(&draw_info->geometry,geometry);
762 draw_info->affine.sx=cos(DegreesToRadians(
763 fmod(geometry_info.rho,360.0)));
764 draw_info->affine.rx=sin(DegreesToRadians(
765 fmod(geometry_info.rho,360.0)));
766 draw_info->affine.ry=(-sin(DegreesToRadians(
767 fmod(geometry_info.sigma,360.0))));
768 draw_info->affine.sy=cos(DegreesToRadians(
769 fmod(geometry_info.sigma,360.0)));
770 (void) AnnotateImage(*image,draw_info);
771 InheritException(exception,&(*image)->exception);
774 if (LocaleCompare("antialias",option+1) == 0)
776 draw_info->stroke_antialias=(*option == '-') ? MagickTrue :
778 draw_info->text_antialias=(*option == '-') ? MagickTrue :
782 if (LocaleCompare("auto-gamma",option+1) == 0)
785 Auto Adjust Gamma of image based on its mean
787 (void) SyncImageSettings(mogrify_info,*image);
788 (void) AutoGammaImageChannel(*image,channel);
791 if (LocaleCompare("auto-level",option+1) == 0)
794 Perfectly Normalize (max/min stretch) the image
796 (void) SyncImageSettings(mogrify_info,*image);
797 (void) AutoLevelImageChannel(*image,channel);
800 if (LocaleCompare("auto-orient",option+1) == 0)
805 (void) SyncImageSettings(mogrify_info,*image);
806 orient_image=NewImageList();
807 switch ((*image)->orientation)
809 case TopRightOrientation:
811 orient_image=FlopImage(*image,exception);
814 case BottomRightOrientation:
816 orient_image=RotateImage(*image,180.0,exception);
819 case BottomLeftOrientation:
821 orient_image=FlipImage(*image,exception);
824 case LeftTopOrientation:
826 orient_image=TransposeImage(*image,exception);
829 case RightTopOrientation:
831 orient_image=RotateImage(*image,90.0,exception);
834 case RightBottomOrientation:
836 orient_image=TransverseImage(*image,exception);
839 case LeftBottomOrientation:
841 orient_image=RotateImage(*image,270.0,exception);
847 if (orient_image == (Image *) NULL)
849 orient_image->orientation=TopLeftOrientation;
850 *image=DestroyImage(*image);
858 if (LocaleCompare("black-threshold",option+1) == 0)
861 Black threshold image.
863 (void) SyncImageSettings(mogrify_info,*image);
864 (void) BlackThresholdImageChannel(*image,channel,argv[i+1],
866 InheritException(exception,&(*image)->exception);
869 if (LocaleCompare("blue-shift",option+1) == 0)
877 (void) SyncImageSettings(mogrify_info,*image);
878 geometry_info.rho=1.5;
880 flags=ParseGeometry(argv[i+1],&geometry_info);
881 shift_image=BlueShiftImage(*image,geometry_info.rho,exception);
882 if (shift_image == (Image *) NULL)
884 *image=DestroyImage(*image);
888 if (LocaleCompare("blur",option+1) == 0)
896 (void) SyncImageSettings(mogrify_info,*image);
897 flags=ParseGeometry(argv[i+1],&geometry_info);
898 if ((flags & SigmaValue) == 0)
899 geometry_info.sigma=1.0;
900 blur_image=BlurImageChannel(*image,channel,geometry_info.rho,
901 geometry_info.sigma,exception);
902 if (blur_image == (Image *) NULL)
904 *image=DestroyImage(*image);
908 if (LocaleCompare("border",option+1) == 0)
914 Surround image with a border of solid color.
916 (void) SyncImageSettings(mogrify_info,*image);
917 flags=ParsePageGeometry(*image,argv[i+1],&geometry,exception);
918 if ((flags & SigmaValue) == 0)
919 geometry.height=geometry.width;
920 border_image=BorderImage(*image,&geometry,exception);
921 if (border_image == (Image *) NULL)
923 *image=DestroyImage(*image);
927 if (LocaleCompare("bordercolor",option+1) == 0)
931 (void) QueryColorDatabase(BorderColor,&draw_info->border_color,
935 (void) QueryColorDatabase(argv[i+1],&draw_info->border_color,
939 if (LocaleCompare("box",option+1) == 0)
941 (void) QueryColorDatabase(argv[i+1],&draw_info->undercolor,
945 if (LocaleCompare("brightness-contrast",option+1) == 0)
958 Brightness / contrast image.
960 (void) SyncImageSettings(mogrify_info,*image);
961 flags=ParseGeometry(argv[i+1],&geometry_info);
962 brightness=geometry_info.rho;
964 if ((flags & SigmaValue) != 0)
965 contrast=geometry_info.sigma;
966 (void) BrightnessContrastImageChannel(*image,channel,brightness,
968 InheritException(exception,&(*image)->exception);
975 if (LocaleCompare("cdl",option+1) == 0)
978 *color_correction_collection;
981 Color correct with a color decision list.
983 (void) SyncImageSettings(mogrify_info,*image);
984 color_correction_collection=FileToString(argv[i+1],~0,exception);
985 if (color_correction_collection == (char *) NULL)
987 (void) ColorDecisionListImage(*image,color_correction_collection);
988 InheritException(exception,&(*image)->exception);
991 if (LocaleCompare("channel",option+1) == 0)
995 channel=DefaultChannels;
998 channel=(ChannelType) ParseChannelOption(argv[i+1]);
1001 if (LocaleCompare("charcoal",option+1) == 0)
1009 (void) SyncImageSettings(mogrify_info,*image);
1010 flags=ParseGeometry(argv[i+1],&geometry_info);
1011 if ((flags & SigmaValue) == 0)
1012 geometry_info.sigma=1.0;
1013 charcoal_image=CharcoalImage(*image,geometry_info.rho,
1014 geometry_info.sigma,exception);
1015 if (charcoal_image == (Image *) NULL)
1017 *image=DestroyImage(*image);
1018 *image=charcoal_image;
1021 if (LocaleCompare("chop",option+1) == 0)
1029 (void) SyncImageSettings(mogrify_info,*image);
1030 (void) ParseGravityGeometry(*image,argv[i+1],&geometry,exception);
1031 chop_image=ChopImage(*image,&geometry,exception);
1032 if (chop_image == (Image *) NULL)
1034 *image=DestroyImage(*image);
1038 if (LocaleCompare("clamp",option+1) == 0)
1043 (void) SyncImageSettings(mogrify_info,*image);
1044 (void) ClampImageChannel(*image,channel);
1045 InheritException(exception,&(*image)->exception);
1048 if (LocaleCompare("clip",option+1) == 0)
1050 (void) SyncImageSettings(mogrify_info,*image);
1053 (void) SetImageClipMask(*image,(Image *) NULL);
1054 InheritException(exception,&(*image)->exception);
1057 (void) ClipImage(*image);
1058 InheritException(exception,&(*image)->exception);
1061 if (LocaleCompare("clip-mask",option+1) == 0)
1072 register PixelPacket
1075 (void) SyncImageSettings(mogrify_info,*image);
1081 (void) SetImageMask(*image,(Image *) NULL);
1082 InheritException(exception,&(*image)->exception);
1088 mask=GetImageCache(mogrify_info,argv[i+1],exception);
1089 if (mask == (Image *) NULL)
1091 for (y=0; y < (ssize_t) mask->rows; y++)
1093 q=GetAuthenticPixels(mask,0,y,mask->columns,1,exception);
1094 if (q == (PixelPacket *) NULL)
1096 for (x=0; x < (ssize_t) mask->columns; x++)
1098 if (mask->matte == MagickFalse)
1099 q->opacity=PixelIntensityToQuantum(q);
1101 q->green=q->opacity;
1105 if (SyncAuthenticPixels(mask,exception) == MagickFalse)
1108 if (SetImageStorageClass(mask,DirectClass) == MagickFalse)
1109 return(MagickFalse);
1110 mask->matte=MagickTrue;
1111 (void) SetImageClipMask(*image,mask);
1112 mask=DestroyImage(mask);
1113 InheritException(exception,&(*image)->exception);
1116 if (LocaleCompare("clip-path",option+1) == 0)
1118 (void) SyncImageSettings(mogrify_info,*image);
1119 (void) ClipImagePath(*image,argv[i+1],*option == '-' ? MagickTrue :
1121 InheritException(exception,&(*image)->exception);
1124 if (LocaleCompare("colorize",option+1) == 0)
1132 (void) SyncImageSettings(mogrify_info,*image);
1133 colorize_image=ColorizeImage(*image,argv[i+1],draw_info->fill,
1135 if (colorize_image == (Image *) NULL)
1137 *image=DestroyImage(*image);
1138 *image=colorize_image;
1141 if (LocaleCompare("color-matrix",option+1) == 0)
1149 (void) SyncImageSettings(mogrify_info,*image);
1150 kernel=AcquireKernelInfo(argv[i+1]);
1151 if (kernel == (KernelInfo *) NULL)
1153 color_image=ColorMatrixImage(*image,kernel,exception);
1154 kernel=DestroyKernelInfo(kernel);
1155 if (color_image == (Image *) NULL)
1157 *image=DestroyImage(*image);
1161 if (LocaleCompare("colors",option+1) == 0)
1164 Reduce the number of colors in the image.
1166 (void) SyncImageSettings(mogrify_info,*image);
1167 quantize_info->number_colors=StringToUnsignedLong(argv[i+1]);
1168 if (quantize_info->number_colors == 0)
1170 if (((*image)->storage_class == DirectClass) ||
1171 (*image)->colors > quantize_info->number_colors)
1172 (void) QuantizeImage(quantize_info,*image);
1174 (void) CompressImageColormap(*image);
1175 InheritException(exception,&(*image)->exception);
1178 if (LocaleCompare("colorspace",option+1) == 0)
1183 (void) SyncImageSettings(mogrify_info,*image);
1186 (void) TransformImageColorspace(*image,RGBColorspace);
1187 InheritException(exception,&(*image)->exception);
1190 colorspace=(ColorspaceType) ParseMagickOption(
1191 MagickColorspaceOptions,MagickFalse,argv[i+1]);
1192 (void) TransformImageColorspace(*image,colorspace);
1193 InheritException(exception,&(*image)->exception);
1196 if (LocaleCompare("contrast",option+1) == 0)
1198 (void) SyncImageSettings(mogrify_info,*image);
1199 (void) ContrastImage(*image,(*option == '-') ? MagickTrue :
1201 InheritException(exception,&(*image)->exception);
1204 if (LocaleCompare("contrast-stretch",option+1) == 0)
1214 Contrast stretch image.
1216 (void) SyncImageSettings(mogrify_info,*image);
1217 flags=ParseGeometry(argv[i+1],&geometry_info);
1218 black_point=geometry_info.rho;
1219 white_point=(flags & SigmaValue) != 0 ? geometry_info.sigma :
1221 if ((flags & PercentValue) != 0)
1223 black_point*=(double) (*image)->columns*(*image)->rows/100.0;
1224 white_point*=(double) (*image)->columns*(*image)->rows/100.0;
1226 white_point=(MagickRealType) (*image)->columns*(*image)->rows-
1228 (void) ContrastStretchImageChannel(*image,channel,black_point,
1230 InheritException(exception,&(*image)->exception);
1233 if (LocaleCompare("convolve",option+1) == 0)
1247 (void) SyncImageSettings(mogrify_info,*image);
1248 kernel=AcquireKernelInfo(argv[i+1]);
1249 if (kernel == (KernelInfo *) NULL)
1252 for (j=0; j < (ssize_t) (kernel->width*kernel->height); j++)
1253 gamma+=kernel->values[j];
1254 gamma=1.0/(fabs((double) gamma) <= MagickEpsilon ? 1.0 : gamma);
1255 for (j=0; j < (ssize_t) (kernel->width*kernel->height); j++)
1256 kernel->values[j]*=gamma;
1257 convolve_image=FilterImageChannel(*image,channel,kernel,exception);
1258 kernel=DestroyKernelInfo(kernel);
1259 if (convolve_image == (Image *) NULL)
1261 *image=DestroyImage(*image);
1262 *image=convolve_image;
1265 if (LocaleCompare("crop",option+1) == 0)
1267 (void) SyncImageSettings(mogrify_info,*image);
1268 flags=ParseGravityGeometry(*image,argv[i+1],&geometry,exception);
1269 if (((geometry.width != 0) || (geometry.height != 0)) &&
1270 ((flags & XValue) == 0) && ((flags & YValue) == 0))
1272 (void) TransformImage(image,argv[i+1],(char *) NULL);
1273 InheritException(exception,&(*image)->exception);
1276 if (LocaleCompare("cycle",option+1) == 0)
1279 Cycle an image colormap.
1281 (void) SyncImageSettings(mogrify_info,*image);
1282 (void) CycleColormapImage(*image,StringToLong(argv[i+1]));
1283 InheritException(exception,&(*image)->exception);
1290 if (LocaleCompare("decipher",option+1) == 0)
1298 (void) SyncImageSettings(mogrify_info,*image);
1299 passkey=FileToStringInfo(argv[i+1],~0,exception);
1300 if (passkey != (StringInfo *) NULL)
1302 (void) PasskeyDecipherImage(*image,passkey,exception);
1303 passkey=DestroyStringInfo(passkey);
1307 if (LocaleCompare("density",option+1) == 0)
1312 (void) CloneString(&draw_info->density,argv[i+1]);
1315 if (LocaleCompare("depth",option+1) == 0)
1317 (void) SyncImageSettings(mogrify_info,*image);
1320 (void) SetImageDepth(*image,MAGICKCORE_QUANTUM_DEPTH);
1323 (void) SetImageDepth(*image,StringToUnsignedLong(argv[i+1]));
1326 if (LocaleCompare("deskew",option+1) == 0)
1335 Straighten the image.
1337 (void) SyncImageSettings(mogrify_info,*image);
1339 threshold=40.0*QuantumRange/100.0;
1341 threshold=SiPrefixToDouble(argv[i+1],QuantumRange);
1342 deskew_image=DeskewImage(*image,threshold,exception);
1343 if (deskew_image == (Image *) NULL)
1345 *image=DestroyImage(*image);
1346 *image=deskew_image;
1349 if (LocaleCompare("despeckle",option+1) == 0)
1355 Reduce the speckles within an image.
1357 (void) SyncImageSettings(mogrify_info,*image);
1358 despeckle_image=DespeckleImage(*image,exception);
1359 if (despeckle_image == (Image *) NULL)
1361 *image=DestroyImage(*image);
1362 *image=despeckle_image;
1365 if (LocaleCompare("display",option+1) == 0)
1367 (void) CloneString(&draw_info->server_name,argv[i+1]);
1370 if (LocaleCompare("distort",option+1) == 0)
1374 token[MaxTextExtent];
1397 (void) SyncImageSettings(mogrify_info,*image);
1398 method=(DistortImageMethod) ParseMagickOption(MagickDistortOptions,
1399 MagickFalse,argv[i+1]);
1400 args=InterpretImageProperties(mogrify_info,*image,argv[i+2]);
1401 InheritException(exception,&(*image)->exception);
1402 if (args == (char *) NULL)
1405 for (x=0; *p != '\0'; x++)
1407 GetMagickToken(p,&p,token);
1409 GetMagickToken(p,&p,token);
1411 number_arguments=(size_t) x;
1412 arguments=(double *) AcquireQuantumMemory(number_arguments,
1413 sizeof(*arguments));
1414 if (arguments == (double *) NULL)
1415 ThrowWandFatalException(ResourceLimitFatalError,
1416 "MemoryAllocationFailed",(*image)->filename);
1417 (void) ResetMagickMemory(arguments,0,number_arguments*
1418 sizeof(*arguments));
1420 for (x=0; (x < (ssize_t) number_arguments) && (*p != '\0'); x++)
1422 GetMagickToken(p,&p,token);
1424 GetMagickToken(p,&p,token);
1425 arguments[x]=StringToDouble(token);
1427 args=DestroyString(args);
1428 distort_image=DistortImage(*image,method,number_arguments,arguments,
1429 (*option == '+') ? MagickTrue : MagickFalse,exception);
1430 arguments=(double *) RelinquishMagickMemory(arguments);
1431 if (distort_image == (Image *) NULL)
1433 *image=DestroyImage(*image);
1434 *image=distort_image;
1437 if (LocaleCompare("dither",option+1) == 0)
1441 quantize_info->dither=MagickFalse;
1444 quantize_info->dither=MagickTrue;
1445 quantize_info->dither_method=(DitherMethod) ParseMagickOption(
1446 MagickDitherOptions,MagickFalse,argv[i+1]);
1447 if (quantize_info->dither_method == NoDitherMethod)
1448 quantize_info->dither=MagickFalse;
1451 if (LocaleCompare("draw",option+1) == 0)
1456 (void) SyncImageSettings(mogrify_info,*image);
1457 (void) CloneString(&draw_info->primitive,argv[i+1]);
1458 (void) DrawImage(*image,draw_info);
1459 InheritException(exception,&(*image)->exception);
1466 if (LocaleCompare("edge",option+1) == 0)
1472 Enhance edges in the image.
1474 (void) SyncImageSettings(mogrify_info,*image);
1475 flags=ParseGeometry(argv[i+1],&geometry_info);
1476 if ((flags & SigmaValue) == 0)
1477 geometry_info.sigma=1.0;
1478 edge_image=EdgeImage(*image,geometry_info.rho,exception);
1479 if (edge_image == (Image *) NULL)
1481 *image=DestroyImage(*image);
1485 if (LocaleCompare("emboss",option+1) == 0)
1491 Gaussian embossen image.
1493 (void) SyncImageSettings(mogrify_info,*image);
1494 flags=ParseGeometry(argv[i+1],&geometry_info);
1495 if ((flags & SigmaValue) == 0)
1496 geometry_info.sigma=1.0;
1497 emboss_image=EmbossImage(*image,geometry_info.rho,
1498 geometry_info.sigma,exception);
1499 if (emboss_image == (Image *) NULL)
1501 *image=DestroyImage(*image);
1502 *image=emboss_image;
1505 if (LocaleCompare("encipher",option+1) == 0)
1513 (void) SyncImageSettings(mogrify_info,*image);
1514 passkey=FileToStringInfo(argv[i+1],~0,exception);
1515 if (passkey != (StringInfo *) NULL)
1517 (void) PasskeyEncipherImage(*image,passkey,exception);
1518 passkey=DestroyStringInfo(passkey);
1522 if (LocaleCompare("encoding",option+1) == 0)
1524 (void) CloneString(&draw_info->encoding,argv[i+1]);
1527 if (LocaleCompare("enhance",option+1) == 0)
1535 (void) SyncImageSettings(mogrify_info,*image);
1536 enhance_image=EnhanceImage(*image,exception);
1537 if (enhance_image == (Image *) NULL)
1539 *image=DestroyImage(*image);
1540 *image=enhance_image;
1543 if (LocaleCompare("equalize",option+1) == 0)
1548 (void) SyncImageSettings(mogrify_info,*image);
1549 (void) EqualizeImageChannel(*image,channel);
1550 InheritException(exception,&(*image)->exception);
1553 if (LocaleCompare("evaluate",option+1) == 0)
1558 MagickEvaluateOperator
1561 (void) SyncImageSettings(mogrify_info,*image);
1562 op=(MagickEvaluateOperator) ParseMagickOption(MagickEvaluateOptions,
1563 MagickFalse,argv[i+1]);
1564 constant=SiPrefixToDouble(argv[i+2],QuantumRange);
1565 (void) EvaluateImageChannel(*image,channel,op,constant,exception);
1568 if (LocaleCompare("extent",option+1) == 0)
1574 Set the image extent.
1576 (void) SyncImageSettings(mogrify_info,*image);
1577 flags=ParseGravityGeometry(*image,argv[i+1],&geometry,exception);
1578 if (geometry.width == 0)
1579 geometry.width=(*image)->columns;
1580 if (geometry.height == 0)
1581 geometry.height=(*image)->rows;
1582 geometry.x=(-geometry.x);
1583 geometry.y=(-geometry.y);
1584 extent_image=ExtentImage(*image,&geometry,exception);
1585 if (extent_image == (Image *) NULL)
1587 *image=DestroyImage(*image);
1588 *image=extent_image;
1595 if (LocaleCompare("family",option+1) == 0)
1599 if (draw_info->family != (char *) NULL)
1600 draw_info->family=DestroyString(draw_info->family);
1603 (void) CloneString(&draw_info->family,argv[i+1]);
1606 if (LocaleCompare("features",option+1) == 0)
1610 (void) DeleteImageArtifact(*image,"identify:features");
1613 (void) SetImageArtifact(*image,"identify:features",argv[i+1]);
1616 if (LocaleCompare("fill",option+1) == 0)
1621 GetMagickPixelPacket(*image,&fill);
1624 (void) QueryMagickColor("none",&fill,exception);
1625 (void) QueryColorDatabase("none",&draw_info->fill,exception);
1626 if (draw_info->fill_pattern != (Image *) NULL)
1627 draw_info->fill_pattern=DestroyImage(draw_info->fill_pattern);
1630 sans=AcquireExceptionInfo();
1631 (void) QueryMagickColor(argv[i+1],&fill,sans);
1632 status=QueryColorDatabase(argv[i+1],&draw_info->fill,sans);
1633 sans=DestroyExceptionInfo(sans);
1634 if (status == MagickFalse)
1635 draw_info->fill_pattern=GetImageCache(mogrify_info,argv[i+1],
1639 if (LocaleCompare("flip",option+1) == 0)
1645 Flip image scanlines.
1647 (void) SyncImageSettings(mogrify_info,*image);
1648 flip_image=FlipImage(*image,exception);
1649 if (flip_image == (Image *) NULL)
1651 *image=DestroyImage(*image);
1655 if (LocaleCompare("flop",option+1) == 0)
1661 Flop image scanlines.
1663 (void) SyncImageSettings(mogrify_info,*image);
1664 flop_image=FlopImage(*image,exception);
1665 if (flop_image == (Image *) NULL)
1667 *image=DestroyImage(*image);
1671 if (LocaleCompare("floodfill",option+1) == 0)
1679 (void) SyncImageSettings(mogrify_info,*image);
1680 (void) ParsePageGeometry(*image,argv[i+1],&geometry,exception);
1681 (void) QueryMagickColor(argv[i+2],&target,exception);
1682 (void) FloodfillPaintImage(*image,channel,draw_info,&target,
1683 geometry.x,geometry.y,*option == '-' ? MagickFalse : MagickTrue);
1684 InheritException(exception,&(*image)->exception);
1687 if (LocaleCompare("font",option+1) == 0)
1691 if (draw_info->font != (char *) NULL)
1692 draw_info->font=DestroyString(draw_info->font);
1695 (void) CloneString(&draw_info->font,argv[i+1]);
1698 if (LocaleCompare("format",option+1) == 0)
1703 if (LocaleCompare("frame",option+1) == 0)
1712 Surround image with an ornamental border.
1714 (void) SyncImageSettings(mogrify_info,*image);
1715 flags=ParsePageGeometry(*image,argv[i+1],&geometry,exception);
1716 frame_info.width=geometry.width;
1717 frame_info.height=geometry.height;
1718 if ((flags & HeightValue) == 0)
1719 frame_info.height=geometry.width;
1720 frame_info.outer_bevel=geometry.x;
1721 frame_info.inner_bevel=geometry.y;
1722 frame_info.x=(ssize_t) frame_info.width;
1723 frame_info.y=(ssize_t) frame_info.height;
1724 frame_info.width=(*image)->columns+2*frame_info.width;
1725 frame_info.height=(*image)->rows+2*frame_info.height;
1726 frame_image=FrameImage(*image,&frame_info,exception);
1727 if (frame_image == (Image *) NULL)
1729 *image=DestroyImage(*image);
1733 if (LocaleCompare("function",option+1) == 0)
1737 token[MaxTextExtent];
1755 Function Modify Image Values
1757 (void) SyncImageSettings(mogrify_info,*image);
1758 function=(MagickFunction) ParseMagickOption(MagickFunctionOptions,
1759 MagickFalse,argv[i+1]);
1760 arguments=InterpretImageProperties(mogrify_info,*image,argv[i+2]);
1761 InheritException(exception,&(*image)->exception);
1762 if (arguments == (char *) NULL)
1764 p=(char *) arguments;
1765 for (x=0; *p != '\0'; x++)
1767 GetMagickToken(p,&p,token);
1769 GetMagickToken(p,&p,token);
1771 number_parameters=(size_t) x;
1772 parameters=(double *) AcquireQuantumMemory(number_parameters,
1773 sizeof(*parameters));
1774 if (parameters == (double *) NULL)
1775 ThrowWandFatalException(ResourceLimitFatalError,
1776 "MemoryAllocationFailed",(*image)->filename);
1777 (void) ResetMagickMemory(parameters,0,number_parameters*
1778 sizeof(*parameters));
1779 p=(char *) arguments;
1780 for (x=0; (x < (ssize_t) number_parameters) && (*p != '\0'); x++)
1782 GetMagickToken(p,&p,token);
1784 GetMagickToken(p,&p,token);
1785 parameters[x]=StringToDouble(token);
1787 arguments=DestroyString(arguments);
1788 (void) FunctionImageChannel(*image,channel,function,
1789 number_parameters,parameters,exception);
1790 parameters=(double *) RelinquishMagickMemory(parameters);
1797 if (LocaleCompare("gamma",option+1) == 0)
1802 (void) SyncImageSettings(mogrify_info,*image);
1804 (*image)->gamma=StringToDouble(argv[i+1]);
1807 if (strchr(argv[i+1],',') != (char *) NULL)
1808 (void) GammaImage(*image,argv[i+1]);
1810 (void) GammaImageChannel(*image,channel,
1811 StringToDouble(argv[i+1]));
1812 InheritException(exception,&(*image)->exception);
1816 if ((LocaleCompare("gaussian-blur",option+1) == 0) ||
1817 (LocaleCompare("gaussian",option+1) == 0))
1823 Gaussian blur image.
1825 (void) SyncImageSettings(mogrify_info,*image);
1826 flags=ParseGeometry(argv[i+1],&geometry_info);
1827 if ((flags & SigmaValue) == 0)
1828 geometry_info.sigma=1.0;
1829 gaussian_image=GaussianBlurImageChannel(*image,channel,
1830 geometry_info.rho,geometry_info.sigma,exception);
1831 if (gaussian_image == (Image *) NULL)
1833 *image=DestroyImage(*image);
1834 *image=gaussian_image;
1837 if (LocaleCompare("geometry",option+1) == 0)
1839 (void) SyncImageSettings(mogrify_info,*image);
1842 if ((*image)->geometry != (char *) NULL)
1843 (*image)->geometry=DestroyString((*image)->geometry);
1846 flags=ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
1847 if (((flags & XValue) != 0) || ((flags & YValue) != 0))
1848 (void) CloneString(&(*image)->geometry,argv[i+1]);
1857 zoom_image=ZoomImage(*image,geometry.width,geometry.height,
1859 if (zoom_image == (Image *) NULL)
1861 *image=DestroyImage(*image);
1866 if (LocaleCompare("gravity",option+1) == 0)
1870 draw_info->gravity=UndefinedGravity;
1873 draw_info->gravity=(GravityType) ParseMagickOption(
1874 MagickGravityOptions,MagickFalse,argv[i+1]);
1881 if (LocaleCompare("highlight-color",option+1) == 0)
1883 (void) SetImageArtifact(*image,option+1,argv[i+1]);
1890 if (LocaleCompare("identify",option+1) == 0)
1895 (void) SyncImageSettings(mogrify_info,*image);
1896 if (format == (char *) NULL)
1898 (void) IdentifyImage(*image,stdout,mogrify_info->verbose);
1899 InheritException(exception,&(*image)->exception);
1902 text=InterpretImageProperties(mogrify_info,*image,format);
1903 InheritException(exception,&(*image)->exception);
1904 if (text == (char *) NULL)
1906 (void) fputs(text,stdout);
1907 (void) fputc('\n',stdout);
1908 text=DestroyString(text);
1911 if (LocaleCompare("implode",option+1) == 0)
1919 (void) SyncImageSettings(mogrify_info,*image);
1920 (void) ParseGeometry(argv[i+1],&geometry_info);
1921 implode_image=ImplodeImage(*image,geometry_info.rho,exception);
1922 if (implode_image == (Image *) NULL)
1924 *image=DestroyImage(*image);
1925 *image=implode_image;
1928 if (LocaleCompare("interline-spacing",option+1) == 0)
1931 (void) ParseGeometry("0",&geometry_info);
1933 (void) ParseGeometry(argv[i+1],&geometry_info);
1934 draw_info->interline_spacing=geometry_info.rho;
1937 if (LocaleCompare("interword-spacing",option+1) == 0)
1940 (void) ParseGeometry("0",&geometry_info);
1942 (void) ParseGeometry(argv[i+1],&geometry_info);
1943 draw_info->interword_spacing=geometry_info.rho;
1950 if (LocaleCompare("kerning",option+1) == 0)
1953 (void) ParseGeometry("0",&geometry_info);
1955 (void) ParseGeometry(argv[i+1],&geometry_info);
1956 draw_info->kerning=geometry_info.rho;
1963 if (LocaleCompare("lat",option+1) == 0)
1969 Local adaptive threshold image.
1971 (void) SyncImageSettings(mogrify_info,*image);
1972 flags=ParseGeometry(argv[i+1],&geometry_info);
1973 if ((flags & PercentValue) != 0)
1974 geometry_info.xi=(double) QuantumRange*geometry_info.xi/100.0;
1975 threshold_image=AdaptiveThresholdImage(*image,(size_t)
1976 geometry_info.rho,(size_t) geometry_info.sigma,
1977 (ssize_t) geometry_info.xi,exception);
1978 if (threshold_image == (Image *) NULL)
1980 *image=DestroyImage(*image);
1981 *image=threshold_image;
1984 if (LocaleCompare("level",option+1) == 0)
1997 (void) SyncImageSettings(mogrify_info,*image);
1998 flags=ParseGeometry(argv[i+1],&geometry_info);
1999 black_point=geometry_info.rho;
2000 white_point=(MagickRealType) QuantumRange;
2001 if ((flags & SigmaValue) != 0)
2002 white_point=geometry_info.sigma;
2004 if ((flags & XiValue) != 0)
2005 gamma=geometry_info.xi;
2006 if ((flags & PercentValue) != 0)
2008 black_point*=(MagickRealType) (QuantumRange/100.0);
2009 white_point*=(MagickRealType) (QuantumRange/100.0);
2011 if ((flags & SigmaValue) == 0)
2012 white_point=(MagickRealType) QuantumRange-black_point;
2013 if ((*option == '+') || ((flags & AspectValue) != 0))
2014 (void) LevelizeImageChannel(*image,channel,black_point,
2017 (void) LevelImageChannel(*image,channel,black_point,white_point,
2019 InheritException(exception,&(*image)->exception);
2022 if (LocaleCompare("level-colors",option+1) == 0)
2025 token[MaxTextExtent];
2034 p=(const char *) argv[i+1];
2035 GetMagickToken(p,&p,token); /* get black point color */
2036 if ((isalpha((int) *token) != 0) || ((*token == '#') != 0))
2037 (void) QueryMagickColor(token,&black_point,exception);
2039 (void) QueryMagickColor("#000000",&black_point,exception);
2040 if (isalpha((int) token[0]) || (token[0] == '#'))
2041 GetMagickToken(p,&p,token);
2043 white_point=black_point; /* set everything to that color */
2047 Get white point color.
2049 if ((isalpha((int) *token) == 0) && ((*token == '#') == 0))
2050 GetMagickToken(p,&p,token);
2051 if ((isalpha((int) *token) != 0) || ((*token == '#') != 0))
2052 (void) QueryMagickColor(token,&white_point,exception);
2054 (void) QueryMagickColor("#ffffff",&white_point,exception);
2056 (void) LevelColorsImageChannel(*image,channel,&black_point,
2057 &white_point,*option == '+' ? MagickTrue : MagickFalse);
2060 if (LocaleCompare("linear-stretch",option+1) == 0)
2069 (void) SyncImageSettings(mogrify_info,*image);
2070 flags=ParseGeometry(argv[i+1],&geometry_info);
2071 black_point=geometry_info.rho;
2072 white_point=(MagickRealType) (*image)->columns*(*image)->rows;
2073 if ((flags & SigmaValue) != 0)
2074 white_point=geometry_info.sigma;
2075 if ((flags & PercentValue) != 0)
2077 black_point*=(double) (*image)->columns*(*image)->rows/100.0;
2078 white_point*=(double) (*image)->columns*(*image)->rows/100.0;
2080 if ((flags & SigmaValue) == 0)
2081 white_point=(MagickRealType) (*image)->columns*(*image)->rows-
2083 (void) LinearStretchImage(*image,black_point,white_point);
2084 InheritException(exception,&(*image)->exception);
2087 if (LocaleCompare("linewidth",option+1) == 0)
2089 draw_info->stroke_width=StringToDouble(argv[i+1]);
2092 if (LocaleCompare("liquid-rescale",option+1) == 0)
2098 Liquid rescale image.
2100 (void) SyncImageSettings(mogrify_info,*image);
2101 flags=ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
2102 if ((flags & XValue) == 0)
2104 if ((flags & YValue) == 0)
2106 resize_image=LiquidRescaleImage(*image,geometry.width,
2107 geometry.height,1.0*geometry.x,1.0*geometry.y,exception);
2108 if (resize_image == (Image *) NULL)
2110 *image=DestroyImage(*image);
2111 *image=resize_image;
2114 if (LocaleCompare("lowlight-color",option+1) == 0)
2116 (void) SetImageArtifact(*image,option+1,argv[i+1]);
2123 if (LocaleCompare("map",option+1) == 0)
2129 Transform image colors to match this set of colors.
2131 (void) SyncImageSettings(mogrify_info,*image);
2134 remap_image=GetImageCache(mogrify_info,argv[i+1],exception);
2135 if (remap_image == (Image *) NULL)
2137 (void) RemapImage(quantize_info,*image,remap_image);
2138 InheritException(exception,&(*image)->exception);
2139 remap_image=DestroyImage(remap_image);
2142 if (LocaleCompare("mask",option+1) == 0)
2147 (void) SyncImageSettings(mogrify_info,*image);
2153 (void) SetImageMask(*image,(Image *) NULL);
2154 InheritException(exception,&(*image)->exception);
2160 mask=GetImageCache(mogrify_info,argv[i+1],exception);
2161 if (mask == (Image *) NULL)
2163 (void) SetImageMask(*image,mask);
2164 mask=DestroyImage(mask);
2165 InheritException(exception,&(*image)->exception);
2168 if (LocaleCompare("matte",option+1) == 0)
2170 (void) SetImageAlphaChannel(*image,(*option == '-') ?
2171 SetAlphaChannel : DeactivateAlphaChannel );
2172 InheritException(exception,&(*image)->exception);
2175 if (LocaleCompare("median",option+1) == 0)
2181 Median filter image.
2183 (void) SyncImageSettings(mogrify_info,*image);
2184 (void) ParseGeometry(argv[i+1],&geometry_info);
2185 median_image=MedianFilterImage(*image,geometry_info.rho,exception);
2186 if (median_image == (Image *) NULL)
2188 *image=DestroyImage(*image);
2189 *image=median_image;
2192 if (LocaleCompare("modulate",option+1) == 0)
2194 (void) SyncImageSettings(mogrify_info,*image);
2195 (void) ModulateImage(*image,argv[i+1]);
2196 InheritException(exception,&(*image)->exception);
2199 if (LocaleCompare("monitor",option+1) == 0)
2203 (void) SetImageProgressMonitor(*image,
2204 (MagickProgressMonitor) NULL,(void *) NULL);
2207 (void) SetImageProgressMonitor(*image,MonitorProgress,
2211 if (LocaleCompare("monochrome",option+1) == 0)
2213 (void) SyncImageSettings(mogrify_info,*image);
2214 (void) SetImageType(*image,BilevelType);
2215 InheritException(exception,&(*image)->exception);
2218 if (LocaleCompare("morphology",option+1) == 0)
2221 token[MaxTextExtent];
2239 Morphological Image Operation
2241 (void) SyncImageSettings(mogrify_info,*image);
2243 GetMagickToken(p,&p,token);
2244 method=(MorphologyMethod) ParseMagickOption(MagickMorphologyOptions,
2247 GetMagickToken(p,&p,token);
2248 if ((*p == ':') || (*p == ','))
2249 GetMagickToken(p,&p,token);
2251 iterations=StringToLong(p);
2252 kernel=AcquireKernelInfo(argv[i+2]);
2253 if (kernel == (KernelInfo *) NULL)
2255 (void) ThrowMagickException(exception,GetMagickModule(),
2256 OptionError,"UnabletoParseKernel","morphology");
2260 morphology_image=MorphologyImageChannel(*image,channel,method,
2261 iterations,kernel,exception);
2262 kernel=DestroyKernelInfo(kernel);
2263 if (morphology_image == (Image *) NULL)
2265 *image=DestroyImage(*image);
2266 *image=morphology_image;
2269 if (LocaleCompare("motion-blur",option+1) == 0)
2277 (void) SyncImageSettings(mogrify_info,*image);
2278 flags=ParseGeometry(argv[i+1],&geometry_info);
2279 if ((flags & SigmaValue) == 0)
2280 geometry_info.sigma=1.0;
2281 blur_image=MotionBlurImageChannel(*image,channel,geometry_info.rho,
2282 geometry_info.sigma,geometry_info.xi,exception);
2283 if (blur_image == (Image *) NULL)
2285 *image=DestroyImage(*image);
2293 if (LocaleCompare("negate",option+1) == 0)
2295 (void) SyncImageSettings(mogrify_info,*image);
2296 (void) NegateImageChannel(*image,channel,*option == '+' ?
2297 MagickTrue : MagickFalse);
2298 InheritException(exception,&(*image)->exception);
2301 if (LocaleCompare("noise",option+1) == 0)
2306 (void) SyncImageSettings(mogrify_info,*image);
2309 (void) ParseGeometry(argv[i+1],&geometry_info);
2310 noisy_image=ReduceNoiseImage(*image,geometry_info.rho,
2318 noise=(NoiseType) ParseMagickOption(MagickNoiseOptions,
2319 MagickFalse,argv[i+1]);
2320 noisy_image=AddNoiseImageChannel(*image,channel,noise,
2323 if (noisy_image == (Image *) NULL)
2325 *image=DestroyImage(*image);
2329 if (LocaleCompare("normalize",option+1) == 0)
2331 (void) SyncImageSettings(mogrify_info,*image);
2332 (void) NormalizeImageChannel(*image,channel);
2333 InheritException(exception,&(*image)->exception);
2340 if (LocaleCompare("opaque",option+1) == 0)
2345 (void) SyncImageSettings(mogrify_info,*image);
2346 (void) QueryMagickColor(argv[i+1],&target,exception);
2347 (void) OpaquePaintImageChannel(*image,channel,&target,&fill,
2348 *option == '-' ? MagickFalse : MagickTrue);
2351 if (LocaleCompare("ordered-dither",option+1) == 0)
2353 (void) SyncImageSettings(mogrify_info,*image);
2354 (void) OrderedPosterizeImageChannel(*image,channel,argv[i+1],
2362 if (LocaleCompare("paint",option+1) == 0)
2370 (void) SyncImageSettings(mogrify_info,*image);
2371 (void) ParseGeometry(argv[i+1],&geometry_info);
2372 paint_image=OilPaintImage(*image,geometry_info.rho,exception);
2373 if (paint_image == (Image *) NULL)
2375 *image=DestroyImage(*image);
2379 if (LocaleCompare("pen",option+1) == 0)
2383 (void) QueryColorDatabase("none",&draw_info->fill,exception);
2386 (void) QueryColorDatabase(argv[i+1],&draw_info->fill,exception);
2389 if (LocaleCompare("pointsize",option+1) == 0)
2392 (void) ParseGeometry("12",&geometry_info);
2394 (void) ParseGeometry(argv[i+1],&geometry_info);
2395 draw_info->pointsize=geometry_info.rho;
2398 if (LocaleCompare("polaroid",option+1) == 0)
2410 Simulate a Polaroid picture.
2412 (void) SyncImageSettings(mogrify_info,*image);
2413 random_info=AcquireRandomInfo();
2414 angle=22.5*(GetPseudoRandomValue(random_info)-0.5);
2415 random_info=DestroyRandomInfo(random_info);
2418 SetGeometryInfo(&geometry_info);
2419 flags=ParseGeometry(argv[i+1],&geometry_info);
2420 angle=geometry_info.rho;
2422 polaroid_image=PolaroidImage(*image,draw_info,angle,exception);
2423 if (polaroid_image == (Image *) NULL)
2425 *image=DestroyImage(*image);
2426 *image=polaroid_image;
2429 if (LocaleCompare("posterize",option+1) == 0)
2434 (void) SyncImageSettings(mogrify_info,*image);
2435 (void) PosterizeImage(*image,StringToUnsignedLong(argv[i+1]),
2436 quantize_info->dither);
2437 InheritException(exception,&(*image)->exception);
2440 if (LocaleCompare("preview",option+1) == 0)
2451 (void) SyncImageSettings(mogrify_info,*image);
2453 preview_type=UndefinedPreview;
2455 preview_type=(PreviewType) ParseMagickOption(MagickPreviewOptions,
2456 MagickFalse,argv[i+1]);
2457 preview_image=PreviewImage(*image,preview_type,exception);
2458 if (preview_image == (Image *) NULL)
2460 *image=DestroyImage(*image);
2461 *image=preview_image;
2464 if (LocaleCompare("profile",option+1) == 0)
2478 (void) SyncImageSettings(mogrify_info,*image);
2482 Remove a profile from the image.
2484 (void) ProfileImage(*image,argv[i+1],(const unsigned char *)
2486 InheritException(exception,&(*image)->exception);
2490 Associate a profile with the image.
2492 profile_info=CloneImageInfo(mogrify_info);
2493 profile=GetImageProfile(*image,"iptc");
2494 if (profile != (StringInfo *) NULL)
2495 profile_info->profile=(void *) CloneStringInfo(profile);
2496 profile_image=GetImageCache(profile_info,argv[i+1],exception);
2497 profile_info=DestroyImageInfo(profile_info);
2498 if (profile_image == (Image *) NULL)
2503 profile_info=CloneImageInfo(mogrify_info);
2504 (void) CopyMagickString(profile_info->filename,argv[i+1],
2506 profile=FileToStringInfo(profile_info->filename,~0UL,exception);
2507 if (profile != (StringInfo *) NULL)
2509 (void) ProfileImage(*image,profile_info->magick,
2510 GetStringInfoDatum(profile),(size_t)
2511 GetStringInfoLength(profile),MagickFalse);
2512 profile=DestroyStringInfo(profile);
2514 profile_info=DestroyImageInfo(profile_info);
2517 ResetImageProfileIterator(profile_image);
2518 name=GetNextImageProfile(profile_image);
2519 while (name != (const char *) NULL)
2521 profile=GetImageProfile(profile_image,name);
2522 if (profile != (StringInfo *) NULL)
2523 (void) ProfileImage(*image,name,GetStringInfoDatum(profile),
2524 (size_t) GetStringInfoLength(profile),MagickFalse);
2525 name=GetNextImageProfile(profile_image);
2527 profile_image=DestroyImage(profile_image);
2534 if (LocaleCompare("quantize",option+1) == 0)
2538 quantize_info->colorspace=UndefinedColorspace;
2541 quantize_info->colorspace=(ColorspaceType) ParseMagickOption(
2542 MagickColorspaceOptions,MagickFalse,argv[i+1]);
2549 if (LocaleCompare("radial-blur",option+1) == 0)
2557 (void) SyncImageSettings(mogrify_info,*image);
2558 blur_image=RadialBlurImageChannel(*image,channel,
2559 StringToDouble(argv[i+1]),exception);
2560 if (blur_image == (Image *) NULL)
2562 *image=DestroyImage(*image);
2566 if (LocaleCompare("raise",option+1) == 0)
2569 Surround image with a raise of solid color.
2571 flags=ParsePageGeometry(*image,argv[i+1],&geometry,exception);
2572 if ((flags & SigmaValue) == 0)
2573 geometry.height=geometry.width;
2574 (void) RaiseImage(*image,&geometry,*option == '-' ? MagickTrue :
2576 InheritException(exception,&(*image)->exception);
2579 if (LocaleCompare("random-threshold",option+1) == 0)
2584 (void) SyncImageSettings(mogrify_info,*image);
2585 (void) RandomThresholdImageChannel(*image,channel,argv[i+1],
2589 if (LocaleCompare("recolor",option+1) == 0)
2597 (void) SyncImageSettings(mogrify_info,*image);
2598 kernel=AcquireKernelInfo(argv[i+1]);
2599 if (kernel == (KernelInfo *) NULL)
2601 color_image=ColorMatrixImage(*image,kernel,exception);
2602 kernel=DestroyKernelInfo(kernel);
2603 if (color_image == (Image *) NULL)
2605 *image=DestroyImage(*image);
2609 if (LocaleCompare("region",option+1) == 0)
2614 (void) SyncImageSettings(mogrify_info,*image);
2615 if (region_image != (Image *) NULL)
2620 (void) CompositeImage(region_image,(*image)->matte !=
2621 MagickFalse ? OverCompositeOp : CopyCompositeOp,*image,
2622 region_geometry.x,region_geometry.y);
2623 InheritException(exception,®ion_image->exception);
2624 *image=DestroyImage(*image);
2625 *image=region_image;
2629 if (region_image != (Image *) NULL)
2630 region_image=DestroyImage(region_image);
2634 Apply transformations to a selected region of the image.
2636 (void) ParseGravityGeometry(*image,argv[i+1],®ion_geometry,
2638 crop_image=CropImage(*image,®ion_geometry,exception);
2639 if (crop_image == (Image *) NULL)
2641 region_image=(*image);
2645 if (LocaleCompare("render",option+1) == 0)
2647 (void) SyncImageSettings(mogrify_info,*image);
2648 draw_info->render=(*option == '+') ? MagickTrue : MagickFalse;
2651 if (LocaleCompare("remap",option+1) == 0)
2657 Transform image colors to match this set of colors.
2659 (void) SyncImageSettings(mogrify_info,*image);
2662 remap_image=GetImageCache(mogrify_info,argv[i+1],exception);
2663 if (remap_image == (Image *) NULL)
2665 (void) RemapImage(quantize_info,*image,remap_image);
2666 InheritException(exception,&(*image)->exception);
2667 remap_image=DestroyImage(remap_image);
2670 if (LocaleCompare("repage",option+1) == 0)
2674 (void) ParseAbsoluteGeometry("0x0+0+0",&(*image)->page);
2677 (void) ResetImagePage(*image,argv[i+1]);
2678 InheritException(exception,&(*image)->exception);
2681 if (LocaleCompare("resample",option+1) == 0)
2689 (void) SyncImageSettings(mogrify_info,*image);
2690 flags=ParseGeometry(argv[i+1],&geometry_info);
2691 if ((flags & SigmaValue) == 0)
2692 geometry_info.sigma=geometry_info.rho;
2693 resample_image=ResampleImage(*image,geometry_info.rho,
2694 geometry_info.sigma,(*image)->filter,(*image)->blur,exception);
2695 if (resample_image == (Image *) NULL)
2697 *image=DestroyImage(*image);
2698 *image=resample_image;
2701 if (LocaleCompare("resize",option+1) == 0)
2709 (void) SyncImageSettings(mogrify_info,*image);
2710 (void) ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
2711 resize_image=ResizeImage(*image,geometry.width,geometry.height,
2712 (*image)->filter,(*image)->blur,exception);
2713 if (resize_image == (Image *) NULL)
2715 *image=DestroyImage(*image);
2716 *image=resize_image;
2719 if (LocaleNCompare("respect-parentheses",option+1,17) == 0)
2721 respect_parenthesis=(*option == '-') ? MagickTrue : MagickFalse;
2724 if (LocaleCompare("roll",option+1) == 0)
2732 (void) SyncImageSettings(mogrify_info,*image);
2733 (void) ParsePageGeometry(*image,argv[i+1],&geometry,exception);
2734 roll_image=RollImage(*image,geometry.x,geometry.y,exception);
2735 if (roll_image == (Image *) NULL)
2737 *image=DestroyImage(*image);
2741 if (LocaleCompare("rotate",option+1) == 0)
2750 Check for conditional image rotation.
2752 (void) SyncImageSettings(mogrify_info,*image);
2753 if (strchr(argv[i+1],'>') != (char *) NULL)
2754 if ((*image)->columns <= (*image)->rows)
2756 if (strchr(argv[i+1],'<') != (char *) NULL)
2757 if ((*image)->columns >= (*image)->rows)
2762 geometry=ConstantString(argv[i+1]);
2763 (void) SubstituteString(&geometry,">","");
2764 (void) SubstituteString(&geometry,"<","");
2765 (void) ParseGeometry(geometry,&geometry_info);
2766 geometry=DestroyString(geometry);
2767 rotate_image=RotateImage(*image,geometry_info.rho,exception);
2768 if (rotate_image == (Image *) NULL)
2770 *image=DestroyImage(*image);
2771 *image=rotate_image;
2778 if (LocaleCompare("sample",option+1) == 0)
2784 Sample image with pixel replication.
2786 (void) SyncImageSettings(mogrify_info,*image);
2787 (void) ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
2788 sample_image=SampleImage(*image,geometry.width,geometry.height,
2790 if (sample_image == (Image *) NULL)
2792 *image=DestroyImage(*image);
2793 *image=sample_image;
2796 if (LocaleCompare("scale",option+1) == 0)
2804 (void) SyncImageSettings(mogrify_info,*image);
2805 (void) ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
2806 scale_image=ScaleImage(*image,geometry.width,geometry.height,
2808 if (scale_image == (Image *) NULL)
2810 *image=DestroyImage(*image);
2814 if (LocaleCompare("selective-blur",option+1) == 0)
2820 Selectively blur pixels within a contrast threshold.
2822 (void) SyncImageSettings(mogrify_info,*image);
2823 flags=ParseGeometry(argv[i+1],&geometry_info);
2824 if ((flags & PercentValue) != 0)
2825 geometry_info.xi=(double) QuantumRange*geometry_info.xi/100.0;
2826 blur_image=SelectiveBlurImageChannel(*image,channel,
2827 geometry_info.rho,geometry_info.sigma,geometry_info.xi,exception);
2828 if (blur_image == (Image *) NULL)
2830 *image=DestroyImage(*image);
2834 if (LocaleCompare("separate",option+1) == 0)
2840 Break channels into separate images.
2842 (void) SyncImageSettings(mogrify_info,*image);
2843 separate_images=SeparateImages(*image,channel,exception);
2844 if (separate_images == (Image *) NULL)
2846 *image=DestroyImage(*image);
2847 *image=separate_images;
2850 if (LocaleCompare("sepia-tone",option+1) == 0)
2861 (void) SyncImageSettings(mogrify_info,*image);
2862 threshold=SiPrefixToDouble(argv[i+1],QuantumRange);
2863 sepia_image=SepiaToneImage(*image,threshold,exception);
2864 if (sepia_image == (Image *) NULL)
2866 *image=DestroyImage(*image);
2870 if (LocaleCompare("segment",option+1) == 0)
2875 (void) SyncImageSettings(mogrify_info,*image);
2876 flags=ParseGeometry(argv[i+1],&geometry_info);
2877 if ((flags & SigmaValue) == 0)
2878 geometry_info.sigma=1.0;
2879 (void) SegmentImage(*image,(*image)->colorspace,
2880 mogrify_info->verbose,geometry_info.rho,geometry_info.sigma);
2881 InheritException(exception,&(*image)->exception);
2884 if (LocaleCompare("set",option+1) == 0)
2894 if (LocaleNCompare(argv[i+1],"registry:",9) == 0)
2895 (void) DeleteImageRegistry(argv[i+1]+9);
2897 if (LocaleNCompare(argv[i+1],"option:",7) == 0)
2899 (void) DeleteImageOption(mogrify_info,argv[i+1]+7);
2900 (void) DeleteImageArtifact(*image,argv[i+1]+7);
2903 (void) DeleteImageProperty(*image,argv[i+1]);
2906 value=InterpretImageProperties(mogrify_info,*image,argv[i+2]);
2907 if (value == (char *) NULL)
2909 if (LocaleNCompare(argv[i+1],"registry:",9) == 0)
2910 (void) SetImageRegistry(StringRegistryType,argv[i+1]+9,value,
2913 if (LocaleNCompare(argv[i+1],"option:",7) == 0)
2915 (void) SetImageOption(mogrify_info,argv[i+1]+7,value);
2916 (void) SetImageArtifact(*image,argv[i+1]+7,value);
2919 (void) SetImageProperty(*image,argv[i+1],value);
2920 value=DestroyString(value);
2923 if (LocaleCompare("shade",option+1) == 0)
2931 (void) SyncImageSettings(mogrify_info,*image);
2932 flags=ParseGeometry(argv[i+1],&geometry_info);
2933 if ((flags & SigmaValue) == 0)
2934 geometry_info.sigma=1.0;
2935 shade_image=ShadeImage(*image,(*option == '-') ? MagickTrue :
2936 MagickFalse,geometry_info.rho,geometry_info.sigma,exception);
2937 if (shade_image == (Image *) NULL)
2939 *image=DestroyImage(*image);
2943 if (LocaleCompare("shadow",option+1) == 0)
2951 (void) SyncImageSettings(mogrify_info,*image);
2952 flags=ParseGeometry(argv[i+1],&geometry_info);
2953 if ((flags & SigmaValue) == 0)
2954 geometry_info.sigma=1.0;
2955 if ((flags & XiValue) == 0)
2956 geometry_info.xi=4.0;
2957 if ((flags & PsiValue) == 0)
2958 geometry_info.psi=4.0;
2959 shadow_image=ShadowImage(*image,geometry_info.rho,
2960 geometry_info.sigma,(ssize_t) ceil(geometry_info.xi-0.5),(ssize_t)
2961 ceil(geometry_info.psi-0.5),exception);
2962 if (shadow_image == (Image *) NULL)
2964 *image=DestroyImage(*image);
2965 *image=shadow_image;
2968 if (LocaleCompare("sharpen",option+1) == 0)
2976 (void) SyncImageSettings(mogrify_info,*image);
2977 flags=ParseGeometry(argv[i+1],&geometry_info);
2978 if ((flags & SigmaValue) == 0)
2979 geometry_info.sigma=1.0;
2980 sharp_image=SharpenImageChannel(*image,channel,geometry_info.rho,
2981 geometry_info.sigma,exception);
2982 if (sharp_image == (Image *) NULL)
2984 *image=DestroyImage(*image);
2988 if (LocaleCompare("shave",option+1) == 0)
2994 Shave the image edges.
2996 (void) SyncImageSettings(mogrify_info,*image);
2997 flags=ParsePageGeometry(*image,argv[i+1],&geometry,exception);
2998 shave_image=ShaveImage(*image,&geometry,exception);
2999 if (shave_image == (Image *) NULL)
3001 *image=DestroyImage(*image);
3005 if (LocaleCompare("shear",option+1) == 0)
3013 (void) SyncImageSettings(mogrify_info,*image);
3014 flags=ParseGeometry(argv[i+1],&geometry_info);
3015 if ((flags & SigmaValue) == 0)
3016 geometry_info.sigma=geometry_info.rho;
3017 shear_image=ShearImage(*image,geometry_info.rho,geometry_info.sigma,
3019 if (shear_image == (Image *) NULL)
3021 *image=DestroyImage(*image);
3025 if (LocaleCompare("sigmoidal-contrast",option+1) == 0)
3028 Sigmoidal non-linearity contrast control.
3030 (void) SyncImageSettings(mogrify_info,*image);
3031 flags=ParseGeometry(argv[i+1],&geometry_info);
3032 if ((flags & SigmaValue) == 0)
3033 geometry_info.sigma=(double) QuantumRange/2.0;
3034 if ((flags & PercentValue) != 0)
3035 geometry_info.sigma=(double) QuantumRange*geometry_info.sigma/
3037 (void) SigmoidalContrastImageChannel(*image,channel,
3038 (*option == '-') ? MagickTrue : MagickFalse,geometry_info.rho,
3039 geometry_info.sigma);
3040 InheritException(exception,&(*image)->exception);
3043 if (LocaleCompare("sketch",option+1) == 0)
3051 (void) SyncImageSettings(mogrify_info,*image);
3052 flags=ParseGeometry(argv[i+1],&geometry_info);
3053 if ((flags & SigmaValue) == 0)
3054 geometry_info.sigma=1.0;
3055 sketch_image=SketchImage(*image,geometry_info.rho,
3056 geometry_info.sigma,geometry_info.xi,exception);
3057 if (sketch_image == (Image *) NULL)
3059 *image=DestroyImage(*image);
3060 *image=sketch_image;
3063 if (LocaleCompare("solarize",option+1) == 0)
3068 (void) SyncImageSettings(mogrify_info,*image);
3069 threshold=SiPrefixToDouble(argv[i+1],QuantumRange);
3070 (void) SolarizeImage(*image,threshold);
3071 InheritException(exception,&(*image)->exception);
3074 if (LocaleCompare("sparse-color",option+1) == 0)
3086 Sparse Color Interpolated Gradient
3088 (void) SyncImageSettings(mogrify_info,*image);
3089 method=(SparseColorMethod) ParseMagickOption(
3090 MagickSparseColorOptions,MagickFalse,argv[i+1]);
3091 arguments=InterpretImageProperties(mogrify_info,*image,argv[i+2]);
3092 InheritException(exception,&(*image)->exception);
3093 if (arguments == (char *) NULL)
3095 sparse_image=SparseColorOption(*image,channel,method,arguments,
3096 option[0] == '+' ? MagickTrue : MagickFalse,exception);
3097 arguments=DestroyString(arguments);
3098 if (sparse_image == (Image *) NULL)
3100 *image=DestroyImage(*image);
3101 *image=sparse_image;
3104 if (LocaleCompare("splice",option+1) == 0)
3110 Splice a solid color into the image.
3112 (void) SyncImageSettings(mogrify_info,*image);
3113 (void) ParseGravityGeometry(*image,argv[i+1],&geometry,exception);
3114 splice_image=SpliceImage(*image,&geometry,exception);
3115 if (splice_image == (Image *) NULL)
3117 *image=DestroyImage(*image);
3118 *image=splice_image;
3121 if (LocaleCompare("spread",option+1) == 0)
3129 (void) SyncImageSettings(mogrify_info,*image);
3130 (void) ParseGeometry(argv[i+1],&geometry_info);
3131 spread_image=SpreadImage(*image,geometry_info.rho,exception);
3132 if (spread_image == (Image *) NULL)
3134 *image=DestroyImage(*image);
3135 *image=spread_image;
3138 if (LocaleCompare("stretch",option+1) == 0)
3142 draw_info->stretch=UndefinedStretch;
3145 draw_info->stretch=(StretchType) ParseMagickOption(
3146 MagickStretchOptions,MagickFalse,argv[i+1]);
3149 if (LocaleCompare("strip",option+1) == 0)
3152 Strip image of profiles and comments.
3154 (void) SyncImageSettings(mogrify_info,*image);
3155 (void) StripImage(*image);
3156 InheritException(exception,&(*image)->exception);
3159 if (LocaleCompare("stroke",option+1) == 0)
3166 (void) QueryColorDatabase("none",&draw_info->stroke,exception);
3167 if (draw_info->stroke_pattern != (Image *) NULL)
3168 draw_info->stroke_pattern=DestroyImage(
3169 draw_info->stroke_pattern);
3172 sans=AcquireExceptionInfo();
3173 status=QueryColorDatabase(argv[i+1],&draw_info->stroke,sans);
3174 sans=DestroyExceptionInfo(sans);
3175 if (status == MagickFalse)
3176 draw_info->stroke_pattern=GetImageCache(mogrify_info,argv[i+1],
3180 if (LocaleCompare("strokewidth",option+1) == 0)
3182 draw_info->stroke_width=StringToDouble(argv[i+1]);
3185 if (LocaleCompare("style",option+1) == 0)
3189 draw_info->style=UndefinedStyle;
3192 draw_info->style=(StyleType) ParseMagickOption(MagickStyleOptions,
3193 MagickFalse,argv[i+1]);
3196 if (LocaleCompare("swirl",option+1) == 0)
3204 (void) SyncImageSettings(mogrify_info,*image);
3205 (void) ParseGeometry(argv[i+1],&geometry_info);
3206 swirl_image=SwirlImage(*image,geometry_info.rho,exception);
3207 if (swirl_image == (Image *) NULL)
3209 *image=DestroyImage(*image);
3217 if (LocaleCompare("threshold",option+1) == 0)
3225 (void) SyncImageSettings(mogrify_info,*image);
3227 threshold=(double) QuantumRange/2.5;
3229 threshold=SiPrefixToDouble(argv[i+1],QuantumRange);
3230 (void) BilevelImageChannel(*image,channel,threshold);
3231 InheritException(exception,&(*image)->exception);
3234 if (LocaleCompare("thumbnail",option+1) == 0)
3242 (void) SyncImageSettings(mogrify_info,*image);
3243 (void) ParseRegionGeometry(*image,argv[i+1],&geometry,exception);
3244 thumbnail_image=ThumbnailImage(*image,geometry.width,
3245 geometry.height,exception);
3246 if (thumbnail_image == (Image *) NULL)
3248 *image=DestroyImage(*image);
3249 *image=thumbnail_image;
3252 if (LocaleCompare("tile",option+1) == 0)
3256 if (draw_info->fill_pattern != (Image *) NULL)
3257 draw_info->fill_pattern=DestroyImage(draw_info->fill_pattern);
3260 draw_info->fill_pattern=GetImageCache(mogrify_info,argv[i+1],
3264 if (LocaleCompare("tint",option+1) == 0)
3272 (void) SyncImageSettings(mogrify_info,*image);
3273 tint_image=TintImage(*image,argv[i+1],draw_info->fill,exception);
3274 if (tint_image == (Image *) NULL)
3276 *image=DestroyImage(*image);
3280 if (LocaleCompare("transform",option+1) == 0)
3286 Affine transform image.
3288 (void) SyncImageSettings(mogrify_info,*image);
3289 transform_image=AffineTransformImage(*image,&draw_info->affine,
3291 if (transform_image == (Image *) NULL)
3293 *image=DestroyImage(*image);
3294 *image=transform_image;
3297 if (LocaleCompare("transparent",option+1) == 0)
3302 (void) SyncImageSettings(mogrify_info,*image);
3303 (void) QueryMagickColor(argv[i+1],&target,exception);
3304 (void) TransparentPaintImage(*image,&target,(Quantum)
3305 TransparentOpacity,*option == '-' ? MagickFalse : MagickTrue);
3306 InheritException(exception,&(*image)->exception);
3309 if (LocaleCompare("transpose",option+1) == 0)
3315 Transpose image scanlines.
3317 (void) SyncImageSettings(mogrify_info,*image);
3318 transpose_image=TransposeImage(*image,exception);
3319 if (transpose_image == (Image *) NULL)
3321 *image=DestroyImage(*image);
3322 *image=transpose_image;
3325 if (LocaleCompare("transverse",option+1) == 0)
3331 Transverse image scanlines.
3333 (void) SyncImageSettings(mogrify_info,*image);
3334 transverse_image=TransverseImage(*image,exception);
3335 if (transverse_image == (Image *) NULL)
3337 *image=DestroyImage(*image);
3338 *image=transverse_image;
3341 if (LocaleCompare("treedepth",option+1) == 0)
3343 quantize_info->tree_depth=StringToUnsignedLong(argv[i+1]);
3346 if (LocaleCompare("trim",option+1) == 0)
3354 (void) SyncImageSettings(mogrify_info,*image);
3355 trim_image=TrimImage(*image,exception);
3356 if (trim_image == (Image *) NULL)
3358 *image=DestroyImage(*image);
3362 if (LocaleCompare("type",option+1) == 0)
3367 (void) SyncImageSettings(mogrify_info,*image);
3371 type=(ImageType) ParseMagickOption(MagickTypeOptions,MagickFalse,
3373 (*image)->type=UndefinedType;
3374 (void) SetImageType(*image,type);
3375 InheritException(exception,&(*image)->exception);
3382 if (LocaleCompare("undercolor",option+1) == 0)
3384 (void) QueryColorDatabase(argv[i+1],&draw_info->undercolor,
3388 if (LocaleCompare("unique",option+1) == 0)
3392 (void) DeleteImageArtifact(*image,"identify:unique-colors");
3395 (void) SetImageArtifact(*image,"identify:unique-colors","true");
3396 (void) SetImageArtifact(*image,"identify:verbose","true");
3399 if (LocaleCompare("unique-colors",option+1) == 0)
3405 Unique image colors.
3407 (void) SyncImageSettings(mogrify_info,*image);
3408 unique_image=UniqueImageColors(*image,exception);
3409 if (unique_image == (Image *) NULL)
3411 *image=DestroyImage(*image);
3412 *image=unique_image;
3415 if (LocaleCompare("unsharp",option+1) == 0)
3423 (void) SyncImageSettings(mogrify_info,*image);
3424 flags=ParseGeometry(argv[i+1],&geometry_info);
3425 if ((flags & SigmaValue) == 0)
3426 geometry_info.sigma=1.0;
3427 if ((flags & XiValue) == 0)
3428 geometry_info.xi=1.0;
3429 if ((flags & PsiValue) == 0)
3430 geometry_info.psi=0.05;
3431 unsharp_image=UnsharpMaskImageChannel(*image,channel,
3432 geometry_info.rho,geometry_info.sigma,geometry_info.xi,
3433 geometry_info.psi,exception);
3434 if (unsharp_image == (Image *) NULL)
3436 *image=DestroyImage(*image);
3437 *image=unsharp_image;
3444 if (LocaleCompare("verbose",option+1) == 0)
3446 (void) SetImageArtifact(*image,option+1,
3447 *option == '+' ? "false" : "true");
3450 if (LocaleCompare("vignette",option+1) == 0)
3458 (void) SyncImageSettings(mogrify_info,*image);
3459 flags=ParseGeometry(argv[i+1],&geometry_info);
3460 if ((flags & SigmaValue) == 0)
3461 geometry_info.sigma=1.0;
3462 if ((flags & XiValue) == 0)
3463 geometry_info.xi=0.1*(*image)->columns;
3464 if ((flags & PsiValue) == 0)
3465 geometry_info.psi=0.1*(*image)->rows;
3466 vignette_image=VignetteImage(*image,geometry_info.rho,
3467 geometry_info.sigma,(ssize_t) ceil(geometry_info.xi-0.5),(ssize_t)
3468 ceil(geometry_info.psi-0.5),exception);
3469 if (vignette_image == (Image *) NULL)
3471 *image=DestroyImage(*image);
3472 *image=vignette_image;
3475 if (LocaleCompare("virtual-pixel",option+1) == 0)
3479 (void) SetImageVirtualPixelMethod(*image,
3480 UndefinedVirtualPixelMethod);
3483 (void) SetImageVirtualPixelMethod(*image,(VirtualPixelMethod)
3484 ParseMagickOption(MagickVirtualPixelOptions,MagickFalse,
3492 if (LocaleCompare("wave",option+1) == 0)
3500 (void) SyncImageSettings(mogrify_info,*image);
3501 flags=ParseGeometry(argv[i+1],&geometry_info);
3502 if ((flags & SigmaValue) == 0)
3503 geometry_info.sigma=1.0;
3504 wave_image=WaveImage(*image,geometry_info.rho,geometry_info.sigma,
3506 if (wave_image == (Image *) NULL)
3508 *image=DestroyImage(*image);
3512 if (LocaleCompare("weight",option+1) == 0)
3514 draw_info->weight=StringToUnsignedLong(argv[i+1]);
3515 if (LocaleCompare(argv[i+1],"all") == 0)
3516 draw_info->weight=0;
3517 if (LocaleCompare(argv[i+1],"bold") == 0)
3518 draw_info->weight=700;
3519 if (LocaleCompare(argv[i+1],"bolder") == 0)
3520 if (draw_info->weight <= 800)
3521 draw_info->weight+=100;
3522 if (LocaleCompare(argv[i+1],"lighter") == 0)
3523 if (draw_info->weight >= 100)
3524 draw_info->weight-=100;
3525 if (LocaleCompare(argv[i+1],"normal") == 0)
3526 draw_info->weight=400;
3529 if (LocaleCompare("white-threshold",option+1) == 0)
3532 White threshold image.
3534 (void) SyncImageSettings(mogrify_info,*image);
3535 (void) WhiteThresholdImageChannel(*image,channel,argv[i+1],
3537 InheritException(exception,&(*image)->exception);
3547 if (region_image != (Image *) NULL)
3550 Composite transformed region onto image.
3552 (void) SyncImageSettings(mogrify_info,*image);
3553 (void) CompositeImage(region_image,(*image)->matte != MagickFalse ?
3554 OverCompositeOp : CopyCompositeOp,*image,region_geometry.x,
3556 InheritException(exception,®ion_image->exception);
3557 *image=DestroyImage(*image);
3558 *image=region_image;
3563 quantize_info=DestroyQuantizeInfo(quantize_info);
3564 draw_info=DestroyDrawInfo(draw_info);
3565 mogrify_info=DestroyImageInfo(mogrify_info);
3566 status=(*image)->exception.severity == UndefinedException ? MagickTrue :
3572 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3576 % M o g r i f y I m a g e C o m m a n d %
3580 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3582 % MogrifyImageCommand() transforms an image or a sequence of images. These
3583 % transforms include image scaling, image rotation, color reduction, and
3584 % others. The transmogrified image overwrites the original image.
3586 % The format of the MogrifyImageCommand method is:
3588 % MagickBooleanType MogrifyImageCommand(ImageInfo *image_info,int argc,
3589 % const char **argv,char **metadata,ExceptionInfo *exception)
3591 % A description of each parameter follows:
3593 % o image_info: the image info.
3595 % o argc: the number of elements in the argument vector.
3597 % o argv: A text array containing the command line arguments.
3599 % o metadata: any metadata is returned here.
3601 % o exception: return any errors or warnings in this structure.
3605 static MagickBooleanType MogrifyUsage(void)
3610 "-debug events display copious debugging information",
3611 "-help print program options",
3612 "-list type print a list of supported option arguments",
3613 "-log format format of debugging information",
3614 "-version print version information",
3619 "-adaptive-blur geometry",
3620 " adaptively blur pixels; decrease effect near edges",
3621 "-adaptive-resize geometry",
3622 " adaptively resize image using 'mesh' interpolation",
3623 "-adaptive-sharpen geometry",
3624 " adaptively sharpen pixels; increase effect near edges",
3625 "-alpha option on, activate, off, deactivate, set, opaque, copy",
3626 " transparent, extract, background, or shape",
3627 "-annotate geometry text",
3628 " annotate the image with text",
3629 "-auto-gamma automagically adjust gamma level of image",
3630 "-auto-level automagically adjust color levels of image",
3631 "-auto-orient automagically orient (rotate) image",
3632 "-bench iterations measure performance",
3633 "-black-threshold value",
3634 " force all pixels below the threshold into black",
3635 "-blue-shift simulate a scene at nighttime in the moonlight",
3636 "-blur geometry reduce image noise and reduce detail levels",
3637 "-border geometry surround image with a border of color",
3638 "-bordercolor color border color",
3639 "-brightness-contrast geometry",
3640 " improve brightness / contrast of the image",
3641 "-cdl filename color correct with a color decision list",
3642 "-charcoal radius simulate a charcoal drawing",
3643 "-chop geometry remove pixels from the image interior",
3644 "-clamp restrict pixel range from 0 to the quantum depth",
3645 "-clip clip along the first path from the 8BIM profile",
3646 "-clip-mask filename associate a clip mask with the image",
3647 "-clip-path id clip along a named path from the 8BIM profile",
3648 "-colorize value colorize the image with the fill color",
3649 "-color-matrix matrix apply color correction to the image",
3650 "-contrast enhance or reduce the image contrast",
3651 "-contrast-stretch geometry",
3652 " improve contrast by `stretching' the intensity range",
3653 "-convolve coefficients",
3654 " apply a convolution kernel to the image",
3655 "-cycle amount cycle the image colormap",
3656 "-decipher filename convert cipher pixels to plain pixels",
3657 "-deskew threshold straighten an image",
3658 "-despeckle reduce the speckles within an image",
3659 "-distort method args",
3660 " distort images according to given method ad args",
3661 "-draw string annotate the image with a graphic primitive",
3662 "-edge radius apply a filter to detect edges in the image",
3663 "-encipher filename convert plain pixels to cipher pixels",
3664 "-emboss radius emboss an image",
3665 "-enhance apply a digital filter to enhance a noisy image",
3666 "-equalize perform histogram equalization to an image",
3667 "-evaluate operator value",
3668 " evaluate an arithmetic, relational, or logical expression",
3669 "-extent geometry set the image size",
3670 "-extract geometry extract area from image",
3671 "-fft implements the discrete Fourier transform (DFT)",
3672 "-flip flip image vertically",
3673 "-floodfill geometry color",
3674 " floodfill the image with color",
3675 "-flop flop image horizontally",
3676 "-frame geometry surround image with an ornamental border",
3677 "-function name parameters",
3678 " apply function over image values",
3679 "-gamma value level of gamma correction",
3680 "-gaussian-blur geometry",
3681 " reduce image noise and reduce detail levels",
3682 "-geometry geometry preferred size or location of the image",
3683 "-identify identify the format and characteristics of the image",
3684 "-ift implements the inverse discrete Fourier transform (DFT)",
3685 "-implode amount implode image pixels about the center",
3686 "-lat geometry local adaptive thresholding",
3687 "-layers method optimize, merge, or compare image layers",
3688 "-level value adjust the level of image contrast",
3689 "-level-colors color,color",
3690 " level image with the given colors",
3691 "-linear-stretch geometry",
3692 " improve contrast by `stretching with saturation'",
3693 "-liquid-rescale geometry",
3694 " rescale image with seam-carving",
3695 "-median radius apply a median filter to the image",
3696 "-modulate value vary the brightness, saturation, and hue",
3697 "-monochrome transform image to black and white",
3698 "-morphology method kernel",
3699 " apply a morphology method to the image",
3700 "-motion-blur geometry",
3701 " simulate motion blur",
3702 "-negate replace every pixel with its complementary color ",
3703 "-noise radius add or reduce noise in an image",
3704 "-normalize transform image to span the full range of colors",
3705 "-opaque color change this color to the fill color",
3706 "-ordered-dither NxN",
3707 " add a noise pattern to the image with specific",
3709 "-paint radius simulate an oil painting",
3710 "-polaroid angle simulate a Polaroid picture",
3711 "-posterize levels reduce the image to a limited number of color levels",
3712 "-profile filename add, delete, or apply an image profile",
3713 "-quantize colorspace reduce colors in this colorspace",
3714 "-radial-blur angle radial blur the image",
3715 "-raise value lighten/darken image edges to create a 3-D effect",
3716 "-random-threshold low,high",
3717 " random threshold the image",
3718 "-region geometry apply options to a portion of the image",
3719 "-render render vector graphics",
3720 "-repage geometry size and location of an image canvas",
3721 "-resample geometry change the resolution of an image",
3722 "-resize geometry resize the image",
3723 "-roll geometry roll an image vertically or horizontally",
3724 "-rotate degrees apply Paeth rotation to the image",
3725 "-sample geometry scale image with pixel sampling",
3726 "-scale geometry scale the image",
3727 "-segment values segment an image",
3728 "-selective-blur geometry",
3729 " selectively blur pixels within a contrast threshold",
3730 "-sepia-tone threshold",
3731 " simulate a sepia-toned photo",
3732 "-set property value set an image property",
3733 "-shade degrees shade the image using a distant light source",
3734 "-shadow geometry simulate an image shadow",
3735 "-sharpen geometry sharpen the image",
3736 "-shave geometry shave pixels from the image edges",
3737 "-shear geometry slide one edge of the image along the X or Y axis",
3738 "-sigmoidal-contrast geometry",
3739 " increase the contrast without saturating highlights or shadows",
3740 "-sketch geometry simulate a pencil sketch",
3741 "-solarize threshold negate all pixels above the threshold level",
3742 "-sparse-color method args",
3743 " fill in a image based on a few color points",
3744 "-splice geometry splice the background color into the image",
3745 "-spread radius displace image pixels by a random amount",
3746 "-strip strip image of all profiles and comments",
3747 "-swirl degrees swirl image pixels about the center",
3748 "-threshold value threshold the image",
3749 "-thumbnail geometry create a thumbnail of the image",
3750 "-tile filename tile image when filling a graphic primitive",
3751 "-tint value tint the image with the fill color",
3752 "-transform affine transform image",
3753 "-transparent color make this color transparent within the image",
3754 "-transpose flip image vertically and rotate 90 degrees",
3755 "-transverse flop image horizontally and rotate 270 degrees",
3756 "-trim trim image edges",
3757 "-type type image type",
3758 "-unique-colors discard all but one of any pixel color",
3759 "-unsharp geometry sharpen the image",
3760 "-vignette geometry soften the edges of the image in vignette style",
3761 "-wave geometry alter an image along a sine wave",
3762 "-white-threshold value",
3763 " force all pixels above the threshold into white",
3766 *sequence_operators[]=
3768 "-append append an image sequence",
3769 "-clut apply a color lookup table to the image",
3770 "-coalesce merge a sequence of images",
3771 "-combine combine a sequence of images",
3772 "-composite composite image",
3773 "-crop geometry cut out a rectangular region of the image",
3774 "-deconstruct break down an image sequence into constituent parts",
3775 "-evaluate-sequence operator",
3776 " evaluate an arithmetic, relational, or logical expression",
3777 "-flatten flatten a sequence of images",
3778 "-fx expression apply mathematical expression to an image channel(s)",
3779 "-hald-clut apply a Hald color lookup table to the image",
3780 "-morph value morph an image sequence",
3781 "-mosaic create a mosaic from an image sequence",
3782 "-print string interpret string and print to console",
3783 "-process arguments process the image with a custom image filter",
3784 "-reverse reverse image sequence",
3785 "-separate separate an image channel into a grayscale image",
3786 "-write filename write images to this file",
3791 "-adjoin join images into a single multi-image file",
3792 "-affine matrix affine transform matrix",
3793 "-alpha option activate, deactivate, reset, or set the alpha channel",
3794 "-antialias remove pixel-aliasing",
3795 "-authenticate password",
3796 " decipher image with this password",
3797 "-attenuate value lessen (or intensify) when adding noise to an image",
3798 "-background color background color",
3799 "-bias value add bias when convolving an image",
3800 "-black-point-compensation",
3801 " use black point compensation",
3802 "-blue-primary point chromaticity blue primary point",
3803 "-bordercolor color border color",
3804 "-caption string assign a caption to an image",
3805 "-channel type apply option to select image channels",
3806 "-colors value preferred number of colors in the image",
3807 "-colorspace type alternate image colorspace",
3808 "-comment string annotate image with comment",
3809 "-compose operator set image composite operator",
3810 "-compress type type of pixel compression when writing the image",
3811 "-define format:option",
3812 " define one or more image format options",
3813 "-delay value display the next image after pausing",
3814 "-density geometry horizontal and vertical density of the image",
3815 "-depth value image depth",
3816 "-direction type render text right-to-left or left-to-right",
3817 "-display server get image or font from this X server",
3818 "-dispose method layer disposal method",
3819 "-dither method apply error diffusion to image",
3820 "-encoding type text encoding type",
3821 "-endian type endianness (MSB or LSB) of the image",
3822 "-family name render text with this font family",
3823 "-fill color color to use when filling a graphic primitive",
3824 "-filter type use this filter when resizing an image",
3825 "-font name render text with this font",
3826 "-format \"string\" output formatted image characteristics",
3827 "-fuzz distance colors within this distance are considered equal",
3828 "-gravity type horizontal and vertical text placement",
3829 "-green-primary point chromaticity green primary point",
3830 "-intent type type of rendering intent when managing the image color",
3831 "-interlace type type of image interlacing scheme",
3832 "-interline-spacing value",
3833 " set the space between two text lines",
3834 "-interpolate method pixel color interpolation method",
3835 "-interword-spacing value",
3836 " set the space between two words",
3837 "-kerning value set the space between two letters",
3838 "-label string assign a label to an image",
3839 "-limit type value pixel cache resource limit",
3840 "-loop iterations add Netscape loop extension to your GIF animation",
3841 "-mask filename associate a mask with the image",
3842 "-mattecolor color frame color",
3843 "-monitor monitor progress",
3844 "-orient type image orientation",
3845 "-page geometry size and location of an image canvas (setting)",
3846 "-ping efficiently determine image attributes",
3847 "-pointsize value font point size",
3848 "-precision value maximum number of significant digits to print",
3849 "-preview type image preview type",
3850 "-quality value JPEG/MIFF/PNG compression level",
3851 "-quiet suppress all warning messages",
3852 "-red-primary point chromaticity red primary point",
3853 "-regard-warnings pay attention to warning messages",
3854 "-remap filename transform image colors to match this set of colors",
3855 "-respect-parentheses settings remain in effect until parenthesis boundary",
3856 "-sampling-factor geometry",
3857 " horizontal and vertical sampling factor",
3858 "-scene value image scene number",
3859 "-seed value seed a new sequence of pseudo-random numbers",
3860 "-size geometry width and height of image",
3861 "-stretch type render text with this font stretch",
3862 "-stroke color graphic primitive stroke color",
3863 "-strokewidth value graphic primitive stroke width",
3864 "-style type render text with this font style",
3865 "-taint image as ineligible for bi-modal delegate",
3866 "-texture filename name of texture to tile onto the image background",
3867 "-tile-offset geometry",
3869 "-treedepth value color tree depth",
3870 "-transparent-color color",
3871 " transparent color",
3872 "-undercolor color annotation bounding box color",
3873 "-units type the units of image resolution",
3874 "-verbose print detailed information about the image",
3875 "-view FlashPix viewing transforms",
3876 "-virtual-pixel method",
3877 " virtual pixel access method",
3878 "-weight type render text with this font weight",
3879 "-white-point point chromaticity white point",
3884 "-clone index clone an image",
3885 "-delete index delete the image from the image sequence",
3886 "-insert index insert last image into the image sequence",
3887 "-swap indexes swap two images in the image sequence",
3894 (void) printf("Version: %s\n",GetMagickVersion((size_t *) NULL));
3895 (void) printf("Copyright: %s\n",GetMagickCopyright());
3896 (void) printf("Features: %s\n\n",GetMagickFeatures());
3897 (void) printf("Usage: %s [options ...] file [ [options ...] file ...]\n",
3899 (void) printf("\nImage Settings:\n");
3900 for (p=settings; *p != (char *) NULL; p++)
3901 (void) printf(" %s\n",*p);
3902 (void) printf("\nImage Operators:\n");
3903 for (p=operators; *p != (char *) NULL; p++)
3904 (void) printf(" %s\n",*p);
3905 (void) printf("\nImage Sequence Operators:\n");
3906 for (p=sequence_operators; *p != (char *) NULL; p++)
3907 (void) printf(" %s\n",*p);
3908 (void) printf("\nImage Stack Operators:\n");
3909 for (p=stack_operators; *p != (char *) NULL; p++)
3910 (void) printf(" %s\n",*p);
3911 (void) printf("\nMiscellaneous Options:\n");
3912 for (p=miscellaneous; *p != (char *) NULL; p++)
3913 (void) printf(" %s\n",*p);
3915 "\nBy default, the image format of `file' is determined by its magic\n");
3917 "number. To specify a particular image format, precede the filename\n");
3919 "with an image format name and a colon (i.e. ps:image) or specify the\n");
3921 "image type as the filename suffix (i.e. image.ps). Specify 'file' as\n");
3922 (void) printf("'-' for standard input or output.\n");
3923 return(MagickFalse);
3926 WandExport MagickBooleanType MogrifyImageCommand(ImageInfo *image_info,
3927 int argc,char **argv,char **wand_unused(metadata),ExceptionInfo *exception)
3929 #define DestroyMogrify() \
3931 if (format != (char *) NULL) \
3932 format=DestroyString(format); \
3933 if (path != (char *) NULL) \
3934 path=DestroyString(path); \
3935 DestroyImageStack(); \
3936 for (i=0; i < (ssize_t) argc; i++) \
3937 argv[i]=DestroyString(argv[i]); \
3938 argv=(char **) RelinquishMagickMemory(argv); \
3940 #define ThrowMogrifyException(asperity,tag,option) \
3942 (void) ThrowMagickException(exception,GetMagickModule(),asperity,tag,"`%s'", \
3945 return(MagickFalse); \
3947 #define ThrowMogrifyInvalidArgumentException(option,argument) \
3949 (void) ThrowMagickException(exception,GetMagickModule(),OptionError, \
3950 "InvalidArgument","`%s': %s",argument,option); \
3952 return(MagickFalse); \
3964 image_stack[MaxImageStackDepth+1];
3986 assert(image_info != (ImageInfo *) NULL);
3987 assert(image_info->signature == MagickSignature);
3988 if (image_info->debug != MagickFalse)
3989 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
3990 assert(exception != (ExceptionInfo *) NULL);
3994 if ((LocaleCompare("version",option+1) == 0) ||
3995 (LocaleCompare("-version",option+1) == 0))
3997 (void) fprintf(stdout,"Version: %s\n",
3998 GetMagickVersion((size_t *) NULL));
3999 (void) fprintf(stdout,"Copyright: %s\n",GetMagickCopyright());
4000 (void) fprintf(stdout,"Features: %s\n\n",GetMagickFeatures());
4001 return(MagickFalse);
4005 return(MogrifyUsage());
4006 format=(char *) NULL;
4008 global_colormap=MagickFalse;
4012 option=(char *) NULL;
4018 ReadCommandlLine(argc,&argv);
4019 status=ExpandFilenames(&argc,&argv);
4020 if (status == MagickFalse)
4021 ThrowMogrifyException(ResourceLimitError,"MemoryAllocationFailed",
4022 GetExceptionMessage(errno));
4023 for (i=1; i < (ssize_t) argc; i++)
4026 if (LocaleCompare(option,"(") == 0)
4028 FireImageStack(MagickFalse,MagickTrue,pend);
4029 if (k == MaxImageStackDepth)
4030 ThrowMogrifyException(OptionError,"ParenthesisNestedTooDeeply",
4035 if (LocaleCompare(option,")") == 0)
4037 FireImageStack(MagickFalse,MagickTrue,MagickTrue);
4039 ThrowMogrifyException(OptionError,"UnableToParseExpression",option);
4043 if (IsMagickOption(option) == MagickFalse)
4046 backup_filename[MaxTextExtent],
4053 Option is a file name: begin by reading image from specified file.
4055 FireImageStack(MagickFalse,MagickFalse,pend);
4057 if ((LocaleCompare(filename,"--") == 0) && (i < (ssize_t) (argc-1)))
4059 (void) CopyMagickString(image_info->filename,filename,MaxTextExtent);
4060 images=ReadImages(image_info,exception);
4061 status&=(images != (Image *) NULL) &&
4062 (exception->severity < ErrorException);
4063 if (images == (Image *) NULL)
4065 if (format != (char *) NULL)
4066 (void) CopyMagickString(images->filename,images->magick_filename,
4068 if (path != (char *) NULL)
4070 GetPathComponent(option,TailPath,filename);
4071 (void) FormatMagickString(images->filename,MaxTextExtent,"%s%c%s",
4072 path,*DirectorySeparator,filename);
4074 if (format != (char *) NULL)
4075 AppendImageFormat(format,images->filename);
4076 AppendImageStack(images);
4077 FinalizeImageSettings(image_info,image,MagickFalse);
4078 if (global_colormap != MagickFalse)
4083 quantize_info=AcquireQuantizeInfo(image_info);
4084 (void) RemapImages(quantize_info,images,(Image *) NULL);
4085 quantize_info=DestroyQuantizeInfo(quantize_info);
4087 *backup_filename='\0';
4088 if ((LocaleCompare(image->filename,"-") != 0) &&
4089 (IsPathWritable(image->filename) != MagickFalse))
4095 Rename image file as backup.
4097 (void) CopyMagickString(backup_filename,image->filename,
4099 for (i=0; i < 6; i++)
4101 (void) ConcatenateMagickString(backup_filename,"~",MaxTextExtent);
4102 if (IsPathAccessible(backup_filename) == MagickFalse)
4105 if ((IsPathAccessible(backup_filename) != MagickFalse) ||
4106 (rename(image->filename,backup_filename) != 0))
4107 *backup_filename='\0';
4110 Write transmogrified image to disk.
4112 image_info->synchronize=MagickTrue;
4113 status&=WriteImages(image_info,image,image->filename,exception);
4114 if ((status == MagickFalse) && (*backup_filename != '\0'))
4115 (void) remove(backup_filename);
4116 RemoveAllImageStack();
4119 pend=image != (Image *) NULL ? MagickTrue : MagickFalse;
4120 switch (*(option+1))
4124 if (LocaleCompare("adaptive-blur",option+1) == 0)
4127 if (i == (ssize_t) argc)
4128 ThrowMogrifyException(OptionError,"MissingArgument",option);
4129 if (IsGeometry(argv[i]) == MagickFalse)
4130 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4133 if (LocaleCompare("adaptive-resize",option+1) == 0)
4136 if (i == (ssize_t) argc)
4137 ThrowMogrifyException(OptionError,"MissingArgument",option);
4138 if (IsGeometry(argv[i]) == MagickFalse)
4139 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4142 if (LocaleCompare("adaptive-sharpen",option+1) == 0)
4145 if (i == (ssize_t) argc)
4146 ThrowMogrifyException(OptionError,"MissingArgument",option);
4147 if (IsGeometry(argv[i]) == MagickFalse)
4148 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4151 if (LocaleCompare("affine",option+1) == 0)
4156 if (i == (ssize_t) argc)
4157 ThrowMogrifyException(OptionError,"MissingArgument",option);
4158 if (IsGeometry(argv[i]) == MagickFalse)
4159 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4162 if (LocaleCompare("alpha",option+1) == 0)
4170 if (i == (ssize_t) argc)
4171 ThrowMogrifyException(OptionError,"MissingArgument",option);
4172 type=ParseMagickOption(MagickAlphaOptions,MagickFalse,argv[i]);
4174 ThrowMogrifyException(OptionError,"UnrecognizedAlphaChannelType",
4178 if (LocaleCompare("annotate",option+1) == 0)
4183 if (i == (ssize_t) argc)
4184 ThrowMogrifyException(OptionError,"MissingArgument",option);
4185 if (IsGeometry(argv[i]) == MagickFalse)
4186 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4187 if (i == (ssize_t) argc)
4188 ThrowMogrifyException(OptionError,"MissingArgument",option);
4192 if (LocaleCompare("antialias",option+1) == 0)
4194 if (LocaleCompare("append",option+1) == 0)
4196 if (LocaleCompare("attenuate",option+1) == 0)
4201 if (i == (ssize_t) (argc-1))
4202 ThrowMogrifyException(OptionError,"MissingArgument",option);
4203 if (IsGeometry(argv[i]) == MagickFalse)
4204 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4207 if (LocaleCompare("authenticate",option+1) == 0)
4212 if (i == (ssize_t) argc)
4213 ThrowMogrifyException(OptionError,"MissingArgument",option);
4216 if (LocaleCompare("auto-gamma",option+1) == 0)
4218 if (LocaleCompare("auto-level",option+1) == 0)
4220 if (LocaleCompare("auto-orient",option+1) == 0)
4222 if (LocaleCompare("average",option+1) == 0)
4224 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
4228 if (LocaleCompare("background",option+1) == 0)
4233 if (i == (ssize_t) argc)
4234 ThrowMogrifyException(OptionError,"MissingArgument",option);
4237 if (LocaleCompare("bias",option+1) == 0)
4242 if (i == (ssize_t) (argc-1))
4243 ThrowMogrifyException(OptionError,"MissingArgument",option);
4244 if (IsGeometry(argv[i]) == MagickFalse)
4245 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4248 if (LocaleCompare("black-point-compensation",option+1) == 0)
4250 if (LocaleCompare("black-threshold",option+1) == 0)
4255 if (i == (ssize_t) argc)
4256 ThrowMogrifyException(OptionError,"MissingArgument",option);
4257 if (IsGeometry(argv[i]) == MagickFalse)
4258 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4261 if (LocaleCompare("blue-primary",option+1) == 0)
4266 if (i == (ssize_t) argc)
4267 ThrowMogrifyException(OptionError,"MissingArgument",option);
4268 if (IsGeometry(argv[i]) == MagickFalse)
4269 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4272 if (LocaleCompare("blue-shift",option+1) == 0)
4275 if (i == (ssize_t) argc)
4276 ThrowMogrifyException(OptionError,"MissingArgument",option);
4277 if (IsGeometry(argv[i]) == MagickFalse)
4278 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4281 if (LocaleCompare("blur",option+1) == 0)
4284 if (i == (ssize_t) argc)
4285 ThrowMogrifyException(OptionError,"MissingArgument",option);
4286 if (IsGeometry(argv[i]) == MagickFalse)
4287 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4290 if (LocaleCompare("border",option+1) == 0)
4295 if (i == (ssize_t) argc)
4296 ThrowMogrifyException(OptionError,"MissingArgument",option);
4297 if (IsGeometry(argv[i]) == MagickFalse)
4298 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4301 if (LocaleCompare("bordercolor",option+1) == 0)
4306 if (i == (ssize_t) argc)
4307 ThrowMogrifyException(OptionError,"MissingArgument",option);
4310 if (LocaleCompare("box",option+1) == 0)
4315 if (i == (ssize_t) argc)
4316 ThrowMogrifyException(OptionError,"MissingArgument",option);
4319 if (LocaleCompare("brightness-contrast",option+1) == 0)
4322 if (i == (ssize_t) argc)
4323 ThrowMogrifyException(OptionError,"MissingArgument",option);
4324 if (IsGeometry(argv[i]) == MagickFalse)
4325 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4328 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
4332 if (LocaleCompare("cache",option+1) == 0)
4337 if (i == (ssize_t) argc)
4338 ThrowMogrifyException(OptionError,"MissingArgument",option);
4339 if (IsGeometry(argv[i]) == MagickFalse)
4340 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4343 if (LocaleCompare("caption",option+1) == 0)
4348 if (i == (ssize_t) argc)
4349 ThrowMogrifyException(OptionError,"MissingArgument",option);
4352 if (LocaleCompare("channel",option+1) == 0)
4360 if (i == (ssize_t) (argc-1))
4361 ThrowMogrifyException(OptionError,"MissingArgument",option);
4362 channel=ParseChannelOption(argv[i]);
4364 ThrowMogrifyException(OptionError,"UnrecognizedChannelType",
4368 if (LocaleCompare("cdl",option+1) == 0)
4373 if (i == (ssize_t) (argc-1))
4374 ThrowMogrifyException(OptionError,"MissingArgument",option);
4377 if (LocaleCompare("charcoal",option+1) == 0)
4382 if (i == (ssize_t) argc)
4383 ThrowMogrifyException(OptionError,"MissingArgument",option);
4384 if (IsGeometry(argv[i]) == MagickFalse)
4385 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4388 if (LocaleCompare("chop",option+1) == 0)
4393 if (i == (ssize_t) argc)
4394 ThrowMogrifyException(OptionError,"MissingArgument",option);
4395 if (IsGeometry(argv[i]) == MagickFalse)
4396 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4399 if (LocaleCompare("clamp",option+1) == 0)
4401 if (LocaleCompare("clip",option+1) == 0)
4403 if (LocaleCompare("clip-mask",option+1) == 0)
4408 if (i == (ssize_t) argc)
4409 ThrowMogrifyException(OptionError,"MissingArgument",option);
4412 if (LocaleCompare("clut",option+1) == 0)
4414 if (LocaleCompare("coalesce",option+1) == 0)
4416 if (LocaleCompare("colorize",option+1) == 0)
4421 if (i == (ssize_t) argc)
4422 ThrowMogrifyException(OptionError,"MissingArgument",option);
4423 if (IsGeometry(argv[i]) == MagickFalse)
4424 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4427 if (LocaleCompare("color-matrix",option+1) == 0)
4432 if (i == (ssize_t) (argc-1))
4433 ThrowMogrifyException(OptionError,"MissingArgument",option);
4434 if (IsGeometry(argv[i]) == MagickFalse)
4435 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4438 if (LocaleCompare("colors",option+1) == 0)
4443 if (i == (ssize_t) argc)
4444 ThrowMogrifyException(OptionError,"MissingArgument",option);
4445 if (IsGeometry(argv[i]) == MagickFalse)
4446 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4449 if (LocaleCompare("colorspace",option+1) == 0)
4457 if (i == (ssize_t) argc)
4458 ThrowMogrifyException(OptionError,"MissingArgument",option);
4459 colorspace=ParseMagickOption(MagickColorspaceOptions,MagickFalse,
4462 ThrowMogrifyException(OptionError,"UnrecognizedColorspace",
4466 if (LocaleCompare("combine",option+1) == 0)
4468 if (LocaleCompare("comment",option+1) == 0)
4473 if (i == (ssize_t) argc)
4474 ThrowMogrifyException(OptionError,"MissingArgument",option);
4477 if (LocaleCompare("composite",option+1) == 0)
4479 if (LocaleCompare("compress",option+1) == 0)
4487 if (i == (ssize_t) argc)
4488 ThrowMogrifyException(OptionError,"MissingArgument",option);
4489 compress=ParseMagickOption(MagickCompressOptions,MagickFalse,
4492 ThrowMogrifyException(OptionError,"UnrecognizedImageCompression",
4496 if (LocaleCompare("concurrent",option+1) == 0)
4498 if (LocaleCompare("contrast",option+1) == 0)
4500 if (LocaleCompare("contrast-stretch",option+1) == 0)
4503 if (i == (ssize_t) argc)
4504 ThrowMogrifyException(OptionError,"MissingArgument",option);
4505 if (IsGeometry(argv[i]) == MagickFalse)
4506 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4509 if (LocaleCompare("convolve",option+1) == 0)
4512 token[MaxTextExtent];
4517 if (i == (ssize_t) argc)
4518 ThrowMogrifyException(OptionError,"MissingArgument",option);
4521 if (IsGeometry(argv[i]) == MagickFalse)
4522 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4524 /* Allow the use of built-in kernels like 'gaussian'
4525 * These may not work for kernels with 'nan' values, like 'diamond'
4527 GetMagickToken(argv[i],NULL,token);
4528 if ( isalpha((int)token[0]) )
4533 op=ParseMagickOption(MagickKernelOptions,MagickFalse,token);
4535 ThrowMogrifyException(OptionError,"UnrecognizedKernelType",
4538 /* geometry current returns invalid if 'nan' values are used */
4539 else if (IsGeometry(argv[i]) == MagickFalse)
4540 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4544 if (LocaleCompare("crop",option+1) == 0)
4549 if (i == (ssize_t) argc)
4550 ThrowMogrifyException(OptionError,"MissingArgument",option);
4551 if (IsGeometry(argv[i]) == MagickFalse)
4552 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4555 if (LocaleCompare("cycle",option+1) == 0)
4560 if (i == (ssize_t) argc)
4561 ThrowMogrifyException(OptionError,"MissingArgument",option);
4562 if (IsGeometry(argv[i]) == MagickFalse)
4563 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4566 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
4570 if (LocaleCompare("decipher",option+1) == 0)
4575 if (i == (ssize_t) (argc-1))
4576 ThrowMogrifyException(OptionError,"MissingArgument",option);
4579 if (LocaleCompare("deconstruct",option+1) == 0)
4581 if (LocaleCompare("debug",option+1) == 0)
4589 if (i == (ssize_t) argc)
4590 ThrowMogrifyException(OptionError,"MissingArgument",option);
4591 event=ParseMagickOption(MagickLogEventOptions,MagickFalse,argv[i]);
4593 ThrowMogrifyException(OptionError,"UnrecognizedEventType",
4595 (void) SetLogEventMask(argv[i]);
4598 if (LocaleCompare("define",option+1) == 0)
4601 if (i == (ssize_t) argc)
4602 ThrowMogrifyException(OptionError,"MissingArgument",option);
4608 define=GetImageOption(image_info,argv[i]);
4609 if (define == (const char *) NULL)
4610 ThrowMogrifyException(OptionError,"NoSuchOption",argv[i]);
4615 if (LocaleCompare("delay",option+1) == 0)
4620 if (i == (ssize_t) argc)
4621 ThrowMogrifyException(OptionError,"MissingArgument",option);
4622 if (IsGeometry(argv[i]) == MagickFalse)
4623 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4626 if (LocaleCompare("density",option+1) == 0)
4631 if (i == (ssize_t) argc)
4632 ThrowMogrifyException(OptionError,"MissingArgument",option);
4633 if (IsGeometry(argv[i]) == MagickFalse)
4634 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4637 if (LocaleCompare("depth",option+1) == 0)
4642 if (i == (ssize_t) argc)
4643 ThrowMogrifyException(OptionError,"MissingArgument",option);
4644 if (IsGeometry(argv[i]) == MagickFalse)
4645 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4648 if (LocaleCompare("deskew",option+1) == 0)
4653 if (i == (ssize_t) argc)
4654 ThrowMogrifyException(OptionError,"MissingArgument",option);
4655 if (IsGeometry(argv[i]) == MagickFalse)
4656 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4659 if (LocaleCompare("despeckle",option+1) == 0)
4661 if (LocaleCompare("dft",option+1) == 0)
4663 if (LocaleCompare("direction",option+1) == 0)
4671 if (i == (ssize_t) argc)
4672 ThrowMogrifyException(OptionError,"MissingArgument",option);
4673 direction=ParseMagickOption(MagickDirectionOptions,MagickFalse,
4676 ThrowMogrifyException(OptionError,"UnrecognizedDirectionType",
4680 if (LocaleCompare("display",option+1) == 0)
4685 if (i == (ssize_t) argc)
4686 ThrowMogrifyException(OptionError,"MissingArgument",option);
4689 if (LocaleCompare("dispose",option+1) == 0)
4697 if (i == (ssize_t) argc)
4698 ThrowMogrifyException(OptionError,"MissingArgument",option);
4699 dispose=ParseMagickOption(MagickDisposeOptions,MagickFalse,argv[i]);
4701 ThrowMogrifyException(OptionError,"UnrecognizedDisposeMethod",
4705 if (LocaleCompare("distort",option+1) == 0)
4711 if (i == (ssize_t) argc)
4712 ThrowMogrifyException(OptionError,"MissingArgument",option);
4713 op=ParseMagickOption(MagickDistortOptions,MagickFalse,argv[i]);
4715 ThrowMogrifyException(OptionError,"UnrecognizedDistortMethod",
4718 if (i == (ssize_t) (argc-1))
4719 ThrowMogrifyException(OptionError,"MissingArgument",option);
4722 if (LocaleCompare("dither",option+1) == 0)
4730 if (i == (ssize_t) argc)
4731 ThrowMogrifyException(OptionError,"MissingArgument",option);
4732 method=ParseMagickOption(MagickDitherOptions,MagickFalse,argv[i]);
4734 ThrowMogrifyException(OptionError,"UnrecognizedDitherMethod",
4738 if (LocaleCompare("draw",option+1) == 0)
4743 if (i == (ssize_t) argc)
4744 ThrowMogrifyException(OptionError,"MissingArgument",option);
4747 if (LocaleCompare("duration",option+1) == 0)
4752 if (i == (ssize_t) (argc-1))
4753 ThrowMogrifyException(OptionError,"MissingArgument",option);
4754 if (IsGeometry(argv[i]) == MagickFalse)
4755 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4758 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
4762 if (LocaleCompare("edge",option+1) == 0)
4767 if (i == (ssize_t) argc)
4768 ThrowMogrifyException(OptionError,"MissingArgument",option);
4769 if (IsGeometry(argv[i]) == MagickFalse)
4770 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4773 if (LocaleCompare("emboss",option+1) == 0)
4778 if (i == (ssize_t) argc)
4779 ThrowMogrifyException(OptionError,"MissingArgument",option);
4780 if (IsGeometry(argv[i]) == MagickFalse)
4781 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4784 if (LocaleCompare("encipher",option+1) == 0)
4789 if (i == (ssize_t) argc)
4790 ThrowMogrifyException(OptionError,"MissingArgument",option);
4793 if (LocaleCompare("encoding",option+1) == 0)
4798 if (i == (ssize_t) argc)
4799 ThrowMogrifyException(OptionError,"MissingArgument",option);
4802 if (LocaleCompare("endian",option+1) == 0)
4810 if (i == (ssize_t) argc)
4811 ThrowMogrifyException(OptionError,"MissingArgument",option);
4812 endian=ParseMagickOption(MagickEndianOptions,MagickFalse,argv[i]);
4814 ThrowMogrifyException(OptionError,"UnrecognizedEndianType",
4818 if (LocaleCompare("enhance",option+1) == 0)
4820 if (LocaleCompare("equalize",option+1) == 0)
4822 if (LocaleCompare("evaluate",option+1) == 0)
4830 if (i == (ssize_t) argc)
4831 ThrowMogrifyException(OptionError,"MissingArgument",option);
4832 op=ParseMagickOption(MagickEvaluateOptions,MagickFalse,argv[i]);
4834 ThrowMogrifyException(OptionError,"UnrecognizedEvaluateOperator",
4837 if (i == (ssize_t) (argc-1))
4838 ThrowMogrifyException(OptionError,"MissingArgument",option);
4839 if (IsGeometry(argv[i]) == MagickFalse)
4840 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4843 if (LocaleCompare("evaluate-sequence",option+1) == 0)
4851 if (i == (ssize_t) argc)
4852 ThrowMogrifyException(OptionError,"MissingArgument",option);
4853 op=ParseMagickOption(MagickEvaluateOptions,MagickFalse,argv[i]);
4855 ThrowMogrifyException(OptionError,"UnrecognizedEvaluateOperator",
4859 if (LocaleCompare("extent",option+1) == 0)
4864 if (i == (ssize_t) argc)
4865 ThrowMogrifyException(OptionError,"MissingArgument",option);
4866 if (IsGeometry(argv[i]) == MagickFalse)
4867 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4870 if (LocaleCompare("extract",option+1) == 0)
4875 if (i == (ssize_t) argc)
4876 ThrowMogrifyException(OptionError,"MissingArgument",option);
4877 if (IsGeometry(argv[i]) == MagickFalse)
4878 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4881 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
4885 if (LocaleCompare("family",option+1) == 0)
4890 if (i == (ssize_t) (argc-1))
4891 ThrowMogrifyException(OptionError,"MissingArgument",option);
4894 if (LocaleCompare("fill",option+1) == 0)
4899 if (i == (ssize_t) argc)
4900 ThrowMogrifyException(OptionError,"MissingArgument",option);
4903 if (LocaleCompare("filter",option+1) == 0)
4911 if (i == (ssize_t) argc)
4912 ThrowMogrifyException(OptionError,"MissingArgument",option);
4913 filter=ParseMagickOption(MagickFilterOptions,MagickFalse,argv[i]);
4915 ThrowMogrifyException(OptionError,"UnrecognizedImageFilter",
4919 if (LocaleCompare("flatten",option+1) == 0)
4921 if (LocaleCompare("flip",option+1) == 0)
4923 if (LocaleCompare("flop",option+1) == 0)
4925 if (LocaleCompare("floodfill",option+1) == 0)
4930 if (i == (ssize_t) argc)
4931 ThrowMogrifyException(OptionError,"MissingArgument",option);
4932 if (IsGeometry(argv[i]) == MagickFalse)
4933 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4935 if (i == (ssize_t) argc)
4936 ThrowMogrifyException(OptionError,"MissingArgument",option);
4939 if (LocaleCompare("font",option+1) == 0)
4944 if (i == (ssize_t) argc)
4945 ThrowMogrifyException(OptionError,"MissingArgument",option);
4948 if (LocaleCompare("format",option+1) == 0)
4950 (void) CopyMagickString(argv[i]+1,"sans",MaxTextExtent);
4951 (void) CloneString(&format,(char *) NULL);
4955 if (i == (ssize_t) argc)
4956 ThrowMogrifyException(OptionError,"MissingArgument",option);
4957 (void) CloneString(&format,argv[i]);
4958 (void) CopyMagickString(image_info->filename,format,MaxTextExtent);
4959 (void) ConcatenateMagickString(image_info->filename,":",
4961 (void) SetImageInfo(image_info,0,exception);
4962 if (*image_info->magick == '\0')
4963 ThrowMogrifyException(OptionError,"UnrecognizedImageFormat",
4967 if (LocaleCompare("frame",option+1) == 0)
4972 if (i == (ssize_t) argc)
4973 ThrowMogrifyException(OptionError,"MissingArgument",option);
4974 if (IsGeometry(argv[i]) == MagickFalse)
4975 ThrowMogrifyInvalidArgumentException(option,argv[i]);
4978 if (LocaleCompare("function",option+1) == 0)
4986 if (i == (ssize_t) argc)
4987 ThrowMogrifyException(OptionError,"MissingArgument",option);
4988 op=ParseMagickOption(MagickFunctionOptions,MagickFalse,argv[i]);
4990 ThrowMogrifyException(OptionError,"UnrecognizedFunction",argv[i]);
4992 if (i == (ssize_t) (argc-1))
4993 ThrowMogrifyException(OptionError,"MissingArgument",option);
4996 if (LocaleCompare("fuzz",option+1) == 0)
5001 if (i == (ssize_t) argc)
5002 ThrowMogrifyException(OptionError,"MissingArgument",option);
5003 if (IsGeometry(argv[i]) == MagickFalse)
5004 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5007 if (LocaleCompare("fx",option+1) == 0)
5012 if (i == (ssize_t) (argc-1))
5013 ThrowMogrifyException(OptionError,"MissingArgument",option);
5016 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5020 if (LocaleCompare("gamma",option+1) == 0)
5023 if (i == (ssize_t) argc)
5024 ThrowMogrifyException(OptionError,"MissingArgument",option);
5025 if (IsGeometry(argv[i]) == MagickFalse)
5026 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5029 if ((LocaleCompare("gaussian-blur",option+1) == 0) ||
5030 (LocaleCompare("gaussian",option+1) == 0))
5033 if (i == (ssize_t) argc)
5034 ThrowMogrifyException(OptionError,"MissingArgument",option);
5035 if (IsGeometry(argv[i]) == MagickFalse)
5036 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5039 if (LocaleCompare("geometry",option+1) == 0)
5044 if (i == (ssize_t) argc)
5045 ThrowMogrifyException(OptionError,"MissingArgument",option);
5046 if (IsGeometry(argv[i]) == MagickFalse)
5047 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5050 if (LocaleCompare("gravity",option+1) == 0)
5058 if (i == (ssize_t) argc)
5059 ThrowMogrifyException(OptionError,"MissingArgument",option);
5060 gravity=ParseMagickOption(MagickGravityOptions,MagickFalse,argv[i]);
5062 ThrowMogrifyException(OptionError,"UnrecognizedGravityType",
5066 if (LocaleCompare("green-primary",option+1) == 0)
5071 if (i == (ssize_t) argc)
5072 ThrowMogrifyException(OptionError,"MissingArgument",option);
5073 if (IsGeometry(argv[i]) == MagickFalse)
5074 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5077 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5081 if (LocaleCompare("hald-clut",option+1) == 0)
5083 if ((LocaleCompare("help",option+1) == 0) ||
5084 (LocaleCompare("-help",option+1) == 0))
5085 return(MogrifyUsage());
5086 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5090 if (LocaleCompare("identify",option+1) == 0)
5092 if (LocaleCompare("idft",option+1) == 0)
5094 if (LocaleCompare("implode",option+1) == 0)
5099 if (i == (ssize_t) argc)
5100 ThrowMogrifyException(OptionError,"MissingArgument",option);
5101 if (IsGeometry(argv[i]) == MagickFalse)
5102 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5105 if (LocaleCompare("intent",option+1) == 0)
5113 if (i == (ssize_t) (argc-1))
5114 ThrowMogrifyException(OptionError,"MissingArgument",option);
5115 intent=ParseMagickOption(MagickIntentOptions,MagickFalse,argv[i]);
5117 ThrowMogrifyException(OptionError,"UnrecognizedIntentType",
5121 if (LocaleCompare("interlace",option+1) == 0)
5129 if (i == (ssize_t) argc)
5130 ThrowMogrifyException(OptionError,"MissingArgument",option);
5131 interlace=ParseMagickOption(MagickInterlaceOptions,MagickFalse,
5134 ThrowMogrifyException(OptionError,"UnrecognizedInterlaceType",
5138 if (LocaleCompare("interline-spacing",option+1) == 0)
5143 if (i == (ssize_t) (argc-1))
5144 ThrowMogrifyException(OptionError,"MissingArgument",option);
5145 if (IsGeometry(argv[i]) == MagickFalse)
5146 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5149 if (LocaleCompare("interpolate",option+1) == 0)
5157 if (i == (ssize_t) argc)
5158 ThrowMogrifyException(OptionError,"MissingArgument",option);
5159 interpolate=ParseMagickOption(MagickInterpolateOptions,MagickFalse,
5161 if (interpolate < 0)
5162 ThrowMogrifyException(OptionError,"UnrecognizedInterpolateMethod",
5166 if (LocaleCompare("interword-spacing",option+1) == 0)
5171 if (i == (ssize_t) (argc-1))
5172 ThrowMogrifyException(OptionError,"MissingArgument",option);
5173 if (IsGeometry(argv[i]) == MagickFalse)
5174 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5177 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5181 if (LocaleCompare("kerning",option+1) == 0)
5186 if (i == (ssize_t) (argc-1))
5187 ThrowMogrifyException(OptionError,"MissingArgument",option);
5188 if (IsGeometry(argv[i]) == MagickFalse)
5189 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5192 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5196 if (LocaleCompare("label",option+1) == 0)
5201 if (i == (ssize_t) argc)
5202 ThrowMogrifyException(OptionError,"MissingArgument",option);
5205 if (LocaleCompare("lat",option+1) == 0)
5210 if (i == (ssize_t) argc)
5211 ThrowMogrifyException(OptionError,"MissingArgument",option);
5212 if (IsGeometry(argv[i]) == MagickFalse)
5213 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5215 if (LocaleCompare("layers",option+1) == 0)
5223 if (i == (ssize_t) (argc-1))
5224 ThrowMogrifyException(OptionError,"MissingArgument",option);
5225 type=ParseMagickOption(MagickLayerOptions,MagickFalse,argv[i]);
5227 ThrowMogrifyException(OptionError,"UnrecognizedLayerMethod",
5231 if (LocaleCompare("level",option+1) == 0)
5234 if (i == (ssize_t) argc)
5235 ThrowMogrifyException(OptionError,"MissingArgument",option);
5236 if (IsGeometry(argv[i]) == MagickFalse)
5237 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5240 if (LocaleCompare("level-colors",option+1) == 0)
5243 if (i == (ssize_t) argc)
5244 ThrowMogrifyException(OptionError,"MissingArgument",option);
5247 if (LocaleCompare("linewidth",option+1) == 0)
5252 if (i == (ssize_t) argc)
5253 ThrowMogrifyException(OptionError,"MissingArgument",option);
5254 if (IsGeometry(argv[i]) == MagickFalse)
5255 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5258 if (LocaleCompare("limit",option+1) == 0)
5272 if (i == (ssize_t) argc)
5273 ThrowMogrifyException(OptionError,"MissingArgument",option);
5274 resource=ParseMagickOption(MagickResourceOptions,MagickFalse,
5277 ThrowMogrifyException(OptionError,"UnrecognizedResourceType",
5280 if (i == (ssize_t) argc)
5281 ThrowMogrifyException(OptionError,"MissingArgument",option);
5282 value=strtod(argv[i],&p);
5283 if ((p == argv[i]) && (LocaleCompare("unlimited",argv[i]) != 0))
5284 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5287 if (LocaleCompare("liquid-rescale",option+1) == 0)
5290 if (i == (ssize_t) argc)
5291 ThrowMogrifyException(OptionError,"MissingArgument",option);
5292 if (IsGeometry(argv[i]) == MagickFalse)
5293 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5296 if (LocaleCompare("list",option+1) == 0)
5304 if (i == (ssize_t) argc)
5305 ThrowMogrifyException(OptionError,"MissingArgument",option);
5306 list=ParseMagickOption(MagickListOptions,MagickFalse,argv[i]);
5308 ThrowMogrifyException(OptionError,"UnrecognizedListType",argv[i]);
5309 status=MogrifyImageInfo(image_info,(int) (i-j+1),(const char **)
5311 return(status != 0 ? MagickFalse : MagickTrue);
5313 if (LocaleCompare("log",option+1) == 0)
5318 if ((i == (ssize_t) argc) ||
5319 (strchr(argv[i],'%') == (char *) NULL))
5320 ThrowMogrifyException(OptionError,"MissingArgument",option);
5323 if (LocaleCompare("loop",option+1) == 0)
5328 if (i == (ssize_t) argc)
5329 ThrowMogrifyException(OptionError,"MissingArgument",option);
5330 if (IsGeometry(argv[i]) == MagickFalse)
5331 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5334 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5338 if (LocaleCompare("map",option+1) == 0)
5340 global_colormap=(*option == '+') ? MagickTrue : MagickFalse;
5344 if (i == (ssize_t) argc)
5345 ThrowMogrifyException(OptionError,"MissingArgument",option);
5348 if (LocaleCompare("mask",option+1) == 0)
5353 if (i == (ssize_t) argc)
5354 ThrowMogrifyException(OptionError,"MissingArgument",option);
5357 if (LocaleCompare("matte",option+1) == 0)
5359 if (LocaleCompare("mattecolor",option+1) == 0)
5364 if (i == (ssize_t) argc)
5365 ThrowMogrifyException(OptionError,"MissingArgument",option);
5368 if (LocaleCompare("maximum",option+1) == 0)
5370 if (LocaleCompare("minimum",option+1) == 0)
5372 if (LocaleCompare("modulate",option+1) == 0)
5377 if (i == (ssize_t) argc)
5378 ThrowMogrifyException(OptionError,"MissingArgument",option);
5379 if (IsGeometry(argv[i]) == MagickFalse)
5380 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5383 if (LocaleCompare("median",option+1) == 0)
5388 if (i == (ssize_t) argc)
5389 ThrowMogrifyException(OptionError,"MissingArgument",option);
5390 if (IsGeometry(argv[i]) == MagickFalse)
5391 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5394 if (LocaleCompare("monitor",option+1) == 0)
5396 if (LocaleCompare("monochrome",option+1) == 0)
5398 if (LocaleCompare("morph",option+1) == 0)
5403 if (i == (ssize_t) (argc-1))
5404 ThrowMogrifyException(OptionError,"MissingArgument",option);
5405 if (IsGeometry(argv[i]) == MagickFalse)
5406 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5409 if (LocaleCompare("morphology",option+1) == 0)
5415 token[MaxTextExtent];
5418 if (i == (ssize_t) argc)
5419 ThrowMogrifyException(OptionError,"MissingArgument",option);
5420 GetMagickToken(argv[i],NULL,token);
5421 op=ParseMagickOption(MagickMorphologyOptions,MagickFalse,token);
5423 ThrowMogrifyException(OptionError,"UnrecognizedMorphologyMethod",
5426 if (i == (ssize_t) (argc-1))
5427 ThrowMogrifyException(OptionError,"MissingArgument",option);
5428 GetMagickToken(argv[i],NULL,token);
5429 if (isalpha((int) ((unsigned char) *token)) != 0)
5431 op=ParseMagickOption(MagickKernelOptions,MagickFalse,token);
5433 ThrowMogrifyException(OptionError,"UnrecognizedKernelType",
5438 if (LocaleCompare("mosaic",option+1) == 0)
5440 if (LocaleCompare("motion-blur",option+1) == 0)
5445 if (i == (ssize_t) argc)
5446 ThrowMogrifyException(OptionError,"MissingArgument",option);
5447 if (IsGeometry(argv[i]) == MagickFalse)
5448 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5451 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5455 if (LocaleCompare("negate",option+1) == 0)
5457 if (LocaleCompare("noise",option+1) == 0)
5460 if (i == (ssize_t) argc)
5461 ThrowMogrifyException(OptionError,"MissingArgument",option);
5467 noise=ParseMagickOption(MagickNoiseOptions,MagickFalse,argv[i]);
5469 ThrowMogrifyException(OptionError,"UnrecognizedNoiseType",
5473 if (IsGeometry(argv[i]) == MagickFalse)
5474 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5477 if (LocaleCompare("noop",option+1) == 0)
5479 if (LocaleCompare("normalize",option+1) == 0)
5481 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5485 if (LocaleCompare("opaque",option+1) == 0)
5488 if (i == (ssize_t) argc)
5489 ThrowMogrifyException(OptionError,"MissingArgument",option);
5492 if (LocaleCompare("ordered-dither",option+1) == 0)
5497 if (i == (ssize_t) argc)
5498 ThrowMogrifyException(OptionError,"MissingArgument",option);
5501 if (LocaleCompare("orient",option+1) == 0)
5506 orientation=UndefinedOrientation;
5510 if (i == (ssize_t) (argc-1))
5511 ThrowMogrifyException(OptionError,"MissingArgument",option);
5512 orientation=ParseMagickOption(MagickOrientationOptions,MagickFalse,
5514 if (orientation < 0)
5515 ThrowMogrifyException(OptionError,"UnrecognizedImageOrientation",
5519 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5523 if (LocaleCompare("page",option+1) == 0)
5528 if (i == (ssize_t) argc)
5529 ThrowMogrifyException(OptionError,"MissingArgument",option);
5532 if (LocaleCompare("paint",option+1) == 0)
5537 if (i == (ssize_t) argc)
5538 ThrowMogrifyException(OptionError,"MissingArgument",option);
5539 if (IsGeometry(argv[i]) == MagickFalse)
5540 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5543 if (LocaleCompare("path",option+1) == 0)
5545 (void) CloneString(&path,(char *) NULL);
5549 if (i == (ssize_t) argc)
5550 ThrowMogrifyException(OptionError,"MissingArgument",option);
5551 (void) CloneString(&path,argv[i]);
5554 if (LocaleCompare("pointsize",option+1) == 0)
5559 if (i == (ssize_t) argc)
5560 ThrowMogrifyException(OptionError,"MissingArgument",option);
5561 if (IsGeometry(argv[i]) == MagickFalse)
5562 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5565 if (LocaleCompare("polaroid",option+1) == 0)
5570 if (i == (ssize_t) argc)
5571 ThrowMogrifyException(OptionError,"MissingArgument",option);
5572 if (IsGeometry(argv[i]) == MagickFalse)
5573 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5576 if (LocaleCompare("posterize",option+1) == 0)
5581 if (i == (ssize_t) argc)
5582 ThrowMogrifyException(OptionError,"MissingArgument",option);
5583 if (IsGeometry(argv[i]) == MagickFalse)
5584 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5587 if (LocaleCompare("precision",option+1) == 0)
5592 if (i == (ssize_t) argc)
5593 ThrowMogrifyException(OptionError,"MissingArgument",option);
5594 if (IsGeometry(argv[i]) == MagickFalse)
5595 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5598 if (LocaleCompare("print",option+1) == 0)
5603 if (i == (ssize_t) argc)
5604 ThrowMogrifyException(OptionError,"MissingArgument",option);
5607 if (LocaleCompare("process",option+1) == 0)
5612 if (i == (ssize_t) (argc-1))
5613 ThrowMogrifyException(OptionError,"MissingArgument",option);
5616 if (LocaleCompare("profile",option+1) == 0)
5619 if (i == (ssize_t) argc)
5620 ThrowMogrifyException(OptionError,"MissingArgument",option);
5623 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5627 if (LocaleCompare("quality",option+1) == 0)
5632 if (i == (ssize_t) argc)
5633 ThrowMogrifyException(OptionError,"MissingArgument",option);
5634 if (IsGeometry(argv[i]) == MagickFalse)
5635 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5638 if (LocaleCompare("quantize",option+1) == 0)
5646 if (i == (ssize_t) (argc-1))
5647 ThrowMogrifyException(OptionError,"MissingArgument",option);
5648 colorspace=ParseMagickOption(MagickColorspaceOptions,MagickFalse,
5651 ThrowMogrifyException(OptionError,"UnrecognizedColorspace",
5655 if (LocaleCompare("quiet",option+1) == 0)
5657 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5661 if (LocaleCompare("radial-blur",option+1) == 0)
5664 if (i == (ssize_t) argc)
5665 ThrowMogrifyException(OptionError,"MissingArgument",option);
5666 if (IsGeometry(argv[i]) == MagickFalse)
5667 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5670 if (LocaleCompare("raise",option+1) == 0)
5673 if (i == (ssize_t) argc)
5674 ThrowMogrifyException(OptionError,"MissingArgument",option);
5675 if (IsGeometry(argv[i]) == MagickFalse)
5676 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5679 if (LocaleCompare("random-threshold",option+1) == 0)
5684 if (i == (ssize_t) argc)
5685 ThrowMogrifyException(OptionError,"MissingArgument",option);
5686 if (IsGeometry(argv[i]) == MagickFalse)
5687 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5690 if (LocaleCompare("recolor",option+1) == 0)
5695 if (i == (ssize_t) (argc-1))
5696 ThrowMogrifyException(OptionError,"MissingArgument",option);
5697 if (IsGeometry(argv[i]) == MagickFalse)
5698 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5701 if (LocaleCompare("red-primary",option+1) == 0)
5706 if (i == (ssize_t) argc)
5707 ThrowMogrifyException(OptionError,"MissingArgument",option);
5708 if (IsGeometry(argv[i]) == MagickFalse)
5709 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5711 if (LocaleCompare("regard-warnings",option+1) == 0)
5713 if (LocaleCompare("region",option+1) == 0)
5718 if (i == (ssize_t) argc)
5719 ThrowMogrifyException(OptionError,"MissingArgument",option);
5720 if (IsGeometry(argv[i]) == MagickFalse)
5721 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5724 if (LocaleCompare("remap",option+1) == 0)
5729 if (i == (ssize_t) (argc-1))
5730 ThrowMogrifyException(OptionError,"MissingArgument",option);
5733 if (LocaleCompare("render",option+1) == 0)
5735 if (LocaleCompare("repage",option+1) == 0)
5740 if (i == (ssize_t) argc)
5741 ThrowMogrifyException(OptionError,"MissingArgument",option);
5742 if (IsGeometry(argv[i]) == MagickFalse)
5743 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5746 if (LocaleCompare("resample",option+1) == 0)
5751 if (i == (ssize_t) argc)
5752 ThrowMogrifyException(OptionError,"MissingArgument",option);
5753 if (IsGeometry(argv[i]) == MagickFalse)
5754 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5757 if (LocaleCompare("resize",option+1) == 0)
5762 if (i == (ssize_t) argc)
5763 ThrowMogrifyException(OptionError,"MissingArgument",option);
5764 if (IsGeometry(argv[i]) == MagickFalse)
5765 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5768 if (LocaleCompare("reverse",option+1) == 0)
5770 if (LocaleCompare("roll",option+1) == 0)
5775 if (i == (ssize_t) argc)
5776 ThrowMogrifyException(OptionError,"MissingArgument",option);
5777 if (IsGeometry(argv[i]) == MagickFalse)
5778 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5781 if (LocaleCompare("rotate",option+1) == 0)
5784 if (i == (ssize_t) argc)
5785 ThrowMogrifyException(OptionError,"MissingArgument",option);
5786 if (IsGeometry(argv[i]) == MagickFalse)
5787 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5790 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
5794 if (LocaleCompare("sample",option+1) == 0)
5799 if (i == (ssize_t) argc)
5800 ThrowMogrifyException(OptionError,"MissingArgument",option);
5801 if (IsGeometry(argv[i]) == MagickFalse)
5802 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5805 if (LocaleCompare("sampling-factor",option+1) == 0)
5810 if (i == (ssize_t) argc)
5811 ThrowMogrifyException(OptionError,"MissingArgument",option);
5812 if (IsGeometry(argv[i]) == MagickFalse)
5813 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5816 if (LocaleCompare("scale",option+1) == 0)
5821 if (i == (ssize_t) argc)
5822 ThrowMogrifyException(OptionError,"MissingArgument",option);
5823 if (IsGeometry(argv[i]) == MagickFalse)
5824 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5827 if (LocaleCompare("scene",option+1) == 0)
5832 if (i == (ssize_t) argc)
5833 ThrowMogrifyException(OptionError,"MissingArgument",option);
5834 if (IsGeometry(argv[i]) == MagickFalse)
5835 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5838 if (LocaleCompare("seed",option+1) == 0)
5843 if (i == (ssize_t) argc)
5844 ThrowMogrifyException(OptionError,"MissingArgument",option);
5845 if (IsGeometry(argv[i]) == MagickFalse)
5846 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5849 if (LocaleCompare("segment",option+1) == 0)
5854 if (i == (ssize_t) argc)
5855 ThrowMogrifyException(OptionError,"MissingArgument",option);
5856 if (IsGeometry(argv[i]) == MagickFalse)
5857 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5860 if (LocaleCompare("selective-blur",option+1) == 0)
5863 if (i == (ssize_t) argc)
5864 ThrowMogrifyException(OptionError,"MissingArgument",option);
5865 if (IsGeometry(argv[i]) == MagickFalse)
5866 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5869 if (LocaleCompare("separate",option+1) == 0)
5871 if (LocaleCompare("sepia-tone",option+1) == 0)
5876 if (i == (ssize_t) argc)
5877 ThrowMogrifyException(OptionError,"MissingArgument",option);
5878 if (IsGeometry(argv[i]) == MagickFalse)
5879 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5882 if (LocaleCompare("set",option+1) == 0)
5885 if (i == (ssize_t) argc)
5886 ThrowMogrifyException(OptionError,"MissingArgument",option);
5890 if (i == (ssize_t) argc)
5891 ThrowMogrifyException(OptionError,"MissingArgument",option);
5894 if (LocaleCompare("shade",option+1) == 0)
5897 if (i == (ssize_t) argc)
5898 ThrowMogrifyException(OptionError,"MissingArgument",option);
5899 if (IsGeometry(argv[i]) == MagickFalse)
5900 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5903 if (LocaleCompare("shadow",option+1) == 0)
5908 if (i == (ssize_t) argc)
5909 ThrowMogrifyException(OptionError,"MissingArgument",option);
5910 if (IsGeometry(argv[i]) == MagickFalse)
5911 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5914 if (LocaleCompare("sharpen",option+1) == 0)
5917 if (i == (ssize_t) argc)
5918 ThrowMogrifyException(OptionError,"MissingArgument",option);
5919 if (IsGeometry(argv[i]) == MagickFalse)
5920 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5923 if (LocaleCompare("shave",option+1) == 0)
5928 if (i == (ssize_t) argc)
5929 ThrowMogrifyException(OptionError,"MissingArgument",option);
5930 if (IsGeometry(argv[i]) == MagickFalse)
5931 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5934 if (LocaleCompare("shear",option+1) == 0)
5937 if (i == (ssize_t) argc)
5938 ThrowMogrifyException(OptionError,"MissingArgument",option);
5939 if (IsGeometry(argv[i]) == MagickFalse)
5940 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5943 if (LocaleCompare("sigmoidal-contrast",option+1) == 0)
5946 if (i == (ssize_t) (argc-1))
5947 ThrowMogrifyException(OptionError,"MissingArgument",option);
5948 if (IsGeometry(argv[i]) == MagickFalse)
5949 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5952 if (LocaleCompare("size",option+1) == 0)
5957 if (i == (ssize_t) argc)
5958 ThrowMogrifyException(OptionError,"MissingArgument",option);
5959 if (IsGeometry(argv[i]) == MagickFalse)
5960 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5963 if (LocaleCompare("sketch",option+1) == 0)
5968 if (i == (ssize_t) argc)
5969 ThrowMogrifyException(OptionError,"MissingArgument",option);
5970 if (IsGeometry(argv[i]) == MagickFalse)
5971 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5974 if (LocaleCompare("solarize",option+1) == 0)
5979 if (i == (ssize_t) argc)
5980 ThrowMogrifyException(OptionError,"MissingArgument",option);
5981 if (IsGeometry(argv[i]) == MagickFalse)
5982 ThrowMogrifyInvalidArgumentException(option,argv[i]);
5985 if (LocaleCompare("sparse-color",option+1) == 0)
5991 if (i == (ssize_t) argc)
5992 ThrowMogrifyException(OptionError,"MissingArgument",option);
5993 op=ParseMagickOption(MagickSparseColorOptions,MagickFalse,argv[i]);
5995 ThrowMogrifyException(OptionError,"UnrecognizedSparseColorMethod",
5998 if (i == (ssize_t) (argc-1))
5999 ThrowMogrifyException(OptionError,"MissingArgument",option);
6002 if (LocaleCompare("spread",option+1) == 0)
6007 if (i == (ssize_t) argc)
6008 ThrowMogrifyException(OptionError,"MissingArgument",option);
6009 if (IsGeometry(argv[i]) == MagickFalse)
6010 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6013 if (LocaleCompare("stretch",option+1) == 0)
6021 if (i == (ssize_t) (argc-1))
6022 ThrowMogrifyException(OptionError,"MissingArgument",option);
6023 stretch=ParseMagickOption(MagickStretchOptions,MagickFalse,argv[i]);
6025 ThrowMogrifyException(OptionError,"UnrecognizedStyleType",
6029 if (LocaleCompare("strip",option+1) == 0)
6031 if (LocaleCompare("stroke",option+1) == 0)
6036 if (i == (ssize_t) argc)
6037 ThrowMogrifyException(OptionError,"MissingArgument",option);
6040 if (LocaleCompare("strokewidth",option+1) == 0)
6045 if (i == (ssize_t) argc)
6046 ThrowMogrifyException(OptionError,"MissingArgument",option);
6047 if (IsGeometry(argv[i]) == MagickFalse)
6048 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6051 if (LocaleCompare("style",option+1) == 0)
6059 if (i == (ssize_t) (argc-1))
6060 ThrowMogrifyException(OptionError,"MissingArgument",option);
6061 style=ParseMagickOption(MagickStyleOptions,MagickFalse,argv[i]);
6063 ThrowMogrifyException(OptionError,"UnrecognizedStyleType",
6067 if (LocaleCompare("swirl",option+1) == 0)
6072 if (i == (ssize_t) argc)
6073 ThrowMogrifyException(OptionError,"MissingArgument",option);
6074 if (IsGeometry(argv[i]) == MagickFalse)
6075 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6078 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6082 if (LocaleCompare("taint",option+1) == 0)
6084 if (LocaleCompare("texture",option+1) == 0)
6089 if (i == (ssize_t) argc)
6090 ThrowMogrifyException(OptionError,"MissingArgument",option);
6093 if (LocaleCompare("tile",option+1) == 0)
6098 if (i == (ssize_t) (argc-1))
6099 ThrowMogrifyException(OptionError,"MissingArgument",option);
6102 if (LocaleCompare("tile-offset",option+1) == 0)
6107 if (i == (ssize_t) argc)
6108 ThrowMogrifyException(OptionError,"MissingArgument",option);
6109 if (IsGeometry(argv[i]) == MagickFalse)
6110 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6113 if (LocaleCompare("tint",option+1) == 0)
6118 if (i == (ssize_t) (argc-1))
6119 ThrowMogrifyException(OptionError,"MissingArgument",option);
6120 if (IsGeometry(argv[i]) == MagickFalse)
6121 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6124 if (LocaleCompare("transform",option+1) == 0)
6126 if (LocaleCompare("transpose",option+1) == 0)
6128 if (LocaleCompare("transverse",option+1) == 0)
6130 if (LocaleCompare("threshold",option+1) == 0)
6135 if (i == (ssize_t) argc)
6136 ThrowMogrifyException(OptionError,"MissingArgument",option);
6137 if (IsGeometry(argv[i]) == MagickFalse)
6138 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6141 if (LocaleCompare("thumbnail",option+1) == 0)
6146 if (i == (ssize_t) argc)
6147 ThrowMogrifyException(OptionError,"MissingArgument",option);
6148 if (IsGeometry(argv[i]) == MagickFalse)
6149 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6152 if (LocaleCompare("transparent",option+1) == 0)
6155 if (i == (ssize_t) argc)
6156 ThrowMogrifyException(OptionError,"MissingArgument",option);
6159 if (LocaleCompare("transparent-color",option+1) == 0)
6164 if (i == (ssize_t) (argc-1))
6165 ThrowMogrifyException(OptionError,"MissingArgument",option);
6168 if (LocaleCompare("treedepth",option+1) == 0)
6173 if (i == (ssize_t) argc)
6174 ThrowMogrifyException(OptionError,"MissingArgument",option);
6175 if (IsGeometry(argv[i]) == MagickFalse)
6176 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6179 if (LocaleCompare("trim",option+1) == 0)
6181 if (LocaleCompare("type",option+1) == 0)
6189 if (i == (ssize_t) argc)
6190 ThrowMogrifyException(OptionError,"MissingArgument",option);
6191 type=ParseMagickOption(MagickTypeOptions,MagickFalse,argv[i]);
6193 ThrowMogrifyException(OptionError,"UnrecognizedImageType",
6197 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6201 if (LocaleCompare("undercolor",option+1) == 0)
6206 if (i == (ssize_t) argc)
6207 ThrowMogrifyException(OptionError,"MissingArgument",option);
6210 if (LocaleCompare("unique-colors",option+1) == 0)
6212 if (LocaleCompare("units",option+1) == 0)
6220 if (i == (ssize_t) argc)
6221 ThrowMogrifyException(OptionError,"MissingArgument",option);
6222 units=ParseMagickOption(MagickResolutionOptions,MagickFalse,
6225 ThrowMogrifyException(OptionError,"UnrecognizedUnitsType",
6229 if (LocaleCompare("unsharp",option+1) == 0)
6232 if (i == (ssize_t) argc)
6233 ThrowMogrifyException(OptionError,"MissingArgument",option);
6234 if (IsGeometry(argv[i]) == MagickFalse)
6235 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6238 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6242 if (LocaleCompare("verbose",option+1) == 0)
6244 image_info->verbose=(*option == '-') ? MagickTrue : MagickFalse;
6247 if ((LocaleCompare("version",option+1) == 0) ||
6248 (LocaleCompare("-version",option+1) == 0))
6250 (void) fprintf(stdout,"Version: %s\n",
6251 GetMagickVersion((size_t *) NULL));
6252 (void) fprintf(stdout,"Copyright: %s\n",GetMagickCopyright());
6253 (void) fprintf(stdout,"Features: %s\n\n",GetMagickFeatures());
6256 if (LocaleCompare("view",option+1) == 0)
6261 if (i == (ssize_t) argc)
6262 ThrowMogrifyException(OptionError,"MissingArgument",option);
6265 if (LocaleCompare("vignette",option+1) == 0)
6270 if (i == (ssize_t) argc)
6271 ThrowMogrifyException(OptionError,"MissingArgument",option);
6272 if (IsGeometry(argv[i]) == MagickFalse)
6273 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6276 if (LocaleCompare("virtual-pixel",option+1) == 0)
6284 if (i == (ssize_t) argc)
6285 ThrowMogrifyException(OptionError,"MissingArgument",option);
6286 method=ParseMagickOption(MagickVirtualPixelOptions,MagickFalse,
6289 ThrowMogrifyException(OptionError,
6290 "UnrecognizedVirtualPixelMethod",argv[i]);
6293 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6297 if (LocaleCompare("wave",option+1) == 0)
6300 if (i == (ssize_t) argc)
6301 ThrowMogrifyException(OptionError,"MissingArgument",option);
6302 if (IsGeometry(argv[i]) == MagickFalse)
6303 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6306 if (LocaleCompare("weight",option+1) == 0)
6311 if (i == (ssize_t) (argc-1))
6312 ThrowMogrifyException(OptionError,"MissingArgument",option);
6315 if (LocaleCompare("white-point",option+1) == 0)
6320 if (i == (ssize_t) argc)
6321 ThrowMogrifyException(OptionError,"MissingArgument",option);
6322 if (IsGeometry(argv[i]) == MagickFalse)
6323 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6326 if (LocaleCompare("white-threshold",option+1) == 0)
6331 if (i == (ssize_t) argc)
6332 ThrowMogrifyException(OptionError,"MissingArgument",option);
6333 if (IsGeometry(argv[i]) == MagickFalse)
6334 ThrowMogrifyInvalidArgumentException(option,argv[i]);
6337 if (LocaleCompare("write",option+1) == 0)
6340 if (i == (ssize_t) (argc-1))
6341 ThrowMogrifyException(OptionError,"MissingArgument",option);
6344 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6349 ThrowMogrifyException(OptionError,"UnrecognizedOption",option)
6351 fire=ParseMagickOption(MagickImageListOptions,MagickFalse,option+1) < 0 ?
6352 MagickFalse : MagickTrue;
6353 if (fire != MagickFalse)
6354 FireImageStack(MagickFalse,MagickTrue,MagickTrue);
6357 ThrowMogrifyException(OptionError,"UnbalancedParenthesis",argv[i]);
6358 if (i != (ssize_t) argc)
6359 ThrowMogrifyException(OptionError,"MissingAnImageFilename",argv[i]);
6361 return(status != 0 ? MagickTrue : MagickFalse);
6365 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6369 + M o g r i f y I m a g e I n f o %
6373 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6375 % MogrifyImageInfo() applies image processing settings to the image as
6376 % prescribed by command line options.
6378 % The format of the MogrifyImageInfo method is:
6380 % MagickBooleanType MogrifyImageInfo(ImageInfo *image_info,const int argc,
6381 % const char **argv,ExceptionInfo *exception)
6383 % A description of each parameter follows:
6385 % o image_info: the image info..
6387 % o argc: Specifies a pointer to an integer describing the number of
6388 % elements in the argument vector.
6390 % o argv: Specifies a pointer to a text array containing the command line
6393 % o exception: return any errors or warnings in this structure.
6396 WandExport MagickBooleanType MogrifyImageInfo(ImageInfo *image_info,
6397 const int argc,const char **argv,ExceptionInfo *exception)
6412 Initialize method variables.
6414 assert(image_info != (ImageInfo *) NULL);
6415 assert(image_info->signature == MagickSignature);
6416 if (image_info->debug != MagickFalse)
6417 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
6418 image_info->filename);
6422 Set the image settings.
6424 for (i=0; i < (ssize_t) argc; i++)
6427 if (IsMagickOption(option) == MagickFalse)
6429 count=MagickMax(ParseMagickOption(MagickCommandOptions,MagickFalse,option),
6431 if ((i+count) >= (ssize_t) argc)
6433 switch (*(option+1))
6437 if (LocaleCompare("adjoin",option+1) == 0)
6439 image_info->adjoin=(*option == '-') ? MagickTrue : MagickFalse;
6442 if (LocaleCompare("antialias",option+1) == 0)
6444 image_info->antialias=(*option == '-') ? MagickTrue : MagickFalse;
6447 if (LocaleCompare("attenuate",option+1) == 0)
6451 (void) DeleteImageOption(image_info,option+1);
6454 (void) SetImageOption(image_info,option+1,argv[i+1]);
6457 if (LocaleCompare("authenticate",option+1) == 0)
6460 (void) CloneString(&image_info->authenticate,(char *) NULL);
6462 (void) CloneString(&image_info->authenticate,argv[i+1]);
6469 if (LocaleCompare("background",option+1) == 0)
6473 (void) DeleteImageOption(image_info,option+1);
6474 (void) QueryColorDatabase(BackgroundColor,
6475 &image_info->background_color,exception);
6478 (void) SetImageOption(image_info,option+1,argv[i+1]);
6479 (void) QueryColorDatabase(argv[i+1],&image_info->background_color,
6483 if (LocaleCompare("bias",option+1) == 0)
6487 (void) SetImageOption(image_info,option+1,"0.0");
6490 (void) SetImageOption(image_info,option+1,argv[i+1]);
6493 if (LocaleCompare("black-point-compensation",option+1) == 0)
6497 (void) SetImageOption(image_info,option+1,"false");
6500 (void) SetImageOption(image_info,option+1,"true");
6503 if (LocaleCompare("blue-primary",option+1) == 0)
6507 (void) SetImageOption(image_info,option+1,"0.0");
6510 (void) SetImageOption(image_info,option+1,argv[i+1]);
6513 if (LocaleCompare("bordercolor",option+1) == 0)
6517 (void) DeleteImageOption(image_info,option+1);
6518 (void) QueryColorDatabase(BorderColor,&image_info->border_color,
6522 (void) QueryColorDatabase(argv[i+1],&image_info->border_color,
6524 (void) SetImageOption(image_info,option+1,argv[i+1]);
6527 if (LocaleCompare("box",option+1) == 0)
6531 (void) SetImageOption(image_info,"undercolor","none");
6534 (void) SetImageOption(image_info,"undercolor",argv[i+1]);
6541 if (LocaleCompare("cache",option+1) == 0)
6546 limit=MagickResourceInfinity;
6547 if (LocaleCompare("unlimited",argv[i+1]) != 0)
6548 limit=(MagickSizeType) SiPrefixToDouble(argv[i+1],100.0);
6549 (void) SetMagickResourceLimit(MemoryResource,limit);
6550 (void) SetMagickResourceLimit(MapResource,2*limit);
6553 if (LocaleCompare("caption",option+1) == 0)
6557 (void) DeleteImageOption(image_info,option+1);
6560 (void) SetImageOption(image_info,option+1,argv[i+1]);
6563 if (LocaleCompare("channel",option+1) == 0)
6567 image_info->channel=DefaultChannels;
6570 image_info->channel=(ChannelType) ParseChannelOption(argv[i+1]);
6573 if (LocaleCompare("colors",option+1) == 0)
6575 image_info->colors=StringToUnsignedLong(argv[i+1]);
6578 if (LocaleCompare("colorspace",option+1) == 0)
6582 image_info->colorspace=UndefinedColorspace;
6583 (void) SetImageOption(image_info,option+1,"undefined");
6586 image_info->colorspace=(ColorspaceType) ParseMagickOption(
6587 MagickColorspaceOptions,MagickFalse,argv[i+1]);
6588 (void) SetImageOption(image_info,option+1,argv[i+1]);
6591 if (LocaleCompare("compress",option+1) == 0)
6595 image_info->compression=UndefinedCompression;
6596 (void) SetImageOption(image_info,option+1,"undefined");
6599 image_info->compression=(CompressionType) ParseMagickOption(
6600 MagickCompressOptions,MagickFalse,argv[i+1]);
6601 (void) SetImageOption(image_info,option+1,argv[i+1]);
6604 if (LocaleCompare("comment",option+1) == 0)
6608 (void) DeleteImageOption(image_info,option+1);
6611 (void) SetImageOption(image_info,option+1,argv[i+1]);
6614 if (LocaleCompare("compose",option+1) == 0)
6618 (void) SetImageOption(image_info,option+1,"undefined");
6621 (void) SetImageOption(image_info,option+1,argv[i+1]);
6624 if (LocaleCompare("compress",option+1) == 0)
6628 image_info->compression=UndefinedCompression;
6629 (void) SetImageOption(image_info,option+1,"undefined");
6632 image_info->compression=(CompressionType) ParseMagickOption(
6633 MagickCompressOptions,MagickFalse,argv[i+1]);
6634 (void) SetImageOption(image_info,option+1,argv[i+1]);
6641 if (LocaleCompare("debug",option+1) == 0)
6644 (void) SetLogEventMask("none");
6646 (void) SetLogEventMask(argv[i+1]);
6647 image_info->debug=IsEventLogging();
6650 if (LocaleCompare("define",option+1) == 0)
6654 if (LocaleNCompare(argv[i+1],"registry:",9) == 0)
6655 (void) DeleteImageRegistry(argv[i+1]+9);
6657 (void) DeleteImageOption(image_info,argv[i+1]);
6660 if (LocaleNCompare(argv[i+1],"registry:",9) == 0)
6662 (void) DefineImageRegistry(StringRegistryType,argv[i+1]+9,
6666 (void) DefineImageOption(image_info,argv[i+1]);
6669 if (LocaleCompare("delay",option+1) == 0)
6673 (void) SetImageOption(image_info,option+1,"0");
6676 (void) SetImageOption(image_info,option+1,argv[i+1]);
6679 if (LocaleCompare("density",option+1) == 0)
6686 if (image_info->density != (char *) NULL)
6687 image_info->density=DestroyString(image_info->density);
6688 (void) SetImageOption(image_info,option+1,"72");
6691 (void) CloneString(&image_info->density,argv[i+1]);
6692 (void) SetImageOption(image_info,option+1,argv[i+1]);
6695 if (LocaleCompare("depth",option+1) == 0)
6699 image_info->depth=MAGICKCORE_QUANTUM_DEPTH;
6702 image_info->depth=StringToUnsignedLong(argv[i+1]);
6705 if (LocaleCompare("direction",option+1) == 0)
6709 (void) SetImageOption(image_info,option+1,"undefined");
6712 (void) SetImageOption(image_info,option+1,argv[i+1]);
6715 if (LocaleCompare("display",option+1) == 0)
6719 if (image_info->server_name != (char *) NULL)
6720 image_info->server_name=DestroyString(
6721 image_info->server_name);
6724 (void) CloneString(&image_info->server_name,argv[i+1]);
6727 if (LocaleCompare("dispose",option+1) == 0)
6731 (void) SetImageOption(image_info,option+1,"undefined");
6734 (void) SetImageOption(image_info,option+1,argv[i+1]);
6737 if (LocaleCompare("dither",option+1) == 0)
6741 image_info->dither=MagickFalse;
6742 (void) SetImageOption(image_info,option+1,"none");
6745 (void) SetImageOption(image_info,option+1,argv[i+1]);
6746 image_info->dither=MagickTrue;
6753 if (LocaleCompare("encoding",option+1) == 0)
6757 (void) SetImageOption(image_info,option+1,"undefined");
6760 (void) SetImageOption(image_info,option+1,argv[i+1]);
6763 if (LocaleCompare("endian",option+1) == 0)
6767 image_info->endian=UndefinedEndian;
6768 (void) SetImageOption(image_info,option+1,"undefined");
6771 image_info->endian=(EndianType) ParseMagickOption(
6772 MagickEndianOptions,MagickFalse,argv[i+1]);
6773 (void) SetImageOption(image_info,option+1,argv[i+1]);
6776 if (LocaleCompare("extract",option+1) == 0)
6779 Set image extract geometry.
6783 if (image_info->extract != (char *) NULL)
6784 image_info->extract=DestroyString(image_info->extract);
6787 (void) CloneString(&image_info->extract,argv[i+1]);
6794 if (LocaleCompare("fill",option+1) == 0)
6798 (void) SetImageOption(image_info,option+1,"none");
6801 (void) SetImageOption(image_info,option+1,argv[i+1]);
6804 if (LocaleCompare("filter",option+1) == 0)
6808 (void) SetImageOption(image_info,option+1,"undefined");
6811 (void) SetImageOption(image_info,option+1,argv[i+1]);
6814 if (LocaleCompare("font",option+1) == 0)
6818 if (image_info->font != (char *) NULL)
6819 image_info->font=DestroyString(image_info->font);
6822 (void) CloneString(&image_info->font,argv[i+1]);
6825 if (LocaleCompare("format",option+1) == 0)
6830 for (q=strchr(argv[i+1],'%'); q != (char *) NULL; q=strchr(q+1,'%'))
6831 if (strchr("gkrz@[#",*(q+1)) != (char *) NULL)
6832 image_info->ping=MagickFalse;
6833 (void) SetImageOption(image_info,option+1,argv[i+1]);
6836 if (LocaleCompare("fuzz",option+1) == 0)
6840 image_info->fuzz=0.0;
6841 (void) SetImageOption(image_info,option+1,"0");
6844 image_info->fuzz=SiPrefixToDouble(argv[i+1],(double) QuantumRange+
6846 (void) SetImageOption(image_info,option+1,argv[i+1]);
6853 if (LocaleCompare("gravity",option+1) == 0)
6857 (void) SetImageOption(image_info,option+1,"undefined");
6860 (void) SetImageOption(image_info,option+1,argv[i+1]);
6863 if (LocaleCompare("green-primary",option+1) == 0)
6867 (void) SetImageOption(image_info,option+1,"0.0");
6870 (void) SetImageOption(image_info,option+1,argv[i+1]);
6877 if (LocaleCompare("intent",option+1) == 0)
6881 (void) SetImageOption(image_info,option+1,"undefined");
6884 (void) SetImageOption(image_info,option+1,argv[i+1]);
6887 if (LocaleCompare("interlace",option+1) == 0)
6891 image_info->interlace=UndefinedInterlace;
6892 (void) SetImageOption(image_info,option+1,"undefined");
6895 image_info->interlace=(InterlaceType) ParseMagickOption(
6896 MagickInterlaceOptions,MagickFalse,argv[i+1]);
6897 (void) SetImageOption(image_info,option+1,argv[i+1]);
6900 if (LocaleCompare("interline-spacing",option+1) == 0)
6904 (void) SetImageOption(image_info,option+1,"undefined");
6907 (void) SetImageOption(image_info,option+1,argv[i+1]);
6910 if (LocaleCompare("interpolate",option+1) == 0)
6914 (void) SetImageOption(image_info,option+1,"undefined");
6917 (void) SetImageOption(image_info,option+1,argv[i+1]);
6920 if (LocaleCompare("interword-spacing",option+1) == 0)
6924 (void) SetImageOption(image_info,option+1,"undefined");
6927 (void) SetImageOption(image_info,option+1,argv[i+1]);
6934 if (LocaleCompare("kerning",option+1) == 0)
6938 (void) SetImageOption(image_info,option+1,"undefined");
6941 (void) SetImageOption(image_info,option+1,argv[i+1]);
6948 if (LocaleCompare("label",option+1) == 0)
6952 (void) DeleteImageOption(image_info,option+1);
6955 (void) SetImageOption(image_info,option+1,argv[i+1]);
6958 if (LocaleCompare("limit",option+1) == 0)
6968 type=(ResourceType) ParseMagickOption(MagickResourceOptions,
6969 MagickFalse,argv[i+1]);
6970 limit=MagickResourceInfinity;
6971 if (LocaleCompare("unlimited",argv[i+2]) != 0)
6972 limit=(MagickSizeType) SiPrefixToDouble(argv[i+2],100.0);
6973 (void) SetMagickResourceLimit(type,limit);
6976 if (LocaleCompare("list",option+1) == 0)
6982 Display configuration list.
6984 list=ParseMagickOption(MagickListOptions,MagickFalse,argv[i+1]);
6987 case MagickCoderOptions:
6989 (void) ListCoderInfo((FILE *) NULL,exception);
6992 case MagickColorOptions:
6994 (void) ListColorInfo((FILE *) NULL,exception);
6997 case MagickConfigureOptions:
6999 (void) ListConfigureInfo((FILE *) NULL,exception);
7002 case MagickDelegateOptions:
7004 (void) ListDelegateInfo((FILE *) NULL,exception);
7007 case MagickFontOptions:
7009 (void) ListTypeInfo((FILE *) NULL,exception);
7012 case MagickFormatOptions:
7014 (void) ListMagickInfo((FILE *) NULL,exception);
7017 case MagickLocaleOptions:
7019 (void) ListLocaleInfo((FILE *) NULL,exception);
7022 case MagickLogOptions:
7024 (void) ListLogInfo((FILE *) NULL,exception);
7027 case MagickMagicOptions:
7029 (void) ListMagicInfo((FILE *) NULL,exception);
7032 case MagickMimeOptions:
7034 (void) ListMimeInfo((FILE *) NULL,exception);
7037 case MagickModuleOptions:
7039 (void) ListModuleInfo((FILE *) NULL,exception);
7042 case MagickPolicyOptions:
7044 (void) ListPolicyInfo((FILE *) NULL,exception);
7047 case MagickResourceOptions:
7049 (void) ListMagickResourceInfo((FILE *) NULL,exception);
7052 case MagickThresholdOptions:
7054 (void) ListThresholdMaps((FILE *) NULL,exception);
7059 (void) ListMagickOptions((FILE *) NULL,(MagickOption) list,
7066 if (LocaleCompare("log",option+1) == 0)
7070 (void) SetLogFormat(argv[i+1]);
7073 if (LocaleCompare("loop",option+1) == 0)
7077 (void) SetImageOption(image_info,option+1,"0");
7080 (void) SetImageOption(image_info,option+1,argv[i+1]);
7087 if (LocaleCompare("matte",option+1) == 0)
7091 (void) SetImageOption(image_info,option+1,"false");
7094 (void) SetImageOption(image_info,option+1,"true");
7097 if (LocaleCompare("mattecolor",option+1) == 0)
7101 (void) SetImageOption(image_info,option+1,argv[i+1]);
7102 (void) QueryColorDatabase(MatteColor,&image_info->matte_color,
7106 (void) SetImageOption(image_info,option+1,argv[i+1]);
7107 (void) QueryColorDatabase(argv[i+1],&image_info->matte_color,
7111 if (LocaleCompare("monitor",option+1) == 0)
7113 (void) SetImageInfoProgressMonitor(image_info,MonitorProgress,
7117 if (LocaleCompare("monochrome",option+1) == 0)
7119 image_info->monochrome=(*option == '-') ? MagickTrue : MagickFalse;
7126 if (LocaleCompare("orient",option+1) == 0)
7130 image_info->orientation=UndefinedOrientation;
7131 (void) SetImageOption(image_info,option+1,"undefined");
7134 image_info->orientation=(OrientationType) ParseMagickOption(
7135 MagickOrientationOptions,MagickFalse,argv[i+1]);
7136 (void) SetImageOption(image_info,option+1,"undefined");
7142 if (LocaleCompare("page",option+1) == 0)
7146 page[MaxTextExtent];
7159 (void) DeleteImageOption(image_info,option+1);
7160 (void) CloneString(&image_info->page,(char *) NULL);
7163 (void) ResetMagickMemory(&geometry,0,sizeof(geometry));
7164 image_option=GetImageOption(image_info,"page");
7165 if (image_option != (const char *) NULL)
7166 flags=ParseAbsoluteGeometry(image_option,&geometry);
7167 canonical_page=GetPageGeometry(argv[i+1]);
7168 flags=ParseAbsoluteGeometry(canonical_page,&geometry);
7169 canonical_page=DestroyString(canonical_page);
7170 (void) FormatMagickString(page,MaxTextExtent,"%lux%lu",
7171 (unsigned long) geometry.width,(unsigned long) geometry.height);
7172 if (((flags & XValue) != 0) || ((flags & YValue) != 0))
7173 (void) FormatMagickString(page,MaxTextExtent,"%lux%lu%+ld%+ld",
7174 (unsigned long) geometry.width,(unsigned long) geometry.height,
7175 (long) geometry.x,(long) geometry.y);
7176 (void) SetImageOption(image_info,option+1,page);
7177 (void) CloneString(&image_info->page,page);
7180 if (LocaleCompare("pen",option+1) == 0)
7184 (void) SetImageOption(image_info,option+1,"none");
7187 (void) SetImageOption(image_info,option+1,argv[i+1]);
7190 if (LocaleCompare("ping",option+1) == 0)
7192 image_info->ping=(*option == '-') ? MagickTrue : MagickFalse;
7195 if (LocaleCompare("pointsize",option+1) == 0)
7198 geometry_info.rho=0.0;
7200 (void) ParseGeometry(argv[i+1],&geometry_info);
7201 image_info->pointsize=geometry_info.rho;
7204 if (LocaleCompare("precision",option+1) == 0)
7206 (void) SetMagickPrecision(StringToInteger(argv[i+1]));
7209 if (LocaleCompare("preview",option+1) == 0)
7216 image_info->preview_type=UndefinedPreview;
7219 image_info->preview_type=(PreviewType) ParseMagickOption(
7220 MagickPreviewOptions,MagickFalse,argv[i+1]);
7227 if (LocaleCompare("quality",option+1) == 0)
7230 Set image compression quality.
7234 image_info->quality=UndefinedCompressionQuality;
7235 (void) SetImageOption(image_info,option+1,"0");
7238 image_info->quality=StringToUnsignedLong(argv[i+1]);
7239 (void) SetImageOption(image_info,option+1,argv[i+1]);
7242 if (LocaleCompare("quiet",option+1) == 0)
7244 static WarningHandler
7245 warning_handler = (WarningHandler) NULL;
7250 Restore error or warning messages.
7252 warning_handler=SetWarningHandler(warning_handler);
7256 Suppress error or warning messages.
7258 warning_handler=SetWarningHandler((WarningHandler) NULL);
7265 if (LocaleCompare("red-primary",option+1) == 0)
7269 (void) SetImageOption(image_info,option+1,"0.0");
7272 (void) SetImageOption(image_info,option+1,argv[i+1]);
7279 if (LocaleCompare("sampling-factor",option+1) == 0)
7282 Set image sampling factor.
7286 if (image_info->sampling_factor != (char *) NULL)
7287 image_info->sampling_factor=DestroyString(
7288 image_info->sampling_factor);
7291 (void) CloneString(&image_info->sampling_factor,argv[i+1]);
7294 if (LocaleCompare("scene",option+1) == 0)
7301 image_info->scene=0;
7302 (void) SetImageOption(image_info,option+1,"0");
7305 image_info->scene=StringToUnsignedLong(argv[i+1]);
7306 (void) SetImageOption(image_info,option+1,argv[i+1]);
7309 if (LocaleCompare("seed",option+1) == 0)
7316 seed=(size_t) time((time_t *) NULL);
7317 SeedPseudoRandomGenerator(seed);
7320 seed=StringToUnsignedLong(argv[i+1]);
7321 SeedPseudoRandomGenerator(seed);
7324 if (LocaleCompare("set",option+1) == 0)
7326 (void) SetImageOption(image_info,argv[i+1],argv[i+2]);
7329 if (LocaleCompare("size",option+1) == 0)
7333 if (image_info->size != (char *) NULL)
7334 image_info->size=DestroyString(image_info->size);
7337 (void) CloneString(&image_info->size,argv[i+1]);
7340 if (LocaleCompare("stroke",option+1) == 0)
7344 (void) SetImageOption(image_info,option+1,"none");
7347 (void) SetImageOption(image_info,option+1,argv[i+1]);
7350 if (LocaleCompare("strokewidth",option+1) == 0)
7354 (void) SetImageOption(image_info,option+1,"0");
7357 (void) SetImageOption(image_info,option+1,argv[i+1]);
7364 if (LocaleCompare("taint",option+1) == 0)
7368 (void) SetImageOption(image_info,option+1,"false");
7371 (void) SetImageOption(image_info,option+1,"true");
7374 if (LocaleCompare("texture",option+1) == 0)
7378 if (image_info->texture != (char *) NULL)
7379 image_info->texture=DestroyString(image_info->texture);
7382 (void) CloneString(&image_info->texture,argv[i+1]);
7385 if (LocaleCompare("tile-offset",option+1) == 0)
7389 (void) SetImageOption(image_info,option+1,"0");
7392 (void) SetImageOption(image_info,option+1,argv[i+1]);
7395 if (LocaleCompare("transparent-color",option+1) == 0)
7399 (void) QueryColorDatabase("none",&image_info->transparent_color, exception);
7400 (void) SetImageOption(image_info,option+1,"none");
7403 (void) QueryColorDatabase(argv[i+1],&image_info->transparent_color,
7405 (void) SetImageOption(image_info,option+1,argv[i+1]);
7408 if (LocaleCompare("type",option+1) == 0)
7412 image_info->type=UndefinedType;
7413 (void) SetImageOption(image_info,option+1,"undefined");
7416 image_info->type=(ImageType) ParseMagickOption(MagickTypeOptions,
7417 MagickFalse,argv[i+1]);
7418 (void) SetImageOption(image_info,option+1,argv[i+1]);
7425 if (LocaleCompare("undercolor",option+1) == 0)
7429 (void) DeleteImageOption(image_info,option+1);
7432 (void) SetImageOption(image_info,option+1,argv[i+1]);
7435 if (LocaleCompare("units",option+1) == 0)
7439 image_info->units=UndefinedResolution;
7440 (void) SetImageOption(image_info,option+1,"undefined");
7443 image_info->units=(ResolutionType) ParseMagickOption(
7444 MagickResolutionOptions,MagickFalse,argv[i+1]);
7445 (void) SetImageOption(image_info,option+1,argv[i+1]);
7452 if (LocaleCompare("verbose",option+1) == 0)
7456 image_info->verbose=MagickFalse;
7459 image_info->verbose=MagickTrue;
7460 image_info->ping=MagickFalse;
7463 if (LocaleCompare("view",option+1) == 0)
7467 if (image_info->view != (char *) NULL)
7468 image_info->view=DestroyString(image_info->view);
7471 (void) CloneString(&image_info->view,argv[i+1]);
7474 if (LocaleCompare("virtual-pixel",option+1) == 0)
7478 image_info->virtual_pixel_method=UndefinedVirtualPixelMethod;
7479 (void) SetImageOption(image_info,option+1,"undefined");
7482 image_info->virtual_pixel_method=(VirtualPixelMethod)
7483 ParseMagickOption(MagickVirtualPixelOptions,MagickFalse,
7485 (void) SetImageOption(image_info,option+1,argv[i+1]);
7492 if (LocaleCompare("white-point",option+1) == 0)
7496 (void) SetImageOption(image_info,option+1,"0.0");
7499 (void) SetImageOption(image_info,option+1,argv[i+1]);
7513 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
7517 + M o g r i f y I m a g e L i s t %
7521 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
7523 % MogrifyImageList() applies any command line options that might affect the
7524 % entire image list (e.g. -append, -coalesce, etc.).
7526 % The format of the MogrifyImage method is:
7528 % MagickBooleanType MogrifyImageList(ImageInfo *image_info,const int argc,
7529 % const char **argv,Image **images,ExceptionInfo *exception)
7531 % A description of each parameter follows:
7533 % o image_info: the image info..
7535 % o argc: Specifies a pointer to an integer describing the number of
7536 % elements in the argument vector.
7538 % o argv: Specifies a pointer to a text array containing the command line
7541 % o images: the images.
7543 % o exception: return any errors or warnings in this structure.
7546 WandExport MagickBooleanType MogrifyImageList(ImageInfo *image_info,
7547 const int argc,const char **argv,Image **images,ExceptionInfo *exception)
7572 Apply options to the image list.
7574 assert(image_info != (ImageInfo *) NULL);
7575 assert(image_info->signature == MagickSignature);
7576 assert(images != (Image **) NULL);
7577 assert((*images)->signature == MagickSignature);
7578 if ((*images)->debug != MagickFalse)
7579 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
7580 (*images)->filename);
7581 if ((argc <= 0) || (*argv == (char *) NULL))
7583 mogrify_info=CloneImageInfo(image_info);
7584 quantize_info=AcquireQuantizeInfo(mogrify_info);
7585 channel=mogrify_info->channel;
7587 for (i=0; i < (ssize_t) argc; i++)
7589 if (*images == (Image *) NULL)
7592 if (IsMagickOption(option) == MagickFalse)
7594 count=MagickMax(ParseMagickOption(MagickCommandOptions,MagickFalse,option),
7596 if ((i+count) >= (ssize_t) argc)
7598 status=MogrifyImageInfo(mogrify_info,(int) count+1,argv+i,exception);
7599 switch (*(option+1))
7603 if (LocaleCompare("affinity",option+1) == 0)
7605 (void) SyncImagesSettings(mogrify_info,*images);
7608 (void) RemapImages(quantize_info,*images,(Image *) NULL);
7609 InheritException(exception,&(*images)->exception);
7615 if (LocaleCompare("append",option+1) == 0)
7620 (void) SyncImagesSettings(mogrify_info,*images);
7621 append_image=AppendImages(*images,*option == '-' ? MagickTrue :
7622 MagickFalse,exception);
7623 if (append_image == (Image *) NULL)
7628 *images=DestroyImageList(*images);
7629 *images=append_image;
7632 if (LocaleCompare("average",option+1) == 0)
7638 Average an image sequence (deprecated).
7640 (void) SyncImagesSettings(mogrify_info,*images);
7641 average_image=EvaluateImages(*images,MeanEvaluateOperator,
7643 if (average_image == (Image *) NULL)
7648 *images=DestroyImageList(*images);
7649 *images=average_image;
7656 if (LocaleCompare("channel",option+1) == 0)
7660 channel=DefaultChannels;
7663 channel=(ChannelType) ParseChannelOption(argv[i+1]);
7666 if (LocaleCompare("clut",option+1) == 0)
7672 (void) SyncImagesSettings(mogrify_info,*images);
7673 image=RemoveFirstImageFromList(images);
7674 clut_image=RemoveFirstImageFromList(images);
7675 if (clut_image == (Image *) NULL)
7680 (void) ClutImageChannel(image,channel,clut_image);
7681 clut_image=DestroyImage(clut_image);
7682 InheritException(exception,&image->exception);
7683 *images=DestroyImageList(*images);
7687 if (LocaleCompare("coalesce",option+1) == 0)
7692 (void) SyncImagesSettings(mogrify_info,*images);
7693 coalesce_image=CoalesceImages(*images,exception);
7694 if (coalesce_image == (Image *) NULL)
7699 *images=DestroyImageList(*images);
7700 *images=coalesce_image;
7703 if (LocaleCompare("combine",option+1) == 0)
7708 (void) SyncImagesSettings(mogrify_info,*images);
7709 combine_image=CombineImages(*images,channel,exception);
7710 if (combine_image == (Image *) NULL)
7715 *images=DestroyImageList(*images);
7716 *images=combine_image;
7719 if (LocaleCompare("composite",option+1) == 0)
7729 (void) SyncImagesSettings(mogrify_info,*images);
7730 image=RemoveFirstImageFromList(images);
7731 composite_image=RemoveFirstImageFromList(images);
7732 if (composite_image == (Image *) NULL)
7737 (void) TransformImage(&composite_image,(char *) NULL,
7738 composite_image->geometry);
7739 SetGeometry(composite_image,&geometry);
7740 (void) ParseAbsoluteGeometry(composite_image->geometry,&geometry);
7741 GravityAdjustGeometry(image->columns,image->rows,image->gravity,
7743 mask_image=RemoveFirstImageFromList(images);
7744 if (mask_image != (Image *) NULL)
7746 if ((image->compose == DisplaceCompositeOp) ||
7747 (image->compose == DistortCompositeOp))
7750 Merge Y displacement into X displacement image.
7752 (void) CompositeImage(composite_image,CopyGreenCompositeOp,
7754 mask_image=DestroyImage(mask_image);
7759 Set a blending mask for the composition.
7761 image->mask=mask_image;
7762 (void) NegateImage(image->mask,MagickFalse);
7765 (void) CompositeImageChannel(image,channel,image->compose,
7766 composite_image,geometry.x,geometry.y);
7767 if (image->mask != (Image *) NULL)
7768 image->mask=DestroyImage(image->mask);
7769 composite_image=DestroyImage(composite_image);
7770 InheritException(exception,&image->exception);
7771 *images=DestroyImageList(*images);
7775 if (LocaleCompare("crop",option+1) == 0)
7783 (void) SyncImagesSettings(mogrify_info,*images);
7784 flags=ParseGravityGeometry(*images,argv[i+1],&geometry,exception);
7785 if (((geometry.width == 0) && (geometry.height == 0)) ||
7786 ((flags & XValue) != 0) || ((flags & YValue) != 0))
7788 (void) TransformImages(images,argv[i+1],(char *) NULL);
7789 InheritException(exception,&(*images)->exception);
7796 if (LocaleCompare("deconstruct",option+1) == 0)
7801 (void) SyncImagesSettings(mogrify_info,*images);
7802 deconstruct_image=DeconstructImages(*images,exception);
7803 if (deconstruct_image == (Image *) NULL)
7808 *images=DestroyImageList(*images);
7809 *images=deconstruct_image;
7812 if (LocaleCompare("delete",option+1) == 0)
7815 DeleteImages(images,"-1",exception);
7817 DeleteImages(images,argv[i+1],exception);
7820 if (LocaleCompare("dither",option+1) == 0)
7824 quantize_info->dither=MagickFalse;
7827 quantize_info->dither=MagickTrue;
7828 quantize_info->dither_method=(DitherMethod) ParseMagickOption(
7829 MagickDitherOptions,MagickFalse,argv[i+1]);
7836 if (LocaleCompare("evaluate-sequence",option+1) == 0)
7841 MagickEvaluateOperator
7844 (void) SyncImageSettings(mogrify_info,*images);
7845 op=(MagickEvaluateOperator) ParseMagickOption(MagickEvaluateOptions,
7846 MagickFalse,argv[i+1]);
7847 evaluate_image=EvaluateImages(*images,op,exception);
7848 if (evaluate_image == (Image *) NULL)
7853 *images=DestroyImageList(*images);
7854 *images=evaluate_image;
7861 if (LocaleCompare("fft",option+1) == 0)
7867 Implements the discrete Fourier transform (DFT).
7869 (void) SyncImageSettings(mogrify_info,*images);
7870 fourier_image=ForwardFourierTransformImage(*images,*option == '-' ?
7871 MagickTrue : MagickFalse,exception);
7872 if (fourier_image == (Image *) NULL)
7874 *images=DestroyImage(*images);
7875 *images=fourier_image;
7878 if (LocaleCompare("flatten",option+1) == 0)
7883 (void) SyncImagesSettings(mogrify_info,*images);
7884 flatten_image=MergeImageLayers(*images,FlattenLayer,exception);
7885 if (flatten_image == (Image *) NULL)
7887 *images=DestroyImageList(*images);
7888 *images=flatten_image;
7891 if (LocaleCompare("fx",option+1) == 0)
7896 (void) SyncImagesSettings(mogrify_info,*images);
7897 fx_image=FxImageChannel(*images,channel,argv[i+1],exception);
7898 if (fx_image == (Image *) NULL)
7903 *images=DestroyImageList(*images);
7911 if (LocaleCompare("hald-clut",option+1) == 0)
7917 (void) SyncImagesSettings(mogrify_info,*images);
7918 image=RemoveFirstImageFromList(images);
7919 hald_image=RemoveFirstImageFromList(images);
7920 if (hald_image == (Image *) NULL)
7925 (void) HaldClutImageChannel(image,channel,hald_image);
7926 hald_image=DestroyImage(hald_image);
7927 InheritException(exception,&image->exception);
7928 if (*images != (Image *) NULL)
7929 *images=DestroyImageList(*images);
7937 if (LocaleCompare("ift",option+1) == 0)
7945 Implements the inverse fourier discrete Fourier transform (DFT).
7947 (void) SyncImagesSettings(mogrify_info,*images);
7948 magnitude_image=RemoveFirstImageFromList(images);
7949 phase_image=RemoveFirstImageFromList(images);
7950 if (phase_image == (Image *) NULL)
7955 fourier_image=InverseFourierTransformImage(magnitude_image,
7956 phase_image,*option == '-' ? MagickTrue : MagickFalse,exception);
7957 if (fourier_image == (Image *) NULL)
7959 if (*images != (Image *) NULL)
7960 *images=DestroyImage(*images);
7961 *images=fourier_image;
7964 if (LocaleCompare("insert",option+1) == 0)
7972 index=StringToLong(argv[i+1]);
7973 p=RemoveLastImageFromList(images);
7974 if (p == (Image *) NULL)
7976 (void) ThrowMagickException(exception,GetMagickModule(),
7977 OptionError,"NoSuchImage","`%s'",argv[i+1]);
7983 PrependImageToList(images,q);
7985 if (index == (ssize_t) GetImageListLength(*images))
7986 AppendImageToList(images,q);
7989 q=GetImageFromList(*images,index-1);
7990 if (q == (Image *) NULL)
7992 (void) ThrowMagickException(exception,GetMagickModule(),
7993 OptionError,"NoSuchImage","`%s'",argv[i+1]);
7997 InsertImageInList(&q,p);
7999 *images=GetFirstImageInList(q);
8006 if (LocaleCompare("layers",option+1) == 0)
8014 (void) SyncImagesSettings(mogrify_info,*images);
8015 layers=(Image *) NULL;
8016 method=(ImageLayerMethod) ParseMagickOption(MagickLayerOptions,
8017 MagickFalse,argv[i+1]);
8022 layers=CoalesceImages(*images,exception);
8025 case CompareAnyLayer:
8026 case CompareClearLayer:
8027 case CompareOverlayLayer:
8030 layers=CompareImageLayers(*images,method,exception);
8036 case TrimBoundsLayer:
8038 layers=MergeImageLayers(*images,method,exception);
8043 layers=DisposeImages(*images,exception);
8046 case OptimizeImageLayer:
8048 layers=OptimizeImageLayers(*images,exception);
8051 case OptimizePlusLayer:
8053 layers=OptimizePlusImageLayers(*images,exception);
8056 case OptimizeTransLayer:
8058 OptimizeImageTransparency(*images,exception);
8061 case RemoveDupsLayer:
8063 RemoveDuplicateLayers(images,exception);
8066 case RemoveZeroLayer:
8068 RemoveZeroDelayLayers(images,exception);
8074 General Purpose, GIF Animation Optimizer.
8076 layers=CoalesceImages(*images,exception);
8077 if (layers == (Image *) NULL)
8082 InheritException(exception,&layers->exception);
8083 *images=DestroyImageList(*images);
8085 layers=OptimizeImageLayers(*images,exception);
8086 if (layers == (Image *) NULL)
8091 InheritException(exception,&layers->exception);
8092 *images=DestroyImageList(*images);
8094 layers=(Image *) NULL;
8095 OptimizeImageTransparency(*images,exception);
8096 InheritException(exception,&(*images)->exception);
8097 (void) RemapImages(quantize_info,*images,(Image *) NULL);
8100 case CompositeLayer:
8112 Split image sequence at the first 'NULL:' image.
8115 while (source != (Image *) NULL)
8117 source=GetNextImageInList(source);
8118 if ((source != (Image *) NULL) &&
8119 (LocaleCompare(source->magick,"NULL") == 0))
8122 if (source != (Image *) NULL)
8124 if ((GetPreviousImageInList(source) == (Image *) NULL) ||
8125 (GetNextImageInList(source) == (Image *) NULL))
8126 source=(Image *) NULL;
8130 Separate the two lists, junk the null: image.
8132 source=SplitImageList(source->previous);
8133 DeleteImageFromList(&source);
8136 if (source == (Image *) NULL)
8138 (void) ThrowMagickException(exception,GetMagickModule(),
8139 OptionError,"MissingNullSeparator","layers Composite");
8144 Adjust offset with gravity and virtual canvas.
8146 SetGeometry(*images,&geometry);
8147 (void) ParseAbsoluteGeometry((*images)->geometry,&geometry);
8148 geometry.width=source->page.width != 0 ?
8149 source->page.width : source->columns;
8150 geometry.height=source->page.height != 0 ?
8151 source->page.height : source->rows;
8152 GravityAdjustGeometry((*images)->page.width != 0 ?
8153 (*images)->page.width : (*images)->columns,
8154 (*images)->page.height != 0 ? (*images)->page.height :
8155 (*images)->rows,(*images)->gravity,&geometry);
8156 compose=OverCompositeOp;
8157 option=GetImageOption(mogrify_info,"compose");
8158 if (option != (const char *) NULL)
8159 compose=(CompositeOperator) ParseMagickOption(
8160 MagickComposeOptions,MagickFalse,option);
8161 CompositeLayers(*images,compose,source,geometry.x,geometry.y,
8163 source=DestroyImageList(source);
8167 if (layers == (Image *) NULL)
8169 InheritException(exception,&layers->exception);
8170 *images=DestroyImageList(*images);
8178 if (LocaleCompare("map",option+1) == 0)
8180 (void) SyncImagesSettings(mogrify_info,*images);
8183 (void) RemapImages(quantize_info,*images,(Image *) NULL);
8184 InheritException(exception,&(*images)->exception);
8190 if (LocaleCompare("maximum",option+1) == 0)
8196 Maximum image sequence (deprecated).
8198 (void) SyncImagesSettings(mogrify_info,*images);
8199 maximum_image=EvaluateImages(*images,MaxEvaluateOperator,exception);
8200 if (maximum_image == (Image *) NULL)
8205 *images=DestroyImageList(*images);
8206 *images=maximum_image;
8209 if (LocaleCompare("minimum",option+1) == 0)
8215 Minimum image sequence (deprecated).
8217 (void) SyncImagesSettings(mogrify_info,*images);
8218 minimum_image=EvaluateImages(*images,MinEvaluateOperator,exception);
8219 if (minimum_image == (Image *) NULL)
8224 *images=DestroyImageList(*images);
8225 *images=minimum_image;
8228 if (LocaleCompare("morph",option+1) == 0)
8233 (void) SyncImagesSettings(mogrify_info,*images);
8234 morph_image=MorphImages(*images,StringToUnsignedLong(argv[i+1]),
8236 if (morph_image == (Image *) NULL)
8241 *images=DestroyImageList(*images);
8242 *images=morph_image;
8245 if (LocaleCompare("mosaic",option+1) == 0)
8250 (void) SyncImagesSettings(mogrify_info,*images);
8251 mosaic_image=MergeImageLayers(*images,MosaicLayer,exception);
8252 if (mosaic_image == (Image *) NULL)
8257 *images=DestroyImageList(*images);
8258 *images=mosaic_image;
8265 if (LocaleCompare("print",option+1) == 0)
8270 (void) SyncImagesSettings(mogrify_info,*images);
8271 string=InterpretImageProperties(mogrify_info,*images,argv[i+1]);
8272 if (string == (char *) NULL)
8274 InheritException(exception,&(*images)->exception);
8275 (void) fprintf(stdout,"%s",string);
8276 string=DestroyString(string);
8278 if (LocaleCompare("process",option+1) == 0)
8287 (void) SyncImagesSettings(mogrify_info,*images);
8288 arguments=StringToArgv(argv[i+1],&number_arguments);
8289 if (arguments == (char **) NULL)
8291 if ((argc > 1) && (strchr(arguments[1],'=') != (char *) NULL))
8312 Support old style syntax, filter="-option arg".
8314 length=strlen(argv[i+1]);
8315 token=(char *) NULL;
8316 if (~length >= MaxTextExtent)
8317 token=(char *) AcquireQuantumMemory(length+MaxTextExtent,
8319 if (token == (char *) NULL)
8322 arguments=argv[i+1];
8323 token_info=AcquireTokenInfo();
8324 status=Tokenizer(token_info,0,token,length,arguments,"","=",
8325 "\"",'\0',&breaker,&next,"e);
8326 token_info=DestroyTokenInfo(token_info);
8332 argv=(&(arguments[next]));
8333 (void) InvokeDynamicImageFilter(token,&(*images),1,&argv,
8336 token=DestroyString(token);
8339 (void) SubstituteString(&arguments[1],"-","");
8340 (void) InvokeDynamicImageFilter(arguments[1],&(*images),
8341 number_arguments-2,(const char **) arguments+2,exception);
8342 for (j=0; j < number_arguments; j++)
8343 arguments[j]=DestroyString(arguments[j]);
8344 arguments=(char **) RelinquishMagickMemory(arguments);
8351 if (LocaleCompare("reverse",option+1) == 0)
8353 ReverseImageList(images);
8354 InheritException(exception,&(*images)->exception);
8361 if (LocaleCompare("swap",option+1) == 0)
8382 flags=ParseGeometry(argv[i+1],&geometry_info);
8383 index=(ssize_t) geometry_info.rho;
8384 if ((flags & SigmaValue) != 0)
8385 swap_index=(ssize_t) geometry_info.sigma;
8387 p=GetImageFromList(*images,index);
8388 q=GetImageFromList(*images,swap_index);
8389 if ((p == (Image *) NULL) || (q == (Image *) NULL))
8391 (void) ThrowMagickException(exception,GetMagickModule(),
8392 OptionError,"NoSuchImage","`%s'",(*images)->filename);
8398 swap=CloneImage(p,0,0,MagickTrue,exception);
8399 ReplaceImageInList(&p,CloneImage(q,0,0,MagickTrue,exception));
8400 ReplaceImageInList(&q,swap);
8401 *images=GetFirstImageInList(q);
8408 if (LocaleCompare("write",option+1) == 0)
8419 (void) SyncImagesSettings(mogrify_info,*images);
8420 (void) FormatMagickString(key,MaxTextExtent,"cache:%s",argv[i+1]);
8421 (void) DeleteImageRegistry(key);
8422 write_images=(*images);
8424 write_images=CloneImageList(*images,exception);
8425 write_info=CloneImageInfo(mogrify_info);
8426 status&=WriteImages(write_info,write_images,argv[i+1],exception);
8427 write_info=DestroyImageInfo(write_info);
8429 write_images=DestroyImageList(write_images);
8439 quantize_info=DestroyQuantizeInfo(quantize_info);
8440 mogrify_info=DestroyImageInfo(mogrify_info);
8441 status&=MogrifyImageInfo(image_info,argc,argv,exception);
8442 return(status != 0 ? MagickTrue : MagickFalse);
8446 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
8450 + M o g r i f y I m a g e s %
8454 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
8456 % MogrifyImages() applies image processing options to a sequence of images as
8457 % prescribed by command line options.
8459 % The format of the MogrifyImage method is:
8461 % MagickBooleanType MogrifyImages(ImageInfo *image_info,
8462 % const MagickBooleanType post,const int argc,const char **argv,
8463 % Image **images,Exceptioninfo *exception)
8465 % A description of each parameter follows:
8467 % o image_info: the image info..
8469 % o post: If true, post process image list operators otherwise pre-process.
8471 % o argc: Specifies a pointer to an integer describing the number of
8472 % elements in the argument vector.
8474 % o argv: Specifies a pointer to a text array containing the command line
8477 % o images: the images.
8479 % o exception: return any errors or warnings in this structure.
8482 WandExport MagickBooleanType MogrifyImages(ImageInfo *image_info,
8483 const MagickBooleanType post,const int argc,const char **argv,
8484 Image **images,ExceptionInfo *exception)
8486 #define MogrifyImageTag "Mogrify/Image"
8505 Apply options to individual images in the list.
8507 assert(image_info != (ImageInfo *) NULL);
8508 assert(image_info->signature == MagickSignature);
8509 if (images == (Image **) NULL)
8510 return(MogrifyImage(image_info,argc,argv,images,exception));
8511 assert((*images)->signature == MagickSignature);
8512 if ((*images)->debug != MagickFalse)
8513 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
8514 (*images)->filename);
8515 if ((argc <= 0) || (*argv == (char *) NULL))
8517 (void) SetImageInfoProgressMonitor(image_info,(MagickProgressMonitor) NULL,
8519 mogrify_images=NewImageList();
8520 number_images=GetImageListLength(*images);
8522 if (post == MagickFalse)
8523 status&=MogrifyImageList(image_info,argc,argv,images,exception);
8524 for (i=0; i < (ssize_t) number_images; i++)
8526 image=RemoveFirstImageFromList(images);
8527 if (image == (Image *) NULL)
8529 status&=MogrifyImage(image_info,argc,argv,&image,exception);
8530 AppendImageToList(&mogrify_images,image);
8531 proceed=SetImageProgress(image,MogrifyImageTag,(MagickOffsetType) i,
8533 if (proceed == MagickFalse)
8536 if (post != MagickFalse)
8537 status&=MogrifyImageList(image_info,argc,argv,&mogrify_images,exception);
8538 *images=mogrify_images;
8539 return(status != 0 ? MagickTrue : MagickFalse);