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