]> granicus.if.org Git - imagemagick/blob - MagickCore/identify.c
(no commit message)
[imagemagick] / MagickCore / identify.c
1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 %                                                                             %
4 %                                                                             %
5 %                                                                             %
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              %
11 %                                                                             %
12 %                                                                             %
13 %               Identify an Image Format and Characteristics.                 %
14 %                                                                             %
15 %                           Software Design                                   %
16 %                             John Cristy                                     %
17 %                            September 1994                                   %
18 %                                                                             %
19 %                                                                             %
20 %  Copyright 1999-2013 ImageMagick Studio LLC, a non-profit organization      %
21 %  dedicated to making software imaging solutions freely available.           %
22 %                                                                             %
23 %  You may not use this file except in compliance with the License.  You may  %
24 %  obtain a copy of the License at                                            %
25 %                                                                             %
26 %    http://www.imagemagick.org/script/license.php                            %
27 %                                                                             %
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.                                             %
33 %                                                                             %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
35 %
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.
38 %
39 %
40 */
41 \f
42 /*
43   Include declarations.
44 */
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"
98 #if defined(MAGICKCORE_LCMS_DELEGATE)
99 #if defined(MAGICKCORE_HAVE_LCMS_LCMS2_H)
100 #include <lcms/lcms2.h>
101 #elif defined(MAGICKCORE_HAVE_LCMS2_H)
102 #include "lcms2.h"
103 #elif defined(MAGICKCORE_HAVE_LCMS_LCMS_H)
104 #include <lcms/lcms.h>
105 #else
106 #include "lcms.h"
107 #endif
108 #endif
109 \f
110 /*
111   Define declarations.
112 */
113 #if defined(MAGICKCORE_LCMS_DELEGATE)
114 #if defined(LCMS_VERSION) && (LCMS_VERSION < 2000)
115 #define cmsUInt32Number  DWORD
116 #endif
117 #endif
118 \f
119 /*
120 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121 %                                                                             %
122 %                                                                             %
123 %                                                                             %
124 %   I d e n t i f y I m a g e                                                 %
125 %                                                                             %
126 %                                                                             %
127 %                                                                             %
128 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
129 %
130 %  IdentifyImage() identifies an image by printing its attributes to the file.
131 %  Attributes include the image width, height, size, and others.
132 %
133 %  The format of the IdentifyImage method is:
134 %
135 %      MagickBooleanType IdentifyImage(Image *image,FILE *file,
136 %        const MagickBooleanType verbose,ExceptionInfo *exception)
137 %
138 %  A description of each parameter follows:
139 %
140 %    o image: the image.
141 %
142 %    o file: the file, typically stdout.
143 %
144 %    o verbose: A value other than zero prints more detailed information
145 %      about the image.
146 %
147 %    o exception: return any errors or warnings in this structure.
148 %
149 */
150
151 static ssize_t PrintChannelFeatures(FILE *file,const PixelChannel channel,
152   const char *name,const ChannelFeatures *channel_features)
153 {
154 #define PrintFeature(feature) \
155   GetMagickPrecision(),(feature)[0], \
156   GetMagickPrecision(),(feature)[1], \
157   GetMagickPrecision(),(feature)[2], \
158   GetMagickPrecision(),(feature)[3], \
159   GetMagickPrecision(),((feature)[0]+(feature)[1]+(feature)[2]+(feature)[3])/4.0 \
160
161 #define FeaturesFormat "    %s:\n" \
162   "      Angular Second Moment:\n" \
163   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
164   "      Contrast:\n" \
165   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
166   "      Correlation:\n" \
167   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
168   "      Sum of Squares: Variance:\n" \
169   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
170   "      Inverse Difference Moment:\n" \
171   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
172   "      Sum Average:\n" \
173   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
174   "      Sum Variance:\n" \
175   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
176   "      Sum Entropy:\n" \
177   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
178   "      Entropy:\n" \
179   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
180   "      Difference Variance:\n" \
181   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
182   "      Difference Entropy:\n" \
183   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
184   "      Information Measure of Correlation 1:\n" \
185   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
186   "      Information Measure of Correlation 2:\n" \
187   "        %.*g, %.*g, %.*g, %.*g, %.*g\n" \
188   "      Maximum Correlation Coefficient:\n" \
189   "        %.*g, %.*g, %.*g, %.*g, %.*g\n"
190
191   ssize_t
192     n;
193
194   n=FormatLocaleFile(file,FeaturesFormat,name,
195     PrintFeature(channel_features[channel].angular_second_moment),
196     PrintFeature(channel_features[channel].contrast),
197     PrintFeature(channel_features[channel].correlation),
198     PrintFeature(channel_features[channel].variance_sum_of_squares),
199     PrintFeature(channel_features[channel].inverse_difference_moment),
200     PrintFeature(channel_features[channel].sum_average),
201     PrintFeature(channel_features[channel].sum_variance),
202     PrintFeature(channel_features[channel].sum_entropy),
203     PrintFeature(channel_features[channel].entropy),
204     PrintFeature(channel_features[channel].difference_variance),
205     PrintFeature(channel_features[channel].difference_entropy),
206     PrintFeature(channel_features[channel].measure_of_correlation_1),
207     PrintFeature(channel_features[channel].measure_of_correlation_2),
208     PrintFeature(channel_features[channel].maximum_correlation_coefficient));
209   return(n);
210 }
211
212 static ssize_t PrintChannelStatistics(FILE *file,const PixelChannel channel,
213   const char *name,const double scale,
214   const ChannelStatistics *channel_statistics)
215 {
216 #define StatisticsFormat "    %s:\n      min: " QuantumFormat  \
217   " (%g)\n      max: " QuantumFormat " (%g)\n"  \
218   "      mean: %g (%g)\n      standard deviation: %g (%g)\n"  \
219   "      kurtosis: %g\n      skewness: %g\n"
220
221   ssize_t
222     n;
223
224   n=FormatLocaleFile(file,StatisticsFormat,name,ClampToQuantum(scale*
225     channel_statistics[channel].minima),channel_statistics[channel].minima/
226     (double) QuantumRange,ClampToQuantum(scale*
227     channel_statistics[channel].maxima),channel_statistics[channel].maxima/
228     (double) QuantumRange,scale*channel_statistics[channel].mean,
229     channel_statistics[channel].mean/(double) QuantumRange,scale*
230     channel_statistics[channel].standard_deviation,
231     channel_statistics[channel].standard_deviation/(double) QuantumRange,
232     channel_statistics[channel].kurtosis,channel_statistics[channel].skewness);
233   return(n);
234 }
235
236 MagickExport MagickBooleanType IdentifyImage(Image *image,FILE *file,
237   const MagickBooleanType verbose,ExceptionInfo *exception)
238 {
239   char
240     color[MaxTextExtent],
241     format[MaxTextExtent],
242     key[MaxTextExtent];
243
244   ChannelFeatures
245     *channel_features;
246
247   ChannelStatistics
248     *channel_statistics;
249
250   ColorspaceType
251     colorspace;
252
253   const char
254     *artifact,
255     *name,
256     *property,
257     *registry,
258     *value;
259
260   const MagickInfo
261     *magick_info;
262
263   double
264     elapsed_time,
265     user_time;
266
267   ImageType
268     type;
269
270   MagickBooleanType
271     ping;
272
273   register const Quantum
274     *p;
275
276   register ssize_t
277     i,
278     x;
279
280   size_t
281     distance,
282     scale;
283
284   ssize_t
285     y;
286
287   assert(image != (Image *) NULL);
288   assert(image->signature == MagickSignature);
289   if (image->debug != MagickFalse)
290     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
291   if (file == (FILE *) NULL)
292     file=stdout;
293   *format='\0';
294   elapsed_time=GetElapsedTime(&image->timer);
295   user_time=GetUserTime(&image->timer);
296   GetTimerInfo(&image->timer);
297   if (verbose == MagickFalse)
298     {
299       /*
300         Display summary info about the image.
301       */
302       if (*image->magick_filename != '\0')
303         if (LocaleCompare(image->magick_filename,image->filename) != 0)
304           (void) FormatLocaleFile(file,"%s=>",image->magick_filename);
305        if ((GetPreviousImageInList(image) == (Image *) NULL) &&
306            (GetNextImageInList(image) == (Image *) NULL) &&
307            (image->scene == 0))
308         (void) FormatLocaleFile(file,"%s ",image->filename);
309       else
310         (void) FormatLocaleFile(file,"%s[%.20g] ",image->filename,(double)
311           image->scene);
312       (void) FormatLocaleFile(file,"%s ",image->magick);
313       if ((image->magick_columns != 0) || (image->magick_rows != 0))
314         if ((image->magick_columns != image->columns) ||
315             (image->magick_rows != image->rows))
316           (void) FormatLocaleFile(file,"%.20gx%.20g=>",(double)
317             image->magick_columns,(double) image->magick_rows);
318       (void) FormatLocaleFile(file,"%.20gx%.20g ",(double) image->columns,
319         (double) image->rows);
320       if ((image->page.width != 0) || (image->page.height != 0) ||
321           (image->page.x != 0) || (image->page.y != 0))
322         (void) FormatLocaleFile(file,"%.20gx%.20g%+.20g%+.20g ",(double)
323           image->page.width,(double) image->page.height,(double) image->page.x,
324           (double) image->page.y);
325       (void) FormatLocaleFile(file,"%.20g-bit ",(double) image->depth);
326       if (image->type != UndefinedType)
327         (void) FormatLocaleFile(file,"%s ",CommandOptionToMnemonic(
328           MagickTypeOptions,(ssize_t) image->type));
329      if (image->colorspace != UndefinedColorspace)
330         (void) FormatLocaleFile(file,"%s ",CommandOptionToMnemonic(
331           MagickColorspaceOptions,(ssize_t) image->colorspace));
332       if (image->storage_class == DirectClass)
333         {
334           if (image->total_colors != 0)
335             {
336               (void) FormatMagickSize(image->total_colors,MagickFalse,format);
337               (void) FormatLocaleFile(file,"%s ",format);
338             }
339         }
340       else
341         if (image->total_colors <= image->colors)
342           (void) FormatLocaleFile(file,"%.20gc ",(double)
343             image->colors);
344         else
345           (void) FormatLocaleFile(file,"%.20g=>%.20gc ",(double)
346             image->total_colors,(double) image->colors);
347       if (image->error.mean_error_per_pixel != 0.0)
348         (void) FormatLocaleFile(file,"%.20g/%f/%fdb ",(double)
349           (image->error.mean_error_per_pixel+0.5),
350           image->error.normalized_mean_error,
351           image->error.normalized_maximum_error);
352       if (GetBlobSize(image) != 0)
353         {
354           (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
355           (void) FormatLocaleFile(file,"%s ",format);
356         }
357       (void) FormatLocaleFile(file,"%0.3fu %lu:%02lu.%03lu",user_time,
358         (unsigned long) (elapsed_time/60.0),(unsigned long) floor(fmod(
359         elapsed_time,60.0)),(unsigned long) (1000.0*(elapsed_time-
360         floor(elapsed_time))));
361       (void) FormatLocaleFile(file,"\n");
362       (void) fflush(file);
363       return(ferror(file) != 0 ? MagickFalse : MagickTrue);
364     }
365   /*
366     Display verbose info about the image.
367   */
368   p=GetVirtualPixels(image,0,0,1,1,exception);
369   ping=p == (const Quantum *) NULL ? MagickTrue : MagickFalse;
370   type=GetImageType(image,exception);
371   (void) SignatureImage(image,exception);
372   (void) FormatLocaleFile(file,"Image: %s\n",image->filename);
373   if (*image->magick_filename != '\0')
374     if (LocaleCompare(image->magick_filename,image->filename) != 0)
375       {
376         char
377           filename[MaxTextExtent];
378
379         GetPathComponent(image->magick_filename,TailPath,filename);
380         (void) FormatLocaleFile(file,"  Base filename: %s\n",filename);
381       }
382   magick_info=GetMagickInfo(image->magick,exception);
383   if ((magick_info == (const MagickInfo *) NULL) ||
384       (*GetMagickDescription(magick_info) == '\0'))
385     (void) FormatLocaleFile(file,"  Format: %s\n",image->magick);
386   else
387     (void) FormatLocaleFile(file,"  Format: %s (%s)\n",image->magick,
388       GetMagickDescription(magick_info));
389   (void) FormatLocaleFile(file,"  Class: %s\n",CommandOptionToMnemonic(
390     MagickClassOptions,(ssize_t) image->storage_class));
391   (void) FormatLocaleFile(file,"  Geometry: %.20gx%.20g%+.20g%+.20g\n",(double)
392     image->columns,(double) image->rows,(double) image->tile_offset.x,(double)
393     image->tile_offset.y);
394   if ((image->magick_columns != 0) || (image->magick_rows != 0))
395     if ((image->magick_columns != image->columns) ||
396         (image->magick_rows != image->rows))
397       (void) FormatLocaleFile(file,"  Base geometry: %.20gx%.20g\n",(double)
398         image->magick_columns,(double) image->magick_rows);
399   if ((image->resolution.x != 0.0) && (image->resolution.y != 0.0))
400     {
401       (void) FormatLocaleFile(file,"  Resolution: %gx%g\n",image->resolution.x,
402         image->resolution.y);
403       (void) FormatLocaleFile(file,"  Print size: %gx%g\n",(double)
404         image->columns/image->resolution.x,(double) image->rows/
405         image->resolution.y);
406     }
407   (void) FormatLocaleFile(file,"  Units: %s\n",CommandOptionToMnemonic(
408     MagickResolutionOptions,(ssize_t) image->units));
409   (void) FormatLocaleFile(file,"  Type: %s\n",CommandOptionToMnemonic(
410     MagickTypeOptions,(ssize_t) type));
411   if (image->type != UndefinedType)
412     (void) FormatLocaleFile(file,"  Base type: %s\n",CommandOptionToMnemonic(
413       MagickTypeOptions,(ssize_t) image->type));
414   (void) FormatLocaleFile(file,"  Endianess: %s\n",CommandOptionToMnemonic(
415     MagickEndianOptions,(ssize_t) image->endian));
416   /*
417     Detail channel depth and extrema.
418   */
419   (void) FormatLocaleFile(file,"  Colorspace: %s\n",CommandOptionToMnemonic(
420     MagickColorspaceOptions,(ssize_t) image->colorspace));
421   channel_statistics=(ChannelStatistics *) NULL;
422   channel_features=(ChannelFeatures *) NULL;
423   colorspace=image->colorspace;
424   scale=1;
425   if (ping == MagickFalse)
426     {
427       size_t
428         depth;
429
430       channel_statistics=GetImageStatistics(image,exception);
431       artifact=GetImageArtifact(image,"identify:features");
432       if (artifact != (const char *) NULL)
433         {
434           distance=StringToUnsignedLong(artifact);
435           channel_features=GetImageFeatures(image,distance,exception);
436         }
437       depth=GetImageDepth(image,exception);
438       if (image->depth == depth)
439         (void) FormatLocaleFile(file,"  Depth: %.20g-bit\n",(double)
440           image->depth);
441       else
442         (void) FormatLocaleFile(file,"  Depth: %.20g/%.20g-bit\n",(double)
443           image->depth,(double) depth);
444       (void) FormatLocaleFile(file,"  Channel depth:\n");
445       if (IsImageGray(image,exception) != MagickFalse)
446         colorspace=GRAYColorspace;
447       switch (colorspace)
448       {
449         case RGBColorspace:
450         default:
451         {
452           (void) FormatLocaleFile(file,"    red: %.20g-bit\n",(double)
453             channel_statistics[RedPixelChannel].depth);
454           (void) FormatLocaleFile(file,"    green: %.20g-bit\n",(double)
455             channel_statistics[GreenPixelChannel].depth);
456           (void) FormatLocaleFile(file,"    blue: %.20g-bit\n",(double)
457             channel_statistics[BluePixelChannel].depth);
458           break;
459         }
460         case CMYKColorspace:
461         {
462           (void) FormatLocaleFile(file,"    cyan: %.20g-bit\n",(double)
463             channel_statistics[CyanPixelChannel].depth);
464           (void) FormatLocaleFile(file,"    magenta: %.20g-bit\n",(double)
465             channel_statistics[MagentaPixelChannel].depth);
466           (void) FormatLocaleFile(file,"    yellow: %.20g-bit\n",(double)
467             channel_statistics[YellowPixelChannel].depth);
468           (void) FormatLocaleFile(file,"    black: %.20g-bit\n",(double)
469             channel_statistics[BlackPixelChannel].depth);
470           break;
471         }
472         case GRAYColorspace:
473         {
474           (void) FormatLocaleFile(file,"    gray: %.20g-bit\n",(double)
475             channel_statistics[GrayPixelChannel].depth);
476           break;
477         }
478       }
479       if (image->alpha_trait == BlendPixelTrait)
480         (void) FormatLocaleFile(file,"    alpha: %.20g-bit\n",(double)
481           channel_statistics[AlphaPixelChannel].depth);
482       scale=1;
483       if (image->depth <= MAGICKCORE_QUANTUM_DEPTH)
484         scale=QuantumRange/((size_t) QuantumRange >> ((size_t)
485           MAGICKCORE_QUANTUM_DEPTH-image->depth));
486     }
487   if (channel_statistics != (ChannelStatistics *) NULL)
488     {
489       (void) FormatLocaleFile(file,"  Channel statistics:\n");
490       switch (colorspace)
491       {
492         case RGBColorspace:
493         default:
494         {
495           (void) PrintChannelStatistics(file,RedPixelChannel,"Red",1.0/
496             scale,channel_statistics);
497           (void) PrintChannelStatistics(file,GreenPixelChannel,"Green",1.0/
498             scale,channel_statistics);
499           (void) PrintChannelStatistics(file,BluePixelChannel,"Blue",1.0/
500             scale,channel_statistics);
501           break;
502         }
503         case CMYKColorspace:
504         {
505           (void) PrintChannelStatistics(file,CyanPixelChannel,"Cyan",1.0/
506             scale,channel_statistics);
507           (void) PrintChannelStatistics(file,MagentaPixelChannel,"Magenta",1.0/
508             scale,channel_statistics);
509           (void) PrintChannelStatistics(file,YellowPixelChannel,"Yellow",1.0/
510             scale,channel_statistics);
511           (void) PrintChannelStatistics(file,BlackPixelChannel,"Black",1.0/
512             scale,channel_statistics);
513           break;
514         }
515         case GRAYColorspace:
516         {
517           (void) PrintChannelStatistics(file,GrayPixelChannel,"Gray",1.0/
518             scale,channel_statistics);
519           break;
520         }
521       }
522       if (image->alpha_trait == BlendPixelTrait)
523         (void) PrintChannelStatistics(file,AlphaPixelChannel,"Alpha",1.0/
524           scale,channel_statistics);
525       if (colorspace != GRAYColorspace)
526         {
527           (void) FormatLocaleFile(file,"  Image statistics:\n");
528           (void) PrintChannelStatistics(file,(PixelChannel) MaxPixelChannels,
529             "Overall",1.0/scale,channel_statistics);
530         }
531       channel_statistics=(ChannelStatistics *) RelinquishMagickMemory(
532         channel_statistics);
533     }
534   if (channel_features != (ChannelFeatures *) NULL)
535     {
536       (void) FormatLocaleFile(file,"  Channel features (horizontal, vertical, "
537         "left and right diagonals, average):\n");
538       switch (colorspace)
539       {
540         case RGBColorspace:
541         default:
542         {
543           (void) PrintChannelFeatures(file,RedPixelChannel,"Red",
544             channel_features);
545           (void) PrintChannelFeatures(file,GreenPixelChannel,"Green",
546             channel_features);
547           (void) PrintChannelFeatures(file,BluePixelChannel,"Blue",
548             channel_features);
549           break;
550         }
551         case CMYKColorspace:
552         {
553           (void) PrintChannelFeatures(file,CyanPixelChannel,"Cyan",
554             channel_features);
555           (void) PrintChannelFeatures(file,MagentaPixelChannel,"Magenta",
556             channel_features);
557           (void) PrintChannelFeatures(file,YellowPixelChannel,"Yellow",
558             channel_features);
559           (void) PrintChannelFeatures(file,BlackPixelChannel,"Black",
560             channel_features);
561           break;
562         }
563         case GRAYColorspace:
564         {
565           (void) PrintChannelFeatures(file,GrayPixelChannel,"Gray",
566             channel_features);
567           break;
568         }
569       }
570       if (image->alpha_trait == BlendPixelTrait)
571         (void) PrintChannelFeatures(file,AlphaPixelChannel,"Alpha",
572           channel_features);
573       channel_features=(ChannelFeatures *) RelinquishMagickMemory(
574         channel_features);
575     }
576   if (ping == MagickFalse)
577     {
578       if (image->colorspace == CMYKColorspace)
579         (void) FormatLocaleFile(file,"  Total ink density: %.0f%%\n",100.0*
580           GetImageTotalInkDensity(image,exception)/(double) QuantumRange);
581       x=0;
582       if (image->alpha_trait == BlendPixelTrait)
583         {
584           register const Quantum
585             *p;
586
587           p=(const Quantum *) NULL;
588           for (y=0; y < (ssize_t) image->rows; y++)
589           {
590             p=GetVirtualPixels(image,0,y,image->columns,1,exception);
591             if (p == (const Quantum *) NULL)
592               break;
593             for (x=0; x < (ssize_t) image->columns; x++)
594             {
595               if (GetPixelAlpha(image,p) == (Quantum) TransparentAlpha)
596                 break;
597               p+=GetPixelChannels(image);
598             }
599             if (x < (ssize_t) image->columns)
600               break;
601           }
602           if ((x < (ssize_t) image->columns) || (y < (ssize_t) image->rows))
603             {
604               char
605                 tuple[MaxTextExtent];
606
607               PixelInfo
608                 pixel;
609
610               GetPixelInfo(image,&pixel);
611               GetPixelInfoPixel(image,p,&pixel);
612               (void) QueryColorname(image,&pixel,SVGCompliance,tuple,
613                 exception);
614               (void) FormatLocaleFile(file,"  Alpha: %s ",tuple);
615               GetColorTuple(&pixel,MagickTrue,tuple);
616               (void) FormatLocaleFile(file,"  %s\n",tuple);
617             }
618         }
619       if (IsHistogramImage(image,exception) != MagickFalse)
620         {
621           (void) FormatLocaleFile(file,"  Colors: %.20g\n",(double)
622             GetNumberColors(image,(FILE *) NULL,exception));
623           (void) FormatLocaleFile(file,"  Histogram:\n");
624           (void) GetNumberColors(image,file,exception);
625         }
626       else
627         {
628           artifact=GetImageArtifact(image,"identify:unique-colors");
629           if (IfMagickTrue(IsStringTrue(artifact)))
630             (void) FormatLocaleFile(file,"  Colors: %.20g\n",(double)
631               GetNumberColors(image,(FILE *) NULL,exception));
632         }
633     }
634   if (image->storage_class == PseudoClass)
635     {
636       (void) FormatLocaleFile(file,"  Colormap entries: %.20g\n",(double)
637         image->colors);
638       (void) FormatLocaleFile(file,"  Colormap:\n");
639       if (image->colors <= 1024)
640         {
641           char
642             color[MaxTextExtent],
643             hex[MaxTextExtent],
644             tuple[MaxTextExtent];
645
646           PixelInfo
647             pixel;
648
649           register PixelInfo
650             *restrict p;
651
652           GetPixelInfo(image,&pixel);
653           p=image->colormap;
654           for (i=0; i < (ssize_t) image->colors; i++)
655           {
656             pixel=(*p);
657             (void) CopyMagickString(tuple,"(",MaxTextExtent);
658             ConcatenateColorComponent(&pixel,RedPixelChannel,X11Compliance,
659               tuple);
660             (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
661             ConcatenateColorComponent(&pixel,GreenPixelChannel,X11Compliance,
662               tuple);
663             (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
664             ConcatenateColorComponent(&pixel,BluePixelChannel,X11Compliance,
665               tuple);
666             if (pixel.colorspace == CMYKColorspace)
667               {
668                 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
669                 ConcatenateColorComponent(&pixel,BlackPixelChannel,
670                   X11Compliance,tuple);
671               }
672             if (pixel.alpha_trait == BlendPixelTrait)
673               {
674                 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
675                 ConcatenateColorComponent(&pixel,AlphaPixelChannel,
676                   X11Compliance,tuple);
677               }
678             (void) ConcatenateMagickString(tuple,")",MaxTextExtent);
679             (void) QueryColorname(image,&pixel,SVGCompliance,color,
680               exception);
681             GetColorTuple(&pixel,MagickTrue,hex);
682             (void) FormatLocaleFile(file,"  %8ld: %s %s %s\n",(long) i,tuple,
683               hex,color);
684             p++;
685           }
686         }
687     }
688   if (image->error.mean_error_per_pixel != 0.0)
689     (void) FormatLocaleFile(file,"  Mean error per pixel: %g\n",
690       image->error.mean_error_per_pixel);
691   if (image->error.normalized_mean_error != 0.0)
692     (void) FormatLocaleFile(file,"  Normalized mean error: %g\n",
693       image->error.normalized_mean_error);
694   if (image->error.normalized_maximum_error != 0.0)
695     (void) FormatLocaleFile(file,"  Normalized maximum error: %g\n",
696       image->error.normalized_maximum_error);
697   (void) FormatLocaleFile(file,"  Rendering intent: %s\n",
698     CommandOptionToMnemonic(MagickIntentOptions,(ssize_t)
699     image->rendering_intent));
700   if (image->gamma != 0.0)
701     (void) FormatLocaleFile(file,"  Gamma: %g\n",image->gamma);
702   if ((image->chromaticity.red_primary.x != 0.0) ||
703       (image->chromaticity.green_primary.x != 0.0) ||
704       (image->chromaticity.blue_primary.x != 0.0) ||
705       (image->chromaticity.white_point.x != 0.0))
706     {
707       /*
708         Display image chromaticity.
709       */
710       (void) FormatLocaleFile(file,"  Chromaticity:\n");
711       (void) FormatLocaleFile(file,"    red primary: (%g,%g)\n",
712         image->chromaticity.red_primary.x,image->chromaticity.red_primary.y);
713       (void) FormatLocaleFile(file,"    green primary: (%g,%g)\n",
714         image->chromaticity.green_primary.x,
715         image->chromaticity.green_primary.y);
716       (void) FormatLocaleFile(file,"    blue primary: (%g,%g)\n",
717         image->chromaticity.blue_primary.x,image->chromaticity.blue_primary.y);
718       (void) FormatLocaleFile(file,"    white point: (%g,%g)\n",
719         image->chromaticity.white_point.x,image->chromaticity.white_point.y);
720     }
721   if ((image->extract_info.width*image->extract_info.height) != 0)
722     (void) FormatLocaleFile(file,"  Tile geometry: %.20gx%.20g%+.20g%+.20g\n",
723       (double) image->extract_info.width,(double) image->extract_info.height,
724       (double) image->extract_info.x,(double) image->extract_info.y);
725   (void) FormatLocaleFile(file,"  Interlace: %s\n",CommandOptionToMnemonic(
726     MagickInterlaceOptions,(ssize_t) image->interlace));
727   (void) QueryColorname(image,&image->background_color,SVGCompliance,color,
728     exception);
729   (void) FormatLocaleFile(file,"  Background color: %s\n",color);
730   (void) QueryColorname(image,&image->border_color,SVGCompliance,color,
731     exception);
732   (void) FormatLocaleFile(file,"  Border color: %s\n",color);
733   (void) QueryColorname(image,&image->matte_color,SVGCompliance,color,
734     exception);
735   (void) FormatLocaleFile(file,"  Matte color: %s\n",color);
736   (void) QueryColorname(image,&image->transparent_color,SVGCompliance,color,
737     exception);
738   (void) FormatLocaleFile(file,"  Transparent color: %s\n",color);
739   (void) FormatLocaleFile(file,"  Compose: %s\n",CommandOptionToMnemonic(
740     MagickComposeOptions,(ssize_t) image->compose));
741   if ((image->page.width != 0) || (image->page.height != 0) ||
742       (image->page.x != 0) || (image->page.y != 0))
743     (void) FormatLocaleFile(file,"  Page geometry: %.20gx%.20g%+.20g%+.20g\n",
744       (double) image->page.width,(double) image->page.height,(double)
745       image->page.x,(double) image->page.y);
746   if ((image->page.x != 0) || (image->page.y != 0))
747     (void) FormatLocaleFile(file,"  Origin geometry: %+.20g%+.20g\n",(double)
748       image->page.x,(double) image->page.y);
749   (void) FormatLocaleFile(file,"  Dispose: %s\n",CommandOptionToMnemonic(
750     MagickDisposeOptions,(ssize_t) image->dispose));
751   if (image->delay != 0)
752     (void) FormatLocaleFile(file,"  Delay: %.20gx%.20g\n",(double) image->delay,
753       (double) image->ticks_per_second);
754   if (image->iterations != 1)
755     (void) FormatLocaleFile(file,"  Iterations: %.20g\n",(double)
756       image->iterations);
757   if ((image->next != (Image *) NULL) || (image->previous != (Image *) NULL))
758     (void) FormatLocaleFile(file,"  Scene: %.20g of %.20g\n",(double)
759       image->scene,(double) GetImageListLength(image));
760   else
761     if (image->scene != 0)
762       (void) FormatLocaleFile(file,"  Scene: %.20g\n",(double) image->scene);
763   (void) FormatLocaleFile(file,"  Compression: %s\n",CommandOptionToMnemonic(
764     MagickCompressOptions,(ssize_t) image->compression));
765   if (image->quality != UndefinedCompressionQuality)
766     (void) FormatLocaleFile(file,"  Quality: %.20g\n",(double) image->quality);
767   (void) FormatLocaleFile(file,"  Orientation: %s\n",CommandOptionToMnemonic(
768     MagickOrientationOptions,(ssize_t) image->orientation));
769   if (image->montage != (char *) NULL)
770     (void) FormatLocaleFile(file,"  Montage: %s\n",image->montage);
771   if (image->directory != (char *) NULL)
772     {
773       Image
774         *tile;
775
776       ImageInfo
777         *image_info;
778
779       register char
780         *p,
781         *q;
782
783       WarningHandler
784         handler;
785
786       /*
787         Display visual image directory.
788       */
789       image_info=AcquireImageInfo();
790       (void) CloneString(&image_info->size,"64x64");
791       (void) FormatLocaleFile(file,"  Directory:\n");
792       for (p=image->directory; *p != '\0'; p++)
793       {
794         q=p;
795         while ((*q != '\n') && (*q != '\0'))
796           q++;
797         (void) CopyMagickString(image_info->filename,p,(size_t) (q-p+1));
798         p=q;
799         (void) FormatLocaleFile(file,"    %s",image_info->filename);
800         handler=SetWarningHandler((WarningHandler) NULL);
801         tile=ReadImage(image_info,exception);
802         (void) SetWarningHandler(handler);
803         if (tile == (Image *) NULL)
804           {
805             (void) FormatLocaleFile(file,"\n");
806             continue;
807           }
808         (void) FormatLocaleFile(file," %.20gx%.20g %s\n",(double)
809           tile->magick_columns,(double) tile->magick_rows,tile->magick);
810         (void) SignatureImage(tile,exception);
811         ResetImagePropertyIterator(tile);
812         property=GetNextImageProperty(tile);
813         while (property != (const char *) NULL)
814         {
815           (void) FormatLocaleFile(file,"  %s:\n",property);
816           value=GetImageProperty(tile,property,exception);
817           if (value != (const char *) NULL)
818             (void) FormatLocaleFile(file,"%s\n",value);
819           property=GetNextImageProperty(tile);
820         }
821         tile=DestroyImage(tile);
822       }
823       image_info=DestroyImageInfo(image_info);
824     }
825   (void) GetImageProperty(image,"exif:*",exception);
826   ResetImagePropertyIterator(image);
827   property=GetNextImageProperty(image);
828   if (property != (const char *) NULL)
829     {
830       /*
831         Display image properties.
832       */
833       (void) FormatLocaleFile(file,"  Properties:\n");
834       while (property != (const char *) NULL)
835       {
836         (void) FormatLocaleFile(file,"    %s: ",property);
837         value=GetImageProperty(image,property,exception);
838         if (value != (const char *) NULL)
839           (void) FormatLocaleFile(file,"%s\n",value);
840         property=GetNextImageProperty(image);
841       }
842     }
843   (void) FormatLocaleString(key,MaxTextExtent,"8BIM:1999,2998:#1");
844   value=GetImageProperty(image,key,exception);
845   if (value != (const char *) NULL)
846     {
847       /*
848         Display clipping path.
849       */
850       (void) FormatLocaleFile(file,"  Clipping path: ");
851       if (strlen(value) > 80)
852         (void) fputc('\n',file);
853       (void) FormatLocaleFile(file,"%s\n",value);
854     }
855   ResetImageProfileIterator(image);
856   name=GetNextImageProfile(image);
857   if (name != (char *) NULL)
858     {
859       const StringInfo
860         *profile;
861
862       /*
863         Identify image profiles.
864       */
865       (void) FormatLocaleFile(file,"  Profiles:\n");
866       while (name != (char *) NULL)
867       {
868         profile=GetImageProfile(image,name);
869         if (profile == (StringInfo *) NULL)
870           continue;
871         (void) FormatLocaleFile(file,"    Profile-%s: %.20g bytes\n",name,
872           (double) GetStringInfoLength(profile));
873 #if defined(MAGICKCORE_LCMS_DELEGATE)
874         if ((LocaleCompare(name,"icc") == 0) ||
875             (LocaleCompare(name,"icm") == 0))
876           {
877             cmsHPROFILE
878               icc_profile;
879
880             icc_profile=cmsOpenProfileFromMem(GetStringInfoDatum(profile),
881               (cmsUInt32Number) GetStringInfoLength(profile));
882             if (icc_profile != (cmsHPROFILE *) NULL)
883               {
884 #if defined(LCMS_VERSION) && (LCMS_VERSION < 2000)
885                 const char
886                   *name;
887
888                 name=cmsTakeProductName(icc_profile);
889                 if (name != (const char *) NULL)
890                   (void) FormatLocaleFile(file,"      %s\n",name);
891 #else
892                 char
893                   info[MaxTextExtent];
894
895                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoDescription,
896                   "en","US",info,MaxTextExtent);
897                 (void) FormatLocaleFile(file,"      Description: %s\n",info);
898                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoManufacturer,
899                   "en","US",info,MaxTextExtent);
900                 (void) FormatLocaleFile(file,"      Manufacturer: %s\n",info);
901                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoModel,"en",
902                   "US",info,MaxTextExtent);
903                 (void) FormatLocaleFile(file,"      Model: %s\n",info);
904                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoCopyright,
905                   "en","US",info,MaxTextExtent);
906                 (void) FormatLocaleFile(file,"      Copyright: %s\n",info);
907 #endif
908                 (void) cmsCloseProfile(icc_profile);
909               }
910           }
911 #endif
912         if (LocaleCompare(name,"iptc") == 0)
913           {
914             char
915               *attribute,
916               **attribute_list;
917
918             const char
919               *tag;
920
921             long
922               dataset,
923               record,
924               sentinel;
925
926             register ssize_t
927               j;
928
929             size_t
930               length,
931               profile_length;
932
933             profile_length=GetStringInfoLength(profile);
934             for (i=0; i < (ssize_t) profile_length; i+=(ssize_t) length)
935             {
936               length=1;
937               sentinel=GetStringInfoDatum(profile)[i++];
938               if (sentinel != 0x1c)
939                 continue;
940               dataset=GetStringInfoDatum(profile)[i++];
941               record=GetStringInfoDatum(profile)[i++];
942               switch (record)
943               {
944                 case 5: tag="Image Name"; break;
945                 case 7: tag="Edit Status"; break;
946                 case 10: tag="Priority"; break;
947                 case 15: tag="Category"; break;
948                 case 20: tag="Supplemental Category"; break;
949                 case 22: tag="Fixture Identifier"; break;
950                 case 25: tag="Keyword"; break;
951                 case 30: tag="Release Date"; break;
952                 case 35: tag="Release Time"; break;
953                 case 40: tag="Special Instructions"; break;
954                 case 45: tag="Reference Service"; break;
955                 case 47: tag="Reference Date"; break;
956                 case 50: tag="Reference Number"; break;
957                 case 55: tag="Created Date"; break;
958                 case 60: tag="Created Time"; break;
959                 case 65: tag="Originating Program"; break;
960                 case 70: tag="Program Version"; break;
961                 case 75: tag="Object Cycle"; break;
962                 case 80: tag="Byline"; break;
963                 case 85: tag="Byline Title"; break;
964                 case 90: tag="City"; break;
965                 case 95: tag="Province State"; break;
966                 case 100: tag="Country Code"; break;
967                 case 101: tag="Country"; break;
968                 case 103: tag="Original Transmission Reference"; break;
969                 case 105: tag="Headline"; break;
970                 case 110: tag="Credit"; break;
971                 case 115: tag="Src"; break;
972                 case 116: tag="Copyright String"; break;
973                 case 120: tag="Caption"; break;
974                 case 121: tag="Local Caption"; break;
975                 case 122: tag="Caption Writer"; break;
976                 case 200: tag="Custom Field 1"; break;
977                 case 201: tag="Custom Field 2"; break;
978                 case 202: tag="Custom Field 3"; break;
979                 case 203: tag="Custom Field 4"; break;
980                 case 204: tag="Custom Field 5"; break;
981                 case 205: tag="Custom Field 6"; break;
982                 case 206: tag="Custom Field 7"; break;
983                 case 207: tag="Custom Field 8"; break;
984                 case 208: tag="Custom Field 9"; break;
985                 case 209: tag="Custom Field 10"; break;
986                 case 210: tag="Custom Field 11"; break;
987                 case 211: tag="Custom Field 12"; break;
988                 case 212: tag="Custom Field 13"; break;
989                 case 213: tag="Custom Field 14"; break;
990                 case 214: tag="Custom Field 15"; break;
991                 case 215: tag="Custom Field 16"; break;
992                 case 216: tag="Custom Field 17"; break;
993                 case 217: tag="Custom Field 18"; break;
994                 case 218: tag="Custom Field 19"; break;
995                 case 219: tag="Custom Field 20"; break;
996                 default: tag="unknown"; break;
997               }
998               (void) FormatLocaleFile(file,"      %s[%.20g,%.20g]: ",tag,
999                 (double) dataset,(double) record);
1000               length=(size_t) (GetStringInfoDatum(profile)[i++] << 8);
1001               length|=GetStringInfoDatum(profile)[i++];
1002               attribute=(char *) NULL;
1003               if (~length >= (MaxTextExtent-1))
1004                 attribute=(char *) AcquireQuantumMemory(length+MaxTextExtent,
1005                   sizeof(*attribute));
1006               if (attribute != (char *) NULL)
1007                 {
1008                   (void) CopyMagickString(attribute,(char *)
1009                     GetStringInfoDatum(profile)+i,length+1);
1010                   attribute_list=StringToList(attribute);
1011                   if (attribute_list != (char **) NULL)
1012                     {
1013                       for (j=0; attribute_list[j] != (char *) NULL; j++)
1014                       {
1015                         (void) fputs(attribute_list[j],file);
1016                         (void) fputs("\n",file);
1017                         attribute_list[j]=(char *) RelinquishMagickMemory(
1018                           attribute_list[j]);
1019                       }
1020                       attribute_list=(char **) RelinquishMagickMemory(
1021                         attribute_list);
1022                     }
1023                   attribute=DestroyString(attribute);
1024                 }
1025             }
1026           }
1027         if (image->debug != MagickFalse)
1028           PrintStringInfo(file,name,profile);
1029         name=GetNextImageProfile(image);
1030       }
1031     }
1032   ResetImageArtifactIterator(image);
1033   artifact=GetNextImageArtifact(image);
1034   if (artifact != (const char *) NULL)
1035     {
1036       /*
1037         Display image artifacts.
1038       */
1039       (void) FormatLocaleFile(file,"  Artifacts:\n");
1040       while (artifact != (const char *) NULL)
1041       {
1042         (void) FormatLocaleFile(file,"    %s: ",artifact);
1043         value=GetImageArtifact(image,artifact);
1044         if (value != (const char *) NULL)
1045           (void) FormatLocaleFile(file,"%s\n",value);
1046         artifact=GetNextImageArtifact(image);
1047       }
1048     }
1049   ResetImageRegistryIterator();
1050   registry=GetNextImageRegistry();
1051   if (registry != (const char *) NULL)
1052     {
1053       /*
1054         Display image registry.
1055       */
1056       (void) FormatLocaleFile(file,"  Registry:\n");
1057       while (registry != (const char *) NULL)
1058       {
1059         (void) FormatLocaleFile(file,"    %s: ",registry);
1060         value=(const char *) GetImageRegistry(StringRegistryType,registry,
1061           exception);
1062         if (value != (const char *) NULL)
1063           (void) FormatLocaleFile(file,"%s\n",value);
1064         registry=GetNextImageRegistry();
1065       }
1066     }
1067   (void) FormatLocaleFile(file,"  Tainted: %s\n",CommandOptionToMnemonic(
1068     MagickBooleanOptions,(ssize_t) image->taint));
1069   (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
1070   (void) FormatLocaleFile(file,"  Filesize: %s\n",format);
1071   (void) FormatMagickSize((MagickSizeType) image->columns*image->rows,
1072     MagickFalse,format);
1073   if (strlen(format) > 1)
1074     format[strlen(format)-1]='\0';
1075   (void) FormatLocaleFile(file,"  Number pixels: %s\n",format);
1076   (void) FormatMagickSize((MagickSizeType) ((double) image->columns*image->rows/
1077     elapsed_time+0.5),MagickFalse,format);
1078   (void) FormatLocaleFile(file,"  Pixels per second: %s\n",format);
1079   (void) FormatLocaleFile(file,"  User time: %0.3fu\n",user_time);
1080   (void) FormatLocaleFile(file,"  Elapsed time: %lu:%02lu.%03lu\n",
1081     (unsigned long) (elapsed_time/60.0),(unsigned long) ceil(fmod(elapsed_time,
1082     60.0)),(unsigned long) (1000.0*(elapsed_time-floor(elapsed_time))));
1083   (void) FormatLocaleFile(file,"  Version: %s\n",GetMagickVersion((size_t *)
1084     NULL));
1085   (void) fflush(file);
1086   return(ferror(file) != 0 ? MagickFalse : MagickTrue);
1087 }