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