granicus.if.org Git - imagemagick/blob - MagickCore/identify.c

   1 /*
   2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   3 %                                                                             %
   4 %                                                                             %
   5 %                                                                             %
   6 %           IIIII  DDDD   EEEEE  N   N  TTTTT  IIIII  FFFFF  Y   Y            %
   7 %             I    D   D  E      NN  N    T      I    F       Y Y             %
   8 %             I    D   D  EEE    N N N    T      I    FFF      Y              %
   9 %             I    D   D  E      N  NN    T      I    F        Y              %
  10 %           IIIII  DDDD   EEEEE  N   N    T    IIIII  F        Y              %
  11 %                                                                             %
  12 %                                                                             %
  13 %               Identify an Image Format and Characteristics.                 %
  14 %                                                                             %
  15 %                           Software Design                                   %
  16 %                             John Cristy                                     %
  17 %                            September 1994                                   %
  18 %                                                                             %
  19 %                                                                             %
  20 %  Copyright 1999-2008 ImageMagick Studio LLC, a non-profit organization      %
  21 %  dedicated to making software imaging solutions freely available.           %
  22 %                                                                             %
  23 %  You may not use this file except in compliance with the License.  You may  %
  24 %  obtain a copy of the License at                                            %
  25 %                                                                             %
  26 %    http://www.imagemagick.org/script/license.php                            %
  27 %                                                                             %
  28 %  Unless required by applicable law or agreed to in writing, software        %
  29 %  distributed under the License is distributed on an "AS IS" BASIS,          %
  30 %  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   %
  31 %  See the License for the specific language governing permissions and        %
  32 %  limitations under the License.                                             %
  33 %                                                                             %
  34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  35 %
  36 %  Identify describes the format and characteristics of one or more image
  37 %  files.  It will also report if an image is incomplete or corrupt.
  38 %
  39 %
  40 */
  41 \f
  42 /*
  43   Include declarations.
  44 */
  45 #include "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 \f
 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 \f
 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
 150 static ssize_t PrintChannelFeatures(FILE *file,const ChannelType 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
 211 static ssize_t PrintChannelStatistics(FILE *file,const ChannelType 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
 235 MagickExport 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->x_resolution != 0.0) && (image->y_resolution != 0.0))
 397     {
 398       (void) FormatLocaleFile(file,"  Resolution: %gx%g\n",image->x_resolution,
 399         image->y_resolution);
 400       (void) FormatLocaleFile(file,"  Print size: %gx%g\n",(double)
 401         image->columns/image->x_resolution,(double) image->rows/
 402         image->y_resolution);
 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[RedChannel].depth);
 450           (void) FormatLocaleFile(file,"    green: %.20g-bit\n",(double)
 451             channel_statistics[GreenChannel].depth);
 452           (void) FormatLocaleFile(file,"    blue: %.20g-bit\n",(double)
 453             channel_statistics[BlueChannel].depth);
 454           break;
 455         }
 456         case CMYKColorspace:
 457         {
 458           (void) FormatLocaleFile(file,"    cyan: %.20g-bit\n",(double)
 459             channel_statistics[CyanChannel].depth);
 460           (void) FormatLocaleFile(file,"    magenta: %.20g-bit\n",(double)
 461             channel_statistics[MagentaChannel].depth);
 462           (void) FormatLocaleFile(file,"    yellow: %.20g-bit\n",(double)
 463             channel_statistics[YellowChannel].depth);
 464           (void) FormatLocaleFile(file,"    black: %.20g-bit\n",(double)
 465             channel_statistics[BlackChannel].depth);
 466           break;
 467         }
 468         case GRAYColorspace:
 469         {
 470           (void) FormatLocaleFile(file,"    gray: %.20g-bit\n",(double)
 471             channel_statistics[GrayChannel].depth);
 472           break;
 473         }
 474       }
 475       if (image->matte != MagickFalse)
 476         (void) FormatLocaleFile(file,"    alpha: %.20g-bit\n",(double)
 477           channel_statistics[OpacityChannel].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,RedChannel,"Red",1.0/scale,
 492             channel_statistics);
 493           (void) PrintChannelStatistics(file,GreenChannel,"Green",1.0/scale,
 494             channel_statistics);
 495           (void) PrintChannelStatistics(file,BlueChannel,"Blue",1.0/scale,
 496             channel_statistics);
 497           break;
 498         }
 499         case CMYKColorspace:
 500         {
 501           (void) PrintChannelStatistics(file,CyanChannel,"Cyan",1.0/scale,
 502             channel_statistics);
 503           (void) PrintChannelStatistics(file,MagentaChannel,"Magenta",1.0/scale,
 504             channel_statistics);
 505           (void) PrintChannelStatistics(file,YellowChannel,"Yellow",1.0/scale,
 506             channel_statistics);
 507           (void) PrintChannelStatistics(file,BlackChannel,"Black",1.0/scale,
 508             channel_statistics);
 509           break;
 510         }
 511         case GRAYColorspace:
 512         {
 513           (void) PrintChannelStatistics(file,GrayChannel,"Gray",1.0/scale,
 514             channel_statistics);
 515           break;
 516         }
 517       }
 518       if (image->matte != MagickFalse)
 519         (void) PrintChannelStatistics(file,AlphaChannel,"Alpha",1.0/scale,
 520           channel_statistics);
 521       if (colorspace != GRAYColorspace)
 522         {
 523           (void) FormatLocaleFile(file,"  Image statistics:\n");
 524           (void) PrintChannelStatistics(file,CompositeChannels,"Overall",1.0/
 525             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,RedChannel,"Red",channel_features);
 540           (void) PrintChannelFeatures(file,GreenChannel,"Green",
 541             channel_features);
 542           (void) PrintChannelFeatures(file,BlueChannel,"Blue",channel_features);
 543           break;
 544         }
 545         case CMYKColorspace:
 546         {
 547           (void) PrintChannelFeatures(file,CyanChannel,"Cyan",channel_features);
 548           (void) PrintChannelFeatures(file,MagentaChannel,"Magenta",
 549             channel_features);
 550           (void) PrintChannelFeatures(file,YellowChannel,"Yellow",
 551             channel_features);
 552           (void) PrintChannelFeatures(file,BlackChannel,"Black",
 553             channel_features);
 554           break;
 555         }
 556         case GRAYColorspace:
 557         {
 558           (void) PrintChannelFeatures(file,GrayChannel,"Gray",channel_features);
 559           break;
 560         }
 561       }
 562       if (image->matte != MagickFalse)
 563         (void) PrintChannelFeatures(file,AlphaChannel,"Alpha",channel_features);
 564       channel_features=(ChannelFeatures *) RelinquishMagickMemory(
 565         channel_features);
 566     }
 567   if (ping == MagickFalse)
 568     {
 569       if (image->colorspace == CMYKColorspace)
 570         (void) FormatLocaleFile(file,"  Total ink density: %.0f%%\n",100.0*
 571           GetImageTotalInkDensity(image)/(double) QuantumRange);
 572       x=0;
 573       if (image->matte != MagickFalse)
 574         {
 575           register const Quantum
 576             *p;
 577
 578           p=(const Quantum *) NULL;
 579           for (y=0; y < (ssize_t) image->rows; y++)
 580           {
 581             p=GetVirtualPixels(image,0,y,image->columns,1,exception);
 582             if (p == (const Quantum *) NULL)
 583               break;
 584             for (x=0; x < (ssize_t) image->columns; x++)
 585             {
 586               if (GetPixelAlpha(image,p) == (Quantum) TransparentAlpha)
 587                 break;
 588               p+=GetPixelChannels(image);
 589             }
 590             if (x < (ssize_t) image->columns)
 591               break;
 592           }
 593           if ((x < (ssize_t) image->columns) || (y < (ssize_t) image->rows))
 594             {
 595               char
 596                 tuple[MaxTextExtent];
 597
 598               PixelInfo
 599                 pixel;
 600
 601               GetPixelInfo(image,&pixel);
 602               SetPixelInfo(image,p,&pixel);
 603               (void) QueryMagickColorname(image,&pixel,SVGCompliance,tuple,
 604                 exception);
 605               (void) FormatLocaleFile(file,"  Alpha: %s ",tuple);
 606               GetColorTuple(&pixel,MagickTrue,tuple);
 607               (void) FormatLocaleFile(file,"  %s\n",tuple);
 608             }
 609         }
 610       artifact=GetImageArtifact(image,"identify:unique-colors");
 611       if (IsHistogramImage(image,exception) != MagickFalse)
 612         {
 613           (void) FormatLocaleFile(file,"  Colors: %.20g\n",(double)
 614             GetNumberColors(image,(FILE *) NULL,exception));
 615           (void) FormatLocaleFile(file,"  Histogram:\n");
 616           (void) GetNumberColors(image,file,exception);
 617         }
 618       else
 619         if ((artifact != (const char *) NULL) &&
 620             (IsMagickTrue(artifact) != MagickFalse))
 621           (void) FormatLocaleFile(file,"  Colors: %.20g\n",(double)
 622             GetNumberColors(image,(FILE *) NULL,exception));
 623     }
 624   if (image->storage_class == PseudoClass)
 625     {
 626       (void) FormatLocaleFile(file,"  Colormap: %.20g\n",(double)
 627         image->colors);
 628       if (image->colors <= 1024)
 629         {
 630           char
 631             color[MaxTextExtent],
 632             hex[MaxTextExtent],
 633             tuple[MaxTextExtent];
 634
 635           PixelInfo
 636             pixel;
 637
 638           register PixelPacket
 639             *restrict p;
 640
 641           GetPixelInfo(image,&pixel);
 642           p=image->colormap;
 643           for (i=0; i < (ssize_t) image->colors; i++)
 644           {
 645             SetPixelInfoPacket(image,p,&pixel);
 646             (void) CopyMagickString(tuple,"(",MaxTextExtent);
 647             ConcatenateColorComponent(&pixel,RedPixelChannel,X11Compliance,
 648               tuple);
 649             (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
 650             ConcatenateColorComponent(&pixel,GreenPixelChannel,X11Compliance,
 651               tuple);
 652             (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
 653             ConcatenateColorComponent(&pixel,BluePixelChannel,X11Compliance,
 654               tuple);
 655             if (pixel.colorspace == CMYKColorspace)
 656               {
 657                 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
 658                 ConcatenateColorComponent(&pixel,BlackPixelChannel,
 659                   X11Compliance,tuple);
 660               }
 661             if (pixel.matte != MagickFalse)
 662               {
 663                 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
 664                 ConcatenateColorComponent(&pixel,AlphaPixelChannel,
 665                   X11Compliance,tuple);
 666               }
 667             (void) ConcatenateMagickString(tuple,")",MaxTextExtent);
 668             (void) QueryMagickColorname(image,&pixel,SVGCompliance,color,
 669               exception);
 670             GetColorTuple(&pixel,MagickTrue,hex);
 671             (void) FormatLocaleFile(file,"  %8ld: %s %s %s\n",(long) i,tuple,
 672               hex,color);
 673             p++;
 674           }
 675         }
 676     }
 677   if (image->error.mean_error_per_pixel != 0.0)
 678     (void) FormatLocaleFile(file,"  Mean error per pixel: %g\n",
 679       image->error.mean_error_per_pixel);
 680   if (image->error.normalized_mean_error != 0.0)
 681     (void) FormatLocaleFile(file,"  Normalized mean error: %g\n",
 682       image->error.normalized_mean_error);
 683   if (image->error.normalized_maximum_error != 0.0)
 684     (void) FormatLocaleFile(file,"  Normalized maximum error: %g\n",
 685       image->error.normalized_maximum_error);
 686   (void) FormatLocaleFile(file,"  Rendering intent: %s\n",
 687     CommandOptionToMnemonic(MagickIntentOptions,(ssize_t)
 688     image->rendering_intent));
 689   if (image->gamma != 0.0)
 690     (void) FormatLocaleFile(file,"  Gamma: %g\n",image->gamma);
 691   if ((image->chromaticity.red_primary.x != 0.0) ||
 692       (image->chromaticity.green_primary.x != 0.0) ||
 693       (image->chromaticity.blue_primary.x != 0.0) ||
 694       (image->chromaticity.white_point.x != 0.0))
 695     {
 696       /*
 697         Display image chromaticity.
 698       */
 699       (void) FormatLocaleFile(file,"  Chromaticity:\n");
 700       (void) FormatLocaleFile(file,"    red primary: (%g,%g)\n",
 701         image->chromaticity.red_primary.x,image->chromaticity.red_primary.y);
 702       (void) FormatLocaleFile(file,"    green primary: (%g,%g)\n",
 703         image->chromaticity.green_primary.x,
 704         image->chromaticity.green_primary.y);
 705       (void) FormatLocaleFile(file,"    blue primary: (%g,%g)\n",
 706         image->chromaticity.blue_primary.x,image->chromaticity.blue_primary.y);
 707       (void) FormatLocaleFile(file,"    white point: (%g,%g)\n",
 708         image->chromaticity.white_point.x,image->chromaticity.white_point.y);
 709     }
 710   if ((image->extract_info.width*image->extract_info.height) != 0)
 711     (void) FormatLocaleFile(file,"  Tile geometry: %.20gx%.20g%+.20g%+.20g\n",
 712       (double) image->extract_info.width,(double) image->extract_info.height,
 713       (double) image->extract_info.x,(double) image->extract_info.y);
 714   (void) FormatLocaleFile(file,"  Interlace: %s\n",CommandOptionToMnemonic(
 715     MagickInterlaceOptions,(ssize_t) image->interlace));
 716   (void) QueryColorname(image,&image->background_color,SVGCompliance,color,
 717     exception);
 718   (void) FormatLocaleFile(file,"  Background color: %s\n",color);
 719   (void) QueryColorname(image,&image->border_color,SVGCompliance,color,
 720     exception);
 721   (void) FormatLocaleFile(file,"  Border color: %s\n",color);
 722   (void) QueryColorname(image,&image->matte_color,SVGCompliance,color,
 723     exception);
 724   (void) FormatLocaleFile(file,"  Matte color: %s\n",color);
 725   (void) QueryColorname(image,&image->transparent_color,SVGCompliance,color,
 726     exception);
 727   (void) FormatLocaleFile(file,"  Transparent color: %s\n",color);
 728   (void) FormatLocaleFile(file,"  Compose: %s\n",CommandOptionToMnemonic(
 729     MagickComposeOptions,(ssize_t) image->compose));
 730   if ((image->page.width != 0) || (image->page.height != 0) ||
 731       (image->page.x != 0) || (image->page.y != 0))
 732     (void) FormatLocaleFile(file,"  Page geometry: %.20gx%.20g%+.20g%+.20g\n",
 733       (double) image->page.width,(double) image->page.height,(double)
 734       image->page.x,(double) image->page.y);
 735   if ((image->page.x != 0) || (image->page.y != 0))
 736     (void) FormatLocaleFile(file,"  Origin geometry: %+.20g%+.20g\n",(double)
 737       image->page.x,(double) image->page.y);
 738   (void) FormatLocaleFile(file,"  Dispose: %s\n",CommandOptionToMnemonic(
 739     MagickDisposeOptions,(ssize_t) image->dispose));
 740   if (image->delay != 0)
 741     (void) FormatLocaleFile(file,"  Delay: %.20gx%.20g\n",(double) image->delay,
 742       (double) image->ticks_per_second);
 743   if (image->iterations != 1)
 744     (void) FormatLocaleFile(file,"  Iterations: %.20g\n",(double)
 745       image->iterations);
 746   if ((image->next != (Image *) NULL) || (image->previous != (Image *) NULL))
 747     (void) FormatLocaleFile(file,"  Scene: %.20g of %.20g\n",(double)
 748       image->scene,(double) GetImageListLength(image));
 749   else
 750     if (image->scene != 0)
 751       (void) FormatLocaleFile(file,"  Scene: %.20g\n",(double) image->scene);
 752   (void) FormatLocaleFile(file,"  Compression: %s\n",CommandOptionToMnemonic(
 753     MagickCompressOptions,(ssize_t) image->compression));
 754   if (image->quality != UndefinedCompressionQuality)
 755     (void) FormatLocaleFile(file,"  Quality: %.20g\n",(double) image->quality);
 756   (void) FormatLocaleFile(file,"  Orientation: %s\n",CommandOptionToMnemonic(
 757     MagickOrientationOptions,(ssize_t) image->orientation));
 758   if (image->montage != (char *) NULL)
 759     (void) FormatLocaleFile(file,"  Montage: %s\n",image->montage);
 760   if (image->directory != (char *) NULL)
 761     {
 762       Image
 763         *tile;
 764
 765       ImageInfo
 766         *image_info;
 767
 768       register char
 769         *p,
 770         *q;
 771
 772       WarningHandler
 773         handler;
 774
 775       /*
 776         Display visual image directory.
 777       */
 778       image_info=AcquireImageInfo();
 779       (void) CloneString(&image_info->size,"64x64");
 780       (void) FormatLocaleFile(file,"  Directory:\n");
 781       for (p=image->directory; *p != '\0'; p++)
 782       {
 783         q=p;
 784         while ((*q != '\n') && (*q != '\0'))
 785           q++;
 786         (void) CopyMagickString(image_info->filename,p,(size_t) (q-p+1));
 787         p=q;
 788         (void) FormatLocaleFile(file,"    %s",image_info->filename);
 789         handler=SetWarningHandler((WarningHandler) NULL);
 790         tile=ReadImage(image_info,exception);
 791         (void) SetWarningHandler(handler);
 792         if (tile == (Image *) NULL)
 793           {
 794             (void) FormatLocaleFile(file,"\n");
 795             continue;
 796           }
 797         (void) FormatLocaleFile(file," %.20gx%.20g %s\n",(double)
 798           tile->magick_columns,(double) tile->magick_rows,tile->magick);
 799         (void) SignatureImage(tile,exception);
 800         ResetImagePropertyIterator(tile);
 801         property=GetNextImageProperty(tile);
 802         while (property != (const char *) NULL)
 803         {
 804           (void) FormatLocaleFile(file,"  %s:\n",property);
 805           value=GetImageProperty(tile,property);
 806           if (value != (const char *) NULL)
 807             (void) FormatLocaleFile(file,"%s\n",value);
 808           property=GetNextImageProperty(tile);
 809         }
 810         tile=DestroyImage(tile);
 811       }
 812       image_info=DestroyImageInfo(image_info);
 813     }
 814   (void) GetImageProperty(image,"exif:*");
 815   ResetImagePropertyIterator(image);
 816   property=GetNextImageProperty(image);
 817   if (property != (const char *) NULL)
 818     {
 819       /*
 820         Display image properties.
 821       */
 822       (void) FormatLocaleFile(file,"  Properties:\n");
 823       while (property != (const char *) NULL)
 824       {
 825         (void) FormatLocaleFile(file,"    %s: ",property);
 826         value=GetImageProperty(image,property);
 827         if (value != (const char *) NULL)
 828           (void) FormatLocaleFile(file,"%s\n",value);
 829         property=GetNextImageProperty(image);
 830       }
 831     }
 832   (void) FormatLocaleString(key,MaxTextExtent,"8BIM:1999,2998:#1");
 833   value=GetImageProperty(image,key);
 834   if (value != (const char *) NULL)
 835     {
 836       /*
 837         Display clipping path.
 838       */
 839       (void) FormatLocaleFile(file,"  Clipping path: ");
 840       if (strlen(value) > 80)
 841         (void) fputc('\n',file);
 842       (void) FormatLocaleFile(file,"%s\n",value);
 843     }
 844   ResetImageProfileIterator(image);
 845   name=GetNextImageProfile(image);
 846   if (name != (char *) NULL)
 847     {
 848       const StringInfo
 849         *profile;
 850
 851       /*
 852         Identify image profiles.
 853       */
 854       (void) FormatLocaleFile(file,"  Profiles:\n");
 855       while (name != (char *) NULL)
 856       {
 857         profile=GetImageProfile(image,name);
 858         if (profile == (StringInfo *) NULL)
 859           continue;
 860         (void) FormatLocaleFile(file,"    Profile-%s: %.20g bytes\n",name,
 861           (double) GetStringInfoLength(profile));
 862 #if defined(MAGICKCORE_LCMS_DELEGATE)
 863         if ((LocaleCompare(name,"icc") == 0) ||
 864             (LocaleCompare(name,"icm") == 0))
 865           {
 866             cmsHPROFILE
 867               icc_profile;
 868
 869             icc_profile=cmsOpenProfileFromMem(GetStringInfoDatum(profile),
 870               (cmsUInt32Number) GetStringInfoLength(profile));
 871             if (icc_profile != (cmsHPROFILE *) NULL)
 872               {
 873 #if defined(LCMS_VERSION) && (LCMS_VERSION < 2000)
 874                 const char
 875                   *name;
 876
 877                 name=cmsTakeProductName(icc_profile);
 878                 if (name != (const char *) NULL)
 879                   (void) FormatLocaleFile(file,"      %s\n",name);
 880 #else
 881                 char
 882                   info[MaxTextExtent];
 883
 884                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoDescription,
 885                   "en","US",info,MaxTextExtent);
 886                 (void) FormatLocaleFile(file,"      Description: %s\n",info);
 887                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoManufacturer,
 888                   "en","US",info,MaxTextExtent);
 889                 (void) FormatLocaleFile(file,"      Manufacturer: %s\n",info);
 890                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoModel,"en",
 891                   "US",info,MaxTextExtent);
 892                 (void) FormatLocaleFile(file,"      Model: %s\n",info);
 893                 (void) cmsGetProfileInfoASCII(icc_profile,cmsInfoCopyright,
 894                   "en","US",info,MaxTextExtent);
 895                 (void) FormatLocaleFile(file,"      Copyright: %s\n",info);
 896 #endif
 897                 (void) cmsCloseProfile(icc_profile);
 898               }
 899           }
 900 #endif
 901         if (LocaleCompare(name,"iptc") == 0)
 902           {
 903             char
 904               *attribute,
 905               **attribute_list;
 906
 907             const char
 908               *tag;
 909
 910             long
 911               dataset,
 912               record,
 913               sentinel;
 914
 915             register ssize_t
 916               j;
 917
 918             size_t
 919               length,
 920               profile_length;
 921
 922             profile_length=GetStringInfoLength(profile);
 923             for (i=0; i < (ssize_t) profile_length; i+=(ssize_t) length)
 924             {
 925               length=1;
 926               sentinel=GetStringInfoDatum(profile)[i++];
 927               if (sentinel != 0x1c)
 928                 continue;
 929               dataset=GetStringInfoDatum(profile)[i++];
 930               record=GetStringInfoDatum(profile)[i++];
 931               switch (record)
 932               {
 933                 case 5: tag="Image Name"; break;
 934                 case 7: tag="Edit Status"; break;
 935                 case 10: tag="Priority"; break;
 936                 case 15: tag="Category"; break;
 937                 case 20: tag="Supplemental Category"; break;
 938                 case 22: tag="Fixture Identifier"; break;
 939                 case 25: tag="Keyword"; break;
 940                 case 30: tag="Release Date"; break;
 941                 case 35: tag="Release Time"; break;
 942                 case 40: tag="Special Instructions"; break;
 943                 case 45: tag="Reference Service"; break;
 944                 case 47: tag="Reference Date"; break;
 945                 case 50: tag="Reference Number"; break;
 946                 case 55: tag="Created Date"; break;
 947                 case 60: tag="Created Time"; break;
 948                 case 65: tag="Originating Program"; break;
 949                 case 70: tag="Program Version"; break;
 950                 case 75: tag="Object Cycle"; break;
 951                 case 80: tag="Byline"; break;
 952                 case 85: tag="Byline Title"; break;
 953                 case 90: tag="City"; break;
 954                 case 95: tag="Province State"; break;
 955                 case 100: tag="Country Code"; break;
 956                 case 101: tag="Country"; break;
 957                 case 103: tag="Original Transmission Reference"; break;
 958                 case 105: tag="Headline"; break;
 959                 case 110: tag="Credit"; break;
 960                 case 115: tag="Src"; break;
 961                 case 116: tag="Copyright String"; break;
 962                 case 120: tag="Caption"; break;
 963                 case 121: tag="Local Caption"; break;
 964                 case 122: tag="Caption Writer"; break;
 965                 case 200: tag="Custom Field 1"; break;
 966                 case 201: tag="Custom Field 2"; break;
 967                 case 202: tag="Custom Field 3"; break;
 968                 case 203: tag="Custom Field 4"; break;
 969                 case 204: tag="Custom Field 5"; break;
 970                 case 205: tag="Custom Field 6"; break;
 971                 case 206: tag="Custom Field 7"; break;
 972                 case 207: tag="Custom Field 8"; break;
 973                 case 208: tag="Custom Field 9"; break;
 974                 case 209: tag="Custom Field 10"; break;
 975                 case 210: tag="Custom Field 11"; break;
 976                 case 211: tag="Custom Field 12"; break;
 977                 case 212: tag="Custom Field 13"; break;
 978                 case 213: tag="Custom Field 14"; break;
 979                 case 214: tag="Custom Field 15"; break;
 980                 case 215: tag="Custom Field 16"; break;
 981                 case 216: tag="Custom Field 17"; break;
 982                 case 217: tag="Custom Field 18"; break;
 983                 case 218: tag="Custom Field 19"; break;
 984                 case 219: tag="Custom Field 20"; break;
 985                 default: tag="unknown"; break;
 986               }
 987               (void) FormatLocaleFile(file,"      %s[%.20g,%.20g]: ",tag,
 988                 (double) dataset,(double) record);
 989               length=(size_t) (GetStringInfoDatum(profile)[i++] << 8);
 990               length|=GetStringInfoDatum(profile)[i++];
 991               attribute=(char *) NULL;
 992               if (~length >= (MaxTextExtent-1))
 993                 attribute=(char *) AcquireQuantumMemory(length+MaxTextExtent,
 994                   sizeof(*attribute));
 995               if (attribute != (char *) NULL)
 996                 {
 997                   (void) CopyMagickString(attribute,(char *)
 998                     GetStringInfoDatum(profile)+i,length+1);
 999                   attribute_list=StringToList(attribute);
1000                   if (attribute_list != (char **) NULL)
1001                     {
1002                       for (j=0; attribute_list[j] != (char *) NULL; j++)
1003                       {
1004                         (void) fputs(attribute_list[j],file);
1005                         (void) fputs("\n",file);
1006                         attribute_list[j]=(char *) RelinquishMagickMemory(
1007                           attribute_list[j]);
1008                       }
1009                       attribute_list=(char **) RelinquishMagickMemory(
1010                         attribute_list);
1011                     }
1012                   attribute=DestroyString(attribute);
1013                 }
1014             }
1015           }
1016         if (image->debug != MagickFalse)
1017           PrintStringInfo(file,name,profile);
1018         name=GetNextImageProfile(image);
1019       }
1020     }
1021   ResetImageArtifactIterator(image);
1022   artifact=GetNextImageArtifact(image);
1023   if (artifact != (const char *) NULL)
1024     {
1025       /*
1026         Display image artifacts.
1027       */
1028       (void) FormatLocaleFile(file,"  Artifacts:\n");
1029       while (artifact != (const char *) NULL)
1030       {
1031         (void) FormatLocaleFile(file,"    %s: ",artifact);
1032         value=GetImageArtifact(image,artifact);
1033         if (value != (const char *) NULL)
1034           (void) FormatLocaleFile(file,"%s\n",value);
1035         artifact=GetNextImageArtifact(image);
1036       }
1037     }
1038   ResetImageRegistryIterator();
1039   registry=GetNextImageRegistry();
1040   if (registry != (const char *) NULL)
1041     {
1042       /*
1043         Display image registry.
1044       */
1045       (void) FormatLocaleFile(file,"  Registry:\n");
1046       while (registry != (const char *) NULL)
1047       {
1048         (void) FormatLocaleFile(file,"    %s: ",registry);
1049         value=(const char *) GetImageRegistry(StringRegistryType,registry,
1050           exception);
1051         if (value != (const char *) NULL)
1052           (void) FormatLocaleFile(file,"%s\n",value);
1053         registry=GetNextImageRegistry();
1054       }
1055     }
1056   (void) FormatLocaleFile(file,"  Tainted: %s\n",CommandOptionToMnemonic(
1057     MagickBooleanOptions,(ssize_t) image->taint));
1058   (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
1059   (void) FormatLocaleFile(file,"  Filesize: %sB\n",format);
1060   (void) FormatMagickSize((MagickSizeType) image->columns*image->rows,
1061      MagickFalse,format);
1062   (void) FormatLocaleFile(file,"  Number pixels: %s\n",format);
1063   (void) FormatMagickSize((MagickSizeType) ((double) image->columns*image->rows/
1064     elapsed_time+0.5),MagickFalse,format);
1065   (void) FormatLocaleFile(file,"  Pixels per second: %s\n",format);
1066   (void) FormatLocaleFile(file,"  User time: %0.3fu\n",user_time);
1067   (void) FormatLocaleFile(file,"  Elapsed time: %lu:%02lu.%03lu\n",
1068     (unsigned long) (elapsed_time/60.0),(unsigned long) ceil(fmod(elapsed_time,
1069     60.0)),(unsigned long) (1000.0*(elapsed_time-floor(elapsed_time))));
1070   (void) FormatLocaleFile(file,"  Version: %s\n",GetMagickVersion((size_t *)
1071     NULL));
1072   (void) fflush(file);
1073   return(ferror(file) != 0 ? MagickFalse : MagickTrue);
1074 }