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-2014 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/token.h"
95 #include "MagickCore/utility.h"
96 #include "MagickCore/utility-private.h"
97 #include "MagickCore/version.h"
100 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
104 % I d e n t i f y I m a g e %
108 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
110 % IdentifyImage() identifies an image by printing its attributes to the file.
111 % Attributes include the image width, height, size, and others.
113 % The format of the IdentifyImage method is:
115 % MagickBooleanType IdentifyImage(Image *image,FILE *file,
116 % const MagickBooleanType verbose,ExceptionInfo *exception)
118 % A description of each parameter follows:
120 % o image: the image.
122 % o file: the file, typically stdout.
124 % o verbose: A value other than zero prints more detailed information
127 % o exception: return any errors or warnings in this structure.
131 static ChannelStatistics *GetLocationStatistics(const Image *image,
132 const StatisticType type,ExceptionInfo *exception)
143 assert(image != (Image *) NULL);
144 assert(image->signature == MagickSignature);
145 if (image->debug != MagickFalse)
146 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
147 channel_statistics=(ChannelStatistics *) AcquireQuantumMemory(
148 MaxPixelChannels+1,sizeof(*channel_statistics));
149 if (channel_statistics == (ChannelStatistics *) NULL)
150 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
151 (void) ResetMagickMemory(channel_statistics,0,(MaxPixelChannels+1)*
152 sizeof(*channel_statistics));
153 for (i=0; i <= (ssize_t) MaxPixelChannels; i++)
157 case MaximumStatistic:
160 channel_statistics[i].maxima=(-MagickHuge);
163 case MinimumStatistic:
165 channel_statistics[i].minima=MagickHuge;
170 for (y=0; y < (ssize_t) image->rows; y++)
172 register const Quantum
178 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
179 if (p == (const Quantum *) NULL)
181 for (x=0; x < (ssize_t) image->columns; x++)
186 if (GetPixelReadMask(image,p) == 0)
188 p+=GetPixelChannels(image);
191 for (i=0; i < (ssize_t) GetPixelChannels(image); i++)
193 PixelChannel channel=GetPixelChannelChannel(image,i);
194 PixelTrait traits=GetPixelChannelTraits(image,channel);
195 if (traits == UndefinedPixelTrait)
199 case MaximumStatistic:
202 if ((double) p[i] > channel_statistics[channel].maxima)
203 channel_statistics[channel].maxima=(double) p[i];
206 case MinimumStatistic:
208 if ((double) p[i] < channel_statistics[channel].minima)
209 channel_statistics[channel].minima=(double) p[i];
214 p+=GetPixelChannels(image);
217 return(channel_statistics);
220 static ssize_t PrintChannelFeatures(FILE *file,const PixelChannel channel,
221 const char *name,const ChannelFeatures *channel_features)
223 #define PrintFeature(feature) \
224 GetMagickPrecision(),(feature)[0], \
225 GetMagickPrecision(),(feature)[1], \
226 GetMagickPrecision(),(feature)[2], \
227 GetMagickPrecision(),(feature)[3], \
228 GetMagickPrecision(),((feature)[0]+(feature)[1]+(feature)[2]+(feature)[3])/4.0 \
230 #define FeaturesFormat " %s:\n" \
231 " Angular Second Moment:\n" \
232 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
234 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
236 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
237 " Sum of Squares Variance:\n" \
238 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
239 " Inverse Difference Moment:\n" \
240 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
242 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
244 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
246 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
248 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
249 " Difference Variance:\n" \
250 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
251 " Difference Entropy:\n" \
252 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
253 " Information Measure of Correlation 1:\n" \
254 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
255 " Information Measure of Correlation 2:\n" \
256 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
257 " Maximum Correlation Coefficient:\n" \
258 " %.*g, %.*g, %.*g, %.*g, %.*g\n"
263 n=FormatLocaleFile(file,FeaturesFormat,name,
264 PrintFeature(channel_features[channel].angular_second_moment),
265 PrintFeature(channel_features[channel].contrast),
266 PrintFeature(channel_features[channel].correlation),
267 PrintFeature(channel_features[channel].variance_sum_of_squares),
268 PrintFeature(channel_features[channel].inverse_difference_moment),
269 PrintFeature(channel_features[channel].sum_average),
270 PrintFeature(channel_features[channel].sum_variance),
271 PrintFeature(channel_features[channel].sum_entropy),
272 PrintFeature(channel_features[channel].entropy),
273 PrintFeature(channel_features[channel].difference_variance),
274 PrintFeature(channel_features[channel].difference_entropy),
275 PrintFeature(channel_features[channel].measure_of_correlation_1),
276 PrintFeature(channel_features[channel].measure_of_correlation_2),
277 PrintFeature(channel_features[channel].maximum_correlation_coefficient));
281 static ssize_t PrintChannelLocations(FILE *file,const Image *image,
282 const PixelChannel channel,const char *name,const StatisticType type,
283 const size_t max_locations,const ChannelStatistics *channel_statistics)
297 case MaximumStatistic:
300 target=channel_statistics[channel].maxima;
303 case MinimumStatistic:
305 target=channel_statistics[channel].minima;
309 (void) FormatLocaleFile(file," %s: %.*g (%.*g)",name,GetMagickPrecision(),
310 target,GetMagickPrecision(),QuantumScale*target);
311 exception=AcquireExceptionInfo();
313 for (y=0; y < (ssize_t) image->rows; y++)
315 register const Quantum
322 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
323 if (p == (const Quantum *) NULL)
325 for (x=0; x < (ssize_t) image->columns; x++)
330 PixelTrait traits=GetPixelChannelTraits(image,channel);
331 if (traits == UndefinedPixelTrait)
333 offset=GetPixelChannelOffset(image,channel);
334 match=fabs((double) p[offset]-target) < 0.5 ? MagickTrue : MagickFalse;
335 if (match != MagickFalse)
337 if ((max_locations != 0) && (n >= (ssize_t) max_locations))
339 (void) FormatLocaleFile(file," %.20g,%.20g",(double) x,(double) y);
342 p+=GetPixelChannels(image);
344 if (x < (ssize_t) image->columns)
347 (void) FormatLocaleFile(file,"\n");
351 static ssize_t PrintChannelMoments(FILE *file,const PixelChannel channel,
352 const char *name,const ChannelMoments *channel_moments)
360 n=FormatLocaleFile(file," %s:\n",name);
361 n+=FormatLocaleFile(file," Centroid: %.*g,%.*g\n",
362 GetMagickPrecision(),channel_moments[channel].centroid.x,
363 GetMagickPrecision(),channel_moments[channel].centroid.y);
364 n+=FormatLocaleFile(file," Ellipse Semi-Major/Minor axis: %.*g,%.*g\n",
365 GetMagickPrecision(),channel_moments[channel].ellipse_axis.x,
366 GetMagickPrecision(),channel_moments[channel].ellipse_axis.y);
367 n+=FormatLocaleFile(file," Ellipse angle: %.*g\n",
368 GetMagickPrecision(),channel_moments[channel].ellipse_angle);
369 n+=FormatLocaleFile(file," Ellipse eccentricity: %.*g\n",
370 GetMagickPrecision(),channel_moments[channel].ellipse_eccentricity);
371 n+=FormatLocaleFile(file," Ellipse intensity: %.*g\n",
372 GetMagickPrecision(),channel_moments[channel].ellipse_intensity);
373 for (i=0; i < 8; i++)
374 n+=FormatLocaleFile(file," I%.20g: %.*g\n",i+1.0,GetMagickPrecision(),
375 channel_moments[channel].I[i]);
379 static ssize_t PrintChannelStatistics(FILE *file,const PixelChannel channel,
380 const char *name,const double scale,
381 const ChannelStatistics *channel_statistics)
383 #define StatisticsFormat " %s:\n min: " QuantumFormat \
384 " (%g)\n max: " QuantumFormat " (%g)\n" \
385 " mean: %g (%g)\n standard deviation: %g (%g)\n" \
386 " kurtosis: %g\n skewness: %g\n"
391 n=FormatLocaleFile(file,StatisticsFormat,name,ClampToQuantum(scale*
392 channel_statistics[channel].minima),channel_statistics[channel].minima/
393 (double) QuantumRange,ClampToQuantum(scale*
394 channel_statistics[channel].maxima),channel_statistics[channel].maxima/
395 (double) QuantumRange,scale*channel_statistics[channel].mean,
396 channel_statistics[channel].mean/(double) QuantumRange,scale*
397 channel_statistics[channel].standard_deviation,
398 channel_statistics[channel].standard_deviation/(double) QuantumRange,
399 channel_statistics[channel].kurtosis,channel_statistics[channel].skewness);
403 MagickExport MagickBooleanType IdentifyImage(Image *image,FILE *file,
404 const MagickBooleanType verbose,ExceptionInfo *exception)
407 color[MaxTextExtent],
408 format[MaxTextExtent],
444 register const Quantum
458 assert(image != (Image *) NULL);
459 assert(image->signature == MagickSignature);
460 if (image->debug != MagickFalse)
461 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
462 if (file == (FILE *) NULL)
465 elapsed_time=GetElapsedTime(&image->timer);
466 user_time=GetUserTime(&image->timer);
467 GetTimerInfo(&image->timer);
468 if (verbose == MagickFalse)
471 Display summary info about the image.
473 if (*image->magick_filename != '\0')
474 if (LocaleCompare(image->magick_filename,image->filename) != 0)
475 (void) FormatLocaleFile(file,"%s=>",image->magick_filename);
476 if ((GetPreviousImageInList(image) == (Image *) NULL) &&
477 (GetNextImageInList(image) == (Image *) NULL) &&
479 (void) FormatLocaleFile(file,"%s ",image->filename);
481 (void) FormatLocaleFile(file,"%s[%.20g] ",image->filename,(double)
483 (void) FormatLocaleFile(file,"%s ",image->magick);
484 if ((image->magick_columns != 0) || (image->magick_rows != 0))
485 if ((image->magick_columns != image->columns) ||
486 (image->magick_rows != image->rows))
487 (void) FormatLocaleFile(file,"%.20gx%.20g=>",(double)
488 image->magick_columns,(double) image->magick_rows);
489 (void) FormatLocaleFile(file,"%.20gx%.20g ",(double) image->columns,
490 (double) image->rows);
491 if ((image->page.width != 0) || (image->page.height != 0) ||
492 (image->page.x != 0) || (image->page.y != 0))
493 (void) FormatLocaleFile(file,"%.20gx%.20g%+.20g%+.20g ",(double)
494 image->page.width,(double) image->page.height,(double) image->page.x,
495 (double) image->page.y);
496 (void) FormatLocaleFile(file,"%.20g-bit ",(double) image->depth);
497 if (image->type != UndefinedType)
498 (void) FormatLocaleFile(file,"%s ",CommandOptionToMnemonic(
499 MagickTypeOptions,(ssize_t) image->type));
500 if (image->colorspace != UndefinedColorspace)
501 (void) FormatLocaleFile(file,"%s ",CommandOptionToMnemonic(
502 MagickColorspaceOptions,(ssize_t) image->colorspace));
503 if (image->storage_class == DirectClass)
505 if (image->total_colors != 0)
507 (void) FormatMagickSize(image->total_colors,MagickFalse,format);
508 (void) FormatLocaleFile(file,"%s ",format);
512 if (image->total_colors <= image->colors)
513 (void) FormatLocaleFile(file,"%.20gc ",(double)
516 (void) FormatLocaleFile(file,"%.20g=>%.20gc ",(double)
517 image->total_colors,(double) image->colors);
518 if (image->error.mean_error_per_pixel != 0.0)
519 (void) FormatLocaleFile(file,"%.20g/%f/%fdb ",(double)
520 (image->error.mean_error_per_pixel+0.5),
521 image->error.normalized_mean_error,
522 image->error.normalized_maximum_error);
523 if (GetBlobSize(image) != 0)
525 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
526 (void) FormatLocaleFile(file,"%s ",format);
528 (void) FormatLocaleFile(file,"%0.3fu %lu:%02lu.%03lu",user_time,
529 (unsigned long) (elapsed_time/60.0),(unsigned long) floor(fmod(
530 elapsed_time,60.0)),(unsigned long) (1000.0*(elapsed_time-
531 floor(elapsed_time))));
532 (void) FormatLocaleFile(file,"\n");
534 return(ferror(file) != 0 ? MagickFalse : MagickTrue);
537 Display verbose info about the image.
539 p=GetVirtualPixels(image,0,0,1,1,exception);
540 ping=p == (const Quantum *) NULL ? MagickTrue : MagickFalse;
541 type=GetImageType(image,exception);
542 (void) SignatureImage(image,exception);
543 (void) FormatLocaleFile(file,"Image: %s\n",image->filename);
544 if (*image->magick_filename != '\0')
545 if (LocaleCompare(image->magick_filename,image->filename) != 0)
548 filename[MaxTextExtent];
550 GetPathComponent(image->magick_filename,TailPath,filename);
551 (void) FormatLocaleFile(file," Base filename: %s\n",filename);
553 magick_info=GetMagickInfo(image->magick,exception);
554 if ((magick_info == (const MagickInfo *) NULL) ||
555 (GetMagickDescription(magick_info) == (const char *) NULL))
556 (void) FormatLocaleFile(file," Format: %s\n",image->magick);
558 (void) FormatLocaleFile(file," Format: %s (%s)\n",image->magick,
559 GetMagickDescription(magick_info));
560 if ((magick_info == (const MagickInfo *) NULL) ||
561 (GetMagickMimeType(magick_info) != (const char *) NULL))
562 (void) FormatLocaleFile(file," Mime type: %s\n",GetMagickMimeType(
564 (void) FormatLocaleFile(file," Class: %s\n",CommandOptionToMnemonic(
565 MagickClassOptions,(ssize_t) image->storage_class));
566 (void) FormatLocaleFile(file," Geometry: %.20gx%.20g%+.20g%+.20g\n",(double)
567 image->columns,(double) image->rows,(double) image->tile_offset.x,(double)
568 image->tile_offset.y);
569 if ((image->magick_columns != 0) || (image->magick_rows != 0))
570 if ((image->magick_columns != image->columns) ||
571 (image->magick_rows != image->rows))
572 (void) FormatLocaleFile(file," Base geometry: %.20gx%.20g\n",(double)
573 image->magick_columns,(double) image->magick_rows);
574 if ((image->resolution.x != 0.0) && (image->resolution.y != 0.0))
576 (void) FormatLocaleFile(file," Resolution: %gx%g\n",image->resolution.x,
577 image->resolution.y);
578 (void) FormatLocaleFile(file," Print size: %gx%g\n",(double)
579 image->columns/image->resolution.x,(double) image->rows/
580 image->resolution.y);
582 (void) FormatLocaleFile(file," Units: %s\n",CommandOptionToMnemonic(
583 MagickResolutionOptions,(ssize_t) image->units));
584 (void) FormatLocaleFile(file," Type: %s\n",CommandOptionToMnemonic(
585 MagickTypeOptions,(ssize_t) type));
586 if (image->type != UndefinedType)
587 (void) FormatLocaleFile(file," Base type: %s\n",CommandOptionToMnemonic(
588 MagickTypeOptions,(ssize_t) image->type));
589 (void) FormatLocaleFile(file," Endianess: %s\n",CommandOptionToMnemonic(
590 MagickEndianOptions,(ssize_t) image->endian));
591 locate=GetImageArtifact(image,"identify:locate");
592 if (locate != (const char *) NULL)
604 Display minimum, maximum, or mean pixel locations.
606 type=(StatisticType) ParseCommandOption(MagickStatisticOptions,
608 limit=GetImageArtifact(image,"identify:limit");
610 if (limit != (const char *) NULL)
611 max_locations=StringToUnsignedLong(limit);
612 channel_statistics=GetLocationStatistics(image,type,exception);
613 if (channel_statistics == (ChannelStatistics *) NULL)
615 colorspace=image->colorspace;
616 if (IsImageGray(image,exception) != MagickFalse)
617 colorspace=GRAYColorspace;
618 (void) FormatLocaleFile(file,"Channel %s locations:\n",locate);
624 (void) PrintChannelLocations(file,image,RedPixelChannel,"Red",
625 type,max_locations,channel_statistics);
626 (void) PrintChannelLocations(file,image,GreenPixelChannel,"Green",
627 type,max_locations,channel_statistics);
628 (void) PrintChannelLocations(file,image,BluePixelChannel,"Blue",
629 type,max_locations,channel_statistics);
634 (void) PrintChannelLocations(file,image,CyanPixelChannel,"Cyan",
635 type,max_locations,channel_statistics);
636 (void) PrintChannelLocations(file,image,MagentaPixelChannel,"Magenta",
637 type,max_locations,channel_statistics);
638 (void) PrintChannelLocations(file,image,YellowPixelChannel,"Yellow",
639 type,max_locations,channel_statistics);
640 (void) PrintChannelLocations(file,image,BlackPixelChannel,"Black",
641 type,max_locations,channel_statistics);
646 (void) PrintChannelLocations(file,image,GrayPixelChannel,"Gray",
647 type,max_locations,channel_statistics);
651 if (image->alpha_trait == BlendPixelTrait)
652 (void) PrintChannelLocations(file,image,AlphaPixelChannel,"Alpha",
653 type,max_locations,channel_statistics);
654 channel_statistics=(ChannelStatistics *) RelinquishMagickMemory(
658 Detail channel depth and extrema.
660 (void) FormatLocaleFile(file," Colorspace: %s\n",CommandOptionToMnemonic(
661 MagickColorspaceOptions,(ssize_t) image->colorspace));
662 channel_statistics=(ChannelStatistics *) NULL;
663 channel_moments=(ChannelMoments *) NULL;
664 channel_features=(ChannelFeatures *) NULL;
665 colorspace=image->colorspace;
667 if (ping == MagickFalse)
672 channel_statistics=GetImageStatistics(image,exception);
673 if (channel_statistics == (ChannelStatistics *) NULL)
675 artifact=GetImageArtifact(image,"identify:moments");
676 if (artifact != (const char *) NULL)
677 channel_moments=GetImageMoments(image,exception);
678 artifact=GetImageArtifact(image,"identify:features");
679 if (artifact != (const char *) NULL)
681 distance=StringToUnsignedLong(artifact);
682 channel_features=GetImageFeatures(image,distance,exception);
684 depth=GetImageDepth(image,exception);
685 if (image->depth == depth)
686 (void) FormatLocaleFile(file," Depth: %.20g-bit\n",(double)
689 (void) FormatLocaleFile(file," Depth: %.20g/%.20g-bit\n",(double)
690 image->depth,(double) depth);
691 (void) FormatLocaleFile(file," Channel depth:\n");
692 if (IsImageGray(image,exception) != MagickFalse)
693 colorspace=GRAYColorspace;
699 (void) FormatLocaleFile(file," Red: %.20g-bit\n",(double)
700 channel_statistics[RedPixelChannel].depth);
701 (void) FormatLocaleFile(file," Green: %.20g-bit\n",(double)
702 channel_statistics[GreenPixelChannel].depth);
703 (void) FormatLocaleFile(file," Blue: %.20g-bit\n",(double)
704 channel_statistics[BluePixelChannel].depth);
709 (void) FormatLocaleFile(file," Cyan: %.20g-bit\n",(double)
710 channel_statistics[CyanPixelChannel].depth);
711 (void) FormatLocaleFile(file," Magenta: %.20g-bit\n",(double)
712 channel_statistics[MagentaPixelChannel].depth);
713 (void) FormatLocaleFile(file," Yellow: %.20g-bit\n",(double)
714 channel_statistics[YellowPixelChannel].depth);
715 (void) FormatLocaleFile(file," Black: %.20g-bit\n",(double)
716 channel_statistics[BlackPixelChannel].depth);
721 (void) FormatLocaleFile(file," Gray: %.20g-bit\n",(double)
722 channel_statistics[GrayPixelChannel].depth);
726 if (image->alpha_trait == BlendPixelTrait)
727 (void) FormatLocaleFile(file," alpha: %.20g-bit\n",(double)
728 channel_statistics[AlphaPixelChannel].depth);
730 if (image->depth <= MAGICKCORE_QUANTUM_DEPTH)
731 scale=QuantumRange/((size_t) QuantumRange >> ((size_t)
732 MAGICKCORE_QUANTUM_DEPTH-image->depth));
734 if (channel_statistics != (ChannelStatistics *) NULL)
736 (void) FormatLocaleFile(file," Channel statistics:\n");
737 (void) FormatLocaleFile(file," Pixels: %.20g\n",
738 channel_statistics[CompositePixelChannel].area);
744 (void) PrintChannelStatistics(file,RedPixelChannel,"Red",1.0/
745 scale,channel_statistics);
746 (void) PrintChannelStatistics(file,GreenPixelChannel,"Green",1.0/
747 scale,channel_statistics);
748 (void) PrintChannelStatistics(file,BluePixelChannel,"Blue",1.0/
749 scale,channel_statistics);
754 (void) PrintChannelStatistics(file,CyanPixelChannel,"Cyan",1.0/
755 scale,channel_statistics);
756 (void) PrintChannelStatistics(file,MagentaPixelChannel,"Magenta",1.0/
757 scale,channel_statistics);
758 (void) PrintChannelStatistics(file,YellowPixelChannel,"Yellow",1.0/
759 scale,channel_statistics);
760 (void) PrintChannelStatistics(file,BlackPixelChannel,"Black",1.0/
761 scale,channel_statistics);
766 (void) PrintChannelStatistics(file,GrayPixelChannel,"Gray",1.0/
767 scale,channel_statistics);
771 if (image->alpha_trait == BlendPixelTrait)
772 (void) PrintChannelStatistics(file,AlphaPixelChannel,"Alpha",1.0/
773 scale,channel_statistics);
774 if (colorspace != GRAYColorspace)
776 (void) FormatLocaleFile(file," Image statistics:\n");
777 (void) PrintChannelStatistics(file,(PixelChannel) MaxPixelChannels,
778 "Overall",1.0/scale,channel_statistics);
780 channel_statistics=(ChannelStatistics *) RelinquishMagickMemory(
783 if (channel_moments != (ChannelMoments *) NULL)
785 (void) FormatLocaleFile(file," Channel moments:\n");
791 (void) PrintChannelMoments(file,RedPixelChannel,"Red",
793 (void) PrintChannelMoments(file,GreenPixelChannel,"Green",
795 (void) PrintChannelMoments(file,BluePixelChannel,"Blue",
801 (void) PrintChannelMoments(file,CyanPixelChannel,"Cyan",
803 (void) PrintChannelMoments(file,MagentaPixelChannel,"Magenta",
805 (void) PrintChannelMoments(file,YellowPixelChannel,"Yellow",
807 (void) PrintChannelMoments(file,BlackPixelChannel,"Black",
813 (void) PrintChannelMoments(file,GrayPixelChannel,"Gray",
818 if (image->alpha_trait == BlendPixelTrait)
819 (void) PrintChannelMoments(file,AlphaPixelChannel,"Alpha",
821 if (colorspace != GRAYColorspace)
823 (void) FormatLocaleFile(file," Image moments:\n");
824 (void) PrintChannelMoments(file,(PixelChannel) MaxPixelChannels,
825 "Overall",channel_moments);
827 channel_moments=(ChannelMoments *) RelinquishMagickMemory(
830 if (channel_features != (ChannelFeatures *) NULL)
832 (void) FormatLocaleFile(file," Channel features (horizontal, vertical, "
833 "left and right diagonals, average):\n");
839 (void) PrintChannelFeatures(file,RedPixelChannel,"Red",
841 (void) PrintChannelFeatures(file,GreenPixelChannel,"Green",
843 (void) PrintChannelFeatures(file,BluePixelChannel,"Blue",
849 (void) PrintChannelFeatures(file,CyanPixelChannel,"Cyan",
851 (void) PrintChannelFeatures(file,MagentaPixelChannel,"Magenta",
853 (void) PrintChannelFeatures(file,YellowPixelChannel,"Yellow",
855 (void) PrintChannelFeatures(file,BlackPixelChannel,"Black",
861 (void) PrintChannelFeatures(file,GrayPixelChannel,"Gray",
866 if (image->alpha_trait == BlendPixelTrait)
867 (void) PrintChannelFeatures(file,AlphaPixelChannel,"Alpha",
869 channel_features=(ChannelFeatures *) RelinquishMagickMemory(
872 if (ping == MagickFalse)
874 if (image->colorspace == CMYKColorspace)
875 (void) FormatLocaleFile(file," Total ink density: %*g%%\n",
876 GetMagickPrecision(),100.0*GetImageTotalInkDensity(image,exception)/
877 (double) QuantumRange);
879 if (image->alpha_trait == BlendPixelTrait)
881 register const Quantum
884 p=(const Quantum *) NULL;
885 for (y=0; y < (ssize_t) image->rows; y++)
887 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
888 if (p == (const Quantum *) NULL)
890 for (x=0; x < (ssize_t) image->columns; x++)
892 if (GetPixelAlpha(image,p) == (Quantum) TransparentAlpha)
894 p+=GetPixelChannels(image);
896 if (x < (ssize_t) image->columns)
899 if ((x < (ssize_t) image->columns) || (y < (ssize_t) image->rows))
902 tuple[MaxTextExtent];
907 GetPixelInfo(image,&pixel);
908 GetPixelInfoPixel(image,p,&pixel);
909 (void) QueryColorname(image,&pixel,SVGCompliance,tuple,
911 (void) FormatLocaleFile(file," Alpha: %s ",tuple);
912 GetColorTuple(&pixel,MagickTrue,tuple);
913 (void) FormatLocaleFile(file," %s\n",tuple);
916 if (IsHistogramImage(image,exception) != MagickFalse)
918 (void) FormatLocaleFile(file," Colors: %.20g\n",(double)
919 GetNumberColors(image,(FILE *) NULL,exception));
920 (void) FormatLocaleFile(file," Histogram:\n");
921 (void) GetNumberColors(image,file,exception);
925 artifact=GetImageArtifact(image,"identify:unique-colors");
926 if (IfMagickTrue(IsStringTrue(artifact)))
927 (void) FormatLocaleFile(file," Colors: %.20g\n",(double)
928 GetNumberColors(image,(FILE *) NULL,exception));
931 if (image->storage_class == PseudoClass)
933 (void) FormatLocaleFile(file," Colormap entries: %.20g\n",(double)
935 (void) FormatLocaleFile(file," Colormap:\n");
936 if (image->colors <= 1024)
939 color[MaxTextExtent],
941 tuple[MaxTextExtent];
949 GetPixelInfo(image,&pixel);
951 for (i=0; i < (ssize_t) image->colors; i++)
954 (void) CopyMagickString(tuple,"(",MaxTextExtent);
955 ConcatenateColorComponent(&pixel,RedPixelChannel,X11Compliance,
957 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
958 ConcatenateColorComponent(&pixel,GreenPixelChannel,X11Compliance,
960 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
961 ConcatenateColorComponent(&pixel,BluePixelChannel,X11Compliance,
963 if (pixel.colorspace == CMYKColorspace)
965 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
966 ConcatenateColorComponent(&pixel,BlackPixelChannel,
967 X11Compliance,tuple);
969 if (pixel.alpha_trait == BlendPixelTrait)
971 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
972 ConcatenateColorComponent(&pixel,AlphaPixelChannel,
973 X11Compliance,tuple);
975 (void) ConcatenateMagickString(tuple,")",MaxTextExtent);
976 (void) QueryColorname(image,&pixel,SVGCompliance,color,
978 GetColorTuple(&pixel,MagickTrue,hex);
979 (void) FormatLocaleFile(file," %8ld: %s %s %s\n",(long) i,tuple,
985 if (image->error.mean_error_per_pixel != 0.0)
986 (void) FormatLocaleFile(file," Mean error per pixel: %g\n",
987 image->error.mean_error_per_pixel);
988 if (image->error.normalized_mean_error != 0.0)
989 (void) FormatLocaleFile(file," Normalized mean error: %g\n",
990 image->error.normalized_mean_error);
991 if (image->error.normalized_maximum_error != 0.0)
992 (void) FormatLocaleFile(file," Normalized maximum error: %g\n",
993 image->error.normalized_maximum_error);
994 (void) FormatLocaleFile(file," Rendering intent: %s\n",
995 CommandOptionToMnemonic(MagickIntentOptions,(ssize_t)
996 image->rendering_intent));
997 if (image->gamma != 0.0)
998 (void) FormatLocaleFile(file," Gamma: %g\n",image->gamma);
999 if ((image->chromaticity.red_primary.x != 0.0) ||
1000 (image->chromaticity.green_primary.x != 0.0) ||
1001 (image->chromaticity.blue_primary.x != 0.0) ||
1002 (image->chromaticity.white_point.x != 0.0))
1005 Display image chromaticity.
1007 (void) FormatLocaleFile(file," Chromaticity:\n");
1008 (void) FormatLocaleFile(file," red primary: (%g,%g)\n",
1009 image->chromaticity.red_primary.x,image->chromaticity.red_primary.y);
1010 (void) FormatLocaleFile(file," green primary: (%g,%g)\n",
1011 image->chromaticity.green_primary.x,
1012 image->chromaticity.green_primary.y);
1013 (void) FormatLocaleFile(file," blue primary: (%g,%g)\n",
1014 image->chromaticity.blue_primary.x,image->chromaticity.blue_primary.y);
1015 (void) FormatLocaleFile(file," white point: (%g,%g)\n",
1016 image->chromaticity.white_point.x,image->chromaticity.white_point.y);
1018 if ((image->extract_info.width*image->extract_info.height) != 0)
1019 (void) FormatLocaleFile(file," Tile geometry: %.20gx%.20g%+.20g%+.20g\n",
1020 (double) image->extract_info.width,(double) image->extract_info.height,
1021 (double) image->extract_info.x,(double) image->extract_info.y);
1022 (void) QueryColorname(image,&image->background_color,SVGCompliance,color,
1024 (void) FormatLocaleFile(file," Background color: %s\n",color);
1025 (void) QueryColorname(image,&image->border_color,SVGCompliance,color,
1027 (void) FormatLocaleFile(file," Border color: %s\n",color);
1028 (void) QueryColorname(image,&image->matte_color,SVGCompliance,color,
1030 (void) FormatLocaleFile(file," Matte color: %s\n",color);
1031 (void) QueryColorname(image,&image->transparent_color,SVGCompliance,color,
1033 (void) FormatLocaleFile(file," Transparent color: %s\n",color);
1034 (void) FormatLocaleFile(file," Interlace: %s\n",CommandOptionToMnemonic(
1035 MagickInterlaceOptions,(ssize_t) image->interlace));
1036 (void) FormatLocaleFile(file," Intensity: %s\n",CommandOptionToMnemonic(
1037 MagickPixelIntensityOptions,(ssize_t) image->intensity));
1038 (void) FormatLocaleFile(file," Compose: %s\n",CommandOptionToMnemonic(
1039 MagickComposeOptions,(ssize_t) image->compose));
1040 if ((image->page.width != 0) || (image->page.height != 0) ||
1041 (image->page.x != 0) || (image->page.y != 0))
1042 (void) FormatLocaleFile(file," Page geometry: %.20gx%.20g%+.20g%+.20g\n",
1043 (double) image->page.width,(double) image->page.height,(double)
1044 image->page.x,(double) image->page.y);
1045 if ((image->page.x != 0) || (image->page.y != 0))
1046 (void) FormatLocaleFile(file," Origin geometry: %+.20g%+.20g\n",(double)
1047 image->page.x,(double) image->page.y);
1048 (void) FormatLocaleFile(file," Dispose: %s\n",CommandOptionToMnemonic(
1049 MagickDisposeOptions,(ssize_t) image->dispose));
1050 if (image->delay != 0)
1051 (void) FormatLocaleFile(file," Delay: %.20gx%.20g\n",(double) image->delay,
1052 (double) image->ticks_per_second);
1053 if (image->iterations != 1)
1054 (void) FormatLocaleFile(file," Iterations: %.20g\n",(double)
1056 if (image->duration != 0)
1057 (void) FormatLocaleFile(file," Duration: %.20g\n",(double)
1059 if ((image->next != (Image *) NULL) || (image->previous != (Image *) NULL))
1060 (void) FormatLocaleFile(file," Scene: %.20g of %.20g\n",(double)
1061 image->scene,(double) GetImageListLength(image));
1063 if (image->scene != 0)
1064 (void) FormatLocaleFile(file," Scene: %.20g\n",(double) image->scene);
1065 (void) FormatLocaleFile(file," Compression: %s\n",CommandOptionToMnemonic(
1066 MagickCompressOptions,(ssize_t) image->compression));
1067 if (image->quality != UndefinedCompressionQuality)
1068 (void) FormatLocaleFile(file," Quality: %.20g\n",(double) image->quality);
1069 (void) FormatLocaleFile(file," Orientation: %s\n",CommandOptionToMnemonic(
1070 MagickOrientationOptions,(ssize_t) image->orientation));
1071 if (image->montage != (char *) NULL)
1072 (void) FormatLocaleFile(file," Montage: %s\n",image->montage);
1073 if (image->directory != (char *) NULL)
1089 Display visual image directory.
1091 image_info=AcquireImageInfo();
1092 (void) CloneString(&image_info->size,"64x64");
1093 (void) FormatLocaleFile(file," Directory:\n");
1094 for (p=image->directory; *p != '\0'; p++)
1097 while ((*q != '\n') && (*q != '\0'))
1099 (void) CopyMagickString(image_info->filename,p,(size_t) (q-p+1));
1101 (void) FormatLocaleFile(file," %s",image_info->filename);
1102 handler=SetWarningHandler((WarningHandler) NULL);
1103 tile=ReadImage(image_info,exception);
1104 (void) SetWarningHandler(handler);
1105 if (tile == (Image *) NULL)
1107 (void) FormatLocaleFile(file,"\n");
1110 (void) FormatLocaleFile(file," %.20gx%.20g %s\n",(double)
1111 tile->magick_columns,(double) tile->magick_rows,tile->magick);
1112 (void) SignatureImage(tile,exception);
1113 ResetImagePropertyIterator(tile);
1114 property=GetNextImageProperty(tile);
1115 while (property != (const char *) NULL)
1117 (void) FormatLocaleFile(file," %s:\n",property);
1118 value=GetImageProperty(tile,property,exception);
1119 if (value != (const char *) NULL)
1120 (void) FormatLocaleFile(file,"%s\n",value);
1121 property=GetNextImageProperty(tile);
1123 tile=DestroyImage(tile);
1125 image_info=DestroyImageInfo(image_info);
1127 (void) GetImageProperty(image,"exif:*",exception);
1128 (void) GetImageProperty(image,"icc:*",exception);
1129 (void) GetImageProperty(image,"iptc:*",exception);
1130 (void) GetImageProperty(image,"xmp:*",exception);
1131 ResetImagePropertyIterator(image);
1132 property=GetNextImageProperty(image);
1133 if (property != (const char *) NULL)
1136 Display image properties.
1138 (void) FormatLocaleFile(file," Properties:\n");
1139 while (property != (const char *) NULL)
1141 (void) FormatLocaleFile(file," %s: ",property);
1142 value=GetImageProperty(image,property,exception);
1143 if (value != (const char *) NULL)
1144 (void) FormatLocaleFile(file,"%s\n",value);
1145 property=GetNextImageProperty(image);
1148 (void) FormatLocaleString(key,MaxTextExtent,"8BIM:1999,2998:#1");
1149 value=GetImageProperty(image,key,exception);
1150 if (value != (const char *) NULL)
1153 Display clipping path.
1155 (void) FormatLocaleFile(file," Clipping path: ");
1156 if (strlen(value) > 80)
1157 (void) fputc('\n',file);
1158 (void) FormatLocaleFile(file,"%s\n",value);
1160 ResetImageProfileIterator(image);
1161 name=GetNextImageProfile(image);
1162 if (name != (char *) NULL)
1168 Identify image profiles.
1170 (void) FormatLocaleFile(file," Profiles:\n");
1171 while (name != (char *) NULL)
1173 profile=GetImageProfile(image,name);
1174 if (profile == (StringInfo *) NULL)
1176 (void) FormatLocaleFile(file," Profile-%s: %.20g bytes\n",name,
1177 (double) GetStringInfoLength(profile));
1178 if (LocaleCompare(name,"iptc") == 0)
1199 profile_length=GetStringInfoLength(profile);
1200 for (i=0; i < (ssize_t) profile_length; i+=(ssize_t) length)
1203 sentinel=GetStringInfoDatum(profile)[i++];
1204 if (sentinel != 0x1c)
1206 dataset=GetStringInfoDatum(profile)[i++];
1207 record=GetStringInfoDatum(profile)[i++];
1210 case 5: tag="Image Name"; break;
1211 case 7: tag="Edit Status"; break;
1212 case 10: tag="Priority"; break;
1213 case 15: tag="Category"; break;
1214 case 20: tag="Supplemental Category"; break;
1215 case 22: tag="Fixture Identifier"; break;
1216 case 25: tag="Keyword"; break;
1217 case 30: tag="Release Date"; break;
1218 case 35: tag="Release Time"; break;
1219 case 40: tag="Special Instructions"; break;
1220 case 45: tag="Reference Service"; break;
1221 case 47: tag="Reference Date"; break;
1222 case 50: tag="Reference Number"; break;
1223 case 55: tag="Created Date"; break;
1224 case 60: tag="Created Time"; break;
1225 case 65: tag="Originating Program"; break;
1226 case 70: tag="Program Version"; break;
1227 case 75: tag="Object Cycle"; break;
1228 case 80: tag="Byline"; break;
1229 case 85: tag="Byline Title"; break;
1230 case 90: tag="City"; break;
1231 case 95: tag="Province State"; break;
1232 case 100: tag="Country Code"; break;
1233 case 101: tag="Country"; break;
1234 case 103: tag="Original Transmission Reference"; break;
1235 case 105: tag="Headline"; break;
1236 case 110: tag="Credit"; break;
1237 case 115: tag="Src"; break;
1238 case 116: tag="Copyright String"; break;
1239 case 120: tag="Caption"; break;
1240 case 121: tag="Local Caption"; break;
1241 case 122: tag="Caption Writer"; break;
1242 case 200: tag="Custom Field 1"; break;
1243 case 201: tag="Custom Field 2"; break;
1244 case 202: tag="Custom Field 3"; break;
1245 case 203: tag="Custom Field 4"; break;
1246 case 204: tag="Custom Field 5"; break;
1247 case 205: tag="Custom Field 6"; break;
1248 case 206: tag="Custom Field 7"; break;
1249 case 207: tag="Custom Field 8"; break;
1250 case 208: tag="Custom Field 9"; break;
1251 case 209: tag="Custom Field 10"; break;
1252 case 210: tag="Custom Field 11"; break;
1253 case 211: tag="Custom Field 12"; break;
1254 case 212: tag="Custom Field 13"; break;
1255 case 213: tag="Custom Field 14"; break;
1256 case 214: tag="Custom Field 15"; break;
1257 case 215: tag="Custom Field 16"; break;
1258 case 216: tag="Custom Field 17"; break;
1259 case 217: tag="Custom Field 18"; break;
1260 case 218: tag="Custom Field 19"; break;
1261 case 219: tag="Custom Field 20"; break;
1262 default: tag="unknown"; break;
1264 (void) FormatLocaleFile(file," %s[%.20g,%.20g]: ",tag,
1265 (double) dataset,(double) record);
1266 length=(size_t) (GetStringInfoDatum(profile)[i++] << 8);
1267 length|=GetStringInfoDatum(profile)[i++];
1268 attribute=(char *) NULL;
1269 if (~length >= (MaxTextExtent-1))
1270 attribute=(char *) AcquireQuantumMemory(length+MaxTextExtent,
1271 sizeof(*attribute));
1272 if (attribute != (char *) NULL)
1274 (void) CopyMagickString(attribute,(char *)
1275 GetStringInfoDatum(profile)+i,length+1);
1276 attribute_list=StringToList(attribute);
1277 if (attribute_list != (char **) NULL)
1279 for (j=0; attribute_list[j] != (char *) NULL; j++)
1281 (void) fputs(attribute_list[j],file);
1282 (void) fputs("\n",file);
1283 attribute_list[j]=(char *) RelinquishMagickMemory(
1286 attribute_list=(char **) RelinquishMagickMemory(
1289 attribute=DestroyString(attribute);
1293 if (image->debug != MagickFalse)
1294 PrintStringInfo(file,name,profile);
1295 name=GetNextImageProfile(image);
1298 ResetImageArtifactIterator(image);
1299 artifact=GetNextImageArtifact(image);
1300 if (artifact != (const char *) NULL)
1303 Display image artifacts.
1305 (void) FormatLocaleFile(file," Artifacts:\n");
1306 while (artifact != (const char *) NULL)
1308 (void) FormatLocaleFile(file," %s: ",artifact);
1309 value=GetImageArtifact(image,artifact);
1310 if (value != (const char *) NULL)
1311 (void) FormatLocaleFile(file,"%s\n",value);
1312 artifact=GetNextImageArtifact(image);
1315 ResetImageRegistryIterator();
1316 registry=GetNextImageRegistry();
1317 if (registry != (const char *) NULL)
1320 Display image registry.
1322 (void) FormatLocaleFile(file," Registry:\n");
1323 while (registry != (const char *) NULL)
1325 (void) FormatLocaleFile(file," %s: ",registry);
1326 value=(const char *) GetImageRegistry(StringRegistryType,registry,
1328 if (value != (const char *) NULL)
1329 (void) FormatLocaleFile(file,"%s\n",value);
1330 registry=GetNextImageRegistry();
1333 (void) FormatLocaleFile(file," Tainted: %s\n",CommandOptionToMnemonic(
1334 MagickBooleanOptions,(ssize_t) image->taint));
1335 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
1336 (void) FormatLocaleFile(file," Filesize: %s\n",format);
1337 (void) FormatMagickSize((MagickSizeType) image->columns*image->rows,
1338 MagickFalse,format);
1339 if (strlen(format) > 1)
1340 format[strlen(format)-1]='\0';
1341 (void) FormatLocaleFile(file," Number pixels: %s\n",format);
1342 (void) FormatMagickSize((MagickSizeType) ((double) image->columns*image->rows/
1343 elapsed_time+0.5),MagickFalse,format);
1344 (void) FormatLocaleFile(file," Pixels per second: %s\n",format);
1345 (void) FormatLocaleFile(file," User time: %0.3fu\n",user_time);
1346 (void) FormatLocaleFile(file," Elapsed time: %lu:%02lu.%03lu\n",
1347 (unsigned long) (elapsed_time/60.0),(unsigned long) ceil(fmod(elapsed_time,
1348 60.0)),(unsigned long) (1000.0*(elapsed_time-floor(elapsed_time))));
1349 (void) FormatLocaleFile(file," Version: %s\n",GetMagickVersion((size_t *)
1351 (void) fflush(file);
1352 return(ferror(file) != 0 ? MagickFalse : MagickTrue);