]> granicus.if.org Git - imagemagick/blob - magick/property.c
(no commit message)
[imagemagick] / magick / property.c
1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 %                                                                             %
4 %                                                                             %
5 %                                                                             %
6 %            PPPP    RRRR    OOO   PPPP   EEEEE  RRRR   TTTTT  Y   Y          %
7 %            P   P   R   R  O   O  P   P  E      R   R    T     Y Y           %
8 %            PPPP    RRRR   O   O  PPPP   EEE    RRRR     T      Y            %
9 %            P       R R    O   O  P      E      R R      T      Y            %
10 %            P       R  R    OOO   P      EEEEE  R  R     T      Y            %
11 %                                                                             %
12 %                                                                             %
13 %                         MagickCore Property Methods                         %
14 %                                                                             %
15 %                              Software Design                                %
16 %                                John Cristy                                  %
17 %                                 March 2000                                  %
18 %                                                                             %
19 %                                                                             %
20 %  Copyright 1999-2011 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 %
37 %
38 */
39 \f
40 /*
41   Include declarations.
42 */
43 #include "magick/studio.h"
44 #include "magick/attribute.h"
45 #include "magick/cache.h"
46 #include "magick/color.h"
47 #include "magick/compare.h"
48 #include "magick/constitute.h"
49 #include "magick/draw.h"
50 #include "magick/effect.h"
51 #include "magick/exception.h"
52 #include "magick/exception-private.h"
53 #include "magick/fx.h"
54 #include "magick/fx-private.h"
55 #include "magick/gem.h"
56 #include "magick/geometry.h"
57 #include "magick/histogram.h"
58 #include "magick/image.h"
59 #include "magick/image.h"
60 #include "magick/layer.h"
61 #include "magick/list.h"
62 #include "magick/magick.h"
63 #include "magick/memory_.h"
64 #include "magick/monitor.h"
65 #include "magick/montage.h"
66 #include "magick/option.h"
67 #include "magick/profile.h"
68 #include "magick/property.h"
69 #include "magick/quantum.h"
70 #include "magick/resource_.h"
71 #include "magick/splay-tree.h"
72 #include "magick/signature-private.h"
73 #include "magick/statistic.h"
74 #include "magick/string_.h"
75 #include "magick/string-private.h"
76 #include "magick/token.h"
77 #include "magick/utility.h"
78 #include "magick/version.h"
79 #include "magick/xml-tree.h"
80 \f
81 /*
82 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
83 %                                                                             %
84 %                                                                             %
85 %                                                                             %
86 %   C l o n e I m a g e P r o p e r t i e s                                   %
87 %                                                                             %
88 %                                                                             %
89 %                                                                             %
90 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
91 %
92 %  CloneImageProperties() clones one or more image properties.
93 %
94 %  The format of the CloneImageProperties method is:
95 %
96 %      MagickBooleanType CloneImageProperties(Image *image,
97 %        const Image *clone_image)
98 %
99 %  A description of each parameter follows:
100 %
101 %    o image: the image.
102 %
103 %    o clone_image: the clone image.
104 %
105 */
106 MagickExport MagickBooleanType CloneImageProperties(Image *image,
107   const Image *clone_image)
108 {
109   assert(image != (Image *) NULL);
110   assert(image->signature == MagickSignature);
111   if (image->debug != MagickFalse)
112     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
113   assert(clone_image != (const Image *) NULL);
114   assert(clone_image->signature == MagickSignature);
115   if (clone_image->debug != MagickFalse)
116     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
117       clone_image->filename);
118   (void) CopyMagickString(image->filename,clone_image->filename,MaxTextExtent);
119   (void) CopyMagickString(image->magick_filename,clone_image->magick_filename,
120     MaxTextExtent);
121   image->compression=clone_image->compression;
122   image->quality=clone_image->quality;
123   image->depth=clone_image->depth;
124   image->background_color=clone_image->background_color;
125   image->border_color=clone_image->border_color;
126   image->matte_color=clone_image->matte_color;
127   image->transparent_color=clone_image->transparent_color;
128   image->gamma=clone_image->gamma;
129   image->chromaticity=clone_image->chromaticity;
130   image->rendering_intent=clone_image->rendering_intent;
131   image->black_point_compensation=clone_image->black_point_compensation;
132   image->units=clone_image->units;
133   image->montage=(char *) NULL;
134   image->directory=(char *) NULL;
135   (void) CloneString(&image->geometry,clone_image->geometry);
136   image->offset=clone_image->offset;
137   image->x_resolution=clone_image->x_resolution;
138   image->y_resolution=clone_image->y_resolution;
139   image->page=clone_image->page;
140   image->tile_offset=clone_image->tile_offset;
141   image->extract_info=clone_image->extract_info;
142   image->bias=clone_image->bias;
143   image->filter=clone_image->filter;
144   image->blur=clone_image->blur;
145   image->fuzz=clone_image->fuzz;
146   image->interlace=clone_image->interlace;
147   image->interpolate=clone_image->interpolate;
148   image->endian=clone_image->endian;
149   image->gravity=clone_image->gravity;
150   image->compose=clone_image->compose;
151   image->scene=clone_image->scene;
152   image->orientation=clone_image->orientation;
153   image->dispose=clone_image->dispose;
154   image->delay=clone_image->delay;
155   image->ticks_per_second=clone_image->ticks_per_second;
156   image->iterations=clone_image->iterations;
157   image->total_colors=clone_image->total_colors;
158   image->taint=clone_image->taint;
159   image->progress_monitor=clone_image->progress_monitor;
160   image->client_data=clone_image->client_data;
161   image->start_loop=clone_image->start_loop;
162   image->error=clone_image->error;
163   image->signature=clone_image->signature;
164   if (clone_image->properties != (void *) NULL)
165     {
166       if (image->properties != (void *) NULL)
167         DestroyImageProperties(image);
168       image->properties=CloneSplayTree((SplayTreeInfo *)
169         clone_image->properties,(void *(*)(void *)) ConstantString,
170         (void *(*)(void *)) ConstantString);
171     }
172   return(MagickTrue);
173 }
174 \f
175 /*
176 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
177 %                                                                             %
178 %                                                                             %
179 %                                                                             %
180 %   D e f i n e I m a g e P r o p e r t y                                     %
181 %                                                                             %
182 %                                                                             %
183 %                                                                             %
184 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
185 %
186 %  DefineImageProperty() associates a key/value pair with an image property.
187 %
188 %  The format of the DefineImageProperty method is:
189 %
190 %      MagickBooleanType DefineImageProperty(Image *image,
191 %        const char *property)
192 %
193 %  A description of each parameter follows:
194 %
195 %    o image: the image.
196 %
197 %    o property: the image property.
198 %
199 */
200 MagickExport MagickBooleanType DefineImageProperty(Image *image,
201   const char *property)
202 {
203   char
204     key[MaxTextExtent],
205     value[MaxTextExtent];
206
207   register char
208     *p;
209
210   assert(image != (Image *) NULL);
211   assert(property != (const char *) NULL);
212   (void) CopyMagickString(key,property,MaxTextExtent-1);
213   for (p=key; *p != '\0'; p++)
214     if (*p == '=')
215       break;
216   *value='\0';
217   if (*p == '=')
218     (void) CopyMagickString(value,p+1,MaxTextExtent);
219   *p='\0';
220   return(SetImageProperty(image,key,value));
221 }
222 \f
223 /*
224 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
225 %                                                                             %
226 %                                                                             %
227 %                                                                             %
228 %   D e l e t e I m a g e P r o p e r t y                                     %
229 %                                                                             %
230 %                                                                             %
231 %                                                                             %
232 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
233 %
234 %  DeleteImageProperty() deletes an image property.
235 %
236 %  The format of the DeleteImageProperty method is:
237 %
238 %      MagickBooleanType DeleteImageProperty(Image *image,const char *property)
239 %
240 %  A description of each parameter follows:
241 %
242 %    o image: the image.
243 %
244 %    o property: the image property.
245 %
246 */
247 MagickExport MagickBooleanType DeleteImageProperty(Image *image,
248   const char *property)
249 {
250   assert(image != (Image *) NULL);
251   assert(image->signature == MagickSignature);
252   if (image->debug != MagickFalse)
253     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
254       image->filename);
255   if (image->properties == (void *) NULL)
256     return(MagickFalse);
257   return(DeleteNodeFromSplayTree((SplayTreeInfo *) image->properties,property));
258 }
259 \f
260 /*
261 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
262 %                                                                             %
263 %                                                                             %
264 %                                                                             %
265 %   D e s t r o y I m a g e P r o p e r t i e s                               %
266 %                                                                             %
267 %                                                                             %
268 %                                                                             %
269 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
270 %
271 %  DestroyImageProperties() releases memory associated with image property
272 %  values.
273 %
274 %  The format of the DestroyDefines method is:
275 %
276 %      void DestroyImageProperties(Image *image)
277 %
278 %  A description of each parameter follows:
279 %
280 %    o image: the image.
281 %
282 */
283 MagickExport void DestroyImageProperties(Image *image)
284 {
285   assert(image != (Image *) NULL);
286   assert(image->signature == MagickSignature);
287   if (image->debug != MagickFalse)
288     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
289       image->filename);
290   if (image->properties != (void *) NULL)
291     image->properties=(void *) DestroySplayTree((SplayTreeInfo *)
292       image->properties);
293 }
294 \f
295 /*
296 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
297 %                                                                             %
298 %                                                                             %
299 %                                                                             %
300 %  F o r m a t I m a g e P r o p e r t y                                      %
301 %                                                                             %
302 %                                                                             %
303 %                                                                             %
304 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
305 %
306 %  FormatImageProperty() permits formatted property/value pairs to be saved as
307 %  an image proporty.
308 %
309 %  The format of the FormatImageProperty method is:
310 %
311 %      MagickBooleanType FormatImageProperty(Image *image,const char *property,
312 %        const char *format,...)
313 %
314 %  A description of each parameter follows.
315 %
316 %   o  image:  The image.
317 %
318 %   o  property:  The attribute property.
319 %
320 %   o  format:  A string describing the format to use to write the remaining
321 %      arguments.
322 %
323 */
324
325 MagickExport MagickBooleanType FormatImagePropertyList(Image *image,
326   const char *property,const char *format,va_list operands)
327 {
328   char
329     value[MaxTextExtent];
330
331   int
332     n;
333
334 #if defined(MAGICKCORE_HAVE_VSNPRINTF)
335   n=vsnprintf(value,MaxTextExtent,format,operands);
336 #else
337   n=vsprintf(value,format,operands);
338 #endif
339   if (n < 0)
340     value[MaxTextExtent-1]='\0';
341   return(SetImageProperty(image,property,value));
342 }
343
344 MagickExport MagickBooleanType FormatImageProperty(Image *image,
345   const char *property,const char *format,...)
346 {
347   MagickBooleanType
348     status;
349
350   va_list
351     operands;
352
353   va_start(operands,format);
354   status=FormatImagePropertyList(image,property,format,operands);
355   va_end(operands);
356   return(status);
357 }
358 \f
359 /*
360 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
361 %                                                                             %
362 %                                                                             %
363 %                                                                             %
364 %   G e t I m a g e P r o p e r t y                                           %
365 %                                                                             %
366 %                                                                             %
367 %                                                                             %
368 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
369 %
370 %  GetImageProperty() gets a value associated with an image property.
371 %
372 %  The format of the GetImageProperty method is:
373 %
374 %      const char *GetImageProperty(const Image *image,const char *key)
375 %
376 %  A description of each parameter follows:
377 %
378 %    o image: the image.
379 %
380 %    o key: the key.
381 %
382 */
383
384 static char
385   *TracePSClippath(const unsigned char *,size_t,const size_t,
386     const size_t),
387   *TraceSVGClippath(const unsigned char *,size_t,const size_t,
388     const size_t);
389
390 static MagickBooleanType GetIPTCProperty(const Image *image,const char *key)
391 {
392   char
393     *attribute,
394     *message;
395
396   const StringInfo
397     *profile;
398
399   long
400     count,
401     dataset,
402     record;
403
404   register ssize_t
405     i;
406
407   size_t
408     length;
409
410   profile=GetImageProfile(image,"iptc");
411   if (profile == (StringInfo *) NULL)
412     profile=GetImageProfile(image,"8bim");
413   if (profile == (StringInfo *) NULL)
414     return(MagickFalse);
415   count=sscanf(key,"IPTC:%ld:%ld",&dataset,&record);
416   if (count != 2)
417     return(MagickFalse);
418   attribute=(char *) NULL;
419   for (i=0; i < (ssize_t) GetStringInfoLength(profile); i+=(ssize_t) length)
420   {
421     length=1;
422     if ((ssize_t) GetStringInfoDatum(profile)[i] != 0x1c)
423       continue;
424     length=(size_t) (GetStringInfoDatum(profile)[i+3] << 8);
425     length|=GetStringInfoDatum(profile)[i+4];
426     if (((long) GetStringInfoDatum(profile)[i+1] == dataset) &&
427         ((long) GetStringInfoDatum(profile)[i+2] == record))
428       {
429         message=(char *) NULL;
430         if (~length >= 1)
431           message=(char *) AcquireQuantumMemory(length+1UL,sizeof(*message));
432         if (message != (char *) NULL)
433           {
434             (void) CopyMagickString(message,(char *) GetStringInfoDatum(
435               profile)+i+5,length+1);
436             (void) ConcatenateString(&attribute,message);
437             (void) ConcatenateString(&attribute,";");
438             message=DestroyString(message);
439           }
440       }
441     i+=5;
442   }
443   if ((attribute == (char *) NULL) || (*attribute == ';'))
444     {
445       if (attribute != (char *) NULL)
446         attribute=DestroyString(attribute);
447       return(MagickFalse);
448     }
449   attribute[strlen(attribute)-1]='\0';
450   (void) SetImageProperty((Image *) image,key,(const char *) attribute);
451   attribute=DestroyString(attribute);
452   return(MagickTrue);
453 }
454
455 static inline ssize_t MagickMax(const ssize_t x,const ssize_t y)
456 {
457   if (x > y)
458     return(x);
459   return(y);
460 }
461
462 static inline int ReadPropertyByte(const unsigned char **p,size_t *length)
463 {
464   int
465     c;
466
467   if (*length < 1)
468     return(EOF);
469   c=(int) (*(*p)++);
470   (*length)--;
471   return(c);
472 }
473
474 static inline size_t ReadPropertyMSBLong(const unsigned char **p,
475   size_t *length)
476 {
477   int
478     c;
479
480   register ssize_t
481     i;
482
483   unsigned char
484     buffer[4];
485
486   size_t
487     value;
488
489   if (*length < 4)
490     return(~0UL);
491   for (i=0; i < 4; i++)
492   {
493     c=(int) (*(*p)++);
494     (*length)--;
495     buffer[i]=(unsigned char) c;
496   }
497   value=(size_t) (buffer[0] << 24);
498   value|=buffer[1] << 16;
499   value|=buffer[2] << 8;
500   value|=buffer[3];
501   return(value & 0xffffffff);
502 }
503
504 static inline unsigned short ReadPropertyMSBShort(const unsigned char **p,
505   size_t *length)
506 {
507   int
508     c;
509
510   register ssize_t
511     i;
512
513   unsigned char
514     buffer[2];
515
516   unsigned short
517     value;
518
519   if (*length < 2)
520     return((unsigned short) ~0U);
521   for (i=0; i < 2; i++)
522   {
523     c=(int) (*(*p)++);
524     (*length)--;
525     buffer[i]=(unsigned char) c;
526   }
527   value=(unsigned short) (buffer[0] << 8);
528   value|=buffer[1];
529   return((unsigned short) (value & 0xffff));
530 }
531
532 static MagickBooleanType Get8BIMProperty(const Image *image,const char *key)
533 {
534   char
535     *attribute,
536     format[MaxTextExtent],
537     name[MaxTextExtent],
538     *resource;
539
540   const StringInfo
541     *profile;
542
543   const unsigned char
544     *info;
545
546   long
547     start,
548     stop;
549
550   MagickBooleanType
551     status;
552
553   register ssize_t
554     i;
555
556   ssize_t
557     count,
558     id,
559     sub_number;
560
561   size_t
562     length;
563
564   /*
565     There's no newlines in path names, so it's safe as terminator.
566   */
567   profile=GetImageProfile(image,"8bim");
568   if (profile == (StringInfo *) NULL)
569     return(MagickFalse);
570   count=(ssize_t) sscanf(key,"8BIM:%ld,%ld:%[^\n]\n%[^\n]",&start,&stop,name,
571     format);
572   if ((count != 2) && (count != 3) && (count != 4))
573     return(MagickFalse);
574   if (count < 4)
575     (void) CopyMagickString(format,"SVG",MaxTextExtent);
576   if (count < 3)
577     *name='\0';
578   sub_number=1;
579   if (*name == '#')
580     sub_number=(ssize_t) StringToLong(&name[1]);
581   sub_number=MagickMax(sub_number,1L);
582   resource=(char *) NULL;
583   status=MagickFalse;
584   length=GetStringInfoLength(profile);
585   info=GetStringInfoDatum(profile);
586   while ((length > 0) && (status == MagickFalse))
587   {
588     if (ReadPropertyByte(&info,&length) != (unsigned char) '8')
589       continue;
590     if (ReadPropertyByte(&info,&length) != (unsigned char) 'B')
591       continue;
592     if (ReadPropertyByte(&info,&length) != (unsigned char) 'I')
593       continue;
594     if (ReadPropertyByte(&info,&length) != (unsigned char) 'M')
595       continue;
596     id=(ssize_t) ReadPropertyMSBShort(&info,&length);
597     if (id < (ssize_t) start)
598       continue;
599     if (id > (ssize_t) stop)
600       continue;
601     if (resource != (char *) NULL)
602       resource=DestroyString(resource);
603     count=(ssize_t) ReadPropertyByte(&info,&length);
604     if ((count != 0) && ((size_t) count <= length))
605       {
606         resource=(char *) NULL;
607         if (~(1UL*count) >= MaxTextExtent)
608           resource=(char *) AcquireQuantumMemory((size_t) count+MaxTextExtent,
609             sizeof(*resource));
610         if (resource != (char *) NULL)
611           {
612             for (i=0; i < (ssize_t) count; i++)
613               resource[i]=(char) ReadPropertyByte(&info,&length);
614             resource[count]='\0';
615           }
616       }
617     if ((count & 0x01) == 0)
618       (void) ReadPropertyByte(&info,&length);
619     count=(ssize_t) ((int) ReadPropertyMSBLong(&info,&length));
620     if ((*name != '\0') && (*name != '#'))
621       if ((resource == (char *) NULL) || (LocaleCompare(name,resource) != 0))
622         {
623           /*
624             No name match, scroll forward and try next.
625           */
626           info+=count;
627           length-=count;
628           continue;
629         }
630     if ((*name == '#') && (sub_number != 1))
631       {
632         /*
633           No numbered match, scroll forward and try next.
634         */
635         sub_number--;
636         info+=count;
637         length-=count;
638         continue;
639       }
640     /*
641       We have the resource of interest.
642     */
643     attribute=(char *) NULL;
644     if (~(1UL*count) >= MaxTextExtent)
645       attribute=(char *) AcquireQuantumMemory((size_t) count+MaxTextExtent,
646         sizeof(*attribute));
647     if (attribute != (char *) NULL)
648       {
649         (void) CopyMagickMemory(attribute,(char *) info,(size_t) count);
650         attribute[count]='\0';
651         info+=count;
652         length-=count;
653         if ((id <= 1999) || (id >= 2999))
654           (void) SetImageProperty((Image *) image,key,(const char *)
655             attribute);
656         else
657           {
658             char
659               *path;
660
661             if (LocaleCompare(format,"svg") == 0)
662               path=TraceSVGClippath((unsigned char *) attribute,(size_t) count,
663                 image->columns,image->rows);
664             else
665               path=TracePSClippath((unsigned char *) attribute,(size_t) count,
666                 image->columns,image->rows);
667             (void) SetImageProperty((Image *) image,key,(const char *) path);
668             path=DestroyString(path);
669           }
670         attribute=DestroyString(attribute);
671         status=MagickTrue;
672       }
673   }
674   if (resource != (char *) NULL)
675     resource=DestroyString(resource);
676   return(status);
677 }
678
679 static inline unsigned short ReadPropertyShort(const EndianType endian,
680   const unsigned char *buffer)
681 {
682   unsigned short
683     value;
684
685   if (endian == MSBEndian)
686     {
687       value=(unsigned short) ((((unsigned char *) buffer)[0] << 8) |
688         ((unsigned char *) buffer)[1]);
689       return((unsigned short) (value & 0xffff));
690     }
691   value=(unsigned short) ((buffer[1] << 8) | buffer[0]);
692   return((unsigned short) (value & 0xffff));
693 }
694
695 static inline size_t ReadPropertyLong(const EndianType endian,
696   const unsigned char *buffer)
697 {
698   size_t
699     value;
700
701   if (endian == MSBEndian)
702     {
703       value=(size_t) ((buffer[0] << 24) | (buffer[1] << 16) |
704         (buffer[2] << 8) | buffer[3]);
705       return((size_t) (value & 0xffffffff));
706     }
707   value=(size_t) ((buffer[3] << 24) | (buffer[2] << 16) |
708     (buffer[1] << 8 ) | (buffer[0]));
709   return((size_t) (value & 0xffffffff));
710 }
711
712 static MagickBooleanType GetEXIFProperty(const Image *image,
713   const char *property)
714 {
715 #define MaxDirectoryStack  16
716 #define EXIF_DELIMITER  "\n"
717 #define EXIF_NUM_FORMATS  12
718 #define EXIF_FMT_BYTE  1
719 #define EXIF_FMT_STRING  2
720 #define EXIF_FMT_USHORT  3
721 #define EXIF_FMT_ULONG  4
722 #define EXIF_FMT_URATIONAL  5
723 #define EXIF_FMT_SBYTE  6
724 #define EXIF_FMT_UNDEFINED  7
725 #define EXIF_FMT_SSHORT  8
726 #define EXIF_FMT_SLONG  9
727 #define EXIF_FMT_SRATIONAL  10
728 #define EXIF_FMT_SINGLE  11
729 #define EXIF_FMT_DOUBLE  12
730 #define TAG_EXIF_OFFSET  0x8769
731 #define TAG_GPS_OFFSET  0x8825
732 #define TAG_INTEROP_OFFSET  0xa005
733
734 #define EXIFMultipleValues(size, format, arg) \
735 { \
736    ssize_t \
737      component; \
738  \
739    size_t \
740      length; \
741  \
742    unsigned char \
743      *p1; \
744  \
745    length=0; \
746    p1=p; \
747    for (component=0; component < components; component++) \
748    { \
749      length+=FormatMagickString(buffer+length,MaxTextExtent-length, \
750        format", ",arg); \
751      if (length >= MaxTextExtent - 1) \
752        length=MaxTextExtent-1; \
753      p1+=size; \
754    } \
755    if (length > 1) \
756      buffer[length-2]='\0'; \
757    value=AcquireString(buffer); \
758 }
759
760 #define EXIFMultipleFractions(size, format, arg1, arg2) \
761 { \
762    ssize_t \
763      component; \
764  \
765    size_t \
766      length; \
767  \
768    unsigned char \
769      *p1; \
770  \
771    length=0; \
772    p1=p; \
773    for (component=0; component < components; component++) \
774    { \
775      length+=FormatMagickString(buffer+length,MaxTextExtent-length, \
776        format", ",arg1, arg2); \
777      if (length >= MaxTextExtent - 1) \
778        length=MaxTextExtent-1; \
779      p1+=size; \
780    } \
781    if (length > 1) \
782      buffer[length-2]='\0'; \
783    value=AcquireString(buffer); \
784 }
785
786   typedef struct _DirectoryInfo
787   {
788     const unsigned char
789       *directory;
790
791     size_t
792       entry,
793       offset;
794   } DirectoryInfo;
795
796   typedef struct _TagInfo
797   {
798     size_t
799       tag;
800
801     const char
802       *description;
803   } TagInfo;
804
805   static TagInfo
806     EXIFTag[] =
807     {
808       {  0x001, "exif:InteroperabilityIndex" },
809       {  0x002, "exif:InteroperabilityVersion" },
810       {  0x100, "exif:ImageWidth" },
811       {  0x101, "exif:ImageLength" },
812       {  0x102, "exif:BitsPerSample" },
813       {  0x103, "exif:Compression" },
814       {  0x106, "exif:PhotometricInterpretation" },
815       {  0x10a, "exif:FillOrder" },
816       {  0x10d, "exif:DocumentName" },
817       {  0x10e, "exif:ImageDescription" },
818       {  0x10f, "exif:Make" },
819       {  0x110, "exif:Model" },
820       {  0x111, "exif:StripOffsets" },
821       {  0x112, "exif:Orientation" },
822       {  0x115, "exif:SamplesPerPixel" },
823       {  0x116, "exif:RowsPerStrip" },
824       {  0x117, "exif:StripByteCounts" },
825       {  0x11a, "exif:XResolution" },
826       {  0x11b, "exif:YResolution" },
827       {  0x11c, "exif:PlanarConfiguration" },
828       {  0x11d, "exif:PageName" },
829       {  0x11e, "exif:XPosition" },
830       {  0x11f, "exif:YPosition" },
831       {  0x118, "exif:MinSampleValue" },
832       {  0x119, "exif:MaxSampleValue" },
833       {  0x120, "exif:FreeOffsets" },
834       {  0x121, "exif:FreeByteCounts" },
835       {  0x122, "exif:GrayResponseUnit" },
836       {  0x123, "exif:GrayResponseCurve" },
837       {  0x124, "exif:T4Options" },
838       {  0x125, "exif:T6Options" },
839       {  0x128, "exif:ResolutionUnit" },
840       {  0x12d, "exif:TransferFunction" },
841       {  0x131, "exif:Software" },
842       {  0x132, "exif:DateTime" },
843       {  0x13b, "exif:Artist" },
844       {  0x13e, "exif:WhitePoint" },
845       {  0x13f, "exif:PrimaryChromaticities" },
846       {  0x140, "exif:ColorMap" },
847       {  0x141, "exif:HalfToneHints" },
848       {  0x142, "exif:TileWidth" },
849       {  0x143, "exif:TileLength" },
850       {  0x144, "exif:TileOffsets" },
851       {  0x145, "exif:TileByteCounts" },
852       {  0x14a, "exif:SubIFD" },
853       {  0x14c, "exif:InkSet" },
854       {  0x14d, "exif:InkNames" },
855       {  0x14e, "exif:NumberOfInks" },
856       {  0x150, "exif:DotRange" },
857       {  0x151, "exif:TargetPrinter" },
858       {  0x152, "exif:ExtraSample" },
859       {  0x153, "exif:SampleFormat" },
860       {  0x154, "exif:SMinSampleValue" },
861       {  0x155, "exif:SMaxSampleValue" },
862       {  0x156, "exif:TransferRange" },
863       {  0x157, "exif:ClipPath" },
864       {  0x158, "exif:XClipPathUnits" },
865       {  0x159, "exif:YClipPathUnits" },
866       {  0x15a, "exif:Indexed" },
867       {  0x15b, "exif:JPEGTables" },
868       {  0x15f, "exif:OPIProxy" },
869       {  0x200, "exif:JPEGProc" },
870       {  0x201, "exif:JPEGInterchangeFormat" },
871       {  0x202, "exif:JPEGInterchangeFormatLength" },
872       {  0x203, "exif:JPEGRestartInterval" },
873       {  0x205, "exif:JPEGLosslessPredictors" },
874       {  0x206, "exif:JPEGPointTransforms" },
875       {  0x207, "exif:JPEGQTables" },
876       {  0x208, "exif:JPEGDCTables" },
877       {  0x209, "exif:JPEGACTables" },
878       {  0x211, "exif:YCbCrCoefficients" },
879       {  0x212, "exif:YCbCrSubSampling" },
880       {  0x213, "exif:YCbCrPositioning" },
881       {  0x214, "exif:ReferenceBlackWhite" },
882       {  0x2bc, "exif:ExtensibleMetadataPlatform" },
883       {  0x301, "exif:Gamma" },
884       {  0x302, "exif:ICCProfileDescriptor" },
885       {  0x303, "exif:SRGBRenderingIntent" },
886       {  0x320, "exif:ImageTitle" },
887       {  0x5001, "exif:ResolutionXUnit" },
888       {  0x5002, "exif:ResolutionYUnit" },
889       {  0x5003, "exif:ResolutionXLengthUnit" },
890       {  0x5004, "exif:ResolutionYLengthUnit" },
891       {  0x5005, "exif:PrintFlags" },
892       {  0x5006, "exif:PrintFlagsVersion" },
893       {  0x5007, "exif:PrintFlagsCrop" },
894       {  0x5008, "exif:PrintFlagsBleedWidth" },
895       {  0x5009, "exif:PrintFlagsBleedWidthScale" },
896       {  0x500A, "exif:HalftoneLPI" },
897       {  0x500B, "exif:HalftoneLPIUnit" },
898       {  0x500C, "exif:HalftoneDegree" },
899       {  0x500D, "exif:HalftoneShape" },
900       {  0x500E, "exif:HalftoneMisc" },
901       {  0x500F, "exif:HalftoneScreen" },
902       {  0x5010, "exif:JPEGQuality" },
903       {  0x5011, "exif:GridSize" },
904       {  0x5012, "exif:ThumbnailFormat" },
905       {  0x5013, "exif:ThumbnailWidth" },
906       {  0x5014, "exif:ThumbnailHeight" },
907       {  0x5015, "exif:ThumbnailColorDepth" },
908       {  0x5016, "exif:ThumbnailPlanes" },
909       {  0x5017, "exif:ThumbnailRawBytes" },
910       {  0x5018, "exif:ThumbnailSize" },
911       {  0x5019, "exif:ThumbnailCompressedSize" },
912       {  0x501a, "exif:ColorTransferFunction" },
913       {  0x501b, "exif:ThumbnailData" },
914       {  0x5020, "exif:ThumbnailImageWidth" },
915       {  0x5021, "exif:ThumbnailImageHeight" },
916       {  0x5022, "exif:ThumbnailBitsPerSample" },
917       {  0x5023, "exif:ThumbnailCompression" },
918       {  0x5024, "exif:ThumbnailPhotometricInterp" },
919       {  0x5025, "exif:ThumbnailImageDescription" },
920       {  0x5026, "exif:ThumbnailEquipMake" },
921       {  0x5027, "exif:ThumbnailEquipModel" },
922       {  0x5028, "exif:ThumbnailStripOffsets" },
923       {  0x5029, "exif:ThumbnailOrientation" },
924       {  0x502a, "exif:ThumbnailSamplesPerPixel" },
925       {  0x502b, "exif:ThumbnailRowsPerStrip" },
926       {  0x502c, "exif:ThumbnailStripBytesCount" },
927       {  0x502d, "exif:ThumbnailResolutionX" },
928       {  0x502e, "exif:ThumbnailResolutionY" },
929       {  0x502f, "exif:ThumbnailPlanarConfig" },
930       {  0x5030, "exif:ThumbnailResolutionUnit" },
931       {  0x5031, "exif:ThumbnailTransferFunction" },
932       {  0x5032, "exif:ThumbnailSoftwareUsed" },
933       {  0x5033, "exif:ThumbnailDateTime" },
934       {  0x5034, "exif:ThumbnailArtist" },
935       {  0x5035, "exif:ThumbnailWhitePoint" },
936       {  0x5036, "exif:ThumbnailPrimaryChromaticities" },
937       {  0x5037, "exif:ThumbnailYCbCrCoefficients" },
938       {  0x5038, "exif:ThumbnailYCbCrSubsampling" },
939       {  0x5039, "exif:ThumbnailYCbCrPositioning" },
940       {  0x503A, "exif:ThumbnailRefBlackWhite" },
941       {  0x503B, "exif:ThumbnailCopyRight" },
942       {  0x5090, "exif:LuminanceTable" },
943       {  0x5091, "exif:ChrominanceTable" },
944       {  0x5100, "exif:FrameDelay" },
945       {  0x5101, "exif:LoopCount" },
946       {  0x5110, "exif:PixelUnit" },
947       {  0x5111, "exif:PixelPerUnitX" },
948       {  0x5112, "exif:PixelPerUnitY" },
949       {  0x5113, "exif:PaletteHistogram" },
950       {  0x1000, "exif:RelatedImageFileFormat" },
951       {  0x1001, "exif:RelatedImageLength" },
952       {  0x1002, "exif:RelatedImageWidth" },
953       {  0x800d, "exif:ImageID" },
954       {  0x80e3, "exif:Matteing" },
955       {  0x80e4, "exif:DataType" },
956       {  0x80e5, "exif:ImageDepth" },
957       {  0x80e6, "exif:TileDepth" },
958       {  0x828d, "exif:CFARepeatPatternDim" },
959       {  0x828e, "exif:CFAPattern2" },
960       {  0x828f, "exif:BatteryLevel" },
961       {  0x8298, "exif:Copyright" },
962       {  0x829a, "exif:ExposureTime" },
963       {  0x829d, "exif:FNumber" },
964       {  0x83bb, "exif:IPTC/NAA" },
965       {  0x84e3, "exif:IT8RasterPadding" },
966       {  0x84e5, "exif:IT8ColorTable" },
967       {  0x8649, "exif:ImageResourceInformation" },
968       {  0x8769, "exif:ExifOffset" },
969       {  0x8773, "exif:InterColorProfile" },
970       {  0x8822, "exif:ExposureProgram" },
971       {  0x8824, "exif:SpectralSensitivity" },
972       {  0x8825, "exif:GPSInfo" },
973       {  0x8827, "exif:ISOSpeedRatings" },
974       {  0x8828, "exif:OECF" },
975       {  0x8829, "exif:Interlace" },
976       {  0x882a, "exif:TimeZoneOffset" },
977       {  0x882b, "exif:SelfTimerMode" },
978       {  0x9000, "exif:ExifVersion" },
979       {  0x9003, "exif:DateTimeOriginal" },
980       {  0x9004, "exif:DateTimeDigitized" },
981       {  0x9101, "exif:ComponentsConfiguration" },
982       {  0x9102, "exif:CompressedBitsPerPixel" },
983       {  0x9201, "exif:ShutterSpeedValue" },
984       {  0x9202, "exif:ApertureValue" },
985       {  0x9203, "exif:BrightnessValue" },
986       {  0x9204, "exif:ExposureBiasValue" },
987       {  0x9205, "exif:MaxApertureValue" },
988       {  0x9206, "exif:SubjectDistance" },
989       {  0x9207, "exif:MeteringMode" },
990       {  0x9208, "exif:LightSource" },
991       {  0x9209, "exif:Flash" },
992       {  0x920a, "exif:FocalLength" },
993       {  0x920b, "exif:FlashEnergy" },
994       {  0x920c, "exif:SpatialFrequencyResponse" },
995       {  0x920d, "exif:Noise" },
996       {  0x9211, "exif:ImageNumber" },
997       {  0x9212, "exif:SecurityClassification" },
998       {  0x9213, "exif:ImageHistory" },
999       {  0x9214, "exif:SubjectArea" },
1000       {  0x9215, "exif:ExposureIndex" },
1001       {  0x9216, "exif:TIFF-EPStandardID" },
1002       {  0x927c, "exif:MakerNote" },
1003       {  0x9C9b, "exif:WinXP-Title" },
1004       {  0x9C9c, "exif:WinXP-Comments" },
1005       {  0x9C9d, "exif:WinXP-Author" },
1006       {  0x9C9e, "exif:WinXP-Keywords" },
1007       {  0x9C9f, "exif:WinXP-Subject" },
1008       {  0x9286, "exif:UserComment" },
1009       {  0x9290, "exif:SubSecTime" },
1010       {  0x9291, "exif:SubSecTimeOriginal" },
1011       {  0x9292, "exif:SubSecTimeDigitized" },
1012       {  0xa000, "exif:FlashPixVersion" },
1013       {  0xa001, "exif:ColorSpace" },
1014       {  0xa002, "exif:ExifImageWidth" },
1015       {  0xa003, "exif:ExifImageLength" },
1016       {  0xa004, "exif:RelatedSoundFile" },
1017       {  0xa005, "exif:InteroperabilityOffset" },
1018       {  0xa20b, "exif:FlashEnergy" },
1019       {  0xa20c, "exif:SpatialFrequencyResponse" },
1020       {  0xa20d, "exif:Noise" },
1021       {  0xa20e, "exif:FocalPlaneXResolution" },
1022       {  0xa20f, "exif:FocalPlaneYResolution" },
1023       {  0xa210, "exif:FocalPlaneResolutionUnit" },
1024       {  0xa214, "exif:SubjectLocation" },
1025       {  0xa215, "exif:ExposureIndex" },
1026       {  0xa216, "exif:TIFF/EPStandardID" },
1027       {  0xa217, "exif:SensingMethod" },
1028       {  0xa300, "exif:FileSource" },
1029       {  0xa301, "exif:SceneType" },
1030       {  0xa302, "exif:CFAPattern" },
1031       {  0xa401, "exif:CustomRendered" },
1032       {  0xa402, "exif:ExposureMode" },
1033       {  0xa403, "exif:WhiteBalance" },
1034       {  0xa404, "exif:DigitalZoomRatio" },
1035       {  0xa405, "exif:FocalLengthIn35mmFilm" },
1036       {  0xa406, "exif:SceneCaptureType" },
1037       {  0xa407, "exif:GainControl" },
1038       {  0xa408, "exif:Contrast" },
1039       {  0xa409, "exif:Saturation" },
1040       {  0xa40a, "exif:Sharpness" },
1041       {  0xa40b, "exif:DeviceSettingDescription" },
1042       {  0xa40c, "exif:SubjectDistanceRange" },
1043       {  0xa420, "exif:ImageUniqueID" },
1044       {  0xc4a5, "exif:PrintImageMatching" },
1045       {  0xa500, "exif:Gamma" },
1046       {  0xc640, "exif:CR2Slice" },
1047       { 0x10000, "exif:GPSVersionID" },
1048       { 0x10001, "exif:GPSLatitudeRef" },
1049       { 0x10002, "exif:GPSLatitude" },
1050       { 0x10003, "exif:GPSLongitudeRef" },
1051       { 0x10004, "exif:GPSLongitude" },
1052       { 0x10005, "exif:GPSAltitudeRef" },
1053       { 0x10006, "exif:GPSAltitude" },
1054       { 0x10007, "exif:GPSTimeStamp" },
1055       { 0x10008, "exif:GPSSatellites" },
1056       { 0x10009, "exif:GPSStatus" },
1057       { 0x1000a, "exif:GPSMeasureMode" },
1058       { 0x1000b, "exif:GPSDop" },
1059       { 0x1000c, "exif:GPSSpeedRef" },
1060       { 0x1000d, "exif:GPSSpeed" },
1061       { 0x1000e, "exif:GPSTrackRef" },
1062       { 0x1000f, "exif:GPSTrack" },
1063       { 0x10010, "exif:GPSImgDirectionRef" },
1064       { 0x10011, "exif:GPSImgDirection" },
1065       { 0x10012, "exif:GPSMapDatum" },
1066       { 0x10013, "exif:GPSDestLatitudeRef" },
1067       { 0x10014, "exif:GPSDestLatitude" },
1068       { 0x10015, "exif:GPSDestLongitudeRef" },
1069       { 0x10016, "exif:GPSDestLongitude" },
1070       { 0x10017, "exif:GPSDestBearingRef" },
1071       { 0x10018, "exif:GPSDestBearing" },
1072       { 0x10019, "exif:GPSDestDistanceRef" },
1073       { 0x1001a, "exif:GPSDestDistance" },
1074       { 0x1001b, "exif:GPSProcessingMethod" },
1075       { 0x1001c, "exif:GPSAreaInformation" },
1076       { 0x1001d, "exif:GPSDateStamp" },
1077       { 0x1001e, "exif:GPSDifferential" },
1078       {  0x0000, NULL}
1079     };
1080
1081   const StringInfo
1082     *profile;
1083
1084   const unsigned char
1085     *directory,
1086     *exif;
1087
1088   DirectoryInfo
1089     directory_stack[MaxDirectoryStack];
1090
1091   EndianType
1092     endian;
1093
1094   ssize_t
1095     all,
1096     id,
1097     level,
1098     tag_value;
1099
1100   register ssize_t
1101     i;
1102
1103   size_t
1104     length;
1105
1106   ssize_t
1107     offset;
1108
1109   static int
1110     tag_bytes[] = {0, 1, 1, 2, 4, 8, 1, 1, 2, 4, 8, 4, 8};
1111
1112   size_t
1113     entry,
1114     number_entries,
1115     tag_offset,
1116     tag;
1117
1118   /*
1119     If EXIF data exists, then try to parse the request for a tag.
1120   */
1121   profile=GetImageProfile(image,"exif");
1122   if (profile == (StringInfo *) NULL)
1123     return(MagickFalse);
1124   if ((property == (const char *) NULL) || (*property == '\0'))
1125     return(MagickFalse);
1126   while (isspace((int) ((unsigned char) *property)) != 0)
1127     property++;
1128   all=0;
1129   tag=(~0UL);
1130   switch (*(property+5))
1131   {
1132     case '*':
1133     {
1134       /*
1135         Caller has asked for all the tags in the EXIF data.
1136       */
1137       tag=0;
1138       all=1; /* return the data in description=value format */
1139       break;
1140     }
1141     case '!':
1142     {
1143       tag=0;
1144       all=2; /* return the data in tagid=value format */
1145       break;
1146     }
1147     case '#':
1148     case '@':
1149     {
1150       int
1151         c;
1152
1153       size_t
1154         n;
1155
1156       /*
1157         Check for a hex based tag specification first.
1158       */
1159       tag=(*(property+5) == '@') ? 1UL : 0UL;
1160       property+=6;
1161       n=strlen(property);
1162       if (n != 4)
1163         return(MagickFalse);
1164       /*
1165         Parse tag specification as a hex number.
1166       */
1167       n/=4;
1168       do
1169       {
1170         for (i=(ssize_t) n-1L; i >= 0; i--)
1171         {
1172           c=(*property++);
1173           tag<<=4;
1174           if ((c >= '0') && (c <= '9'))
1175             tag|=(c-'0');
1176           else
1177             if ((c >= 'A') && (c <= 'F'))
1178               tag|=(c-('A'-10));
1179             else
1180               if ((c >= 'a') && (c <= 'f'))
1181                 tag|=(c-('a'-10));
1182               else
1183                 return(MagickFalse);
1184         }
1185       } while (*property != '\0');
1186       break;
1187     }
1188     default:
1189     {
1190       /*
1191         Try to match the text with a tag name instead.
1192       */
1193       for (i=0; ; i++)
1194       {
1195         if (EXIFTag[i].tag == 0)
1196           break;
1197         if (LocaleCompare(EXIFTag[i].description,property) == 0)
1198           {
1199             tag=(size_t) EXIFTag[i].tag;
1200             break;
1201           }
1202       }
1203       break;
1204     }
1205   }
1206   if (tag == (~0UL))
1207     return(MagickFalse);
1208   length=GetStringInfoLength(profile);
1209   exif=GetStringInfoDatum(profile);
1210   while (length != 0)
1211   {
1212     if (ReadPropertyByte(&exif,&length) != 0x45)
1213       continue;
1214     if (ReadPropertyByte(&exif,&length) != 0x78)
1215       continue;
1216     if (ReadPropertyByte(&exif,&length) != 0x69)
1217       continue;
1218     if (ReadPropertyByte(&exif,&length) != 0x66)
1219       continue;
1220     if (ReadPropertyByte(&exif,&length) != 0x00)
1221       continue;
1222     if (ReadPropertyByte(&exif,&length) != 0x00)
1223       continue;
1224     break;
1225   }
1226   if (length < 16)
1227     return(MagickFalse);
1228   id=(ssize_t) ReadPropertyShort(LSBEndian,exif);
1229   endian=LSBEndian;
1230   if (id == 0x4949)
1231     endian=LSBEndian;
1232   else
1233     if (id == 0x4D4D)
1234       endian=MSBEndian;
1235     else
1236       return(MagickFalse);
1237   if (ReadPropertyShort(endian,exif+2) != 0x002a)
1238     return(MagickFalse);
1239   /*
1240     This the offset to the first IFD.
1241   */
1242   offset=(ssize_t) ((int) ReadPropertyLong(endian,exif+4));
1243   if ((size_t) offset >= length)
1244     return(MagickFalse);
1245   /*
1246     Set the pointer to the first IFD and follow it were it leads.
1247   */
1248   directory=exif+offset;
1249   level=0;
1250   entry=0;
1251   tag_offset=0;
1252   do
1253   {
1254     /*
1255       If there is anything on the stack then pop it off.
1256     */
1257     if (level > 0)
1258       {
1259         level--;
1260         directory=directory_stack[level].directory;
1261         entry=directory_stack[level].entry;
1262         tag_offset=directory_stack[level].offset;
1263       }
1264     /*
1265       Determine how many entries there are in the current IFD.
1266     */
1267     number_entries=ReadPropertyShort(endian,directory);
1268     for ( ; entry < number_entries; entry++)
1269     {
1270       ssize_t
1271         components;
1272
1273       register unsigned char
1274         *p,
1275         *q;
1276
1277       size_t
1278         number_bytes;
1279
1280       size_t
1281         format;
1282
1283       q=(unsigned char *) (directory+2+(12*entry));
1284       tag_value=(ssize_t) (ReadPropertyShort(endian,q)+tag_offset);
1285       format=(size_t) ReadPropertyShort(endian,q+2);
1286       if (format >= (sizeof(tag_bytes)/sizeof(*tag_bytes)))
1287         break;
1288       components=(ssize_t) ((int) ReadPropertyLong(endian,q+4));
1289       number_bytes=(size_t) components*tag_bytes[format];
1290       if (number_bytes <= 4)
1291         p=q+8;
1292       else
1293         {
1294           ssize_t
1295             offset;
1296
1297           /*
1298             The directory entry contains an offset.
1299           */
1300           offset=(ssize_t) ((int) ReadPropertyLong(endian,q+8));
1301           if ((size_t) (offset+number_bytes) > length)
1302             continue;
1303           p=(unsigned char *) (exif+offset);
1304         }
1305       if ((all != 0) || (tag == (size_t) tag_value))
1306         {
1307           char
1308             buffer[MaxTextExtent],
1309             *value;
1310
1311           switch (format)
1312           {
1313             case EXIF_FMT_BYTE:
1314             case EXIF_FMT_UNDEFINED:
1315             {
1316               EXIFMultipleValues(1,"%.20g",(double)
1317                 (*(unsigned char *) p1));
1318               break;
1319             }
1320             case EXIF_FMT_SBYTE:
1321             {
1322               EXIFMultipleValues(1,"%.20g",(double) (*(signed char *) p1));
1323               break;
1324             }
1325             case EXIF_FMT_SSHORT:
1326             {
1327               EXIFMultipleValues(2,"%hd",ReadPropertyShort(endian,p1));
1328               break;
1329             }
1330             case EXIF_FMT_USHORT:
1331             {
1332               EXIFMultipleValues(2,"%hu",ReadPropertyShort(endian,p1));
1333               break;
1334             }
1335             case EXIF_FMT_ULONG:
1336             {
1337               EXIFMultipleValues(4,"%.20g",(double)
1338                 ReadPropertyLong(endian,p1));
1339               break;
1340             }
1341             case EXIF_FMT_SLONG:
1342             {
1343               EXIFMultipleValues(4,"%.20g",(double)
1344                 ReadPropertyLong(endian,p1));
1345               break;
1346             }
1347             case EXIF_FMT_URATIONAL:
1348             {
1349               EXIFMultipleFractions(8,"%.20g/%.20g",(double)
1350                 ReadPropertyLong(endian,p1),(double)
1351                 ReadPropertyLong(endian,p1+4));
1352               break;
1353             }
1354             case EXIF_FMT_SRATIONAL:
1355             {
1356               EXIFMultipleFractions(8,"%.20g/%.20g",(double)
1357                 ReadPropertyLong(endian,p1),(double)
1358                 ReadPropertyLong(endian,p1+4));
1359               break;
1360             }
1361             case EXIF_FMT_SINGLE:
1362             {
1363               EXIFMultipleValues(4,"%f",(double) *(float *) p1);
1364               break;
1365             }
1366             case EXIF_FMT_DOUBLE:
1367             {
1368               EXIFMultipleValues(8,"%f",*(double *) p1);
1369               break;
1370             }
1371             default:
1372             case EXIF_FMT_STRING:
1373             {
1374               value=(char *) NULL;
1375               if (~(1UL*number_bytes) >= 1)
1376                 value=(char *) AcquireQuantumMemory((size_t) number_bytes+1UL,
1377                   sizeof(*value));
1378               if (value != (char *) NULL)
1379                 {
1380                   register ssize_t
1381                     i;
1382
1383                   for (i=0; i < (ssize_t) number_bytes; i++)
1384                   {
1385                     value[i]='.';
1386                     if ((isprint((int) p[i]) != 0) || (p[i] == '\0'))
1387                       value[i]=(char) p[i];
1388                   }
1389                   value[i]='\0';
1390                 }
1391               break;
1392             }
1393           }
1394           if (value != (char *) NULL)
1395             {
1396               char
1397                 key[MaxTextExtent];
1398
1399               register const char
1400                 *p;
1401
1402               (void) CopyMagickString(key,property,MaxTextExtent);
1403               switch (all)
1404               {
1405                 case 1:
1406                 {
1407                   const char
1408                     *description;
1409
1410                   register ssize_t
1411                     i;
1412
1413                   description="unknown";
1414                   for (i=0; ; i++)
1415                   {
1416                     if (EXIFTag[i].tag == 0)
1417                       break;
1418                     if ((ssize_t) EXIFTag[i].tag == tag_value)
1419                       {
1420                         description=EXIFTag[i].description;
1421                         break;
1422                       }
1423                   }
1424                   (void) FormatMagickString(key,MaxTextExtent,"%s",
1425                     description);
1426                   break;
1427                 }
1428                 case 2:
1429                 {
1430                   if (tag_value < 0x10000)
1431                     (void) FormatMagickString(key,MaxTextExtent,"#%04lx",
1432                       (unsigned long) tag_value);
1433                   else
1434                     if (tag_value < 0x20000)
1435                       (void) FormatMagickString(key,MaxTextExtent,"@%04lx",
1436                         (unsigned long) (tag_value & 0xffff));
1437                     else
1438                       (void) FormatMagickString(key,MaxTextExtent,"unknown");
1439                   break;
1440                 }
1441               }
1442               p=(const char *) NULL;
1443               if (image->properties != (void *) NULL)
1444                 p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
1445                   image->properties,key);
1446               if (p == (const char *) NULL)
1447                 (void) SetImageProperty((Image *) image,key,value);
1448               value=DestroyString(value);
1449             }
1450         }
1451         if ((tag_value == TAG_EXIF_OFFSET) ||
1452             (tag_value == TAG_INTEROP_OFFSET) ||
1453             (tag_value == TAG_GPS_OFFSET))
1454           {
1455             size_t
1456               offset;
1457
1458             offset=(size_t) ReadPropertyLong(endian,p);
1459             if ((offset < length) && (level < (MaxDirectoryStack-2)))
1460               {
1461                 size_t
1462                   tag_offset1;
1463
1464                 tag_offset1=(tag_value == TAG_GPS_OFFSET) ? 0x10000UL : 0UL;
1465                 directory_stack[level].directory=directory;
1466                 entry++;
1467                 directory_stack[level].entry=entry;
1468                 directory_stack[level].offset=tag_offset;
1469                 level++;
1470                 directory_stack[level].directory=exif+offset;
1471                 directory_stack[level].offset=tag_offset1;
1472                 directory_stack[level].entry=0;
1473                 level++;
1474                 if ((directory+2+(12*number_entries)) > (exif+length))
1475                   break;
1476                 offset=(size_t) ReadPropertyLong(endian,directory+2+(12*
1477                   number_entries));
1478                 if ((offset != 0) && (offset < length) &&
1479                     (level < (MaxDirectoryStack-2)))
1480                   {
1481                     directory_stack[level].directory=exif+offset;
1482                     directory_stack[level].entry=0;
1483                     directory_stack[level].offset=tag_offset1;
1484                     level++;
1485                   }
1486               }
1487             break;
1488           }
1489     }
1490   } while (level > 0);
1491   return(MagickTrue);
1492 }
1493
1494 static MagickBooleanType GetXMPProperty(const Image *image,
1495   const char *property)
1496 {
1497   char
1498     *xmp_profile;
1499
1500   const StringInfo
1501     *profile;
1502
1503   ExceptionInfo
1504     *exception;
1505
1506   MagickBooleanType
1507     status;
1508
1509   register const char
1510     *p;
1511
1512   XMLTreeInfo
1513     *child,
1514     *description,
1515     *node,
1516     *rdf,
1517     *xmp;
1518
1519   profile=GetImageProfile(image,"xmp");
1520   if (profile == (StringInfo *) NULL)
1521     return(MagickFalse);
1522   if ((property == (const char *) NULL) || (*property == '\0'))
1523     return(MagickFalse);
1524   xmp_profile=StringInfoToString(profile);
1525   if (xmp_profile == (char *) NULL)
1526     return(MagickFalse);
1527   for (p=xmp_profile; *p != '\0'; p++)
1528     if ((*p == '<') && (*(p+1) == 'x'))
1529       break;
1530   exception=AcquireExceptionInfo();
1531   xmp=NewXMLTree((char *) p,exception);
1532   xmp_profile=DestroyString(xmp_profile);
1533   exception=DestroyExceptionInfo(exception);
1534   if (xmp == (XMLTreeInfo *) NULL)
1535     return(MagickFalse);
1536   status=MagickFalse;
1537   rdf=GetXMLTreeChild(xmp,"rdf:RDF");
1538   if (rdf != (XMLTreeInfo *) NULL)
1539     {
1540       if (image->properties == (void *) NULL)
1541         ((Image *) image)->properties=NewSplayTree(CompareSplayTreeString,
1542           RelinquishMagickMemory,RelinquishMagickMemory);
1543       description=GetXMLTreeChild(rdf,"rdf:Description");
1544       while (description != (XMLTreeInfo *) NULL)
1545       {
1546         node=GetXMLTreeChild(description,(const char *) NULL);
1547         while (node != (XMLTreeInfo *) NULL)
1548         {
1549           child=GetXMLTreeChild(node,(const char *) NULL);
1550           if (child == (XMLTreeInfo *) NULL)
1551             (void) AddValueToSplayTree((SplayTreeInfo *) image->properties,
1552               ConstantString(GetXMLTreeTag(node)),
1553               ConstantString(GetXMLTreeContent(node)));
1554           while (child != (XMLTreeInfo *) NULL)
1555           {
1556             if (LocaleCompare(GetXMLTreeTag(child),"rdf:Seq") != 0)
1557               (void) AddValueToSplayTree((SplayTreeInfo *) image->properties,
1558                 ConstantString(GetXMLTreeTag(child)),
1559                 ConstantString(GetXMLTreeContent(child)));
1560             child=GetXMLTreeSibling(child);
1561           }
1562           node=GetXMLTreeSibling(node);
1563         }
1564         description=GetNextXMLTreeTag(description);
1565       }
1566     }
1567   xmp=DestroyXMLTree(xmp);
1568   return(status);
1569 }
1570
1571 static char *TracePSClippath(const unsigned char *blob,size_t length,
1572   const size_t magick_unused(columns),
1573   const size_t magick_unused(rows))
1574 {
1575   char
1576     *path,
1577     *message;
1578
1579   ssize_t
1580     knot_count,
1581     selector,
1582     y;
1583
1584   MagickBooleanType
1585     in_subpath;
1586
1587   PointInfo
1588     first[3],
1589     last[3],
1590     point[3];
1591
1592   register ssize_t
1593     i,
1594     x;
1595
1596   path=AcquireString((char *) NULL);
1597   if (path == (char *) NULL)
1598     return((char *) NULL);
1599   message=AcquireString((char *) NULL);
1600   (void) FormatMagickString(message,MaxTextExtent,"/ClipImage\n");
1601   (void) ConcatenateString(&path,message);
1602   (void) FormatMagickString(message,MaxTextExtent,"{\n");
1603   (void) ConcatenateString(&path,message);
1604   (void) FormatMagickString(message,MaxTextExtent,"  /c {curveto} bind def\n");
1605   (void) ConcatenateString(&path,message);
1606   (void) FormatMagickString(message,MaxTextExtent,"  /l {lineto} bind def\n");
1607   (void) ConcatenateString(&path,message);
1608   (void) FormatMagickString(message,MaxTextExtent,"  /m {moveto} bind def\n");
1609   (void) ConcatenateString(&path,message);
1610   (void) FormatMagickString(message,MaxTextExtent,
1611     "  /v {currentpoint 6 2 roll curveto} bind def\n");
1612   (void) ConcatenateString(&path,message);
1613   (void) FormatMagickString(message,MaxTextExtent,
1614     "  /y {2 copy curveto} bind def\n");
1615   (void) ConcatenateString(&path,message);
1616   (void) FormatMagickString(message,MaxTextExtent,
1617     "  /z {closepath} bind def\n");
1618   (void) ConcatenateString(&path,message);
1619   (void) FormatMagickString(message,MaxTextExtent,"  newpath\n");
1620   (void) ConcatenateString(&path,message);
1621   /*
1622     The clipping path format is defined in "Adobe Photoshop File
1623     Formats Specification" version 6.0 downloadable from adobe.com.
1624   */
1625   (void) ResetMagickMemory(point,0,sizeof(point));
1626   (void) ResetMagickMemory(first,0,sizeof(first));
1627   (void) ResetMagickMemory(last,0,sizeof(last));
1628   knot_count=0;
1629   in_subpath=MagickFalse;
1630   while (length > 0)
1631   {
1632     selector=(ssize_t) ReadPropertyMSBShort(&blob,&length);
1633     switch (selector)
1634     {
1635       case 0:
1636       case 3:
1637       {
1638         if (knot_count != 0)
1639           {
1640             blob+=24;
1641             length-=24;
1642             break;
1643           }
1644         /*
1645           Expected subpath length record.
1646         */
1647         knot_count=(ssize_t) ReadPropertyMSBShort(&blob,&length);
1648         blob+=22;
1649         length-=22;
1650         break;
1651       }
1652       case 1:
1653       case 2:
1654       case 4:
1655       case 5:
1656       {
1657         if (knot_count == 0)
1658           {
1659             /*
1660               Unexpected subpath knot
1661             */
1662             blob+=24;
1663             length-=24;
1664             break;
1665           }
1666         /*
1667           Add sub-path knot
1668         */
1669         for (i=0; i < 3; i++)
1670         {
1671           size_t
1672             xx,
1673             yy;
1674
1675           yy=ReadPropertyMSBLong(&blob,&length);
1676           xx=ReadPropertyMSBLong(&blob,&length);
1677           x=(ssize_t) xx;
1678           if (xx > 2147483647)
1679             x=(ssize_t) xx-4294967295-1;
1680           y=(ssize_t) yy;
1681           if (yy > 2147483647)
1682             y=(ssize_t) yy-4294967295-1;
1683           point[i].x=(double) x/4096/4096;
1684           point[i].y=1.0-(double) y/4096/4096;
1685         }
1686         if (in_subpath == MagickFalse)
1687           {
1688             (void) FormatMagickString(message,MaxTextExtent,"  %g %g m\n",
1689               point[1].x,point[1].y);
1690             for (i=0; i < 3; i++)
1691             {
1692               first[i]=point[i];
1693               last[i]=point[i];
1694             }
1695           }
1696         else
1697           {
1698             /*
1699               Handle special cases when Bezier curves are used to describe
1700               corners and straight lines.
1701             */
1702             if ((last[1].x == last[2].x) && (last[1].y == last[2].y) &&
1703                 (point[0].x == point[1].x) && (point[0].y == point[1].y))
1704               (void) FormatMagickString(message,MaxTextExtent,
1705                 "  %g %g l\n",point[1].x,point[1].y);
1706             else
1707               if ((last[1].x == last[2].x) && (last[1].y == last[2].y))
1708                 (void) FormatMagickString(message,MaxTextExtent,
1709                   "  %g %g %g %g v\n",point[0].x,point[0].y,
1710                   point[1].x,point[1].y);
1711               else
1712                 if ((point[0].x == point[1].x) && (point[0].y == point[1].y))
1713                   (void) FormatMagickString(message,MaxTextExtent,
1714                     "  %g %g %g %g y\n",last[2].x,last[2].y,
1715                     point[1].x,point[1].y);
1716                 else
1717                   (void) FormatMagickString(message,MaxTextExtent,
1718                     "  %g %g %g %g %g %g c\n",last[2].x,
1719                     last[2].y,point[0].x,point[0].y,point[1].x,point[1].y);
1720             for (i=0; i < 3; i++)
1721               last[i]=point[i];
1722           }
1723         (void) ConcatenateString(&path,message);
1724         in_subpath=MagickTrue;
1725         knot_count--;
1726         /*
1727           Close the subpath if there are no more knots.
1728         */
1729         if (knot_count == 0)
1730           {
1731             /*
1732               Same special handling as above except we compare to the
1733               first point in the path and close the path.
1734             */
1735             if ((last[1].x == last[2].x) && (last[1].y == last[2].y) &&
1736                 (first[0].x == first[1].x) && (first[0].y == first[1].y))
1737               (void) FormatMagickString(message,MaxTextExtent,
1738                 "  %g %g l z\n",first[1].x,first[1].y);
1739             else
1740               if ((last[1].x == last[2].x) && (last[1].y == last[2].y))
1741                 (void) FormatMagickString(message,MaxTextExtent,
1742                   "  %g %g %g %g v z\n",first[0].x,first[0].y,
1743                   first[1].x,first[1].y);
1744               else
1745                 if ((first[0].x == first[1].x) && (first[0].y == first[1].y))
1746                   (void) FormatMagickString(message,MaxTextExtent,
1747                     "  %g %g %g %g y z\n",last[2].x,last[2].y,
1748                     first[1].x,first[1].y);
1749                 else
1750                   (void) FormatMagickString(message,MaxTextExtent,
1751                     "  %g %g %g %g %g %g c z\n",last[2].x,
1752                     last[2].y,first[0].x,first[0].y,first[1].x,first[1].y);
1753             (void) ConcatenateString(&path,message);
1754             in_subpath=MagickFalse;
1755           }
1756         break;
1757       }
1758       case 6:
1759       case 7:
1760       case 8:
1761       default:
1762       {
1763         blob+=24;
1764         length-=24;
1765         break;
1766       }
1767     }
1768   }
1769   /*
1770     Returns an empty PS path if the path has no knots.
1771   */
1772   (void) FormatMagickString(message,MaxTextExtent,"  eoclip\n");
1773   (void) ConcatenateString(&path,message);
1774   (void) FormatMagickString(message,MaxTextExtent,"} bind def");
1775   (void) ConcatenateString(&path,message);
1776   message=DestroyString(message);
1777   return(path);
1778 }
1779
1780 static char *TraceSVGClippath(const unsigned char *blob,size_t length,
1781   const size_t columns,const size_t rows)
1782 {
1783   char
1784     *path,
1785     *message;
1786
1787   ssize_t
1788     knot_count,
1789     selector,
1790     x,
1791     y;
1792
1793   MagickBooleanType
1794     in_subpath;
1795
1796   PointInfo
1797     first[3],
1798     last[3],
1799     point[3];
1800
1801   register ssize_t
1802     i;
1803
1804   path=AcquireString((char *) NULL);
1805   if (path == (char *) NULL)
1806     return((char *) NULL);
1807   message=AcquireString((char *) NULL);
1808   (void) FormatMagickString(message,MaxTextExtent,
1809     "<?xml version=\"1.0\" encoding=\"iso-8859-1\"?>\n");
1810   (void) ConcatenateString(&path,message);
1811   (void) FormatMagickString(message,MaxTextExtent,
1812     "<svg width=\"%.20g\" height=\"%.20g\">\n",(double) columns,(double) rows);
1813   (void) ConcatenateString(&path,message);
1814   (void) FormatMagickString(message,MaxTextExtent,"<g>\n");
1815   (void) ConcatenateString(&path,message);
1816   (void) FormatMagickString(message,MaxTextExtent,
1817     "<path style=\"fill:#00000000;stroke:#00000000;");
1818   (void) ConcatenateString(&path,message);
1819   (void) FormatMagickString(message,MaxTextExtent,
1820     "stroke-width:0;stroke-antialiasing:false\" d=\"\n");
1821   (void) ConcatenateString(&path,message);
1822   (void) ResetMagickMemory(point,0,sizeof(point));
1823   (void) ResetMagickMemory(first,0,sizeof(first));
1824   (void) ResetMagickMemory(last,0,sizeof(last));
1825   knot_count=0;
1826   in_subpath=MagickFalse;
1827   while (length != 0)
1828   {
1829     selector=(ssize_t) ReadPropertyMSBShort(&blob,&length);
1830     switch (selector)
1831     {
1832       case 0:
1833       case 3:
1834       {
1835         if (knot_count != 0)
1836           {
1837             blob+=24;
1838             length-=24;
1839             break;
1840           }
1841         /*
1842           Expected subpath length record.
1843         */
1844         knot_count=(ssize_t) ReadPropertyMSBShort(&blob,&length);
1845         blob+=22;
1846         length-=22;
1847         break;
1848       }
1849       case 1:
1850       case 2:
1851       case 4:
1852       case 5:
1853       {
1854         if (knot_count == 0)
1855           {
1856             /*
1857               Unexpected subpath knot.
1858             */
1859             blob+=24;
1860             length-=24;
1861             break;
1862           }
1863         /*
1864           Add sub-path knot
1865         */
1866         for (i=0; i < 3; i++)
1867         {
1868           size_t 
1869             xx,
1870             yy;
1871
1872           yy=ReadPropertyMSBLong(&blob,&length);
1873           xx=ReadPropertyMSBLong(&blob,&length);
1874           x=(ssize_t) xx;
1875           if (xx > 2147483647)
1876             x=(ssize_t) xx-4294967295-1;
1877           y=(ssize_t) yy;
1878           if (yy > 2147483647)
1879             y=(ssize_t) yy-4294967295-1;
1880           point[i].x=(double) x*columns/4096/4096;
1881           point[i].y=(double) y*rows/4096/4096;
1882         }
1883         if (in_subpath == MagickFalse)
1884           {
1885             (void) FormatMagickString(message,MaxTextExtent,"M %g,%g\n",
1886               point[1].x,point[1].y);
1887             for (i=0; i < 3; i++)
1888             {
1889               first[i]=point[i];
1890               last[i]=point[i];
1891             }
1892           }
1893         else
1894           {
1895             if ((last[1].x == last[2].x) && (last[1].y == last[2].y) &&
1896                 (point[0].x == point[1].x) && (point[0].y == point[1].y))
1897               (void) FormatMagickString(message,MaxTextExtent,"L %g,%g\n",
1898                 point[1].x,point[1].y);
1899             else
1900               (void) FormatMagickString(message,MaxTextExtent,
1901                 "C %g,%g %g,%g %g,%g\n",last[2].x,last[2].y,
1902                 point[0].x,point[0].y,point[1].x,point[1].y);
1903             for (i=0; i < 3; i++)
1904               last[i]=point[i];
1905           }
1906         (void) ConcatenateString(&path,message);
1907         in_subpath=MagickTrue;
1908         knot_count--;
1909         /*
1910           Close the subpath if there are no more knots.
1911         */
1912         if (knot_count == 0)
1913           {
1914             if ((last[1].x == last[2].x) && (last[1].y == last[2].y) &&
1915                 (first[0].x == first[1].x) && (first[0].y == first[1].y))
1916               (void) FormatMagickString(message,MaxTextExtent,
1917                 "L %g,%g Z\n",first[1].x,first[1].y);
1918             else
1919               {
1920                 (void) FormatMagickString(message,MaxTextExtent,
1921                   "C %g,%g %g,%g %g,%g Z\n",last[2].x,
1922                   last[2].y,first[0].x,first[0].y,first[1].x,first[1].y);
1923                 (void) ConcatenateString(&path,message);
1924               }
1925             in_subpath=MagickFalse;
1926           }
1927         break;
1928       }
1929       case 6:
1930       case 7:
1931       case 8:
1932       default:
1933       {
1934         blob+=24;
1935         length-=24;
1936         break;
1937       }
1938     }
1939   }
1940   /*
1941     Return an empty SVG image if the path does not have knots.
1942   */
1943   (void) FormatMagickString(message,MaxTextExtent,"\"/>\n");
1944   (void) ConcatenateString(&path,message);
1945   (void) FormatMagickString(message,MaxTextExtent,"</g>\n");
1946   (void) ConcatenateString(&path,message);
1947   (void) FormatMagickString(message,MaxTextExtent,"</svg>\n");
1948   (void) ConcatenateString(&path,message);
1949   message=DestroyString(message);
1950   return(path);
1951 }
1952
1953 MagickExport const char *GetImageProperty(const Image *image,
1954   const char *property)
1955 {
1956   ExceptionInfo
1957     *exception;
1958
1959   FxInfo
1960     *fx_info;
1961
1962   MagickRealType
1963     alpha;
1964
1965   MagickStatusType
1966     status;
1967
1968   register const char
1969     *p;
1970
1971   assert(image != (Image *) NULL);
1972   assert(image->signature == MagickSignature);
1973   if (image->debug != MagickFalse)
1974     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1975   p=(const char *) NULL;
1976   if (property == (const char *) NULL)
1977     {
1978       ResetSplayTreeIterator((SplayTreeInfo *) image->properties);
1979       p=(const char *) GetNextValueInSplayTree((SplayTreeInfo *)
1980         image->properties);
1981       return(p);
1982     }
1983   if (image->properties != (void *) NULL)
1984     {
1985       p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
1986         image->properties,property);
1987       if (p != (const char *) NULL)
1988         return(p);
1989     }
1990   if (strchr(property,':') == (char *) NULL)
1991     return(p);
1992   exception=(&((Image *) image)->exception);
1993   switch (*property)
1994   {
1995     case '8':
1996     {
1997       if (LocaleNCompare("8bim:",property,5) == 0)
1998         {
1999           if (Get8BIMProperty(image,property) != MagickFalse)
2000             {
2001               p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
2002                 image->properties,property);
2003               return(p);
2004             }
2005         }
2006       break;
2007     }
2008     case 'E':
2009     case 'e':
2010     {
2011       if (LocaleNCompare("exif:",property,5) == 0)
2012         {
2013           if (GetEXIFProperty(image,property) != MagickFalse)
2014             {
2015               p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
2016                 image->properties,property);
2017               return(p);
2018             }
2019         }
2020       break;
2021     }
2022     case 'F':
2023     case 'f':
2024     {
2025       if (LocaleNCompare("fx:",property,3) == 0)
2026         {
2027           fx_info=AcquireFxInfo(image,property+3);
2028           status=FxEvaluateChannelExpression(fx_info,DefaultChannels,0,0,&alpha,
2029             exception);
2030           fx_info=DestroyFxInfo(fx_info);
2031           if (status != MagickFalse)
2032             {
2033               char
2034                 value[MaxTextExtent];
2035
2036               (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2037                 GetMagickPrecision(),(double) alpha);
2038               (void) SetImageProperty((Image *) image,property,value);
2039             }
2040           p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
2041             image->properties,property);
2042           return(p);
2043         }
2044       break;
2045     }
2046     case 'I':
2047     case 'i':
2048     {
2049       if (LocaleNCompare("iptc:",property,5) == 0)
2050         {
2051           if (GetIPTCProperty(image,property) != MagickFalse)
2052             {
2053               p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
2054                 image->properties,property);
2055               return(p);
2056             }
2057         }
2058       break;
2059     }
2060     case 'P':
2061     case 'p':
2062     {
2063       if (LocaleNCompare("pixel:",property,6) == 0)
2064         {
2065           MagickPixelPacket
2066             pixel;
2067
2068           GetMagickPixelPacket(image,&pixel);
2069           fx_info=AcquireFxInfo(image,property+6);
2070           status=FxEvaluateChannelExpression(fx_info,RedChannel,0,0,&alpha,
2071             exception);
2072           pixel.red=(MagickRealType) QuantumRange*alpha;
2073           status|=FxEvaluateChannelExpression(fx_info,GreenChannel,0,0,&alpha,
2074             exception);
2075           pixel.green=(MagickRealType) QuantumRange*alpha;
2076           status|=FxEvaluateChannelExpression(fx_info,BlueChannel,0,0,&alpha,
2077             exception);
2078           pixel.blue=(MagickRealType) QuantumRange*alpha;
2079           status|=FxEvaluateChannelExpression(fx_info,OpacityChannel,0,0,&alpha,
2080             exception);
2081           pixel.opacity=(MagickRealType) QuantumRange*(1.0-alpha);
2082           if (image->colorspace == CMYKColorspace)
2083             {
2084               status|=FxEvaluateChannelExpression(fx_info,BlackChannel,0,0,
2085                 &alpha,exception);
2086               pixel.index=(MagickRealType) QuantumRange*alpha;
2087             }
2088           fx_info=DestroyFxInfo(fx_info);
2089           if (status != MagickFalse)
2090             {
2091               char
2092                 name[MaxTextExtent];
2093
2094               (void) QueryMagickColorname(image,&pixel,SVGCompliance,name,
2095                 exception);
2096               (void) SetImageProperty((Image *) image,property,name);
2097               return(GetImageProperty(image,property));
2098             }
2099         }
2100       break;
2101     }
2102     case 'X':
2103     case 'x':
2104     {
2105       if (LocaleNCompare("xmp:",property,4) == 0)
2106         {
2107           if (GetXMPProperty(image,property) != MagickFalse)
2108             {
2109               p=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
2110                 image->properties,property);
2111               return(p);
2112             }
2113         }
2114       break;
2115     }
2116   }
2117   return(p);
2118 }
2119 \f
2120 /*
2121 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2122 %                                                                             %
2123 %                                                                             %
2124 %                                                                             %
2125 +   G e t M a g i c k P r o p e r t y                                         %
2126 %                                                                             %
2127 %                                                                             %
2128 %                                                                             %
2129 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2130 %
2131 %  GetMagickProperty() gets a value associated with an image property.
2132 %
2133 %  The format of the GetMagickProperty method is:
2134 %
2135 %      const char *GetMagickProperty(const ImageInfo *image_info,
2136 %        Image *image,const char *key)
2137 %
2138 %  A description of each parameter follows:
2139 %
2140 %    o image_info: the image info.
2141 %
2142 %    o image: the image.
2143 %
2144 %    o key: the key.
2145 %
2146 */
2147 MagickExport const char *GetMagickProperty(const ImageInfo *image_info,
2148   Image *image,const char *property)
2149 {
2150   char
2151     value[MaxTextExtent],
2152     filename[MaxTextExtent];
2153
2154   *value='\0';
2155   switch (*property)
2156   {
2157     case 'b':
2158     {
2159       if (LocaleNCompare("base",property,4) == 0)
2160         {
2161           GetPathComponent(image->magick_filename,BasePath,filename);
2162           (void) CopyMagickString(value,filename,MaxTextExtent);
2163           break;
2164         }
2165       break;
2166     }
2167     case 'c':
2168     {
2169       if (LocaleNCompare("channels",property,8) == 0)
2170         {
2171           /*
2172             Image channels.
2173           */
2174           (void) FormatMagickString(value,MaxTextExtent,"%s",
2175             MagickOptionToMnemonic(MagickColorspaceOptions,(ssize_t)
2176             image->colorspace));
2177           LocaleLower(value);
2178           if (image->matte != MagickFalse)
2179             (void) ConcatenateMagickString(value,"a",MaxTextExtent);
2180           break;
2181         }
2182       if (LocaleNCompare("colorspace",property,10) == 0)
2183         {
2184           ColorspaceType
2185             colorspace;
2186
2187           /*
2188             Image storage class and colorspace.
2189           */
2190           colorspace=image->colorspace;
2191           if (IsGrayImage(image,&image->exception) != MagickFalse)
2192             colorspace=GRAYColorspace;
2193           (void) FormatMagickString(value,MaxTextExtent,"%s",
2194             MagickOptionToMnemonic(MagickColorspaceOptions,(ssize_t)
2195             colorspace));
2196           break;
2197         }
2198       if (LocaleNCompare("copyright",property,9) == 0)
2199         {
2200           (void) CopyMagickString(value,GetMagickCopyright(),MaxTextExtent);
2201           break;
2202         }
2203       break;
2204     }
2205     case 'd':
2206     {
2207       if (LocaleNCompare("depth",property,5) == 0)
2208         {
2209           (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2210             image->depth);
2211           break;
2212         }
2213       if (LocaleNCompare("directory",property,9) == 0)
2214         {
2215           GetPathComponent(image->magick_filename,HeadPath,filename);
2216           (void) CopyMagickString(value,filename,MaxTextExtent);
2217           break;
2218         }
2219       break;
2220     }
2221     case 'e':
2222     {
2223       if (LocaleNCompare("extension",property,9) == 0)
2224         {
2225           GetPathComponent(image->magick_filename,ExtensionPath,filename);
2226           (void) CopyMagickString(value,filename,MaxTextExtent);
2227           break;
2228         }
2229       break;
2230     }
2231     case 'g':
2232     {
2233       if (LocaleNCompare("group",property,5) == 0)
2234         {
2235           (void) FormatMagickString(value,MaxTextExtent,"0x%lx",
2236             (unsigned long) image_info->group);
2237           break;
2238         }
2239       break;
2240     }
2241     case 'h':
2242     {
2243       if (LocaleNCompare("height",property,6) == 0)
2244         {
2245           (void) FormatMagickString(value,MaxTextExtent,"%.20g",
2246             image->magick_rows != 0 ? (double) image->magick_rows : 256.0);
2247           break;
2248         }
2249       break;
2250     }
2251     case 'i':
2252     {
2253       if (LocaleNCompare("input",property,5) == 0)
2254         {
2255           (void) CopyMagickString(value,image->filename,MaxTextExtent);
2256           break;
2257         }
2258       break;
2259     }
2260     case 'k':
2261     {
2262       if (LocaleNCompare("kurtosis",property,8) == 0)
2263         {
2264           double
2265             kurtosis,
2266             skewness;
2267
2268           (void) GetImageChannelKurtosis(image,image_info->channel,&kurtosis,
2269             &skewness,&image->exception);
2270           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2271             GetMagickPrecision(),kurtosis);
2272           break;
2273         }
2274       break;
2275     }
2276     case 'm':
2277     {
2278       if (LocaleNCompare("magick",property,6) == 0)
2279         {
2280           (void) CopyMagickString(value,image->magick,MaxTextExtent);
2281           break;
2282         }
2283       if (LocaleNCompare("max",property,3) == 0)
2284         {
2285           double
2286             maximum,
2287             minimum;
2288
2289           (void) GetImageChannelRange(image,image_info->channel,&minimum,
2290             &maximum,&image->exception);
2291           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2292             GetMagickPrecision(),maximum);
2293           break;
2294         }
2295       if (LocaleNCompare("mean",property,4) == 0)
2296         {
2297           double
2298             mean,
2299             standard_deviation;
2300
2301           (void) GetImageChannelMean(image,image_info->channel,&mean,
2302             &standard_deviation,&image->exception);
2303           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2304             GetMagickPrecision(),mean);
2305           break;
2306         }
2307       if (LocaleNCompare("min",property,3) == 0)
2308         {
2309           double
2310             maximum,
2311             minimum;
2312
2313           (void) GetImageChannelRange(image,image_info->channel,&minimum,
2314             &maximum,&image->exception);
2315           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2316             GetMagickPrecision(),minimum);
2317           break;
2318         }
2319       break;
2320     }
2321     case 'n':
2322     {
2323       if (LocaleNCompare("name",property,4) == 0)
2324         {
2325           (void) CopyMagickString(value,filename,MaxTextExtent);
2326           break;
2327         }
2328      break;
2329     }
2330     case 'o':
2331     {
2332       if (LocaleNCompare("output",property,6) == 0)
2333         {
2334           (void) CopyMagickString(value,image_info->filename,MaxTextExtent);
2335           break;
2336         }
2337      break;
2338     }
2339     case 'p':
2340     {
2341       if (LocaleNCompare("page",property,4) == 0)
2342         {
2343           register const Image
2344             *p;
2345
2346           size_t
2347             page;
2348
2349           p=image;
2350           for (page=1; GetPreviousImageInList(p) != (Image *) NULL; page++)
2351             p=GetPreviousImageInList(p);
2352           (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2353             page);
2354           break;
2355         }
2356       break;
2357     }
2358     case 's':
2359     {
2360       if (LocaleNCompare("size",property,4) == 0)
2361         {
2362           char
2363             format[MaxTextExtent];
2364
2365           (void) FormatMagickSize(GetBlobSize(image),MagickFalse,format);
2366           (void) FormatMagickString(value,MaxTextExtent,"%sB",format);
2367           break;
2368         }
2369       if (LocaleNCompare("scenes",property,6) == 0)
2370         {
2371           (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2372             GetImageListLength(image));
2373           break;
2374         }
2375       if (LocaleNCompare("scene",property,5) == 0)
2376         {
2377           (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2378             image->scene);
2379           if (image_info->number_scenes != 0)
2380             (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2381               image_info->scene);
2382           break;
2383         }
2384       if (LocaleNCompare("skewness",property,8) == 0)
2385         {
2386           double
2387             kurtosis,
2388             skewness;
2389
2390           (void) GetImageChannelKurtosis(image,image_info->channel,&kurtosis,
2391             &skewness,&image->exception);
2392           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2393             GetMagickPrecision(),skewness);
2394           break;
2395         }
2396       if ((LocaleNCompare("standard-deviation",property,18) == 0) ||
2397           (LocaleNCompare("standard_deviation",property,18) == 0))
2398         {
2399           double
2400             mean,
2401             standard_deviation;
2402
2403           (void) GetImageChannelMean(image,image_info->channel,&mean,
2404             &standard_deviation,&image->exception);
2405           (void) FormatMagickString(value,MaxTextExtent,"%.*g",
2406             GetMagickPrecision(),standard_deviation);
2407           break;
2408         }
2409        break;
2410     }
2411     case 'u':
2412     {
2413       if (LocaleNCompare("unique",property,6) == 0)
2414         {
2415           (void) CopyMagickString(filename,image_info->unique,MaxTextExtent);
2416           (void) CopyMagickString(value,filename,MaxTextExtent);
2417           break;
2418         }
2419       break;
2420     }
2421     case 'v':
2422     {
2423       if (LocaleNCompare("version",property,7) == 0)
2424         {
2425           (void) CopyMagickString(value,GetMagickVersion((size_t *) NULL),
2426             MaxTextExtent);
2427           break;
2428         }
2429       break;
2430     }
2431     case 'w':
2432     {
2433       if (LocaleNCompare("width",property,5) == 0)
2434         {
2435           (void) FormatMagickString(value,MaxTextExtent,"%.20g",(double)
2436             (image->magick_columns != 0 ? image->magick_columns : 256));
2437           break;
2438         }
2439       break;
2440     }
2441     case 'x':
2442     {
2443       if (LocaleNCompare("xresolution",property,11) == 0)
2444         {
2445           (void) FormatMagickString(value,MaxTextExtent,"%g",
2446             image->x_resolution);
2447           break;
2448         }
2449       break;
2450     }
2451     case 'y':
2452     {
2453       if (LocaleNCompare("yresolution",property,11) == 0)
2454         {
2455           (void) FormatMagickString(value,MaxTextExtent,"%g",
2456             image->y_resolution);
2457           break;
2458         }
2459       break;
2460     }
2461     case 'z':
2462     {
2463       if (LocaleNCompare("zero",property,4) == 0)
2464         {
2465           (void) CopyMagickString(filename,image_info->zero,MaxTextExtent);
2466           (void) CopyMagickString(value,filename,MaxTextExtent);
2467           break;
2468         }
2469       break;
2470     }
2471   }
2472   if (*value != '\0')
2473    {
2474      if (image->properties == (void *) NULL)
2475        image->properties=NewSplayTree(CompareSplayTreeString,
2476          RelinquishMagickMemory,RelinquishMagickMemory);
2477      (void) AddValueToSplayTree((SplayTreeInfo *) image->properties,
2478        ConstantString(property),ConstantString(value));
2479    }
2480   return(GetImageProperty(image,property));
2481 }
2482 \f
2483 /*
2484 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2485 %                                                                             %
2486 %                                                                             %
2487 %                                                                             %
2488 %   G e t N e x t I m a g e P r o p e r t y                                   %
2489 %                                                                             %
2490 %                                                                             %
2491 %                                                                             %
2492 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2493 %
2494 %  GetNextImageProperty() gets the next image property value.
2495 %
2496 %  The format of the GetNextImageProperty method is:
2497 %
2498 %      char *GetNextImageProperty(const Image *image)
2499 %
2500 %  A description of each parameter follows:
2501 %
2502 %    o image: the image.
2503 %
2504 */
2505 MagickExport char *GetNextImageProperty(const Image *image)
2506 {
2507   assert(image != (Image *) NULL);
2508   assert(image->signature == MagickSignature);
2509   if (image->debug != MagickFalse)
2510     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
2511       image->filename);
2512   if (image->properties == (void *) NULL)
2513     return((char *) NULL);
2514   return((char *) GetNextKeyInSplayTree((SplayTreeInfo *) image->properties));
2515 }
2516 \f
2517 /*
2518 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2519 %                                                                             %
2520 %                                                                             %
2521 %                                                                             %
2522 %   I n t e r p r e t I m a g e P r o p e r t i e s                           %
2523 %                                                                             %
2524 %                                                                             %
2525 %                                                                             %
2526 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2527 %
2528 %  InterpretImageProperties() replaces any embedded formatting characters with
2529 %  the appropriate image property and returns the interpretted text.
2530 %
2531 %  The format of the InterpretImageProperties method is:
2532 %
2533 %      char *InterpretImageProperties(const ImageInfo *image_info,Image *image,
2534 %        const char *embed_text)
2535 %
2536 %  A description of each parameter follows:
2537 %
2538 %    o image_info: the image info.
2539 %
2540 %    o image: the image.
2541 %
2542 %    o embed_text: the address of a character string containing the embedded
2543 %      formatting characters.
2544 %
2545 */
2546 MagickExport char *InterpretImageProperties(const ImageInfo *image_info,
2547   Image *image,const char *embed_text)
2548 {
2549   char
2550     filename[MaxTextExtent],
2551     *interpret_text,
2552     *text;
2553
2554   const char
2555     *value;
2556
2557   ImageInfo
2558     *text_info;
2559
2560   register char
2561     *q;
2562
2563   register const char
2564     *p;
2565
2566   register ssize_t
2567     i;
2568
2569   size_t
2570     extent,
2571     length;
2572
2573   assert(image != (Image *) NULL);
2574   assert(image->signature == MagickSignature);
2575   if (image->debug != MagickFalse)
2576     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
2577   if ((embed_text == (const char *) NULL) || (*embed_text == '\0'))
2578     return((char *) NULL);
2579   text=(char *) embed_text;
2580   if ((*text == '@') && ((*(text+1) == '-') ||
2581       (IsPathAccessible(text+1) != MagickFalse)))
2582     return(FileToString(embed_text+1,~0,&image->exception));
2583   /*
2584     Translate any embedded format characters.
2585   */
2586   text_info=CloneImageInfo(image_info);
2587   interpret_text=AcquireString(text);
2588   extent=MaxTextExtent;
2589   p=text;
2590   for (q=interpret_text; *p != '\0'; p++)
2591   {
2592     *q='\0';
2593     if ((size_t) (q-interpret_text+MaxTextExtent) >= extent)
2594       {
2595         extent+=MaxTextExtent;
2596         interpret_text=(char *) ResizeQuantumMemory(interpret_text,extent+
2597           MaxTextExtent+1,sizeof(*interpret_text));
2598         if (interpret_text == (char *) NULL)
2599           break;
2600         q=interpret_text+strlen(interpret_text);
2601       }
2602     /*
2603       Process formatting characters in text.
2604     */
2605     if ((*p == '\\') && (*(p+1) == 'r'))
2606       {
2607         *q++='\r';
2608         p++;
2609         continue;
2610       }
2611     if ((*p == '\\') && (*(p+1) == 'n'))
2612       {
2613         *q++='\n';
2614         p++;
2615         continue;
2616       }
2617     if (*p == '\\')
2618       {
2619         p++;
2620         *q++=(*p);
2621         continue;
2622       }
2623     if (*p != '%')
2624       {
2625         *q++=(*p);
2626         continue;
2627       }
2628     p++;
2629     switch (*p)
2630     {
2631       case 'b':
2632       {
2633         char
2634           format[MaxTextExtent];
2635
2636         /*
2637           File size.
2638         */
2639         (void) FormatMagickString(format,MaxTextExtent,"%.20g",(double)
2640           image->extent);
2641         if (image->extent != (MagickSizeType) ((size_t) image->extent))
2642           (void) FormatMagickSize(image->extent,MagickFalse,format);
2643         q+=ConcatenateMagickString(q,format,extent);
2644         q+=ConcatenateMagickString(q,"B",extent);
2645         break;
2646       }
2647       case 'c':
2648       {
2649         /*
2650           Image comment.
2651         */
2652         value=GetImageProperty(image,"comment");
2653         if (value == (const char *) NULL)
2654           break;
2655         length=strlen(value);
2656         if ((size_t) (q-interpret_text+length+1) >= extent)
2657           {
2658             extent+=length;
2659             interpret_text=(char *) ResizeQuantumMemory(interpret_text,
2660               extent+MaxTextExtent,sizeof(*interpret_text));
2661             if (interpret_text == (char *) NULL)
2662               break;
2663             q=interpret_text+strlen(interpret_text);
2664           }
2665         (void) CopyMagickString(q,value,extent);
2666         q+=length;
2667         break;
2668       }
2669       case 'd':
2670       case 'e':
2671       case 'f':
2672       case 't':
2673       {
2674         /*
2675           Label segment is the base of the filename.
2676         */
2677         if (*image->magick_filename == '\0')
2678           break;
2679         switch (*p)
2680         {
2681           case 'd':
2682           {
2683             /*
2684               Directory.
2685             */
2686             GetPathComponent(image->magick_filename,HeadPath,filename);
2687             q+=CopyMagickString(q,filename,extent);
2688             break;
2689           }
2690           case 'e':
2691           {
2692             /*
2693               Filename extension.
2694             */
2695             GetPathComponent(image->magick_filename,ExtensionPath,filename);
2696             q+=CopyMagickString(q,filename,extent);
2697             break;
2698           }
2699           case 'f':
2700           {
2701             /*
2702               Filename.
2703             */
2704             GetPathComponent(image->magick_filename,TailPath,filename);
2705             q+=CopyMagickString(q,filename,extent);
2706             break;
2707           }
2708           case 't':
2709           {
2710             /*
2711               Base filename.
2712             */
2713             GetPathComponent(image->magick_filename,BasePath,filename);
2714             q+=CopyMagickString(q,filename,extent);
2715             break;
2716           }
2717         }
2718         break;
2719       }
2720       case 'g':
2721       {
2722         /*
2723           Image geometry.
2724         */
2725         q+=FormatMagickString(q,extent,"%.20gx%.20g%+.20g%+.20g",(double)
2726           image->page.width,(double) image->page.height,(double)
2727           image->page.x,(double) image->page.y);
2728         break;
2729       }
2730       case 'h':
2731       {
2732         /*
2733           Image height.
2734         */
2735         q+=FormatMagickString(q,extent,"%.20g",(double)
2736           (image->rows != 0 ? image->rows : image->magick_rows));
2737         break;
2738       }
2739       case 'i':
2740       {
2741         /*
2742           Image filename.
2743         */
2744         q+=CopyMagickString(q,image->filename,extent);
2745         break;
2746       }
2747       case 'k':
2748       {
2749         /*
2750           Number of unique colors.
2751         */
2752         q+=FormatMagickString(q,extent,"%.20g",(double)
2753           GetNumberColors(image,(FILE *) NULL,&image->exception));
2754         break;
2755       }
2756       case 'l':
2757       {
2758         /*
2759           Image label.
2760         */
2761         value=GetImageProperty(image,"label");
2762         if (value == (const char *) NULL)
2763           break;
2764         length=strlen(value);
2765         if ((size_t) (q-interpret_text+length+1) >= extent)
2766           {
2767             extent+=length;
2768             interpret_text=(char *) ResizeQuantumMemory(interpret_text,
2769               extent+MaxTextExtent,sizeof(*interpret_text));
2770             if (interpret_text == (char *) NULL)
2771               break;
2772             q=interpret_text+strlen(interpret_text);
2773           }
2774         q+=CopyMagickString(q,value,extent);
2775         break;
2776       }
2777       case 'm':
2778       {
2779         /*
2780           Image format.
2781         */
2782         q+=CopyMagickString(q,image->magick,extent);
2783         break;
2784       }
2785       case 'M':
2786       {
2787         /*
2788           Image magick filename.
2789         */
2790         q+=CopyMagickString(q,image->magick_filename,extent);
2791         break;
2792       }
2793       case 'n':
2794       {
2795         /*
2796           Number of images in the list.
2797         */
2798         q+=FormatMagickString(q,extent,"%.20g",(double)
2799           GetImageListLength(image));
2800         break;
2801       }
2802       case 'o':
2803       {
2804         /*
2805           Image output filename.
2806         */
2807         q+=CopyMagickString(q,text_info->filename,extent);
2808         break;
2809       }
2810       case 'p':
2811       {
2812         register const Image
2813           *p;
2814
2815         size_t
2816           page;
2817
2818         /*
2819           Image page number.
2820         */
2821         p=image;
2822         for (page=1; GetPreviousImageInList(p) != (Image *) NULL; page++)
2823           p=GetPreviousImageInList(p);
2824         q+=FormatMagickString(q,extent,"%.20g",(double) page);
2825         break;
2826       }
2827       case 'q':
2828       {
2829         /*
2830           Image depth.
2831         */
2832         q+=FormatMagickString(q,extent,"%.20g",(double)
2833           MAGICKCORE_QUANTUM_DEPTH);
2834         break;
2835       }
2836       case 'r':
2837       {
2838         ColorspaceType
2839           colorspace;
2840
2841         /*
2842           Image storage class and colorspace.
2843         */
2844         colorspace=image->colorspace;
2845         if (IsGrayImage(image,&image->exception) != MagickFalse)
2846           colorspace=GRAYColorspace;
2847         q+=FormatMagickString(q,extent,"%s%s%s",MagickOptionToMnemonic(
2848           MagickClassOptions,(ssize_t) image->storage_class),
2849           MagickOptionToMnemonic(MagickColorspaceOptions,(ssize_t) colorspace),
2850           image->matte != MagickFalse ? "Matte" : "");
2851         break;
2852       }
2853       case 's':
2854       {
2855         /*
2856           Image scene number.
2857         */
2858         if (text_info->number_scenes == 0)
2859           q+=FormatMagickString(q,extent,"%.20g",(double) image->scene);
2860         else
2861           q+=FormatMagickString(q,extent,"%.20g",(double) text_info->scene);
2862         break;
2863       }
2864       case 'u':
2865       {
2866         /*
2867           Unique filename.
2868         */
2869         (void) CopyMagickString(filename,text_info->unique,extent);
2870         q+=CopyMagickString(q,filename,extent);
2871         break;
2872       }
2873       case 'w':
2874       {
2875         /*
2876           Image width.
2877         */
2878         q+=FormatMagickString(q,extent,"%.20g",(double)
2879           (image->columns != 0 ? image->columns : image->magick_columns));
2880         break;
2881       }
2882       case 'x':
2883       {
2884         /*
2885           Image horizontal resolution.
2886         */
2887         q+=FormatMagickString(q,extent,"%g %s",image->x_resolution,
2888           MagickOptionToMnemonic(MagickResolutionOptions,(ssize_t)
2889             image->units));
2890         break;
2891       }
2892       case 'y':
2893       {
2894         /*
2895           Image vertical resolution.
2896         */
2897         q+=FormatMagickString(q,extent,"%g %s",image->y_resolution,
2898           MagickOptionToMnemonic(MagickResolutionOptions,(ssize_t)
2899           image->units));
2900         break;
2901       }
2902       case 'z':
2903       {
2904         /*
2905           Image depth.
2906         */
2907         q+=FormatMagickString(q,extent,"%.20g",(double) image->depth);
2908         break;
2909       }
2910       case 'A':
2911       {
2912         /*
2913           Image alpha channel.
2914         */
2915         q+=FormatMagickString(q,extent,"%s",MagickOptionToMnemonic(
2916           MagickBooleanOptions,(ssize_t) image->matte));
2917         break;
2918       }
2919       case 'C':
2920       {
2921         /*
2922           Image compression method.
2923         */
2924         q+=FormatMagickString(q,extent,"%s",MagickOptionToMnemonic(
2925           MagickCompressOptions,(ssize_t) image->compression));
2926         break;
2927       }
2928       case 'D':
2929       {
2930         /*
2931           Image dispose method.
2932         */
2933         q+=FormatMagickString(q,extent,"%s",MagickOptionToMnemonic(
2934           MagickDisposeOptions,(ssize_t) image->dispose));
2935         break;
2936       }
2937       case 'G':
2938       {
2939         q+=FormatMagickString(q,extent,"%.20gx%.20g",(double)
2940           image->magick_columns,(double) image->magick_rows);
2941         break;
2942       }
2943       case 'H':
2944       {
2945         q+=FormatMagickString(q,extent,"%.20g",(double)
2946           image->page.height);
2947         break;
2948       }
2949       case 'O':
2950       {
2951         q+=FormatMagickString(q,extent,"%+ld%+ld",(long) image->page.x,
2952           (long) image->page.y);
2953         break;
2954       }
2955       case 'P':
2956       {
2957         q+=FormatMagickString(q,extent,"%.20gx%.20g",(double) image->page.width,
2958           (double) image->page.height);
2959         break;
2960       }
2961       case 'Q':
2962       {
2963         q+=FormatMagickString(q,extent,"%.20g",(double) image->quality);
2964         break;
2965       }
2966       case 'S':
2967       {
2968         /*
2969           Image scenes.
2970         */
2971         if (text_info->number_scenes == 0)
2972           q+=CopyMagickString(q,"2147483647",extent);
2973         else
2974           q+=FormatMagickString(q,extent,"%.20g",(double)
2975             (text_info->scene+text_info->number_scenes));
2976         break;
2977       }
2978       case 'T':
2979       {
2980         q+=FormatMagickString(q,extent,"%.20g",(double) image->delay);
2981         break;
2982       }
2983       case 'W':
2984       {
2985         q+=FormatMagickString(q,extent,"%.20g",(double) image->page.width);
2986         break;
2987       }
2988       case 'X':
2989       {
2990         q+=FormatMagickString(q,extent,"%+.20g",(double) image->page.x);
2991         break;
2992       }
2993       case 'Y':
2994       {
2995         q+=FormatMagickString(q,extent,"%+.20g",(double) image->page.y);
2996         break;
2997       }
2998       case 'Z':
2999       {
3000         /*
3001           Unique filename.
3002         */
3003         (void) CopyMagickString(filename,text_info->zero,extent);
3004         q+=CopyMagickString(q,filename,extent);
3005         break;
3006       }
3007       case '[':
3008       {
3009         char
3010           pattern[MaxTextExtent];
3011
3012         const char
3013           *key,
3014           *value;
3015
3016         ssize_t
3017           depth;
3018
3019         /*
3020           Image value.
3021         */
3022         if (strchr(p,']') == (char *) NULL)
3023           break;
3024         depth=1;
3025         p++;
3026         for (i=0; (i < (MaxTextExtent-1L)) && (*p != '\0'); i++)
3027         {
3028           if (*p == '[')
3029             depth++;
3030           if (*p == ']')
3031             depth--;
3032           if (depth <= 0)
3033             break;
3034           pattern[i]=(*p++);
3035         }
3036         pattern[i]='\0';
3037         value=GetImageProperty(image,pattern);
3038         if (value != (const char *) NULL)
3039           {
3040             length=strlen(value);
3041             if ((size_t) (q-interpret_text+length+1) >= extent)
3042               {
3043                 extent+=length;
3044                 interpret_text=(char *) ResizeQuantumMemory(interpret_text,
3045                   extent+MaxTextExtent,sizeof(*interpret_text));
3046                 if (interpret_text == (char *) NULL)
3047                   break;
3048                 q=interpret_text+strlen(interpret_text);
3049               }
3050             (void) CopyMagickString(q,value,extent);
3051             q+=length;
3052             break;
3053           }
3054         else
3055           if (IsGlob(pattern) != MagickFalse)
3056             {
3057               /*
3058                 Iterate over image properties.
3059               */
3060               ResetImagePropertyIterator(image);
3061               key=GetNextImageProperty(image);
3062               while (key != (const char *) NULL)
3063               {
3064                 if (GlobExpression(key,pattern,MagickTrue) != MagickFalse)
3065                   {
3066                     value=GetImageProperty(image,key);
3067                     if (value != (const char *) NULL)
3068                       {
3069                         length=strlen(key)+strlen(value)+2;
3070                         if ((size_t) (q-interpret_text+length+1) >= extent)
3071                           {
3072                             extent+=length;
3073                             interpret_text=(char *) ResizeQuantumMemory(
3074                               interpret_text,extent+MaxTextExtent,
3075                               sizeof(*interpret_text));
3076                             if (interpret_text == (char *) NULL)
3077                               break;
3078                             q=interpret_text+strlen(interpret_text);
3079                           }
3080                         q+=FormatMagickString(q,extent,"%s=%s\n",key,value);
3081                       }
3082                   }
3083                 key=GetNextImageProperty(image);
3084               }
3085             }
3086         value=GetMagickProperty(text_info,image,pattern);
3087         if (value != (const char *) NULL)
3088           {
3089             length=strlen(value);
3090             if ((size_t) (q-interpret_text+length+1) >= extent)
3091               {
3092                 extent+=length;
3093                 interpret_text=(char *) ResizeQuantumMemory(interpret_text,
3094                   extent+MaxTextExtent,sizeof(*interpret_text));
3095                 if (interpret_text == (char *) NULL)
3096                   break;
3097                 q=interpret_text+strlen(interpret_text);
3098               }
3099             (void) CopyMagickString(q,value,extent);
3100             q+=length;
3101             break;
3102           }
3103         if (image_info == (ImageInfo *) NULL)
3104           break;
3105         value=GetImageOption(image_info,pattern);
3106         if (value != (char *) NULL)
3107           {
3108             length=strlen(value);
3109             if ((size_t) (q-interpret_text+length+1) >= extent)
3110               {
3111                 extent+=length;
3112                 interpret_text=(char *) ResizeQuantumMemory(interpret_text,
3113                   extent+MaxTextExtent,sizeof(*interpret_text));
3114                 if (interpret_text == (char *) NULL)
3115                   break;
3116                 q=interpret_text+strlen(interpret_text);
3117               }
3118             (void) CopyMagickString(q,value,extent);
3119             q+=length;
3120             break;
3121           }
3122         break;
3123       }
3124       case '@':
3125       {
3126         RectangleInfo
3127           page;
3128
3129         /*
3130           Image bounding box.
3131         */
3132         page=GetImageBoundingBox(image,&image->exception);
3133         q+=FormatMagickString(q,MaxTextExtent,"%.20gx%.20g%+.20g%+.20g",
3134           (double) page.width,(double) page.height,(double) page.x,(double)
3135           page.y);
3136         break;
3137       }
3138       case '#':
3139       {
3140         /*
3141           Image signature.
3142         */
3143         (void) SignatureImage(image);
3144         value=GetImageProperty(image,"signature");
3145         if (value == (const char *) NULL)
3146           break;
3147         q+=CopyMagickString(q,value,extent);
3148         break;
3149       }
3150       case '%':
3151       {
3152         *q++=(*p);
3153         break;
3154       }
3155       default:
3156       {
3157         *q++='%';
3158         *q++=(*p);
3159         break;
3160       }
3161     }
3162   }
3163   *q='\0';
3164   text_info=DestroyImageInfo(text_info);
3165   if (text != (const char *) embed_text)
3166     text=DestroyString(text);
3167   (void) SubstituteString(&interpret_text,"&lt;","<");
3168   (void) SubstituteString(&interpret_text,"&gt;",">");
3169   return(interpret_text);
3170 }
3171 \f
3172 /*
3173 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3174 %                                                                             %
3175 %                                                                             %
3176 %                                                                             %
3177 %   R e m o v e I m a g e P r o p e r t y                                     %
3178 %                                                                             %
3179 %                                                                             %
3180 %                                                                             %
3181 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3182 %
3183 %  RemoveImageProperty() removes a property from the image and returns its
3184 %  value.
3185 %
3186 %  The format of the RemoveImageProperty method is:
3187 %
3188 %      char *RemoveImageProperty(Image *image,const char *property)
3189 %
3190 %  A description of each parameter follows:
3191 %
3192 %    o image: the image.
3193 %
3194 %    o property: the image property.
3195 %
3196 */
3197 MagickExport char *RemoveImageProperty(Image *image,
3198   const char *property)
3199 {
3200   char
3201     *value;
3202
3203   assert(image != (Image *) NULL);
3204   assert(image->signature == MagickSignature);
3205   if (image->debug != MagickFalse)
3206     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
3207       image->filename);
3208   if (image->properties == (void *) NULL)
3209     return((char *) NULL);
3210   value=(char *) RemoveNodeFromSplayTree((SplayTreeInfo *) image->properties,
3211     property);
3212   return(value);
3213 }
3214 \f
3215 /*
3216 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3217 %                                                                             %
3218 %                                                                             %
3219 %                                                                             %
3220 %   R e s e t I m a g e P r o p e r t y I t e r a t o r                       %
3221 %                                                                             %
3222 %                                                                             %
3223 %                                                                             %
3224 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3225 %
3226 %  ResetImagePropertyIterator() resets the image properties iterator.  Use it
3227 %  in conjunction with GetNextImageProperty() to iterate over all the values
3228 %  associated with an image property.
3229 %
3230 %  The format of the ResetImagePropertyIterator method is:
3231 %
3232 %      ResetImagePropertyIterator(Image *image)
3233 %
3234 %  A description of each parameter follows:
3235 %
3236 %    o image: the image.
3237 %
3238 */
3239 MagickExport void ResetImagePropertyIterator(const Image *image)
3240 {
3241   assert(image != (Image *) NULL);
3242   assert(image->signature == MagickSignature);
3243   if (image->debug != MagickFalse)
3244     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
3245       image->filename);
3246   if (image->properties == (void *) NULL)
3247     return;
3248   ResetSplayTreeIterator((SplayTreeInfo *) image->properties);
3249 }
3250 \f
3251 /*
3252 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3253 %                                                                             %
3254 %                                                                             %
3255 %                                                                             %
3256 %   S e t I m a g e P r o p e r t y                                           %
3257 %                                                                             %
3258 %                                                                             %
3259 %                                                                             %
3260 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3261 %
3262 %  SetImageProperty() associates an value with an image property.
3263 %
3264 %  The format of the SetImageProperty method is:
3265 %
3266 %      MagickBooleanType SetImageProperty(Image *image,const char *property,
3267 %        const char *value)
3268 %
3269 %  A description of each parameter follows:
3270 %
3271 %    o image: the image.
3272 %
3273 %    o property: the image property.
3274 %
3275 %    o values: the image property values.
3276 %
3277 */
3278 MagickExport MagickBooleanType SetImageProperty(Image *image,
3279   const char *property,const char *value)
3280 {
3281   ExceptionInfo
3282     *exception;
3283
3284   MagickBooleanType
3285     status;
3286
3287   MagickStatusType
3288     flags;
3289
3290   assert(image != (Image *) NULL);
3291   assert(image->signature == MagickSignature);
3292   if (image->debug != MagickFalse)
3293     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
3294       image->filename);
3295   if (image->properties == (void *) NULL)
3296     image->properties=NewSplayTree(CompareSplayTreeString,
3297       RelinquishMagickMemory,RelinquishMagickMemory);
3298   if ((value == (const char *) NULL) || (*value == '\0'))
3299     return(DeleteImageProperty(image,property));
3300   status=MagickTrue;
3301   exception=(&image->exception);
3302   switch (*property)
3303   {
3304     case 'B':
3305     case 'b':
3306     {
3307       if (LocaleCompare(property,"background") == 0)
3308         {
3309           (void) QueryColorDatabase(value,&image->background_color,exception);
3310           break;
3311         }
3312       if (LocaleCompare(property,"bias") == 0)
3313         {
3314           image->bias=SiPrefixToDouble(value,QuantumRange);
3315           break;
3316         }
3317       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3318         ConstantString(property),ConstantString(value));
3319       break;
3320     }
3321     case 'C':
3322     case 'c':
3323     {
3324       if (LocaleCompare(property,"colorspace") == 0)
3325         {
3326           ssize_t
3327             colorspace;
3328
3329           colorspace=ParseMagickOption(MagickColorspaceOptions,MagickFalse,
3330             value);
3331           if (colorspace < 0)
3332             break;
3333           (void) SetImageColorspace(image,(ColorspaceType) colorspace);
3334           break;
3335         }
3336       if (LocaleCompare(property,"compose") == 0)
3337         {
3338           ssize_t
3339             compose;
3340
3341           compose=ParseMagickOption(MagickComposeOptions,MagickFalse,value);
3342           if (compose < 0)
3343             break;
3344           image->compose=(CompositeOperator) compose;
3345           break;
3346         }
3347       if (LocaleCompare(property,"compress") == 0)
3348         {
3349           ssize_t
3350             compression;
3351
3352           compression=ParseMagickOption(MagickCompressOptions,MagickFalse,
3353             value);
3354           if (compression < 0)
3355             break;
3356           image->compression=(CompressionType) compression;
3357           break;
3358         }
3359       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3360         ConstantString(property),ConstantString(value));
3361       break;
3362     }
3363     case 'D':
3364     case 'd':
3365     {
3366       if (LocaleCompare(property,"delay") == 0)
3367         {
3368           GeometryInfo
3369             geometry_info;
3370
3371           flags=ParseGeometry(value,&geometry_info);
3372           if ((flags & GreaterValue) != 0)
3373             {
3374               if (image->delay > (size_t) floor(geometry_info.rho+0.5))
3375                 image->delay=(size_t) floor(geometry_info.rho+0.5);
3376             }
3377           else
3378             if ((flags & LessValue) != 0)
3379               {
3380                 if (image->delay < (size_t) floor(geometry_info.rho+0.5))
3381                   image->ticks_per_second=(ssize_t)
3382                     floor(geometry_info.sigma+0.5);
3383               }
3384             else
3385               image->delay=(size_t) floor(geometry_info.rho+0.5);
3386           if ((flags & SigmaValue) != 0)
3387             image->ticks_per_second=(ssize_t) floor(geometry_info.sigma+0.5);
3388           break;
3389         }
3390       if (LocaleCompare(property,"density") == 0)
3391         {
3392           GeometryInfo
3393             geometry_info;
3394
3395           flags=ParseGeometry(value,&geometry_info);
3396           image->x_resolution=geometry_info.rho;
3397           image->y_resolution=geometry_info.sigma;
3398           if ((flags & SigmaValue) == 0)
3399             image->y_resolution=image->x_resolution;
3400         }
3401       if (LocaleCompare(property,"depth") == 0)
3402         {
3403           image->depth=StringToUnsignedLong(value);
3404           break;
3405         }
3406       if (LocaleCompare(property,"dispose") == 0)
3407         {
3408           ssize_t
3409             dispose;
3410
3411           dispose=ParseMagickOption(MagickDisposeOptions,MagickFalse,value);
3412           if (dispose < 0)
3413             break;
3414           image->dispose=(DisposeType) dispose;
3415           break;
3416         }
3417       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3418         ConstantString(property),ConstantString(value));
3419       break;
3420     }
3421     case 'G':
3422     case 'g':
3423     {
3424       if (LocaleCompare(property,"gravity") == 0)
3425         {
3426           ssize_t
3427             gravity;
3428
3429           gravity=ParseMagickOption(MagickGravityOptions,MagickFalse,value);
3430           if (gravity < 0)
3431             break;
3432           image->gravity=(GravityType) gravity;
3433           break;
3434         }
3435       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3436         ConstantString(property),ConstantString(value));
3437       break;
3438     }
3439     case 'I':
3440     case 'i':
3441     {
3442       if (LocaleCompare(property,"intent") == 0)
3443         {
3444           ssize_t
3445             rendering_intent;
3446
3447           rendering_intent=ParseMagickOption(MagickIntentOptions,MagickFalse,
3448             value);
3449           if (rendering_intent < 0)
3450             break;
3451           image->rendering_intent=(RenderingIntent) rendering_intent;
3452           break;
3453         }
3454       if (LocaleCompare(property,"interpolate") == 0)
3455         {
3456           ssize_t
3457             interpolate;
3458
3459           interpolate=ParseMagickOption(MagickInterpolateOptions,MagickFalse,
3460             value);
3461           if (interpolate < 0)
3462             break;
3463           image->interpolate=(InterpolatePixelMethod) interpolate;
3464           break;
3465         }
3466       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3467         ConstantString(property),ConstantString(value));
3468       break;
3469     }
3470     case 'L':
3471     case 'l':
3472     {
3473       if (LocaleCompare(property,"loop") == 0)
3474         {
3475           image->iterations=StringToUnsignedLong(value);
3476           break;
3477         }
3478       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3479         ConstantString(property),ConstantString(value));
3480       break;
3481     }
3482     case 'P':
3483     case 'p':
3484     {
3485       if (LocaleCompare(property,"page") == 0)
3486         {
3487           char
3488             *geometry;
3489
3490           geometry=GetPageGeometry(value);
3491           flags=ParseAbsoluteGeometry(geometry,&image->page);
3492           geometry=DestroyString(geometry);
3493           break;
3494         }
3495       if (LocaleCompare(property,"profile") == 0)
3496         {
3497           ImageInfo
3498             *image_info;
3499
3500           StringInfo
3501             *profile;
3502
3503           image_info=AcquireImageInfo();
3504           (void) CopyMagickString(image_info->filename,value,MaxTextExtent);
3505           (void) SetImageInfo(image_info,1,exception);
3506           profile=FileToStringInfo(image_info->filename,~0UL,exception);
3507           if (profile != (StringInfo *) NULL)
3508             status=SetImageProfile(image,image_info->magick,profile);
3509           image_info=DestroyImageInfo(image_info);
3510           break;
3511         }
3512       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3513         ConstantString(property),ConstantString(value));
3514       break;
3515     }
3516     case 'R':
3517     case 'r':
3518     {
3519       if (LocaleCompare(property,"rendering-intent") == 0)
3520         {
3521           ssize_t
3522             rendering_intent;
3523
3524           rendering_intent=ParseMagickOption(MagickIntentOptions,MagickFalse,
3525             value);
3526           if (rendering_intent < 0)
3527             break;
3528           image->rendering_intent=(RenderingIntent) rendering_intent;
3529           break;
3530         }
3531       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3532         ConstantString(property),ConstantString(value));
3533       break;
3534     }
3535     case 'T':
3536     case 't':
3537     {
3538       if (LocaleCompare(property,"tile-offset") == 0)
3539         {
3540           char
3541             *geometry;
3542
3543           geometry=GetPageGeometry(value);
3544           flags=ParseAbsoluteGeometry(geometry,&image->tile_offset);
3545           geometry=DestroyString(geometry);
3546           break;
3547         }
3548       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3549         ConstantString(property),ConstantString(value));
3550       break;
3551     }
3552     case 'U':
3553     case 'u':
3554     {
3555       if (LocaleCompare(property,"units") == 0)
3556         {
3557           ssize_t
3558             units;
3559
3560           units=ParseMagickOption(MagickResolutionOptions,MagickFalse,value);
3561           if (units < 0)
3562             break;
3563           image->units=(ResolutionType) units;
3564           break;
3565         }
3566       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3567         ConstantString(property),ConstantString(value));
3568       break;
3569     }
3570     default:
3571     {
3572       status=AddValueToSplayTree((SplayTreeInfo *) image->properties,
3573         ConstantString(property),ConstantString(value));
3574       break;
3575     }
3576   }
3577   return(status);
3578 }