2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
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 %
13 % Identify an Image Format and Characteristics. %
20 % Copyright 1999-2008 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
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. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
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.
45 #include "magick/studio.h"
46 #include "magick/annotate.h"
47 #include "magick/artifact.h"
48 #include "magick/attribute.h"
49 #include "magick/blob.h"
50 #include "magick/cache.h"
51 #include "magick/client.h"
52 #include "magick/coder.h"
53 #include "magick/color.h"
54 #include "magick/configure.h"
55 #include "magick/constitute.h"
56 #include "magick/decorate.h"
57 #include "magick/delegate.h"
58 #include "magick/draw.h"
59 #include "magick/effect.h"
60 #include "magick/exception.h"
61 #include "magick/exception-private.h"
62 #include "magick/feature.h"
63 #include "magick/gem.h"
64 #include "magick/geometry.h"
65 #include "magick/histogram.h"
66 #include "magick/identify.h"
67 #include "magick/image.h"
68 #include "magick/image-private.h"
69 #include "magick/list.h"
70 #include "magick/locale_.h"
71 #include "magick/log.h"
72 #include "magick/magic.h"
73 #include "magick/magick.h"
74 #include "magick/memory_.h"
75 #include "magick/module.h"
76 #include "magick/monitor.h"
77 #include "magick/montage.h"
78 #include "magick/option.h"
79 #include "magick/pixel-private.h"
80 #include "magick/prepress.h"
81 #include "magick/profile.h"
82 #include "magick/property.h"
83 #include "magick/quantize.h"
84 #include "magick/quantum.h"
85 #include "magick/random_.h"
86 #include "magick/registry.h"
87 #include "magick/resize.h"
88 #include "magick/resource_.h"
89 #include "magick/signature.h"
90 #include "magick/statistic.h"
91 #include "magick/string_.h"
92 #include "magick/string-private.h"
93 #include "magick/timer.h"
94 #include "magick/utility.h"
95 #include "magick/version.h"
96 #if defined(MAGICKCORE_LCMS_DELEGATE)
97 #if defined(MAGICKCORE_HAVE_LCMS_LCMS_H)
98 #include <lcms/lcms.h>
105 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
109 % I d e n t i f y I m a g e %
113 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
115 % IdentifyImage() identifies an image by printing its attributes to the file.
116 % Attributes include the image width, height, size, and others.
118 % The format of the IdentifyImage method is:
120 % MagickBooleanType IdentifyImage(Image *image,FILE *file,
121 % const MagickBooleanType verbose)
123 % A description of each parameter follows:
125 % o image: the image.
127 % o file: the file, typically stdout.
129 % o verbose: A value other than zero prints more detailed information
134 static int PrintChannelFeatures(FILE *file,const ChannelType channel,
135 const char *name,const ChannelFeatures *channel_features)
137 #define PrintFeature(feature) \
138 GetMagickPrecision(),(feature)[0], \
139 GetMagickPrecision(),(feature)[1], \
140 GetMagickPrecision(),(feature)[2], \
141 GetMagickPrecision(),(feature)[3], \
142 GetMagickPrecision(),((feature)[0]+(feature)[1]+(feature)[2]+(feature)[3])/4.0 \
144 #define FeaturesFormat " %s:\n" \
145 " Angular Second Moment:\n" \
146 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
148 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
150 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
151 " Sum of Squares: Variance:\n" \
152 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
153 " Inverse Difference Moment:\n" \
154 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
156 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
158 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
160 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
162 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
163 " Difference Variance:\n" \
164 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
165 " Difference Entropy:\n" \
166 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
167 " Information Measure of Correlation 1:\n" \
168 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
169 " Information Measure of Correlation 2:\n" \
170 " %.*g, %.*g, %.*g, %.*g, %.*g\n" \
171 " Maximum Correlation Coefficient:\n" \
172 " %.*g, %.*g, %.*g, %.*g, %.*g\n"
177 status=fprintf(file,FeaturesFormat,name,
178 PrintFeature(channel_features[channel].angular_second_moment),
179 PrintFeature(channel_features[channel].contrast),
180 PrintFeature(channel_features[channel].correlation),
181 PrintFeature(channel_features[channel].variance_sum_of_squares),
182 PrintFeature(channel_features[channel].inverse_difference_moment),
183 PrintFeature(channel_features[channel].sum_average),
184 PrintFeature(channel_features[channel].sum_variance),
185 PrintFeature(channel_features[channel].sum_entropy),
186 PrintFeature(channel_features[channel].entropy),
187 PrintFeature(channel_features[channel].difference_variance),
188 PrintFeature(channel_features[channel].difference_entropy),
189 PrintFeature(channel_features[channel].measure_of_correlation_1),
190 PrintFeature(channel_features[channel].measure_of_correlation_2),
191 PrintFeature(channel_features[channel].maximum_correlation_coefficient));
195 static int PrintChannelStatistics(FILE *file,const ChannelType channel,
196 const char *name,const double scale,
197 const ChannelStatistics *channel_statistics)
199 #define StatisticsFormat " %s:\n min: " QuantumFormat \
200 " (%g)\n max: " QuantumFormat " (%g)\n" \
201 " mean: %g (%g)\n standard deviation: %g (%g)\n" \
202 " kurtosis: %g\n skewness: %g\n"
212 minima=channel_statistics[channel].minima;
213 maxima=channel_statistics[channel].maxima;
214 mean=channel_statistics[channel].mean;
215 if (channel == AlphaChannel)
217 minima=QuantumRange-minima;
218 maxima=QuantumRange-maxima;
219 mean=QuantumRange-mean;
221 status=fprintf(file,StatisticsFormat,name,(Quantum) (scale*minima),minima/
222 (double) QuantumRange,(Quantum) (maxima/scale),maxima/(double) QuantumRange,
223 scale*mean,mean/(double) QuantumRange,
224 scale*channel_statistics[channel].standard_deviation,
225 channel_statistics[channel].standard_deviation/(double)
226 QuantumRange,channel_statistics[channel].kurtosis,
227 channel_statistics[channel].skewness);
231 MagickExport MagickBooleanType IdentifyImage(Image *image,FILE *file,
232 const MagickBooleanType verbose)
235 color[MaxTextExtent],
236 format[MaxTextExtent],
285 assert(image != (Image *) NULL);
286 assert(image->signature == MagickSignature);
287 if (image->debug != MagickFalse)
288 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
289 if (file == (FILE *) NULL)
292 elapsed_time=GetElapsedTime(&image->timer);
293 user_time=GetUserTime(&image->timer);
294 GetTimerInfo(&image->timer);
295 if (verbose == MagickFalse)
298 Display summary info about the image.
300 if (*image->magick_filename != '\0')
301 if (LocaleCompare(image->magick_filename,image->filename) != 0)
302 (void) fprintf(file,"%s=>",image->magick_filename);
303 if ((GetPreviousImageInList(image) == (Image *) NULL) &&
304 (GetNextImageInList(image) == (Image *) NULL) && (image->scene == 0))
305 (void) fprintf(file,"%s ",image->filename);
307 (void) fprintf(file,"%s[%lu] ",image->filename,image->scene);
308 (void) fprintf(file,"%s ",image->magick);
309 if ((image->magick_columns != 0) || (image->magick_rows != 0))
310 if ((image->magick_columns != image->columns) ||
311 (image->magick_rows != image->rows))
312 (void) fprintf(file,"%lux%lu=>",image->magick_columns,
314 (void) fprintf(file,"%lux%lu ",image->columns,image->rows);
315 if ((image->page.width != 0) || (image->page.height != 0) ||
316 (image->page.x != 0) || (image->page.y != 0))
317 (void) fprintf(file,"%lux%lu%+ld%+ld ",image->page.width,
318 image->page.height,image->page.x,image->page.y);
319 (void) fprintf(file,"%lu-bit ",image->depth);
320 if (image->type != UndefinedType)
321 (void) fprintf(file,"%s ",MagickOptionToMnemonic(MagickTypeOptions,
322 (long) image->type));
323 if (image->storage_class == DirectClass)
325 (void) fprintf(file,"DirectClass ");
326 if (image->total_colors != 0)
328 (void) FormatMagickSize(image->total_colors,MagickFalse,format);
329 (void) fprintf(file,"%s ",format);
333 if (image->total_colors <= image->colors)
334 (void) fprintf(file,"PseudoClass %luc ",image->colors);
336 (void) fprintf(file,"PseudoClass %lu=>%luc ",image->total_colors,
338 if (image->error.mean_error_per_pixel != 0.0)
339 (void) fprintf(file,"%ld/%f/%fdb ",(long)
340 (image->error.mean_error_per_pixel+0.5),
341 image->error.normalized_mean_error,
342 image->error.normalized_maximum_error);
343 if (GetBlobSize(image) != 0)
345 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
346 (void) fprintf(file,"%s ",format);
348 (void) fprintf(file,"%0.3fu %ld:%02ld.%03ld",user_time,(long)
349 (elapsed_time/60.0),(long) floor(fmod(elapsed_time,60.0)),
350 (long) (1000.0*(elapsed_time-floor(elapsed_time))));
351 (void) fprintf(file,"\n");
353 return(ferror(file) != 0 ? MagickFalse : MagickTrue);
356 Display verbose info about the image.
358 exception=AcquireExceptionInfo();
359 pixels=GetVirtualPixels(image,0,0,1,1,exception);
360 exception=DestroyExceptionInfo(exception);
361 ping=pixels == (const PixelPacket *) NULL ? MagickTrue : MagickFalse;
362 type=GetImageType(image,&image->exception);
363 (void) SignatureImage(image);
364 (void) fprintf(file,"Image: %s\n",image->filename);
365 if (*image->magick_filename != '\0')
366 if (LocaleCompare(image->magick_filename,image->filename) != 0)
369 filename[MaxTextExtent];
371 GetPathComponent(image->magick_filename,TailPath,filename);
372 (void) fprintf(file," Base filename: %s\n",filename);
374 magick_info=GetMagickInfo(image->magick,&image->exception);
375 if ((magick_info == (const MagickInfo *) NULL) ||
376 (*GetMagickDescription(magick_info) == '\0'))
377 (void) fprintf(file," Format: %s\n",image->magick);
379 (void) fprintf(file," Format: %s (%s)\n",image->magick,
380 GetMagickDescription(magick_info));
381 (void) fprintf(file," Class: %s\n",MagickOptionToMnemonic(MagickClassOptions,
382 (long) image->storage_class));
383 (void) fprintf(file," Geometry: %lux%lu%+ld%+ld\n",image->columns,
384 image->rows,image->tile_offset.x,image->tile_offset.y);
385 if ((image->magick_columns != 0) || (image->magick_rows != 0))
386 if ((image->magick_columns != image->columns) ||
387 (image->magick_rows != image->rows))
388 (void) fprintf(file," Base geometry: %lux%lu\n",image->magick_columns,
390 if ((image->x_resolution != 0.0) && (image->y_resolution != 0.0))
392 (void) fprintf(file," Resolution: %gx%g\n",image->x_resolution,
393 image->y_resolution);
394 (void) fprintf(file," Print size: %gx%g\n",(double) image->columns/
395 image->x_resolution,(double) image->rows/image->y_resolution);
397 (void) fprintf(file," Units: %s\n",MagickOptionToMnemonic(
398 MagickResolutionOptions,(long) image->units));
399 (void) fprintf(file," Type: %s\n",MagickOptionToMnemonic(MagickTypeOptions,
401 if (image->type != UndefinedType)
402 (void) fprintf(file," Base type: %s\n",MagickOptionToMnemonic(
403 MagickTypeOptions,(long) image->type));
404 (void) fprintf(file," Endianess: %s\n",MagickOptionToMnemonic(
405 MagickEndianOptions,(long) image->endian));
407 Detail channel depth and extrema.
409 (void) fprintf(file," Colorspace: %s\n",MagickOptionToMnemonic(
410 MagickColorspaceOptions,(long) image->colorspace));
411 channel_statistics=(ChannelStatistics *) NULL;
412 if (ping == MagickFalse)
413 channel_statistics=GetImageChannelStatistics(image,&image->exception);
414 if (channel_statistics != (ChannelStatistics *) NULL)
419 depth=GetImageDepth(image,&image->exception);
420 if (image->depth == depth)
421 (void) fprintf(file," Depth: %lu-bit\n",image->depth);
423 (void) fprintf(file," Depth: %lu/%lu-bit\n",image->depth,depth);
424 (void) fprintf(file," Channel depth:\n");
425 colorspace=image->colorspace;
426 if (IsGrayImage(image,&image->exception) != MagickFalse)
427 colorspace=GRAYColorspace;
433 (void) fprintf(file," red: %lu-bit\n",
434 channel_statistics[RedChannel].depth);
435 (void) fprintf(file," green: %lu-bit\n",
436 channel_statistics[GreenChannel].depth);
437 (void) fprintf(file," blue: %lu-bit\n",
438 channel_statistics[BlueChannel].depth);
439 if (image->matte != MagickFalse)
440 (void) fprintf(file," alpha: %lu-bit\n",
441 channel_statistics[OpacityChannel].depth);
446 (void) fprintf(file," cyan: %lu-bit\n",
447 channel_statistics[CyanChannel].depth);
448 (void) fprintf(file," magenta: %lu-bit\n",
449 channel_statistics[MagentaChannel].depth);
450 (void) fprintf(file," yellow: %lu-bit\n",
451 channel_statistics[YellowChannel].depth);
452 (void) fprintf(file," black: %lu-bit\n",
453 channel_statistics[BlackChannel].depth);
454 if (image->matte != MagickFalse)
455 (void) fprintf(file," alpha: %lu-bit\n",
456 channel_statistics[OpacityChannel].depth);
461 (void) fprintf(file," gray: %lu-bit\n",
462 channel_statistics[GrayChannel].depth);
463 if (image->matte != MagickFalse)
464 (void) fprintf(file," alpha: %lu-bit\n",
465 channel_statistics[OpacityChannel].depth);
470 if (image->depth <= MAGICKCORE_QUANTUM_DEPTH)
471 scale=QuantumRange/((unsigned long) QuantumRange >> ((unsigned long)
472 MAGICKCORE_QUANTUM_DEPTH-image->depth));
473 (void) fprintf(file," Channel statistics:\n");
479 (void) PrintChannelStatistics(file,RedChannel,"Red",1.0/scale,
481 (void) PrintChannelStatistics(file,GreenChannel,"Green",1.0/scale,
483 (void) PrintChannelStatistics(file,BlueChannel,"Blue",1.0/scale,
489 (void) PrintChannelStatistics(file,CyanChannel,"Cyan",1.0/scale,
491 (void) PrintChannelStatistics(file,MagentaChannel,"Magenta",1.0/scale,
493 (void) PrintChannelStatistics(file,YellowChannel,"Yellow",1.0/scale,
495 (void) PrintChannelStatistics(file,BlackChannel,"Black",1.0/scale,
501 (void) PrintChannelStatistics(file,GrayChannel,"Gray",1.0/scale,
506 if (image->matte != MagickFalse)
507 (void) PrintChannelStatistics(file,AlphaChannel,"Alpha",1.0/scale,
509 if (colorspace != GRAYColorspace)
511 (void) fprintf(file," Image statistics:\n");
512 (void) PrintChannelStatistics(file,AllChannels,"Overall",1.0/scale,
515 channel_statistics=(ChannelStatistics *) RelinquishMagickMemory(
518 channel_features=(ChannelFeatures *) NULL;
519 artifact=GetImageArtifact(image,"identify:features");
520 if ((ping == MagickFalse) && (artifact != (const char *) NULL))
522 distance=StringToUnsignedLong(artifact);
523 channel_features=GetImageChannelFeatures(image,distance,
526 if (channel_features != (ChannelFeatures *) NULL)
528 (void) fprintf(file," Channel features (horizontal, vertical, left and right diagonals, average):\n");
534 (void) PrintChannelFeatures(file,RedChannel,"Red",channel_features);
535 (void) PrintChannelFeatures(file,GreenChannel,"Green",
537 (void) PrintChannelFeatures(file,BlueChannel,"Blue",channel_features);
542 (void) PrintChannelFeatures(file,CyanChannel,"Cyan",channel_features);
543 (void) PrintChannelFeatures(file,MagentaChannel,"Magenta",
545 (void) PrintChannelFeatures(file,YellowChannel,"Yellow",
547 (void) PrintChannelFeatures(file,BlackChannel,"Black",
553 (void) PrintChannelFeatures(file,GrayChannel,"Gray",channel_features);
557 if (image->matte != MagickFalse)
558 (void) PrintChannelFeatures(file,AlphaChannel,"Alpha",channel_features);
559 channel_features=(ChannelFeatures *) RelinquishMagickMemory(
562 if (ping == MagickFalse)
564 if (image->colorspace == CMYKColorspace)
565 (void) fprintf(file," Total ink density: %.0f%%\n",100.0*
566 GetImageTotalInkDensity(image)/(double) QuantumRange);
568 if (image->matte != MagickFalse)
570 register const IndexPacket
573 register const PixelPacket
576 p=(PixelPacket *) NULL;
577 indexes=(IndexPacket *) NULL;
578 for (y=0; y < (long) image->rows; y++)
580 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
581 if (p == (const PixelPacket *) NULL)
583 indexes=GetVirtualIndexQueue(image);
584 for (x=0; x < (long) image->columns; x++)
586 if (p->opacity == (Quantum) TransparentOpacity)
590 if (x < (long) image->columns)
593 if ((x < (long) image->columns) || (y < (long) image->rows))
596 tuple[MaxTextExtent];
601 GetMagickPixelPacket(image,&pixel);
602 SetMagickPixelPacket(image,p,indexes+x,&pixel);
603 (void) QueryMagickColorname(image,&pixel,SVGCompliance,tuple,
605 (void) fprintf(file," Alpha: %s ",tuple);
606 GetColorTuple(&pixel,MagickTrue,tuple);
607 (void) fprintf(file," %s\n",tuple);
610 artifact=GetImageArtifact(image,"identify:unique");
611 if ((artifact != (const char *) NULL) &&
612 (IsMagickTrue(artifact) != MagickFalse))
613 (void) fprintf(file," Colors: %lu\n",GetNumberColors(image,
614 (FILE *) NULL,&image->exception));
615 if (IsHistogramImage(image,&image->exception) != MagickFalse)
617 (void) fprintf(file," Histogram:\n");
618 (void) GetNumberColors(image,file,&image->exception);
621 if (image->storage_class == PseudoClass)
623 (void) fprintf(file," Colormap: %lu\n",image->colors);
624 if (image->colors <= 1024)
627 color[MaxTextExtent],
629 tuple[MaxTextExtent];
637 GetMagickPixelPacket(image,&pixel);
639 for (i=0; i < (long) image->colors; i++)
641 SetMagickPixelPacket(image,p,(IndexPacket *) NULL,&pixel);
642 (void) CopyMagickString(tuple,"(",MaxTextExtent);
643 ConcatenateColorComponent(&pixel,RedChannel,X11Compliance,tuple);
644 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
645 ConcatenateColorComponent(&pixel,GreenChannel,X11Compliance,tuple);
646 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
647 ConcatenateColorComponent(&pixel,BlueChannel,X11Compliance,tuple);
648 if (pixel.colorspace == CMYKColorspace)
650 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
651 ConcatenateColorComponent(&pixel,IndexChannel,X11Compliance,
654 if (pixel.matte != MagickFalse)
656 (void) ConcatenateMagickString(tuple,",",MaxTextExtent);
657 ConcatenateColorComponent(&pixel,OpacityChannel,X11Compliance,
660 (void) ConcatenateMagickString(tuple,")",MaxTextExtent);
661 (void) QueryMagickColorname(image,&pixel,SVGCompliance,color,
663 GetColorTuple(&pixel,MagickTrue,hex);
664 (void) fprintf(file," %8ld: %s %s %s\n",i,tuple,hex,color);
669 if (image->error.mean_error_per_pixel != 0.0)
670 (void) fprintf(file," Mean error per pixel: %g\n",
671 image->error.mean_error_per_pixel);
672 if (image->error.normalized_mean_error != 0.0)
673 (void) fprintf(file," Normalized mean error: %g\n",
674 image->error.normalized_mean_error);
675 if (image->error.normalized_maximum_error != 0.0)
676 (void) fprintf(file," Normalized maximum error: %g\n",
677 image->error.normalized_maximum_error);
678 (void) fprintf(file," Rendering intent: %s\n",MagickOptionToMnemonic(
679 MagickIntentOptions,(long) image->rendering_intent));
680 if (image->gamma != 0.0)
681 (void) fprintf(file," Gamma: %g\n",image->gamma);
682 if ((image->chromaticity.red_primary.x != 0.0) ||
683 (image->chromaticity.green_primary.x != 0.0) ||
684 (image->chromaticity.blue_primary.x != 0.0) ||
685 (image->chromaticity.white_point.x != 0.0))
688 Display image chromaticity.
690 (void) fprintf(file," Chromaticity:\n");
691 (void) fprintf(file," red primary: (%g,%g)\n",
692 image->chromaticity.red_primary.x,image->chromaticity.red_primary.y);
693 (void) fprintf(file," green primary: (%g,%g)\n",
694 image->chromaticity.green_primary.x,
695 image->chromaticity.green_primary.y);
696 (void) fprintf(file," blue primary: (%g,%g)\n",
697 image->chromaticity.blue_primary.x,image->chromaticity.blue_primary.y);
698 (void) fprintf(file," white point: (%g,%g)\n",
699 image->chromaticity.white_point.x,image->chromaticity.white_point.y);
701 if ((image->extract_info.width*image->extract_info.height) != 0)
702 (void) fprintf(file," Tile geometry: %lux%lu%+ld%+ld\n",
703 image->extract_info.width,image->extract_info.height,
704 image->extract_info.x,image->extract_info.y);
705 (void) fprintf(file," Interlace: %s\n",MagickOptionToMnemonic(
706 MagickInterlaceOptions,(long) image->interlace));
707 (void) QueryColorname(image,&image->background_color,SVGCompliance,color,
709 (void) fprintf(file," Background color: %s\n",color);
710 (void) QueryColorname(image,&image->border_color,SVGCompliance,color,
712 (void) fprintf(file," Border color: %s\n",color);
713 (void) QueryColorname(image,&image->matte_color,SVGCompliance,color,
715 (void) fprintf(file," Matte color: %s\n",color);
716 (void) QueryColorname(image,&image->transparent_color,SVGCompliance,color,
718 (void) fprintf(file," Transparent color: %s\n",color);
719 (void) fprintf(file," Compose: %s\n",MagickOptionToMnemonic(
720 MagickComposeOptions,(long) image->compose));
721 if ((image->page.width != 0) || (image->page.height != 0) ||
722 (image->page.x != 0) || (image->page.y != 0))
723 (void) fprintf(file," Page geometry: %lux%lu%+ld%+ld\n",image->page.width,
724 image->page.height,image->page.x,image->page.y);
725 if ((image->page.x != 0) || (image->page.y != 0))
726 (void) fprintf(file," Origin geometry: %+ld%+ld\n",image->page.x,
728 (void) fprintf(file," Dispose: %s\n",MagickOptionToMnemonic(
729 MagickDisposeOptions,(long) image->dispose));
730 if (image->delay != 0)
731 (void) fprintf(file," Delay: %lux%ld\n",image->delay,
732 image->ticks_per_second);
733 if (image->iterations != 1)
734 (void) fprintf(file," Iterations: %lu\n",image->iterations);
735 if ((image->next != (Image *) NULL) || (image->previous != (Image *) NULL))
736 (void) fprintf(file," Scene: %lu of %lu\n",image->scene,
737 GetImageListLength(image));
739 if (image->scene != 0)
740 (void) fprintf(file," Scene: %lu\n",image->scene);
741 (void) fprintf(file," Compression: %s\n",MagickOptionToMnemonic(
742 MagickCompressOptions,(long) image->compression));
743 if (image->quality != UndefinedCompressionQuality)
744 (void) fprintf(file," Quality: %lu\n",image->quality);
745 (void) fprintf(file," Orientation: %s\n",MagickOptionToMnemonic(
746 MagickOrientationOptions,(long) image->orientation));
747 if (image->montage != (char *) NULL)
748 (void) fprintf(file," Montage: %s\n",image->montage);
749 if (image->directory != (char *) NULL)
765 Display visual image directory.
767 image_info=AcquireImageInfo();
768 (void) CloneString(&image_info->size,"64x64");
769 (void) fprintf(file," Directory:\n");
770 for (p=image->directory; *p != '\0'; p++)
773 while ((*q != '\n') && (*q != '\0'))
775 (void) CopyMagickString(image_info->filename,p,(size_t) (q-p+1));
777 (void) fprintf(file," %s",image_info->filename);
778 handler=SetWarningHandler((WarningHandler) NULL);
779 tile=ReadImage(image_info,&image->exception);
780 (void) SetWarningHandler(handler);
781 if (tile == (Image *) NULL)
783 (void) fprintf(file,"\n");
786 (void) fprintf(file," %lux%lu %s\n",tile->magick_columns,
787 tile->magick_rows,tile->magick);
788 (void) SignatureImage(tile);
789 ResetImagePropertyIterator(tile);
790 property=GetNextImageProperty(tile);
791 while (property != (const char *) NULL)
793 (void) fprintf(file," %s:\n",property);
794 value=GetImageProperty(tile,property);
795 if (value != (const char *) NULL)
796 (void) fprintf(file,"%s\n",value);
797 property=GetNextImageProperty(tile);
799 tile=DestroyImage(tile);
801 image_info=DestroyImageInfo(image_info);
803 (void) GetImageProperty(image,"exif:*");
804 ResetImagePropertyIterator(image);
805 property=GetNextImageProperty(image);
806 if (property != (const char *) NULL)
809 Display image properties.
811 (void) fprintf(file," Properties:\n");
812 while (property != (const char *) NULL)
814 (void) fprintf(file," %c",*property);
815 if (strlen(property) > 1)
816 (void) fprintf(file,"%s: ",property+1);
817 if (strlen(property) > 80)
818 (void) fputc('\n',file);
819 value=GetImageProperty(image,property);
820 if (value != (const char *) NULL)
821 (void) fprintf(file,"%s\n",value);
822 property=GetNextImageProperty(image);
825 (void) FormatMagickString(key,MaxTextExtent,"8BIM:1999,2998:#1");
826 value=GetImageProperty(image,key);
827 if (value != (const char *) NULL)
830 Display clipping path.
832 (void) fprintf(file," Clipping path: ");
833 if (strlen(value) > 80)
834 (void) fputc('\n',file);
835 (void) fprintf(file,"%s\n",value);
837 ResetImageProfileIterator(image);
838 name=GetNextImageProfile(image);
839 if (name != (char *) NULL)
845 Identify image profiles.
847 (void) fprintf(file," Profiles:\n");
848 while (name != (char *) NULL)
850 profile=GetImageProfile(image,name);
851 if (profile == (StringInfo *) NULL)
853 (void) fprintf(file," Profile-%s: %lu bytes\n",name,(unsigned long)
854 GetStringInfoLength(profile));
855 #if defined(MAGICKCORE_LCMS_DELEGATE)
856 if ((LocaleCompare(name,"icc") == 0) ||
857 (LocaleCompare(name,"icm") == 0))
862 icc_profile=cmsOpenProfileFromMem(GetStringInfoDatum(profile),
863 (DWORD) GetStringInfoLength(profile));
864 if (icc_profile != (cmsHPROFILE *) NULL)
869 name=cmsTakeProductName(icc_profile);
870 if (name != (const char *) NULL)
871 (void) fprintf(file," %s\n",name);
872 (void) cmsCloseProfile(icc_profile);
876 if (LocaleCompare(name,"iptc") == 0)
897 profile_length=GetStringInfoLength(profile);
898 for (i=0; i < (long) profile_length; i+=(long) length)
901 sentinel=GetStringInfoDatum(profile)[i++];
902 if (sentinel != 0x1c)
904 dataset=GetStringInfoDatum(profile)[i++];
905 record=GetStringInfoDatum(profile)[i++];
908 case 5: tag="Image Name"; break;
909 case 7: tag="Edit Status"; break;
910 case 10: tag="Priority"; break;
911 case 15: tag="Category"; break;
912 case 20: tag="Supplemental Category"; break;
913 case 22: tag="Fixture Identifier"; break;
914 case 25: tag="Keyword"; break;
915 case 30: tag="Release Date"; break;
916 case 35: tag="Release Time"; break;
917 case 40: tag="Special Instructions"; break;
918 case 45: tag="Reference Service"; break;
919 case 47: tag="Reference Date"; break;
920 case 50: tag="Reference Number"; break;
921 case 55: tag="Created Date"; break;
922 case 60: tag="Created Time"; break;
923 case 65: tag="Originating Program"; break;
924 case 70: tag="Program Version"; break;
925 case 75: tag="Object Cycle"; break;
926 case 80: tag="Byline"; break;
927 case 85: tag="Byline Title"; break;
928 case 90: tag="City"; break;
929 case 95: tag="Province State"; break;
930 case 100: tag="Country Code"; break;
931 case 101: tag="Country"; break;
932 case 103: tag="Original Transmission Reference"; break;
933 case 105: tag="Headline"; break;
934 case 110: tag="Credit"; break;
935 case 115: tag="Src"; break;
936 case 116: tag="Copyright String"; break;
937 case 120: tag="Caption"; break;
938 case 121: tag="Local Caption"; break;
939 case 122: tag="Caption Writer"; break;
940 case 200: tag="Custom Field 1"; break;
941 case 201: tag="Custom Field 2"; break;
942 case 202: tag="Custom Field 3"; break;
943 case 203: tag="Custom Field 4"; break;
944 case 204: tag="Custom Field 5"; break;
945 case 205: tag="Custom Field 6"; break;
946 case 206: tag="Custom Field 7"; break;
947 case 207: tag="Custom Field 8"; break;
948 case 208: tag="Custom Field 9"; break;
949 case 209: tag="Custom Field 10"; break;
950 case 210: tag="Custom Field 11"; break;
951 case 211: tag="Custom Field 12"; break;
952 case 212: tag="Custom Field 13"; break;
953 case 213: tag="Custom Field 14"; break;
954 case 214: tag="Custom Field 15"; break;
955 case 215: tag="Custom Field 16"; break;
956 case 216: tag="Custom Field 17"; break;
957 case 217: tag="Custom Field 18"; break;
958 case 218: tag="Custom Field 19"; break;
959 case 219: tag="Custom Field 20"; break;
960 default: tag="unknown"; break;
962 (void) fprintf(file," %s[%ld,%ld]: ",tag,dataset,record);
963 length=(size_t) (GetStringInfoDatum(profile)[i++] << 8);
964 length|=GetStringInfoDatum(profile)[i++];
965 attribute=(char *) NULL;
966 if (~length >= MaxTextExtent)
967 attribute=(char *) AcquireQuantumMemory(length+
968 MaxTextExtent,sizeof(*attribute));
969 if (attribute != (char *) NULL)
971 (void) CopyMagickString(attribute,(char *)
972 GetStringInfoDatum(profile)+i,length+1);
973 attribute_list=StringToList(attribute);
974 if (attribute_list != (char **) NULL)
976 for (j=0; attribute_list[j] != (char *) NULL; j++)
978 (void) fputs(attribute_list[j],file);
979 (void) fputs("\n",file);
980 attribute_list[j]=(char *) RelinquishMagickMemory(
983 attribute_list=(char **) RelinquishMagickMemory(
986 attribute=DestroyString(attribute);
990 if (image->debug != MagickFalse)
991 PrintStringInfo(file,name,profile);
992 name=GetNextImageProfile(image);
995 ResetImageArtifactIterator(image);
996 artifact=GetNextImageArtifact(image);
997 if (artifact != (const char *) NULL)
1000 Display image artifacts.
1002 (void) fprintf(file," Artifacts:\n");
1003 while (artifact != (const char *) NULL)
1005 (void) fprintf(file," %c",*artifact);
1006 if (strlen(artifact) > 1)
1007 (void) fprintf(file,"%s: ",artifact+1);
1008 if (strlen(artifact) > 80)
1009 (void) fputc('\n',file);
1010 value=GetImageArtifact(image,artifact);
1011 if (value != (const char *) NULL)
1012 (void) fprintf(file,"%s\n",value);
1013 artifact=GetNextImageArtifact(image);
1016 ResetImageRegistryIterator();
1017 registry=GetNextImageRegistry();
1018 if (registry != (const char *) NULL)
1021 Display image registry.
1023 (void) fprintf(file," Registry:\n");
1024 while (registry != (const char *) NULL)
1026 (void) fprintf(file," %c",*registry);
1027 if (strlen(registry) > 1)
1028 (void) fprintf(file,"%s: ",registry+1);
1029 if (strlen(registry) > 80)
1030 (void) fputc('\n',file);
1031 value=(const char *) GetImageRegistry(StringRegistryType,registry,
1033 if (value != (const char *) NULL)
1034 (void) fprintf(file,"%s\n",value);
1035 registry=GetNextImageRegistry();
1038 (void) fprintf(file," Tainted: %s\n",MagickOptionToMnemonic(
1039 MagickBooleanOptions,(long) image->taint));
1040 (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
1041 (void) fprintf(file," Filesize: %s\n",format);
1042 (void) FormatMagickSize((MagickSizeType) image->columns*image->rows,
1043 MagickFalse,format);
1044 (void) fprintf(file," Number pixels: %s\n",format);
1045 (void) FormatMagickSize((MagickSizeType) ((double) image->columns*image->rows/
1046 elapsed_time+0.5),MagickFalse,format);
1047 (void) fprintf(file," Pixels per second: %s\n",format);
1048 (void) fprintf(file," User time: %0.3fu\n",user_time);
1049 (void) fprintf(file," Elapsed time: %ld:%02ld.%03ld\n",(long)
1050 (elapsed_time/60.0),(long) ceil(fmod(elapsed_time,60.0)),(long)
1051 (1000.0*(elapsed_time-floor(elapsed_time))));
1052 (void) fprintf(file," Version: %s\n",GetMagickVersion((unsigned long *)
1054 (void) fflush(file);
1055 return(ferror(file) != 0 ? MagickFalse : MagickTrue);