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