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