2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % IIIII DDDD EEEEE N N TTTTT IIIII FFFFF Y Y %
7 % I D D E NN N T I F Y Y %
8 % I D D EEE N N N T I FFF Y %
9 % I D D E N NN T I F Y %
10 % IIIII DDDD EEEEE N N T IIIII F Y %
13 % Identify an Image Format and Characteristics. %
20 % Copyright 1999-2008 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 % Identify describes the format and characteristics of one or more image
37 % files. It will also report if an image is incomplete or corrupt.
45 #include "MagickCore/studio.h"
46 #include "MagickCore/annotate.h"
47 #include "MagickCore/artifact.h"
48 #include "MagickCore/attribute.h"
49 #include "MagickCore/blob.h"
50 #include "MagickCore/cache.h"
51 #include "MagickCore/client.h"
52 #include "MagickCore/coder.h"
53 #include "MagickCore/color.h"
54 #include "MagickCore/configure.h"
55 #include "MagickCore/constitute.h"
56 #include "MagickCore/decorate.h"
57 #include "MagickCore/delegate.h"
58 #include "MagickCore/draw.h"
59 #include "MagickCore/effect.h"
60 #include "MagickCore/exception.h"
61 #include "MagickCore/exception-private.h"
62 #include "MagickCore/feature.h"
63 #include "MagickCore/gem.h"
64 #include "MagickCore/geometry.h"
65 #include "MagickCore/histogram.h"
66 #include "MagickCore/identify.h"
67 #include "MagickCore/image.h"
68 #include "MagickCore/image-private.h"
69 #include "MagickCore/list.h"
70 #include "MagickCore/locale_.h"
71 #include "MagickCore/log.h"
72 #include "MagickCore/magic.h"
73 #include "MagickCore/magick.h"
74 #include "MagickCore/memory_.h"
75 #include "MagickCore/module.h"
76 #include "MagickCore/monitor.h"
77 #include "MagickCore/montage.h"
78 #include "MagickCore/option.h"
79 #include "MagickCore/pixel-accessor.h"
80 #include "MagickCore/prepress.h"
81 #include "MagickCore/profile.h"
82 #include "MagickCore/property.h"
83 #include "MagickCore/quantize.h"
84 #include "MagickCore/quantum.h"
85 #include "MagickCore/random_.h"
86 #include "MagickCore/registry.h"
87 #include "MagickCore/resize.h"
88 #include "MagickCore/resource_.h"
89 #include "MagickCore/signature.h"
90 #include "MagickCore/statistic.h"
91 #include "MagickCore/string_.h"
92 #include "MagickCore/string-private.h"
93 #include "MagickCore/timer.h"
94 #include "MagickCore/utility.h"
95 #include "MagickCore/utility-private.h"
96 #include "MagickCore/version.h"
97 #if defined(MAGICKCORE_LCMS_DELEGATE)
98 #if defined(MAGICKCORE_HAVE_LCMS_LCMS2_H)
99 #include <lcms/lcms2.h>
100 #elif defined(MAGICKCORE_HAVE_LCMS2_H)
102 #elif defined(MAGICKCORE_HAVE_LCMS_LCMS_H)
103 #include <lcms/lcms.h>
112 #if defined(MAGICKCORE_LCMS_DELEGATE)
113 #if defined(LCMS_VERSION) && (LCMS_VERSION < 2000)
114 #define cmsUInt32Number DWORD
119 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
123 % I d e n t i f y I m a g e %
127 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
129 % IdentifyImage() identifies an image by printing its attributes to the file.
130 % Attributes include the image width, height, size, and others.
132 % The format of the IdentifyImage method is:
134 % MagickBooleanType IdentifyImage(Image *image,FILE *file,
135 % const MagickBooleanType verbose,ExceptionInfo *exception)
137 % A description of each parameter follows:
139 % o image: the image.
141 % o file: the file, typically stdout.
143 % o verbose: A value other than zero prints more detailed information
146 % o exception: return any errors or warnings in this structure.
150 static ssize_t PrintChannelFeatures(FILE *file,const PixelChannel channel,
151 const char *name,const ChannelFeatures *channel_features)
153 #define PrintFeature(feature) \
154 GetMagickPrecision(),(feature)[0], \
155 GetMagickPrecision(),(feature)[1], \
156 GetMagickPrecision(),(feature)[2], \
157 GetMagickPrecision(),(feature)[3], \
158 GetMagickPrecision(),((feature)[0]+(feature)[1]+(feature)[2]+(feature)[3])/4.0 \
160 #define FeaturesFormat " %s:\n" \
161 " Angular Second Moment:\n" \
162 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
164 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
166 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
167 " Sum of Squares: Variance:\n" \
168 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
169 " Inverse Difference Moment:\n" \
170 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
172 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
174 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
176 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
178 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
179 " Difference Variance:\n" \
180 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
181 " Difference Entropy:\n" \
182 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
183 " Information Measure of Correlation 1:\n" \
184 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
185 " Information Measure of Correlation 2:\n" \
186 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
187 " Maximum Correlation Coefficient:\n" \
188 " %.*g, %.*g, %.*g, %.*g, %.*g\n"
193 n=FormatLocaleFile(file,FeaturesFormat,name,
194 PrintFeature(channel_features[channel].angular_second_moment),
195 PrintFeature(channel_features[channel].contrast),
196 PrintFeature(channel_features[channel].correlation),
197 PrintFeature(channel_features[channel].variance_sum_of_squares),
198 PrintFeature(channel_features[channel].inverse_difference_moment),
199 PrintFeature(channel_features[channel].sum_average),
200 PrintFeature(channel_features[channel].sum_variance),
201 PrintFeature(channel_features[channel].sum_entropy),
202 PrintFeature(channel_features[channel].entropy),
203 PrintFeature(channel_features[channel].difference_variance),
204 PrintFeature(channel_features[channel].difference_entropy),
205 PrintFeature(channel_features[channel].measure_of_correlation_1),
206 PrintFeature(channel_features[channel].measure_of_correlation_2),
207 PrintFeature(channel_features[channel].maximum_correlation_coefficient));
211 static ssize_t PrintChannelStatistics(FILE *file,const PixelChannel channel,
212 const char *name,const double scale,
213 const ChannelStatistics *channel_statistics)
215 #define StatisticsFormat " %s:\n min: " QuantumFormat \
216 " (%g)\n max: " QuantumFormat " (%g)\n" \
217 " mean: %g (%g)\n standard deviation: %g (%g)\n" \
218 " kurtosis: %g\n skewness: %g\n"
223 n=FormatLocaleFile(file,StatisticsFormat,name,ClampToQuantum(scale*
224 channel_statistics[channel].minima),channel_statistics[channel].minima/
225 (double) QuantumRange,ClampToQuantum(scale*
226 channel_statistics[channel].maxima),channel_statistics[channel].maxima/
227 (double) QuantumRange,scale*channel_statistics[channel].mean,
228 channel_statistics[channel].mean/(double) QuantumRange,scale*
229 channel_statistics[channel].standard_deviation,
230 channel_statistics[channel].standard_deviation/(double) QuantumRange,
231 channel_statistics[channel].kurtosis,channel_statistics[channel].skewness);
235 MagickExport MagickBooleanType IdentifyImage(Image *image,FILE *file,
236 const MagickBooleanType verbose,ExceptionInfo *exception)
239 color[MaxTextExtent],
240 format[MaxTextExtent],
272 register const Quantum
286 assert(image != (Image *) NULL);
287 assert(image->signature == MagickSignature);
288 if (image->debug != MagickFalse)
289 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
290 if (file == (FILE *) NULL)
293 elapsed_time=GetElapsedTime(&image->timer);
294 user_time=GetUserTime(&image->timer);
295 GetTimerInfo(&image->timer);
296 if (verbose == MagickFalse)
299 Display summary info about the image.
301 if (*image->magick_filename != '\0')
302 if (LocaleCompare(image->magick_filename,image->filename) != 0)
303 (void) FormatLocaleFile(file,"%s=>",image->magick_filename);
304 if ((GetPreviousImageInList(image) == (Image *) NULL) &&
305 (GetNextImageInList(image) == (Image *) NULL) &&
307 (void) FormatLocaleFile(file,"%s ",image->filename);
309 (void) FormatLocaleFile(file,"%s[%.20g] ",image->filename,(double)
311 (void) FormatLocaleFile(file,"%s ",image->magick);
312 if ((image->magick_columns != 0) || (image->magick_rows != 0))
313 if ((image->magick_columns != image->columns) ||
314 (image->magick_rows != image->rows))
315 (void) FormatLocaleFile(file,"%.20gx%.20g=>",(double)
316 image->magick_columns,(double) image->magick_rows);
317 (void) FormatLocaleFile(file,"%.20gx%.20g ",(double) image->columns,
318 (double) image->rows);
319 if ((image->page.width != 0) || (image->page.height != 0) ||
320 (image->page.x != 0) || (image->page.y != 0))
321 (void) FormatLocaleFile(file,"%.20gx%.20g%+.20g%+.20g ",(double)
322 image->page.width,(double) image->page.height,(double) image->page.x,
323 (double) image->page.y);
324 (void) FormatLocaleFile(file,"%.20g-bit ",(double) image->depth);
325 if (image->type != UndefinedType)
326 (void) FormatLocaleFile(file,"%s ",CommandOptionToMnemonic(
327 MagickTypeOptions,(ssize_t) image->type));
328 if (image->storage_class == DirectClass)
330 (void) FormatLocaleFile(file,"DirectClass ");
331 if (image->total_colors != 0)
333 (void) FormatMagickSize(image->total_colors,MagickFalse,format);
334 (void) FormatLocaleFile(file,"%s ",format);
338 if (image->total_colors <= image->colors)
339 (void) FormatLocaleFile(file,"PseudoClass %.20gc ",(double)
342 (void) FormatLocaleFile(file,"PseudoClass %.20g=>%.20gc ",(double)
343 image->total_colors,(double) image->colors);
344 if (image->error.mean_error_per_pixel != 0.0)
345 (void) FormatLocaleFile(file,"%.20g/%f/%fdb ",(double)
346 (image->error.mean_error_per_pixel+0.5),
347 image->error.normalized_mean_error,
348 image->error.normalized_maximum_error);
349 if (GetBlobSize(image) != 0)
351 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
352 (void) FormatLocaleFile(file,"%s ",format);
354 (void) FormatLocaleFile(file,"%0.3fu %lu:%02lu.%03lu",user_time,
355 (unsigned long) (elapsed_time/60.0),(unsigned long) floor(fmod(
356 elapsed_time,60.0)),(unsigned long) (1000.0*(elapsed_time-
357 floor(elapsed_time))));
358 (void) FormatLocaleFile(file,"\n");
360 return(ferror(file) != 0 ? MagickFalse : MagickTrue);
363 Display verbose info about the image.
365 p=GetVirtualPixels(image,0,0,1,1,exception);
366 ping=p == (const Quantum *) NULL ? MagickTrue : MagickFalse;
367 type=GetImageType(image,exception);
368 (void) SignatureImage(image,exception);
369 (void) FormatLocaleFile(file,"Image: %s\n",image->filename);
370 if (*image->magick_filename != '\0')
371 if (LocaleCompare(image->magick_filename,image->filename) != 0)
374 filename[MaxTextExtent];
376 GetPathComponent(image->magick_filename,TailPath,filename);
377 (void) FormatLocaleFile(file," Base filename: %s\n",filename);
379 magick_info=GetMagickInfo(image->magick,exception);
380 if ((magick_info == (const MagickInfo *) NULL) ||
381 (*GetMagickDescription(magick_info) == '\0'))
382 (void) FormatLocaleFile(file," Format: %s\n",image->magick);
384 (void) FormatLocaleFile(file," Format: %s (%s)\n",image->magick,
385 GetMagickDescription(magick_info));
386 (void) FormatLocaleFile(file," Class: %s\n",CommandOptionToMnemonic(
387 MagickClassOptions,(ssize_t) image->storage_class));
388 (void) FormatLocaleFile(file," Geometry: %.20gx%.20g%+.20g%+.20g\n",(double)
389 image->columns,(double) image->rows,(double) image->tile_offset.x,(double)
390 image->tile_offset.y);
391 if ((image->magick_columns != 0) || (image->magick_rows != 0))
392 if ((image->magick_columns != image->columns) ||
393 (image->magick_rows != image->rows))
394 (void) FormatLocaleFile(file," Base geometry: %.20gx%.20g\n",(double)
395 image->magick_columns,(double) image->magick_rows);
396 if ((image->resolution.x != 0.0) && (image->resolution.y != 0.0))
398 (void) FormatLocaleFile(file," Resolution: %gx%g\n",image->resolution.x,
399 image->resolution.y);
400 (void) FormatLocaleFile(file," Print size: %gx%g\n",(double)
401 image->columns/image->resolution.x,(double) image->rows/
402 image->resolution.y);
404 (void) FormatLocaleFile(file," Units: %s\n",CommandOptionToMnemonic(
405 MagickResolutionOptions,(ssize_t) image->units));
406 (void) FormatLocaleFile(file," Type: %s\n",CommandOptionToMnemonic(
407 MagickTypeOptions,(ssize_t) type));
408 if (image->type != UndefinedType)
409 (void) FormatLocaleFile(file," Base type: %s\n",CommandOptionToMnemonic(
410 MagickTypeOptions,(ssize_t) image->type));
411 (void) FormatLocaleFile(file," Endianess: %s\n",CommandOptionToMnemonic(
412 MagickEndianOptions,(ssize_t) image->endian));
414 Detail channel depth and extrema.
416 (void) FormatLocaleFile(file," Colorspace: %s\n",CommandOptionToMnemonic(
417 MagickColorspaceOptions,(ssize_t) image->colorspace));
418 channel_statistics=(ChannelStatistics *) NULL;
419 channel_features=(ChannelFeatures *) NULL;
420 colorspace=image->colorspace;
421 if (ping == MagickFalse)
426 channel_statistics=GetImageStatistics(image,exception);
427 artifact=GetImageArtifact(image,"identify:features");
428 if (artifact != (const char *) NULL)
430 distance=StringToUnsignedLong(artifact);
431 channel_features=GetImageFeatures(image,distance,exception);
433 depth=GetImageDepth(image,exception);
434 if (image->depth == depth)
435 (void) FormatLocaleFile(file," Depth: %.20g-bit\n",(double)
438 (void) FormatLocaleFile(file," Depth: %.20g/%.20g-bit\n",(double)
439 image->depth,(double) depth);
440 (void) FormatLocaleFile(file," Channel depth:\n");
441 if (IsImageGray(image,exception) != MagickFalse)
442 colorspace=GRAYColorspace;
448 (void) FormatLocaleFile(file," red: %.20g-bit\n",(double)
449 channel_statistics[RedPixelChannel].depth);
450 (void) FormatLocaleFile(file," green: %.20g-bit\n",(double)
451 channel_statistics[GreenPixelChannel].depth);
452 (void) FormatLocaleFile(file," blue: %.20g-bit\n",(double)
453 channel_statistics[BluePixelChannel].depth);
458 (void) FormatLocaleFile(file," cyan: %.20g-bit\n",(double)
459 channel_statistics[CyanPixelChannel].depth);
460 (void) FormatLocaleFile(file," magenta: %.20g-bit\n",(double)
461 channel_statistics[MagentaPixelChannel].depth);
462 (void) FormatLocaleFile(file," yellow: %.20g-bit\n",(double)
463 channel_statistics[YellowPixelChannel].depth);
464 (void) FormatLocaleFile(file," black: %.20g-bit\n",(double)
465 channel_statistics[BlackPixelChannel].depth);
470 (void) FormatLocaleFile(file," gray: %.20g-bit\n",(double)
471 channel_statistics[GrayPixelChannel].depth);
475 if (image->matte != MagickFalse)
476 (void) FormatLocaleFile(file," alpha: %.20g-bit\n",(double)
477 channel_statistics[AlphaPixelChannel].depth);
479 if (image->depth <= MAGICKCORE_QUANTUM_DEPTH)
480 scale=QuantumRange/((size_t) QuantumRange >> ((size_t)
481 MAGICKCORE_QUANTUM_DEPTH-image->depth));
483 if (channel_statistics != (ChannelStatistics *) NULL)
485 (void) FormatLocaleFile(file," Channel statistics:\n");
491 (void) PrintChannelStatistics(file,RedPixelChannel,"Red",1.0/
492 scale,channel_statistics);
493 (void) PrintChannelStatistics(file,GreenPixelChannel,"Green",1.0/
494 scale,channel_statistics);
495 (void) PrintChannelStatistics(file,BluePixelChannel,"Blue",1.0/
496 scale,channel_statistics);
501 (void) PrintChannelStatistics(file,CyanPixelChannel,"Cyan",1.0/
502 scale,channel_statistics);
503 (void) PrintChannelStatistics(file,MagentaPixelChannel,"Magenta",1.0/
504 scale,channel_statistics);
505 (void) PrintChannelStatistics(file,YellowPixelChannel,"Yellow",1.0/
506 scale,channel_statistics);
507 (void) PrintChannelStatistics(file,BlackPixelChannel,"Black",1.0/
508 scale,channel_statistics);
513 (void) PrintChannelStatistics(file,GrayPixelChannel,"Gray",1.0/
514 scale,channel_statistics);
518 if (image->matte != MagickFalse)
519 (void) PrintChannelStatistics(file,AlphaPixelChannel,"Alpha",1.0/
520 scale,channel_statistics);
521 if (colorspace != GRAYColorspace)
523 (void) FormatLocaleFile(file," Image statistics:\n");
524 (void) PrintChannelStatistics(file,(PixelChannel) MaxPixelChannels,
525 "Overall",1.0/scale,channel_statistics);
527 channel_statistics=(ChannelStatistics *) RelinquishMagickMemory(
530 if (channel_features != (ChannelFeatures *) NULL)
532 (void) FormatLocaleFile(file," Channel features (horizontal, vertical, "
533 "left and right diagonals, average):\n");
539 (void) PrintChannelFeatures(file,RedPixelChannel,"Red",
541 (void) PrintChannelFeatures(file,GreenPixelChannel,"Green",
543 (void) PrintChannelFeatures(file,BluePixelChannel,"Blue",
549 (void) PrintChannelFeatures(file,CyanPixelChannel,"Cyan",
551 (void) PrintChannelFeatures(file,MagentaPixelChannel,"Magenta",
553 (void) PrintChannelFeatures(file,YellowPixelChannel,"Yellow",
555 (void) PrintChannelFeatures(file,BlackPixelChannel,"Black",
561 (void) PrintChannelFeatures(file,GrayPixelChannel,"Gray",
566 if (image->matte != MagickFalse)
567 (void) PrintChannelFeatures(file,AlphaPixelChannel,"Alpha",
569 channel_features=(ChannelFeatures *) RelinquishMagickMemory(
572 if (ping == MagickFalse)
574 if (image->colorspace == CMYKColorspace)
575 (void) FormatLocaleFile(file," Total ink density: %.0f%%\n",100.0*
576 GetImageTotalInkDensity(image,exception)/(double) QuantumRange);
578 if (image->matte != MagickFalse)
580 register const Quantum
583 p=(const Quantum *) NULL;
584 for (y=0; y < (ssize_t) image->rows; y++)
586 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
587 if (p == (const Quantum *) NULL)
589 for (x=0; x < (ssize_t) image->columns; x++)
591 if (GetPixelAlpha(image,p) == (Quantum) TransparentAlpha)
593 p+=GetPixelChannels(image);
595 if (x < (ssize_t) image->columns)
598 if ((x < (ssize_t) image->columns) || (y < (ssize_t) image->rows))
601 tuple[MaxTextExtent];
606 GetPixelInfo(image,&pixel);
607 GetPixelInfoPixel(image,p,&pixel);
608 (void) QueryColorname(image,&pixel,SVGCompliance,tuple,
610 (void) FormatLocaleFile(file," Alpha: %s ",tuple);
611 GetColorTuple(&pixel,MagickTrue,tuple);
612 (void) FormatLocaleFile(file," %s\n",tuple);
615 artifact=GetImageArtifact(image,"identify:unique-colors");
616 if (IsHistogramImage(image,exception) != MagickFalse)
618 (void) FormatLocaleFile(file," Colors: %.20g\n",(double)
619 GetNumberColors(image,(FILE *) NULL,exception));
620 (void) FormatLocaleFile(file," Histogram:\n");
621 (void) GetNumberColors(image,file,exception);
624 if ((artifact != (const char *) NULL) &&
625 (IsMagickTrue(artifact) != MagickFalse))
626 (void) FormatLocaleFile(file," Colors: %.20g\n",(double)
627 GetNumberColors(image,(FILE *) NULL,exception));
629 if (image->storage_class == PseudoClass)
631 (void) FormatLocaleFile(file," Colormap: %.20g\n",(double)
633 if (image->colors <= 1024)
636 color[MaxTextExtent],
638 tuple[MaxTextExtent];
646 GetPixelInfo(image,&pixel);
648 for (i=0; i < (ssize_t) image->colors; i++)
651 (void) CopyMagickString(tuple,"(",MaxTextExtent);
652 ConcatenateColorComponent(&pixel,RedPixelChannel,X11Compliance,
654 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
655 ConcatenateColorComponent(&pixel,GreenPixelChannel,X11Compliance,
657 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
658 ConcatenateColorComponent(&pixel,BluePixelChannel,X11Compliance,
660 if (pixel.colorspace == CMYKColorspace)
662 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
663 ConcatenateColorComponent(&pixel,BlackPixelChannel,
664 X11Compliance,tuple);
666 if (pixel.matte != MagickFalse)
668 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
669 ConcatenateColorComponent(&pixel,AlphaPixelChannel,
670 X11Compliance,tuple);
672 (void) ConcatenateMagickString(tuple,")",MaxTextExtent);
673 (void) QueryColorname(image,&pixel,SVGCompliance,color,
675 GetColorTuple(&pixel,MagickTrue,hex);
676 (void) FormatLocaleFile(file," %8ld: %s %s %s\n",(long) i,tuple,
682 if (image->error.mean_error_per_pixel != 0.0)
683 (void) FormatLocaleFile(file," Mean error per pixel: %g\n",
684 image->error.mean_error_per_pixel);
685 if (image->error.normalized_mean_error != 0.0)
686 (void) FormatLocaleFile(file," Normalized mean error: %g\n",
687 image->error.normalized_mean_error);
688 if (image->error.normalized_maximum_error != 0.0)
689 (void) FormatLocaleFile(file," Normalized maximum error: %g\n",
690 image->error.normalized_maximum_error);
691 (void) FormatLocaleFile(file," Rendering intent: %s\n",
692 CommandOptionToMnemonic(MagickIntentOptions,(ssize_t)
693 image->rendering_intent));
694 if (image->gamma != 0.0)
695 (void) FormatLocaleFile(file," Gamma: %g\n",image->gamma);
696 if ((image->chromaticity.red_primary.x != 0.0) ||
697 (image->chromaticity.green_primary.x != 0.0) ||
698 (image->chromaticity.blue_primary.x != 0.0) ||
699 (image->chromaticity.white_point.x != 0.0))
702 Display image chromaticity.
704 (void) FormatLocaleFile(file," Chromaticity:\n");
705 (void) FormatLocaleFile(file," red primary: (%g,%g)\n",
706 image->chromaticity.red_primary.x,image->chromaticity.red_primary.y);
707 (void) FormatLocaleFile(file," green primary: (%g,%g)\n",
708 image->chromaticity.green_primary.x,
709 image->chromaticity.green_primary.y);
710 (void) FormatLocaleFile(file," blue primary: (%g,%g)\n",
711 image->chromaticity.blue_primary.x,image->chromaticity.blue_primary.y);
712 (void) FormatLocaleFile(file," white point: (%g,%g)\n",
713 image->chromaticity.white_point.x,image->chromaticity.white_point.y);
715 if ((image->extract_info.width*image->extract_info.height) != 0)
716 (void) FormatLocaleFile(file," Tile geometry: %.20gx%.20g%+.20g%+.20g\n",
717 (double) image->extract_info.width,(double) image->extract_info.height,
718 (double) image->extract_info.x,(double) image->extract_info.y);
719 (void) FormatLocaleFile(file," Interlace: %s\n",CommandOptionToMnemonic(
720 MagickInterlaceOptions,(ssize_t) image->interlace));
721 (void) QueryColorname(image,&image->background_color,SVGCompliance,color,
723 (void) FormatLocaleFile(file," Background color: %s\n",color);
724 (void) QueryColorname(image,&image->border_color,SVGCompliance,color,
726 (void) FormatLocaleFile(file," Border color: %s\n",color);
727 (void) QueryColorname(image,&image->matte_color,SVGCompliance,color,
729 (void) FormatLocaleFile(file," Matte color: %s\n",color);
730 (void) QueryColorname(image,&image->transparent_color,SVGCompliance,color,
732 (void) FormatLocaleFile(file," Transparent color: %s\n",color);
733 (void) FormatLocaleFile(file," Compose: %s\n",CommandOptionToMnemonic(
734 MagickComposeOptions,(ssize_t) image->compose));
735 if ((image->page.width != 0) || (image->page.height != 0) ||
736 (image->page.x != 0) || (image->page.y != 0))
737 (void) FormatLocaleFile(file," Page geometry: %.20gx%.20g%+.20g%+.20g\n",
738 (double) image->page.width,(double) image->page.height,(double)
739 image->page.x,(double) image->page.y);
740 if ((image->page.x != 0) || (image->page.y != 0))
741 (void) FormatLocaleFile(file," Origin geometry: %+.20g%+.20g\n",(double)
742 image->page.x,(double) image->page.y);
743 (void) FormatLocaleFile(file," Dispose: %s\n",CommandOptionToMnemonic(
744 MagickDisposeOptions,(ssize_t) image->dispose));
745 if (image->delay != 0)
746 (void) FormatLocaleFile(file," Delay: %.20gx%.20g\n",(double) image->delay,
747 (double) image->ticks_per_second);
748 if (image->iterations != 1)
749 (void) FormatLocaleFile(file," Iterations: %.20g\n",(double)
751 if ((image->next != (Image *) NULL) || (image->previous != (Image *) NULL))
752 (void) FormatLocaleFile(file," Scene: %.20g of %.20g\n",(double)
753 image->scene,(double) GetImageListLength(image));
755 if (image->scene != 0)
756 (void) FormatLocaleFile(file," Scene: %.20g\n",(double) image->scene);
757 (void) FormatLocaleFile(file," Compression: %s\n",CommandOptionToMnemonic(
758 MagickCompressOptions,(ssize_t) image->compression));
759 if (image->quality != UndefinedCompressionQuality)
760 (void) FormatLocaleFile(file," Quality: %.20g\n",(double) image->quality);
761 (void) FormatLocaleFile(file," Orientation: %s\n",CommandOptionToMnemonic(
762 MagickOrientationOptions,(ssize_t) image->orientation));
763 if (image->montage != (char *) NULL)
764 (void) FormatLocaleFile(file," Montage: %s\n",image->montage);
765 if (image->directory != (char *) NULL)
781 Display visual image directory.
783 image_info=AcquireImageInfo();
784 (void) CloneString(&image_info->size,"64x64");
785 (void) FormatLocaleFile(file," Directory:\n");
786 for (p=image->directory; *p != '\0'; p++)
789 while ((*q != '\n') && (*q != '\0'))
791 (void) CopyMagickString(image_info->filename,p,(size_t) (q-p+1));
793 (void) FormatLocaleFile(file," %s",image_info->filename);
794 handler=SetWarningHandler((WarningHandler) NULL);
795 tile=ReadImage(image_info,exception);
796 (void) SetWarningHandler(handler);
797 if (tile == (Image *) NULL)
799 (void) FormatLocaleFile(file,"\n");
802 (void) FormatLocaleFile(file," %.20gx%.20g %s\n",(double)
803 tile->magick_columns,(double) tile->magick_rows,tile->magick);
804 (void) SignatureImage(tile,exception);
805 ResetImagePropertyIterator(tile);
806 property=GetNextImageProperty(tile);
807 while (property != (const char *) NULL)
809 (void) FormatLocaleFile(file," %s:\n",property);
810 value=GetImageProperty(tile,property,exception);
811 if (value != (const char *) NULL)
812 (void) FormatLocaleFile(file,"%s\n",value);
813 property=GetNextImageProperty(tile);
815 tile=DestroyImage(tile);
817 image_info=DestroyImageInfo(image_info);
819 (void) GetImageProperty(image,"exif:*",exception);
820 ResetImagePropertyIterator(image);
821 property=GetNextImageProperty(image);
822 if (property != (const char *) NULL)
825 Display image properties.
827 (void) FormatLocaleFile(file," Properties:\n");
828 while (property != (const char *) NULL)
830 (void) FormatLocaleFile(file," %s: ",property);
831 value=GetImageProperty(image,property,exception);
832 if (value != (const char *) NULL)
833 (void) FormatLocaleFile(file,"%s\n",value);
834 property=GetNextImageProperty(image);
837 (void) FormatLocaleString(key,MaxTextExtent,"8BIM:1999,2998:#1");
838 value=GetImageProperty(image,key,exception);
839 if (value != (const char *) NULL)
842 Display clipping path.
844 (void) FormatLocaleFile(file," Clipping path: ");
845 if (strlen(value) > 80)
846 (void) fputc('\n',file);
847 (void) FormatLocaleFile(file,"%s\n",value);
849 ResetImageProfileIterator(image);
850 name=GetNextImageProfile(image);
851 if (name != (char *) NULL)
857 Identify image profiles.
859 (void) FormatLocaleFile(file," Profiles:\n");
860 while (name != (char *) NULL)
862 profile=GetImageProfile(image,name);
863 if (profile == (StringInfo *) NULL)
865 (void) FormatLocaleFile(file," Profile-%s: %.20g bytes\n",name,
866 (double) GetStringInfoLength(profile));
867 #if defined(MAGICKCORE_LCMS_DELEGATE)
868 if ((LocaleCompare(name,"icc") == 0) ||
869 (LocaleCompare(name,"icm") == 0))
874 icc_profile=cmsOpenProfileFromMem(GetStringInfoDatum(profile),
875 (cmsUInt32Number) GetStringInfoLength(profile));
876 if (icc_profile != (cmsHPROFILE *) NULL)
878 #if defined(LCMS_VERSION) && (LCMS_VERSION < 2000)
882 name=cmsTakeProductName(icc_profile);
883 if (name != (const char *) NULL)
884 (void) FormatLocaleFile(file," %s\n",name);
889 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoDescription,
890 "en","US",info,MaxTextExtent);
891 (void) FormatLocaleFile(file," Description: %s\n",info);
892 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoManufacturer,
893 "en","US",info,MaxTextExtent);
894 (void) FormatLocaleFile(file," Manufacturer: %s\n",info);
895 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoModel,"en",
896 "US",info,MaxTextExtent);
897 (void) FormatLocaleFile(file," Model: %s\n",info);
898 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoCopyright,
899 "en","US",info,MaxTextExtent);
900 (void) FormatLocaleFile(file," Copyright: %s\n",info);
902 (void) cmsCloseProfile(icc_profile);
906 if (LocaleCompare(name,"iptc") == 0)
927 profile_length=GetStringInfoLength(profile);
928 for (i=0; i < (ssize_t) profile_length; i+=(ssize_t) length)
931 sentinel=GetStringInfoDatum(profile)[i++];
932 if (sentinel != 0x1c)
934 dataset=GetStringInfoDatum(profile)[i++];
935 record=GetStringInfoDatum(profile)[i++];
938 case 5: tag="Image Name"; break;
939 case 7: tag="Edit Status"; break;
940 case 10: tag="Priority"; break;
941 case 15: tag="Category"; break;
942 case 20: tag="Supplemental Category"; break;
943 case 22: tag="Fixture Identifier"; break;
944 case 25: tag="Keyword"; break;
945 case 30: tag="Release Date"; break;
946 case 35: tag="Release Time"; break;
947 case 40: tag="Special Instructions"; break;
948 case 45: tag="Reference Service"; break;
949 case 47: tag="Reference Date"; break;
950 case 50: tag="Reference Number"; break;
951 case 55: tag="Created Date"; break;
952 case 60: tag="Created Time"; break;
953 case 65: tag="Originating Program"; break;
954 case 70: tag="Program Version"; break;
955 case 75: tag="Object Cycle"; break;
956 case 80: tag="Byline"; break;
957 case 85: tag="Byline Title"; break;
958 case 90: tag="City"; break;
959 case 95: tag="Province State"; break;
960 case 100: tag="Country Code"; break;
961 case 101: tag="Country"; break;
962 case 103: tag="Original Transmission Reference"; break;
963 case 105: tag="Headline"; break;
964 case 110: tag="Credit"; break;
965 case 115: tag="Src"; break;
966 case 116: tag="Copyright String"; break;
967 case 120: tag="Caption"; break;
968 case 121: tag="Local Caption"; break;
969 case 122: tag="Caption Writer"; break;
970 case 200: tag="Custom Field 1"; break;
971 case 201: tag="Custom Field 2"; break;
972 case 202: tag="Custom Field 3"; break;
973 case 203: tag="Custom Field 4"; break;
974 case 204: tag="Custom Field 5"; break;
975 case 205: tag="Custom Field 6"; break;
976 case 206: tag="Custom Field 7"; break;
977 case 207: tag="Custom Field 8"; break;
978 case 208: tag="Custom Field 9"; break;
979 case 209: tag="Custom Field 10"; break;
980 case 210: tag="Custom Field 11"; break;
981 case 211: tag="Custom Field 12"; break;
982 case 212: tag="Custom Field 13"; break;
983 case 213: tag="Custom Field 14"; break;
984 case 214: tag="Custom Field 15"; break;
985 case 215: tag="Custom Field 16"; break;
986 case 216: tag="Custom Field 17"; break;
987 case 217: tag="Custom Field 18"; break;
988 case 218: tag="Custom Field 19"; break;
989 case 219: tag="Custom Field 20"; break;
990 default: tag="unknown"; break;
992 (void) FormatLocaleFile(file," %s[%.20g,%.20g]: ",tag,
993 (double) dataset,(double) record);
994 length=(size_t) (GetStringInfoDatum(profile)[i++] << 8);
995 length|=GetStringInfoDatum(profile)[i++];
996 attribute=(char *) NULL;
997 if (~length >= (MaxTextExtent-1))
998 attribute=(char *) AcquireQuantumMemory(length+MaxTextExtent,
1000 if (attribute != (char *) NULL)
1002 (void) CopyMagickString(attribute,(char *)
1003 GetStringInfoDatum(profile)+i,length+1);
1004 attribute_list=StringToList(attribute);
1005 if (attribute_list != (char **) NULL)
1007 for (j=0; attribute_list[j] != (char *) NULL; j++)
1009 (void) fputs(attribute_list[j],file);
1010 (void) fputs("\n",file);
1011 attribute_list[j]=(char *) RelinquishMagickMemory(
1014 attribute_list=(char **) RelinquishMagickMemory(
1017 attribute=DestroyString(attribute);
1021 if (image->debug != MagickFalse)
1022 PrintStringInfo(file,name,profile);
1023 name=GetNextImageProfile(image);
1026 ResetImageArtifactIterator(image);
1027 artifact=GetNextImageArtifact(image);
1028 if (artifact != (const char *) NULL)
1031 Display image artifacts.
1033 (void) FormatLocaleFile(file," Artifacts:\n");
1034 while (artifact != (const char *) NULL)
1036 (void) FormatLocaleFile(file," %s: ",artifact);
1037 value=GetImageArtifact(image,artifact);
1038 if (value != (const char *) NULL)
1039 (void) FormatLocaleFile(file,"%s\n",value);
1040 artifact=GetNextImageArtifact(image);
1043 ResetImageRegistryIterator();
1044 registry=GetNextImageRegistry();
1045 if (registry != (const char *) NULL)
1048 Display image registry.
1050 (void) FormatLocaleFile(file," Registry:\n");
1051 while (registry != (const char *) NULL)
1053 (void) FormatLocaleFile(file," %s: ",registry);
1054 value=(const char *) GetImageRegistry(StringRegistryType,registry,
1056 if (value != (const char *) NULL)
1057 (void) FormatLocaleFile(file,"%s\n",value);
1058 registry=GetNextImageRegistry();
1061 (void) FormatLocaleFile(file," Tainted: %s\n",CommandOptionToMnemonic(
1062 MagickBooleanOptions,(ssize_t) image->taint));
1063 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
1064 (void) FormatLocaleFile(file," Filesize: %s\n",format);
1065 (void) FormatMagickSize((MagickSizeType) image->columns*image->rows,
1066 MagickFalse,format);
1067 (void) FormatLocaleFile(file," Number pixels: %s\n",format);
1068 (void) FormatMagickSize((MagickSizeType) ((double) image->columns*image->rows/
1069 elapsed_time+0.5),MagickFalse,format);
1070 (void) FormatLocaleFile(file," Pixels per second: %s\n",format);
1071 (void) FormatLocaleFile(file," User time: %0.3fu\n",user_time);
1072 (void) FormatLocaleFile(file," Elapsed time: %lu:%02lu.%03lu\n",
1073 (unsigned long) (elapsed_time/60.0),(unsigned long) ceil(fmod(elapsed_time,
1074 60.0)),(unsigned long) (1000.0*(elapsed_time-floor(elapsed_time))));
1075 (void) FormatLocaleFile(file," Version: %s\n",GetMagickVersion((size_t *)
1077 (void) fflush(file);
1078 return(ferror(file) != 0 ? MagickFalse : MagickTrue);