44#include "MagickWand/studio.h"
45#include "MagickWand/MagickWand.h"
46#include "MagickWand/mogrify-private.h"
47#include "MagickCore/compare-private.h"
48#include "MagickCore/image-private.h"
49#include "MagickCore/string-private.h"
85static MagickBooleanType CompareUsage(
void)
89 " -separate separate an image channel into a grayscale image",
91 " -channel mask set the image channel mask\n"
92 " -debug events display copious debugging information\n"
93 " -help print program options\n"
94 " -list type print a list of supported option arguments\n"
95 " -log format format of debugging information",
97 " -auto-orient automagically orient (rotate) image\n"
98 " -brightness-contrast geometry\n"
99 " improve brightness / contrast of the image\n"
100 " -distort method args\n"
101 " distort images according to given method and args\n"
102 " -level value adjust the level of image contrast\n"
103 " -resize geometry resize the image\n"
104 " -rotate degrees apply Paeth rotation to the image\n"
105 " -sigmoidal-contrast geometry\n"
106 " increase the contrast without saturating highlights or\n"
107 " -trim trim image edges\n"
108 " -write filename write images to this file",
109 sequence_operators[] =
110 " -crop geometry cut out a rectangular region of the image",
112 " -adjoin join images into a single multi-image file\n"
113 " -alpha option on, activate, off, deactivate, set, opaque, copy\n"
114 " transparent, extract, background, or shape\n"
115 " -authenticate password\n"
116 " decipher image with this password\n"
117 " -background color background color\n"
118 " -colorspace type alternate image colorspace\n"
119 " -compose operator set image composite operator\n"
120 " -compress type type of pixel compression when writing the image\n"
121 " -decipher filename convert cipher pixels to plain pixels\n"
122 " -define format:option\n"
123 " define one or more image format options\n"
124 " -density geometry horizontal and vertical density of the image\n"
125 " -depth value image depth\n"
126 " -dissimilarity-threshold value\n"
127 " maximum distortion for (sub)image match\n"
128 " -encipher filename convert plain pixels to cipher pixels\n"
129 " -extract geometry extract area from image\n"
130 " -format \"string\" output formatted image characteristics\n"
131 " -fuzz distance colors within this distance are considered equal\n"
132 " -gravity type horizontal and vertical text placement\n"
133 " -highlight-color color\n"
134 " emphasize pixel differences with this color\n"
135 " -identify identify the format and characteristics of the image\n"
136 " -interlace type type of image interlacing scheme\n"
137 " -limit type value pixel cache resource limit\n"
138 " -lowlight-color color\n"
139 " de-emphasize pixel differences with this color\n"
140 " -metric type measure differences between images with this metric\n"
141 " -monitor monitor progress\n"
142 " -negate replace every pixel with its complementary color \n"
143 " -passphrase filename get the passphrase from this file\n"
144 " -precision value maximum number of significant digits to print\n"
145 " -profile filename add, delete, or apply an image profile\n"
146 " -quality value JPEG/MIFF/PNG compression level\n"
147 " -quiet suppress all warning messages\n"
148 " -quantize colorspace reduce colors in this colorspace\n"
149 " -read-mask filename associate a read mask with the image\n"
150 " -regard-warnings pay attention to warning messages\n"
151 " -respect-parentheses settings remain in effect until parenthesis boundary\n"
152 " -sampling-factor geometry\n"
153 " horizontal and vertical sampling factor\n"
154 " -seed value seed a new sequence of pseudo-random numbers\n"
155 " -set attribute value set an image attribute\n"
156 " -quality value JPEG/MIFF/PNG compression level\n"
157 " -repage geometry size and location of an image canvas\n"
158 " -similarity-threshold value\n"
159 " minimum distortion for (sub)image match\n"
160 " -size geometry width and height of image\n"
161 " -subimage-search search for subimage\n"
162 " -synchronize synchronize image to storage device\n"
163 " -taint declare the image as modified\n"
164 " -transparent-color color\n"
165 " transparent color\n"
166 " -type type image type\n"
167 " -verbose print detailed information about the image\n"
168 " -version print version information\n"
169 " -virtual-pixel method\n"
170 " virtual pixel access method\n"
171 " -write-mask filename associate a write mask with the image",
173 " -delete indexes delete the image from the image sequence";
175 ListMagickVersion(stdout);
176 (void) printf(
"Usage: %s [options ...] image reconstruct difference\n",
178 (void) printf(
"\nImage Settings:\n");
179 (void) puts(settings);
180 (void) printf(
"\nImage Operators:\n");
181 (void) puts(operators);
182 (void) printf(
"\nImage Channel Operators:\n");
183 (void) puts(channel_operators);
184 (void) printf(
"\nImage Sequence Operators:\n");
185 (void) puts(sequence_operators);
186 (void) printf(
"\nImage Stack Operators:\n");
187 (void) puts(stack_operators);
188 (void) printf(
"\nMiscellaneous Options:\n");
189 (void) puts(miscellaneous);
191 "\nBy default, the image format of 'file' is determined by its magic\n");
193 "number. To specify a particular image format, precede the filename\n");
195 "with an image format name and a colon (i.e. ps:image) or specify the\n");
197 "image type as the filename suffix (i.e. image.ps). Specify 'file' as\n");
198 (void) printf(
"'-' for standard input or output.\n");
202WandExport MagickBooleanType CompareImagesCommand(ImageInfo *image_info,
203 int argc,
char **argv,
char **metadata,ExceptionInfo *exception)
205#define CompareEpsilon (1.0e-06)
206#define CompareConstantColorException \
207 "search metric is unreliable for constant-color images"
208#define CompareEqualSizedException \
209 "subimage search metric is unreliable for equal-sized images"
210#define DefaultDissimilarityThreshold (1.0/MagickPI)
211#define DestroyCompare() \
213 if (similarity_image != (Image *) NULL) \
214 similarity_image=DestroyImageList(similarity_image); \
215 if (difference_image != (Image *) NULL) \
216 difference_image=DestroyImageList(difference_image); \
217 DestroyImageStack(); \
218 for (i=0; i < (ssize_t) argc; i++) \
219 argv[i]=DestroyString(argv[i]); \
220 argv=(char **) RelinquishMagickMemory(argv); \
222#define ThrowCompareException(asperity,tag,option) \
224 char *message = GetExceptionMessage(errno); \
225 (void) ThrowMagickException(exception,GetMagickModule(),asperity,tag, \
226 "`%s'",option == (char *) NULL ? message : option); \
227 message=DestroyString(message); \
229 return(MagickFalse); \
231#define ThrowCompareInvalidArgumentException(option,argument) \
233 (void) ThrowMagickException(exception,GetMagickModule(),OptionError, \
234 "InvalidArgument","'%s': %s",option,argument); \
236 return(MagickFalse); \
247 dissimilarity_threshold = DefaultDissimilarityThreshold,
250 scale = (double) QuantumRange,
251 similarity_metric = 0.0,
252 similarity_threshold = DefaultSimilarityThreshold;
256 *image = (Image *) NULL,
261 image_stack[MaxImageStackDepth+1];
267 similar = MagickTrue,
274 metric = UndefinedErrorMetric;
289 assert(image_info != (ImageInfo *) NULL);
290 assert(image_info->signature == MagickCoreSignature);
291 assert(exception != (ExceptionInfo *) NULL);
292 if (IsEventLogging() != MagickFalse)
293 (void) LogMagickEvent(TraceEvent,GetMagickModule(),
"...");
297 if ((LocaleCompare(
"version",option+1) == 0) ||
298 (LocaleCompare(
"-version",option+1) == 0))
300 ListMagickVersion(stdout);
306 (void) ThrowMagickException(exception,GetMagickModule(),OptionError,
307 "MissingArgument",
"%s",
"");
308 (void) CompareUsage();
311 difference_image=NewImageList();
312 similarity_image=NewImageList();
313 format=(
char *) NULL;
317 option=(
char *) NULL;
319 reconstruct_image=NewImageList();
320 respect_parentheses=MagickFalse;
322 subimage_search=MagickFalse;
326 ReadCommandlLine(argc,&argv);
327 status=ExpandFilenames(&argc,&argv);
328 if (status == MagickFalse)
329 ThrowCompareException(ResourceLimitError,
"MemoryAllocationFailed",
331 for (i=1; i < ((ssize_t) argc-1); i++)
334 if (LocaleCompare(option,
"(") == 0)
336 FireImageStack(MagickTrue,MagickTrue,pend);
337 if (k == MaxImageStackDepth)
338 ThrowCompareException(OptionError,
"ParenthesisNestedTooDeeply",
343 if (LocaleCompare(option,
")") == 0)
345 FireImageStack(MagickTrue,MagickTrue,MagickTrue);
347 ThrowCompareException(OptionError,
"UnableToParseExpression",option);
351 if (IsCommandOption(option) == MagickFalse)
359 FireImageStack(MagickFalse,MagickFalse,pend);
361 if ((LocaleCompare(filename,
"--") == 0) && (i < ((ssize_t) argc-1)))
363 images=ReadImages(image_info,filename,exception);
364 status&=(MagickStatusType) ((images != (Image *) NULL) &&
365 (exception->severity < ErrorException));
366 if (images == (Image *) NULL)
368 AppendImageStack(images);
371 pend=image != (Image *) NULL ? MagickTrue : MagickFalse;
376 if (LocaleCompare(
"adjoin",option+1) == 0)
378 if (LocaleCompare(
"alpha",option+1) == 0)
386 if (i == (ssize_t) argc)
387 ThrowCompareException(OptionError,
"MissingArgument",option);
388 type=ParseCommandOption(MagickAlphaChannelOptions,MagickFalse,
391 ThrowCompareException(OptionError,
392 "UnrecognizedAlphaChannelOption",argv[i]);
395 if (LocaleCompare(
"auto-orient",option+1) == 0)
397 if (LocaleCompare(
"authenticate",option+1) == 0)
402 if (i == (ssize_t) argc)
403 ThrowCompareException(OptionError,
"MissingArgument",option);
406 ThrowCompareException(OptionError,
"UnrecognizedOption",option);
410 if (LocaleCompare(
"background",option+1) == 0)
415 if (i == (ssize_t) argc)
416 ThrowCompareException(OptionError,
"MissingArgument",option);
419 if (LocaleCompare(
"brightness-contrast",option+1) == 0)
422 if (i == (ssize_t) argc)
423 ThrowCompareException(OptionError,
"MissingArgument",option);
424 if (IsGeometry(argv[i]) == MagickFalse)
425 ThrowCompareInvalidArgumentException(option,argv[i]);
428 ThrowCompareException(OptionError,
"UnrecognizedOption",option);
432 if (LocaleCompare(
"cache",option+1) == 0)
437 if (i == (ssize_t) argc)
438 ThrowCompareException(OptionError,
"MissingArgument",option);
439 if (IsGeometry(argv[i]) == MagickFalse)
440 ThrowCompareInvalidArgumentException(option,argv[i]);
443 if (LocaleCompare(
"channel",option+1) == 0)
451 if (i == (ssize_t) argc)
452 ThrowCompareException(OptionError,
"MissingArgument",option);
453 channel=ParseChannelOption(argv[i]);
455 ThrowCompareException(OptionError,
"UnrecognizedChannelType",
459 if (LocaleCompare(
"colorspace",option+1) == 0)
467 if (i == (ssize_t) argc)
468 ThrowCompareException(OptionError,
"MissingArgument",option);
469 colorspace=ParseCommandOption(MagickColorspaceOptions,MagickFalse,
472 ThrowCompareException(OptionError,
"UnrecognizedColorspace",
476 if (LocaleCompare(
"compose",option+1) == 0)
484 if (i == (ssize_t) argc)
485 ThrowCompareException(OptionError,
"MissingArgument",option);
486 compose=ParseCommandOption(MagickComposeOptions,MagickFalse,
489 ThrowCompareException(OptionError,
"UnrecognizedComposeOperator",
493 if (LocaleCompare(
"compress",option+1) == 0)
501 if (i == (ssize_t) argc)
502 ThrowCompareException(OptionError,
"MissingArgument",option);
503 compress=ParseCommandOption(MagickCompressOptions,MagickFalse,
506 ThrowCompareException(OptionError,
"UnrecognizedImageCompression",
510 if (LocaleCompare(
"concurrent",option+1) == 0)
512 if (LocaleCompare(
"crop",option+1) == 0)
517 if (i == (ssize_t) argc)
518 ThrowCompareException(OptionError,
"MissingArgument",option);
519 if (IsGeometry(argv[i]) == MagickFalse)
520 ThrowCompareInvalidArgumentException(option,argv[i]);
523 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
527 if (LocaleCompare(
"debug",option+1) == 0)
535 if (i == (ssize_t) argc)
536 ThrowCompareException(OptionError,
"MissingArgument",option);
537 event_mask=SetLogEventMask(argv[i]);
538 if (event_mask == UndefinedEvents)
539 ThrowCompareException(OptionError,
"UnrecognizedEventType",
543 if (LocaleCompare(
"decipher",option+1) == 0)
548 if (i == (ssize_t) argc)
549 ThrowCompareException(OptionError,
"MissingArgument",option);
552 if (LocaleCompare(
"define",option+1) == 0)
555 if (i == (ssize_t) argc)
556 ThrowCompareException(OptionError,
"MissingArgument",option);
562 define=GetImageOption(image_info,argv[i]);
563 if (define == (
const char *) NULL)
564 ThrowCompareException(OptionError,
"NoSuchOption",argv[i]);
569 if (LocaleCompare(
"delete",option+1) == 0)
574 if (i == (ssize_t) argc)
575 ThrowCompareException(OptionError,
"MissingArgument",option);
576 if (IsSceneGeometry(argv[i],MagickFalse) == MagickFalse)
577 ThrowCompareInvalidArgumentException(option,argv[i]);
580 if (LocaleCompare(
"density",option+1) == 0)
585 if (i == (ssize_t) argc)
586 ThrowCompareException(OptionError,
"MissingArgument",option);
587 if (IsGeometry(argv[i]) == MagickFalse)
588 ThrowCompareInvalidArgumentException(option,argv[i]);
591 if (LocaleCompare(
"depth",option+1) == 0)
596 if (i == (ssize_t) argc)
597 ThrowCompareException(OptionError,
"MissingArgument",option);
598 if (IsGeometry(argv[i]) == MagickFalse)
599 ThrowCompareInvalidArgumentException(option,argv[i]);
602 if (LocaleCompare(
"dissimilarity-threshold",option+1) == 0)
607 if (i == (ssize_t) argc)
608 ThrowCompareException(OptionError,
"MissingArgument",option);
609 if (IsGeometry(argv[i]) == MagickFalse)
610 ThrowCompareInvalidArgumentException(option,argv[i]);
612 dissimilarity_threshold=DefaultDissimilarityThreshold;
614 dissimilarity_threshold=StringToDouble(argv[i],(
char **) NULL);
617 if (LocaleCompare(
"distort",option+1) == 0)
623 if (i == (ssize_t) argc)
624 ThrowCompareException(OptionError,
"MissingArgument",option);
625 op=ParseCommandOption(MagickDistortOptions,MagickFalse,argv[i]);
627 ThrowCompareException(OptionError,
"UnrecognizedDistortMethod",
630 if (i == (ssize_t) argc)
631 ThrowCompareException(OptionError,
"MissingArgument",option);
634 if (LocaleCompare(
"duration",option+1) == 0)
639 if (i == (ssize_t) argc)
640 ThrowCompareException(OptionError,
"MissingArgument",option);
641 if (IsGeometry(argv[i]) == MagickFalse)
642 ThrowCompareInvalidArgumentException(option,argv[i]);
645 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
649 if (LocaleCompare(
"encipher",option+1) == 0)
654 if (i == (ssize_t) argc)
655 ThrowCompareException(OptionError,
"MissingArgument",option);
658 if (LocaleCompare(
"extract",option+1) == 0)
663 if (i == (ssize_t) argc)
664 ThrowCompareException(OptionError,
"MissingArgument",option);
665 if (IsGeometry(argv[i]) == MagickFalse)
666 ThrowCompareInvalidArgumentException(option,argv[i]);
669 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
673 if (LocaleCompare(
"format",option+1) == 0)
678 if (i == (ssize_t) argc)
679 ThrowCompareException(OptionError,
"MissingArgument",option);
683 if (LocaleCompare(
"fuzz",option+1) == 0)
688 if (i == (ssize_t) argc)
689 ThrowCompareException(OptionError,
"MissingArgument",option);
690 if (IsGeometry(argv[i]) == MagickFalse)
691 ThrowCompareInvalidArgumentException(option,argv[i]);
694 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
698 if (LocaleCompare(
"gravity",option+1) == 0)
706 if (i == (ssize_t) argc)
707 ThrowCompareException(OptionError,
"MissingArgument",option);
708 gravity=ParseCommandOption(MagickGravityOptions,MagickFalse,
711 ThrowCompareException(OptionError,
"UnrecognizedGravityType",
715 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
719 if ((LocaleCompare(
"help",option+1) == 0) ||
720 (LocaleCompare(
"-help",option+1) == 0))
723 return(CompareUsage());
725 if (LocaleCompare(
"highlight-color",option+1) == 0)
730 if (i == (ssize_t) argc)
731 ThrowCompareException(OptionError,
"MissingArgument",option);
734 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
738 if (LocaleCompare(
"identify",option+1) == 0)
740 if (LocaleCompare(
"interlace",option+1) == 0)
748 if (i == (ssize_t) argc)
749 ThrowCompareException(OptionError,
"MissingArgument",option);
750 interlace=ParseCommandOption(MagickInterlaceOptions,MagickFalse,
753 ThrowCompareException(OptionError,
"UnrecognizedInterlaceType",
757 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
761 if (LocaleCompare(
"level",option+1) == 0)
764 if (i == (ssize_t) argc)
765 ThrowCompareException(OptionError,
"MissingArgument",option);
766 if (IsGeometry(argv[i]) == MagickFalse)
767 ThrowCompareInvalidArgumentException(option,argv[i]);
770 if (LocaleCompare(
"limit",option+1) == 0)
784 if (i == (ssize_t) argc)
785 ThrowCompareException(OptionError,
"MissingArgument",option);
786 resource=ParseCommandOption(MagickResourceOptions,MagickFalse,
789 ThrowCompareException(OptionError,
"UnrecognizedResourceType",
792 if (i == (ssize_t) argc)
793 ThrowCompareException(OptionError,
"MissingArgument",option);
794 value=StringToDouble(argv[i],&p);
796 if ((p == argv[i]) && (LocaleCompare(
"unlimited",argv[i]) != 0))
797 ThrowCompareInvalidArgumentException(option,argv[i]);
800 if (LocaleCompare(
"list",option+1) == 0)
808 if (i == (ssize_t) argc)
809 ThrowCompareException(OptionError,
"MissingArgument",option);
810 list=ParseCommandOption(MagickListOptions,MagickFalse,argv[i]);
812 ThrowCompareException(OptionError,
"UnrecognizedListType",argv[i]);
813 status=MogrifyImageInfo(image_info,(
int) (i-j+1),(
const char **)
816 return(status == 0 ? MagickFalse : MagickTrue);
818 if (LocaleCompare(
"log",option+1) == 0)
823 if ((i == (ssize_t) argc) || (strchr(argv[i],
'%') == (
char *) NULL))
824 ThrowCompareException(OptionError,
"MissingArgument",option);
827 if (LocaleCompare(
"lowlight-color",option+1) == 0)
832 if (i == (ssize_t) argc)
833 ThrowCompareException(OptionError,
"MissingArgument",option);
836 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
840 if (LocaleCompare(
"matte",option+1) == 0)
842 if (LocaleCompare(
"metric",option+1) == 0)
850 if (i == (ssize_t) argc)
851 ThrowCompareException(OptionError,
"MissingArgument",option);
852 type=ParseCommandOption(MagickMetricOptions,MagickTrue,argv[i]);
854 ThrowCompareException(OptionError,
"UnrecognizedMetricType",
856 metric=(MetricType) type;
859 if (LocaleCompare(
"monitor",option+1) == 0)
861 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
865 if (LocaleCompare(
"negate",option+1) == 0)
867 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
871 if (LocaleCompare(
"passphrase",option+1) == 0)
876 if (i == (ssize_t) argc)
877 ThrowCompareException(OptionError,
"MissingArgument",option);
880 if (LocaleCompare(
"precision",option+1) == 0)
885 if (i == (ssize_t) argc)
886 ThrowCompareException(OptionError,
"MissingArgument",option);
887 if (IsGeometry(argv[i]) == MagickFalse)
888 ThrowCompareInvalidArgumentException(option,argv[i]);
891 if (LocaleCompare(
"profile",option+1) == 0)
894 if (i == (ssize_t) argc)
895 ThrowCompareException(OptionError,
"MissingArgument",option);
898 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
902 if (LocaleCompare(
"quality",option+1) == 0)
907 if (i == (ssize_t) argc)
908 ThrowCompareException(OptionError,
"MissingArgument",option);
909 if (IsGeometry(argv[i]) == MagickFalse)
910 ThrowCompareInvalidArgumentException(option,argv[i]);
913 if (LocaleCompare(
"quantize",option+1) == 0)
921 if (i == (ssize_t) argc)
922 ThrowCompareException(OptionError,
"MissingArgument",option);
923 colorspace=ParseCommandOption(MagickColorspaceOptions,
924 MagickFalse,argv[i]);
926 ThrowCompareException(OptionError,
"UnrecognizedColorspace",
930 if (LocaleCompare(
"quiet",option+1) == 0)
932 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
936 if (LocaleCompare(
"read-mask",option+1) == 0)
941 if (i == (ssize_t) argc)
942 ThrowCompareException(OptionError,
"MissingArgument",option);
945 if (LocaleCompare(
"regard-warnings",option+1) == 0)
947 if (LocaleCompare(
"repage",option+1) == 0)
952 if (i == (ssize_t) argc)
953 ThrowCompareException(OptionError,
"MissingArgument",option);
954 if (IsGeometry(argv[i]) == MagickFalse)
955 ThrowCompareInvalidArgumentException(option,argv[i]);
958 if (LocaleCompare(
"resize",option+1) == 0)
963 if (i == (ssize_t) argc)
964 ThrowCompareException(OptionError,
"MissingArgument",option);
965 if (IsGeometry(argv[i]) == MagickFalse)
966 ThrowCompareInvalidArgumentException(option,argv[i]);
969 if (LocaleNCompare(
"respect-parentheses",option+1,17) == 0)
971 respect_parentheses=(*option ==
'-') ? MagickTrue : MagickFalse;
974 if (LocaleCompare(
"rotate",option+1) == 0)
977 if (i == (ssize_t) argc)
978 ThrowCompareException(OptionError,
"MissingArgument",option);
979 if (IsGeometry(argv[i]) == MagickFalse)
980 ThrowCompareInvalidArgumentException(option,argv[i]);
983 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
987 if (LocaleCompare(
"sampling-factor",option+1) == 0)
992 if (i == (ssize_t) argc)
993 ThrowCompareException(OptionError,
"MissingArgument",option);
994 if (IsGeometry(argv[i]) == MagickFalse)
995 ThrowCompareInvalidArgumentException(option,argv[i]);
998 if (LocaleCompare(
"seed",option+1) == 0)
1003 if (i == (ssize_t) argc)
1004 ThrowCompareException(OptionError,
"MissingArgument",option);
1005 if (IsGeometry(argv[i]) == MagickFalse)
1006 ThrowCompareInvalidArgumentException(option,argv[i]);
1009 if (LocaleCompare(
"separate",option+1) == 0)
1011 if (LocaleCompare(
"set",option+1) == 0)
1014 if (i == (ssize_t) argc)
1015 ThrowCompareException(OptionError,
"MissingArgument",option);
1019 if (i == (ssize_t) argc)
1020 ThrowCompareException(OptionError,
"MissingArgument",option);
1023 if (LocaleCompare(
"sigmoidal-contrast",option+1) == 0)
1026 if (i == (ssize_t) argc)
1027 ThrowCompareException(OptionError,
"MissingArgument",option);
1028 if (IsGeometry(argv[i]) == MagickFalse)
1029 ThrowCompareInvalidArgumentException(option,argv[i]);
1032 if (LocaleCompare(
"similarity-threshold",option+1) == 0)
1037 if (i == (ssize_t) argc)
1038 ThrowCompareException(OptionError,
"MissingArgument",option);
1039 if (IsGeometry(argv[i]) == MagickFalse)
1040 ThrowCompareInvalidArgumentException(option,argv[i]);
1042 similarity_threshold=DefaultSimilarityThreshold;
1044 similarity_threshold=StringToDouble(argv[i],(
char **) NULL);
1047 if (LocaleCompare(
"size",option+1) == 0)
1052 if (i == (ssize_t) argc)
1053 ThrowCompareException(OptionError,
"MissingArgument",option);
1054 if (IsGeometry(argv[i]) == MagickFalse)
1055 ThrowCompareInvalidArgumentException(option,argv[i]);
1058 if (LocaleCompare(
"subimage-search",option+1) == 0)
1062 subimage_search=MagickFalse;
1065 subimage_search=MagickTrue;
1068 if (LocaleCompare(
"synchronize",option+1) == 0)
1070 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
1074 if (LocaleCompare(
"taint",option+1) == 0)
1076 if (LocaleCompare(
"transparent-color",option+1) == 0)
1081 if (i == (ssize_t) argc)
1082 ThrowCompareException(OptionError,
"MissingArgument",option);
1085 if (LocaleCompare(
"trim",option+1) == 0)
1087 if (LocaleCompare(
"type",option+1) == 0)
1095 if (i == (ssize_t) argc)
1096 ThrowCompareException(OptionError,
"MissingArgument",option);
1097 type=ParseCommandOption(MagickTypeOptions,MagickFalse,argv[i]);
1099 ThrowCompareException(OptionError,
"UnrecognizedImageType",
1103 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
1107 if (LocaleCompare(
"verbose",option+1) == 0)
1109 if ((LocaleCompare(
"version",option+1) == 0) ||
1110 (LocaleCompare(
"-version",option+1) == 0))
1112 ListMagickVersion(stdout);
1115 if (LocaleCompare(
"virtual-pixel",option+1) == 0)
1123 if (i == (ssize_t) argc)
1124 ThrowCompareException(OptionError,
"MissingArgument",option);
1125 method=ParseCommandOption(MagickVirtualPixelOptions,MagickFalse,
1128 ThrowCompareException(OptionError,
1129 "UnrecognizedVirtualPixelMethod",argv[i]);
1132 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
1136 if (LocaleCompare(
"write",option+1) == 0)
1139 if (i == (ssize_t) argc)
1140 ThrowCompareException(OptionError,
"MissingArgument",option);
1143 if (LocaleCompare(
"write-mask",option+1) == 0)
1148 if (i == (ssize_t) argc)
1149 ThrowCompareException(OptionError,
"MissingArgument",option);
1152 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
1157 ThrowCompareException(OptionError,
"UnrecognizedOption",option)
1159 fire=(GetCommandOptionFlags(MagickCommandOptions,MagickFalse,option) &
1160 FireOptionFlag) == 0 ? MagickFalse : MagickTrue;
1161 if (fire != MagickFalse)
1162 FireImageStack(MagickTrue,MagickTrue,MagickTrue);
1165 ThrowCompareException(OptionError,
"UnbalancedParenthesis",argv[i]);
1166 if (i-- != ((ssize_t) argc-1))
1167 ThrowCompareException(OptionError,
"MissingAnImageFilename",argv[i]);
1168 if ((image == (Image *) NULL) || (GetImageListLength(image) < 2))
1169 ThrowCompareException(OptionError,
"MissingAnImageFilename",argv[i]);
1170 FinalizeImageSettings(image_info,image,MagickTrue);
1171 if ((image == (Image *) NULL) || (GetImageListLength(image) < 2))
1172 ThrowCompareException(OptionError,
"MissingAnImageFilename",argv[i]);
1173 image=GetImageFromList(image,0);
1174 reconstruct_image=GetImageFromList(image,1);
1177 if (subimage_search != MagickFalse)
1179 similarity_image=SimilarityImage(image,reconstruct_image,metric,
1180 similarity_threshold,&offset,&similarity_metric,exception);
1181 if (similarity_image == (Image *) NULL)
1184 return(MagickFalse);
1186 if (((metric == NormalizedCrossCorrelationErrorMetric) ||
1187 (metric == UndefinedErrorMetric) ||
1188 (metric == PeakSignalToNoiseRatioErrorMetric) ||
1189 (metric == StructuralSimilarityErrorMetric) ||
1190 (metric == StructuralDissimilarityErrorMetric)) ?
1191 (similarity_metric < dissimilarity_threshold) :
1192 (similarity_metric >= dissimilarity_threshold))
1193 (void) ThrowMagickException(exception,GetMagickModule(),ImageWarning,
1194 "ImagesTooDissimilar",
"`%s'",image->filename);
1196 if (similarity_image == (Image *) NULL)
1197 difference_image=CompareImages(image,reconstruct_image,metric,&distortion,
1207 composite_image=CloneImage(image,0,0,MagickTrue,exception);
1208 if (composite_image == (Image *) NULL)
1209 difference_image=CompareImages(image,reconstruct_image,metric,
1210 &distortion,exception);
1219 (void) CompositeImage(composite_image,reconstruct_image,
1220 CopyCompositeOp,MagickTrue,offset.x,offset.y,exception);
1221 difference_image=CompareImages(image,composite_image,metric,
1222 &distortion,exception);
1223 if (difference_image != (Image *) NULL)
1225 difference_image->page.x=offset.x;
1226 difference_image->page.y=offset.y;
1228 composite_image=DestroyImage(composite_image);
1229 page.width=reconstruct_image->columns;
1230 page.height=reconstruct_image->rows;
1233 distort_image=CropImage(image,&page,exception);
1234 if (distort_image != (Image *) NULL)
1239 (void) SetImageArtifact(distort_image,
"compare:virtual-pixels",
1241 sans_image=CompareImages(distort_image,reconstruct_image,metric,
1242 &distortion,exception);
1243 if (sans_image != (Image *) NULL)
1244 sans_image=DestroyImage(sans_image);
1245 distort_image=DestroyImage(distort_image);
1248 if (difference_image != (Image *) NULL)
1250 AppendImageToList(&difference_image,similarity_image);
1251 similarity_image=(Image *) NULL;
1256 case AbsoluteErrorMetric:
1262 SetImageCompareBounds(image,reconstruct_image,&columns,&rows);
1263 scale=(double) columns*rows;
1266 case DotProductCorrelationErrorMetric:
1267 case PhaseCorrelationErrorMetric:
1268 case NormalizedCrossCorrelationErrorMetric:
1274 (void) GetImageRange(reconstruct_image,&minima,&maxima,exception);
1275 if (fabs(maxima-minima) < MagickEpsilon)
1276 (void) ThrowMagickException(exception,GetMagickModule(),ImageWarning,
1277 CompareConstantColorException,
"(%s)",CommandOptionToMnemonic(
1278 MagickMetricOptions,(ssize_t) metric));
1281 case PeakAbsoluteErrorMetric:
1283 if ((subimage_search != MagickFalse) &&
1284 (image->columns == reconstruct_image->columns) &&
1285 (image->rows == reconstruct_image->rows))
1286 (void) ThrowMagickException(exception,GetMagickModule(),ImageWarning,
1287 CompareEqualSizedException,
"(%s)",CommandOptionToMnemonic(
1288 MagickMetricOptions,(ssize_t) metric));
1291 case PerceptualHashErrorMetric:
1294 if (subimage_search == MagickFalse)
1300 (void) GetImageRange(reconstruct_image,&minima,&maxima,exception);
1301 if (fabs(maxima-minima) < MagickEpsilon)
1302 (void) ThrowMagickException(exception,GetMagickModule(),
1303 ImageWarning,CompareConstantColorException,
"(%s)",
1304 CommandOptionToMnemonic(MagickMetricOptions,(ssize_t) metric));
1306 if ((subimage_search != MagickFalse) &&
1307 (image->columns == reconstruct_image->columns) &&
1308 (image->rows == reconstruct_image->rows))
1309 (void) ThrowMagickException(exception,GetMagickModule(),ImageWarning,
1310 CompareEqualSizedException,
"(%s)",CommandOptionToMnemonic(
1311 MagickMetricOptions,(ssize_t) metric));
1314 case PeakSignalToNoiseRatioErrorMetric:
1316 scale=MagickSafePSNRRecipicol(10.0);
1319 case PixelDifferenceCountErrorMetric:
1322 normal_scale=1.0/(double) image->columns/(
double) image->rows;
1328 if (fabs(distortion) > CompareEpsilon)
1329 similar=MagickFalse;
1330 if (difference_image == (Image *) NULL)
1334 if (image_info->verbose != MagickFalse)
1335 (void) SetImageColorMetric(image,reconstruct_image,exception);
1336 if (*difference_image->magick ==
'\0')
1337 (void) CopyMagickString(difference_image->magick,image->magick,
1339 if (image_info->verbose == MagickFalse)
1343 case MeanErrorPerPixelErrorMetric:
1345 if (subimage_search == MagickFalse)
1347 (void) FormatLocaleFile(stderr,
"%.*g (%.*g, %.*g)",
1348 GetMagickPrecision(),scale*distortion,
1349 GetMagickPrecision(),distortion,GetMagickPrecision(),
1350 image->error.normalized_maximum_error);
1357 (void) FormatLocaleFile(stderr,
"%.*g (%.*g)",GetMagickPrecision(),
1358 scale*distortion,GetMagickPrecision(),normal_scale*distortion);
1362 if (subimage_search != MagickFalse)
1363 (void) FormatLocaleFile(stderr,
" @ %.17g,%.17g [%.*g]",
1364 (
double) offset.x,(
double) offset.y,GetMagickPrecision(),
1370 *channel_distortion;
1372 channel_distortion=GetImageDistortions(image,reconstruct_image,
1374 (void) FormatLocaleFile(stderr,
"Image: %s\n",image->filename);
1375 if ((reconstruct_image->columns != image->columns) ||
1376 (reconstruct_image->rows != image->rows))
1377 (void) FormatLocaleFile(stderr,
"Offset: %.17g,%.17g\n",(
double)
1378 difference_image->page.x,(
double) difference_image->page.y);
1379 (void) FormatLocaleFile(stderr,
" Channel distortion: %s\n",
1380 CommandOptionToMnemonic(MagickMetricOptions,(ssize_t) metric));
1383 case FuzzErrorMetric:
1384 case MeanAbsoluteErrorMetric:
1385 case MeanSquaredErrorMetric:
1386 case PeakAbsoluteErrorMetric:
1387 case RootMeanSquaredErrorMetric:
1389 switch (image->colorspace)
1394 (void) FormatLocaleFile(stderr,
" red: %.*g (%.*g)\n",
1395 GetMagickPrecision(),scale*
1396 channel_distortion[RedPixelChannel],GetMagickPrecision(),
1397 normal_scale*channel_distortion[RedPixelChannel]);
1398 (void) FormatLocaleFile(stderr,
" green: %.*g (%.*g)\n",
1399 GetMagickPrecision(),scale*
1400 channel_distortion[GreenPixelChannel],GetMagickPrecision(),
1401 normal_scale*channel_distortion[GreenPixelChannel]);
1402 (void) FormatLocaleFile(stderr,
" blue: %.*g (%.*g)\n",
1403 GetMagickPrecision(),scale*
1404 channel_distortion[BluePixelChannel],GetMagickPrecision(),
1405 normal_scale*channel_distortion[BluePixelChannel]);
1406 if (image->alpha_trait != UndefinedPixelTrait)
1407 (void) FormatLocaleFile(stderr,
" alpha: %.*g (%.*g)\n",
1408 GetMagickPrecision(),scale*
1409 channel_distortion[AlphaPixelChannel],GetMagickPrecision(),
1410 normal_scale*channel_distortion[AlphaPixelChannel]);
1413 case CMYKColorspace:
1415 (void) FormatLocaleFile(stderr,
" cyan: %.*g (%.*g)\n",
1416 GetMagickPrecision(),scale*
1417 channel_distortion[CyanPixelChannel],GetMagickPrecision(),
1418 normal_scale*channel_distortion[CyanPixelChannel]);
1419 (void) FormatLocaleFile(stderr,
" magenta: %.*g (%.*g)\n",
1420 GetMagickPrecision(),scale*
1421 channel_distortion[MagentaPixelChannel],
1422 GetMagickPrecision(),
1423 normal_scale*channel_distortion[MagentaPixelChannel]);
1424 (void) FormatLocaleFile(stderr,
" yellow: %.*g (%.*g)\n",
1425 GetMagickPrecision(),scale*
1426 channel_distortion[YellowPixelChannel],GetMagickPrecision(),
1427 normal_scale*channel_distortion[YellowPixelChannel]);
1428 (void) FormatLocaleFile(stderr,
" black: %.*g (%.*g)\n",
1429 GetMagickPrecision(),scale*
1430 channel_distortion[BlackPixelChannel],GetMagickPrecision(),
1431 normal_scale*channel_distortion[BlackPixelChannel]);
1432 if (image->alpha_trait != UndefinedPixelTrait)
1433 (void) FormatLocaleFile(stderr,
" alpha: %.*g (%.*g)\n",
1434 GetMagickPrecision(),scale*
1435 channel_distortion[AlphaPixelChannel],
1436 GetMagickPrecision(),
1437 normal_scale*channel_distortion[AlphaPixelChannel]);
1440 case LinearGRAYColorspace:
1441 case GRAYColorspace:
1443 (void) FormatLocaleFile(stderr,
" gray: %.*g (%.*g)\n",
1444 GetMagickPrecision(),scale*
1445 channel_distortion[GrayPixelChannel],GetMagickPrecision(),
1446 normal_scale*channel_distortion[GrayPixelChannel]);
1447 if (image->alpha_trait != UndefinedPixelTrait)
1448 (void) FormatLocaleFile(stderr,
" alpha: %.*g (%.*g)\n",
1449 GetMagickPrecision(),scale*
1450 channel_distortion[AlphaPixelChannel],
1451 GetMagickPrecision(),
1452 normal_scale*channel_distortion[AlphaPixelChannel]);
1456 (void) FormatLocaleFile(stderr,
" all: %.*g (%.*g)\n",
1457 GetMagickPrecision(),scale*channel_distortion[MaxPixelChannels],
1458 GetMagickPrecision(),normal_scale*channel_distortion[MaxPixelChannels]);
1461 case DotProductCorrelationErrorMetric:
1462 case NormalizedCrossCorrelationErrorMetric:
1463 case PeakSignalToNoiseRatioErrorMetric:
1464 case PerceptualHashErrorMetric:
1465 case PhaseCorrelationErrorMetric:
1466 case StructuralSimilarityErrorMetric:
1467 case StructuralDissimilarityErrorMetric:
1469 switch (image->colorspace)
1474 (void) FormatLocaleFile(stderr,
" red: %.*g\n",
1475 GetMagickPrecision(),channel_distortion[RedPixelChannel]);
1476 (void) FormatLocaleFile(stderr,
" green: %.*g\n",
1477 GetMagickPrecision(),channel_distortion[GreenPixelChannel]);
1478 (void) FormatLocaleFile(stderr,
" blue: %.*g\n",
1479 GetMagickPrecision(),channel_distortion[BluePixelChannel]);
1480 if (image->alpha_trait != UndefinedPixelTrait)
1481 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1482 GetMagickPrecision(),
1483 channel_distortion[AlphaPixelChannel]);
1486 case CMYKColorspace:
1488 (void) FormatLocaleFile(stderr,
" cyan: %.*g\n",
1489 GetMagickPrecision(),channel_distortion[CyanPixelChannel]);
1490 (void) FormatLocaleFile(stderr,
" magenta: %.*g\n",
1491 GetMagickPrecision(),
1492 channel_distortion[MagentaPixelChannel]);
1493 (void) FormatLocaleFile(stderr,
" yellow: %.*g\n",
1494 GetMagickPrecision(),
1495 channel_distortion[YellowPixelChannel]);
1496 (void) FormatLocaleFile(stderr,
" black: %.*g\n",
1497 GetMagickPrecision(),
1498 channel_distortion[BlackPixelChannel]);
1499 if (image->alpha_trait != UndefinedPixelTrait)
1500 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1501 GetMagickPrecision(),
1502 channel_distortion[AlphaPixelChannel]);
1505 case LinearGRAYColorspace:
1506 case GRAYColorspace:
1508 (void) FormatLocaleFile(stderr,
" gray: %.*g\n",
1509 GetMagickPrecision(),channel_distortion[GrayPixelChannel]);
1510 if (image->alpha_trait != UndefinedPixelTrait)
1511 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1512 GetMagickPrecision(),
1513 channel_distortion[AlphaPixelChannel]);
1517 (void) FormatLocaleFile(stderr,
" all: %.*g\n",
1518 GetMagickPrecision(),channel_distortion[MaxPixelChannels]);
1521 case MeanErrorPerPixelErrorMetric:
1523 (void) FormatLocaleFile(stderr,
" %.*g (%.*g, %.*g)\n",
1524 GetMagickPrecision(),channel_distortion[MaxPixelChannels],
1525 GetMagickPrecision(),channel_distortion[MaxPixelChannels],
1526 GetMagickPrecision(),image->error.normalized_maximum_error);
1529 case AbsoluteErrorMetric:
1530 case PixelDifferenceCountErrorMetric:
1532 switch (image->colorspace)
1537 (void) FormatLocaleFile(stderr,
" red: %.*g\n",
1538 GetMagickPrecision(),scale*
1539 channel_distortion[RedPixelChannel]);
1540 (void) FormatLocaleFile(stderr,
" green: %.*g\n",
1541 GetMagickPrecision(),scale*
1542 channel_distortion[GreenPixelChannel]);
1543 (void) FormatLocaleFile(stderr,
" blue: %.*g\n",
1544 GetMagickPrecision(),scale*
1545 channel_distortion[BluePixelChannel]);
1546 if (image->alpha_trait != UndefinedPixelTrait)
1547 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1548 GetMagickPrecision(),scale*
1549 channel_distortion[AlphaPixelChannel]);
1552 case CMYKColorspace:
1554 (void) FormatLocaleFile(stderr,
" cyan: %.*g\n",
1555 GetMagickPrecision(),channel_distortion[CyanPixelChannel]);
1556 (void) FormatLocaleFile(stderr,
" magenta: %.*g\n",
1557 GetMagickPrecision(),scale*
1558 channel_distortion[MagentaPixelChannel]);
1559 (void) FormatLocaleFile(stderr,
" yellow: %.*g\n",
1560 GetMagickPrecision(),scale*
1561 channel_distortion[YellowPixelChannel]);
1562 (void) FormatLocaleFile(stderr,
" black: %.*g\n",
1563 GetMagickPrecision(),scale*
1564 channel_distortion[BlackPixelChannel]);
1565 if (image->alpha_trait != UndefinedPixelTrait)
1566 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1567 GetMagickPrecision(),scale*
1568 channel_distortion[AlphaPixelChannel]);
1571 case LinearGRAYColorspace:
1572 case GRAYColorspace:
1574 (void) FormatLocaleFile(stderr,
" gray: %.*g\n",
1575 GetMagickPrecision(),scale*
1576 channel_distortion[GrayPixelChannel]);
1577 if (image->alpha_trait != UndefinedPixelTrait)
1578 (void) FormatLocaleFile(stderr,
" alpha: %.*g\n",
1579 GetMagickPrecision(),scale*
1580 channel_distortion[AlphaPixelChannel]);
1584 (void) FormatLocaleFile(stderr,
" all: %.*g\n",
1585 GetMagickPrecision(),scale*
1586 channel_distortion[MaxPixelChannels]);
1589 case UndefinedErrorMetric:
1592 channel_distortion=(
double *) RelinquishMagickMemory(
1593 channel_distortion);
1594 if (subimage_search != MagickFalse)
1596 (void) FormatLocaleFile(stderr,
" Offset: %.17g,%.17g\n",
1597 (
double) difference_image->page.x,(
double)
1598 difference_image->page.y);
1599 (void) FormatLocaleFile(stderr,
" Similarity metric: %*g\n",
1600 GetMagickPrecision(),similarity_metric);
1601 (void) FormatLocaleFile(stderr,
" Similarity threshold: %*g\n",
1602 GetMagickPrecision(),similarity_threshold);
1603 (void) FormatLocaleFile(stderr,
1604 " Dissimilarity threshold: %*g\n",GetMagickPrecision(),
1605 dissimilarity_threshold);
1608 (void) ResetImagePage(difference_image,
"0x0+0+0");
1609 if (difference_image->next != (Image *) NULL)
1610 (void) ResetImagePage(difference_image->next,
"0x0+0+0");
1611 status&=(MagickStatusType) WriteImages(image_info,difference_image,
1612 argv[argc-1],exception);
1613 if ((metadata != (
char **) NULL) && (format != (
char *) NULL))
1618 text=InterpretImageProperties(image_info,difference_image,format,
1620 if (text == (
char *) NULL)
1621 ThrowCompareException(ResourceLimitError,
"MemoryAllocationFailed",
1623 (void) ConcatenateString(&(*metadata),text);
1624 text=DestroyString(text);
1626 difference_image=DestroyImageList(difference_image);
1629 if (similar == MagickFalse)
1630 (void) SetImageOption(image_info,
"compare:dissimilar",
"true");
1631 return(status != 0 ? MagickTrue : MagickFalse);