2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % CCCC OOO DDDD EEEEE RRRR %
10 % CCCC OOO DDDD EEEEE R R %
13 % MagickCore Image Coder Methods %
20 % Copyright 1999-2010 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
28 % Unless required by applicable law or agreed to in writing, software %
29 % distributed under the License is distributed on an "AS IS" BASIS, %
30 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31 % See the License for the specific language governing permissions and %
32 % limitations under the License. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 #include "magick/studio.h"
43 #include "magick/blob.h"
44 #include "magick/client.h"
45 #include "magick/coder.h"
46 #include "magick/configure.h"
47 #include "magick/draw.h"
48 #include "magick/exception.h"
49 #include "magick/exception-private.h"
50 #include "magick/hashmap.h"
51 #include "magick/log.h"
52 #include "magick/memory_.h"
53 #include "magick/option.h"
54 #include "magick/semaphore.h"
55 #include "magick/string_.h"
56 #include "magick/splay-tree.h"
57 #include "magick/token.h"
58 #include "magick/utility.h"
59 #include "magick/xml-tree.h"
64 #define MagickCoderFilename "coder.xml"
69 typedef struct _CoderMapInfo
79 static const CoderMapInfo
84 { "8BIMTEXT", "META" },
85 { "8BIMWTEXT", "META" },
89 { "APP1JPEG", "META" },
121 { "FRACTAL", "PLASMA" },
129 { "GRANITE", "MAGICK" },
130 { "GROUP4", "TIFF" },
140 { "IMPLICIT", "***" },
142 { "IPTCTEXT", "META" },
143 { "IPTCWTEXT", "META" },
144 { "ISOBRL", "BRAILLE" },
152 { "LOGO", "MAGICK" },
164 { "NETSCAPE", "MAGICK" },
190 { "RADIAL-GRADIENT", "GRADIENT" },
197 { "ROSE", "MAGICK" },
203 { "TIFF64", "TIFF" },
206 { "UBRL", "BRAILLE" },
210 { "WMFWIN32", "EMF" },
214 { "XTRNARRAY", "XTRN" },
215 { "XTRNBLOB", "XTRN" },
216 { "XTRNBSTR", "XTRN" },
217 { "XTRNFILE", "XTRN" },
218 { "XTRNIMAGE", "XTRN" },
219 { "XTRNSTREAM", "XTRN" },
222 { "YCbCrA", "YCbCr" }
226 *coder_semaphore = (SemaphoreInfo *) NULL;
229 *coder_list = (SplayTreeInfo *) NULL;
231 static volatile MagickBooleanType
232 instantiate_coder = MagickFalse;
235 Forward declarations.
237 static MagickBooleanType
238 InitializeCoderList(ExceptionInfo *),
239 LoadCoderLists(const char *,ExceptionInfo *);
242 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
246 + C o d e r C o m p o n e n t G e n e s i s %
250 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
252 % CoderComponentGenesis() instantiates the coder component.
254 % The format of the CoderComponentGenesis method is:
256 % MagickBooleanType CoderComponentGenesis(void)
259 MagickExport MagickBooleanType CoderComponentGenesis(void)
261 AcquireSemaphoreInfo(&coder_semaphore);
266 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
270 + C o d e r C o m p o n e n t T e r m i n u s %
274 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
276 % CoderComponentTerminus() destroys the coder component.
278 % The format of the CoderComponentTerminus method is:
280 % CoderComponentTerminus(void)
283 MagickExport void CoderComponentTerminus(void)
285 if (coder_semaphore == (SemaphoreInfo *) NULL)
286 AcquireSemaphoreInfo(&coder_semaphore);
287 LockSemaphoreInfo(coder_semaphore);
288 if (coder_list != (SplayTreeInfo *) NULL)
289 coder_list=DestroySplayTree(coder_list);
290 instantiate_coder=MagickFalse;
291 UnlockSemaphoreInfo(coder_semaphore);
292 DestroySemaphoreInfo(&coder_semaphore);
296 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
300 + G e t C o d e r I n f o %
304 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
306 % GetCoderInfo searches the coder list for the specified name and if found
307 % returns attributes for that coder.
309 % The format of the GetCoderInfo method is:
311 % const CoderInfo *GetCoderInfo(const char *name,ExceptionInfo *exception)
313 % A description of each parameter follows:
315 % o name: the coder name.
317 % o exception: return any errors or warnings in this structure.
320 MagickExport const CoderInfo *GetCoderInfo(const char *name,
321 ExceptionInfo *exception)
323 assert(exception != (ExceptionInfo *) NULL);
324 if ((coder_list == (SplayTreeInfo *) NULL) ||
325 (instantiate_coder == MagickFalse))
326 if (InitializeCoderList(exception) == MagickFalse)
327 return((const CoderInfo *) NULL);
328 if ((coder_list == (SplayTreeInfo *) NULL) ||
329 (GetNumberOfNodesInSplayTree(coder_list) == 0))
330 return((const CoderInfo *) NULL);
331 if ((name == (const char *) NULL) || (LocaleCompare(name,"*") == 0))
333 ResetSplayTreeIterator(coder_list);
334 return((const CoderInfo *) GetNextValueInSplayTree(coder_list));
336 return((const CoderInfo *) GetValueFromSplayTree(coder_list,name));
340 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
344 % G e t C o d e r I n f o L i s t %
348 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
350 % GetCoderInfoList() returns any coder_map that match the specified pattern.
351 % The format of the GetCoderInfoList function is:
353 % const CoderInfo **GetCoderInfoList(const char *pattern,
354 % size_t *number_coders,ExceptionInfo *exception)
356 % A description of each parameter follows:
358 % o pattern: Specifies a pointer to a text string containing a pattern.
360 % o number_coders: This integer returns the number of coders in the list.
362 % o exception: return any errors or warnings in this structure.
366 static int CoderInfoCompare(const void *x,const void *y)
372 p=(const CoderInfo **) x,
373 q=(const CoderInfo **) y;
374 if (LocaleCompare((*p)->path,(*q)->path) == 0)
375 return(LocaleCompare((*p)->name,(*q)->name));
376 return(LocaleCompare((*p)->path,(*q)->path));
379 MagickExport const CoderInfo **GetCoderInfoList(const char *pattern,
380 size_t *number_coders,ExceptionInfo *exception)
385 register const CoderInfo
394 assert(pattern != (char *) NULL);
395 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
396 assert(number_coders != (size_t *) NULL);
398 p=GetCoderInfo("*",exception);
399 if (p == (const CoderInfo *) NULL)
400 return((const CoderInfo **) NULL);
401 coder_map=(const CoderInfo **) AcquireQuantumMemory((size_t)
402 GetNumberOfNodesInSplayTree(coder_list)+1UL,sizeof(*coder_map));
403 if (coder_map == (const CoderInfo **) NULL)
404 return((const CoderInfo **) NULL);
408 LockSemaphoreInfo(coder_semaphore);
409 ResetSplayTreeIterator(coder_list);
410 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
411 for (i=0; p != (const CoderInfo *) NULL; )
413 if ((p->stealth == MagickFalse) &&
414 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
416 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
418 UnlockSemaphoreInfo(coder_semaphore);
419 qsort((void *) coder_map,(size_t) i,sizeof(*coder_map),CoderInfoCompare);
420 coder_map[i]=(CoderInfo *) NULL;
421 *number_coders=(size_t) i;
426 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
430 % G e t C o d e r L i s t %
434 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
436 % GetCoderList() returns any coder_map that match the specified pattern.
438 % The format of the GetCoderList function is:
440 % char **GetCoderList(const char *pattern,size_t *number_coders,
441 % ExceptionInfo *exception)
443 % A description of each parameter follows:
445 % o pattern: Specifies a pointer to a text string containing a pattern.
447 % o number_coders: This integer returns the number of coders in the list.
449 % o exception: return any errors or warnings in this structure.
453 static int CoderCompare(const void *x,const void *y)
461 return(LocaleCompare(*p,*q));
464 MagickExport char **GetCoderList(const char *pattern,
465 size_t *number_coders,ExceptionInfo *exception)
470 register const CoderInfo
479 assert(pattern != (char *) NULL);
480 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
481 assert(number_coders != (size_t *) NULL);
483 p=GetCoderInfo("*",exception);
484 if (p == (const CoderInfo *) NULL)
485 return((char **) NULL);
486 coder_map=(char **) AcquireQuantumMemory((size_t)
487 GetNumberOfNodesInSplayTree(coder_list)+1UL,sizeof(*coder_map));
488 if (coder_map == (char **) NULL)
489 return((char **) NULL);
493 LockSemaphoreInfo(coder_semaphore);
494 ResetSplayTreeIterator(coder_list);
495 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
496 for (i=0; p != (const CoderInfo *) NULL; )
498 if ((p->stealth == MagickFalse) &&
499 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
500 coder_map[i++]=ConstantString(p->name);
501 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
503 UnlockSemaphoreInfo(coder_semaphore);
504 qsort((void *) coder_map,(size_t) i,sizeof(*coder_map),CoderCompare);
505 coder_map[i]=(char *) NULL;
506 *number_coders=(size_t) i;
511 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
515 + I n i t i a l i z e C o d e r L i s t %
519 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
521 % InitializeCoderList() initializes the coder list.
523 % The format of the InitializeCoderList method is:
525 % MagickBooleanType InitializeCoderList(ExceptionInfo *exception)
527 % A description of each parameter follows.
529 % o exception: return any errors or warnings in this structure.
532 static MagickBooleanType InitializeCoderList(ExceptionInfo *exception)
534 if ((coder_list == (SplayTreeInfo *) NULL) &&
535 (instantiate_coder == MagickFalse))
537 if (coder_semaphore == (SemaphoreInfo *) NULL)
538 AcquireSemaphoreInfo(&coder_semaphore);
539 LockSemaphoreInfo(coder_semaphore);
540 if ((coder_list == (SplayTreeInfo *) NULL) &&
541 (instantiate_coder == MagickFalse))
543 (void) LoadCoderLists(MagickCoderFilename,exception);
544 instantiate_coder=MagickTrue;
546 UnlockSemaphoreInfo(coder_semaphore);
548 return(coder_list != (SplayTreeInfo *) NULL ? MagickTrue : MagickFalse);
552 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
556 % L i s t C o d e r I n f o %
560 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
562 % ListCoderInfo() lists the coder info to a file.
564 % The format of the ListCoderInfo coder is:
566 % MagickBooleanType ListCoderInfo(FILE *file,ExceptionInfo *exception)
568 % A description of each parameter follows.
570 % o file: An pointer to a FILE.
572 % o exception: return any errors or warnings in this structure.
575 MagickExport MagickBooleanType ListCoderInfo(FILE *file,
576 ExceptionInfo *exception)
593 if (file == (const FILE *) NULL)
595 coder_info=GetCoderInfoList("*",&number_coders,exception);
596 if (coder_info == (const CoderInfo **) NULL)
598 path=(const char *) NULL;
599 for (i=0; i < (ssize_t) number_coders; i++)
601 if (coder_info[i]->stealth != MagickFalse)
603 if ((path == (const char *) NULL) ||
604 (LocaleCompare(path,coder_info[i]->path) != 0))
606 if (coder_info[i]->path != (char *) NULL)
607 (void) fprintf(file,"\nPath: %s\n\n",coder_info[i]->path);
608 (void) fprintf(file,"Magick Coder\n");
609 (void) fprintf(file,"-------------------------------------------------"
610 "------------------------------\n");
612 path=coder_info[i]->path;
613 (void) fprintf(file,"%s",coder_info[i]->magick);
614 for (j=(ssize_t) strlen(coder_info[i]->magick); j <= 11; j++)
615 (void) fprintf(file," ");
616 if (coder_info[i]->name != (char *) NULL)
617 (void) fprintf(file,"%s",coder_info[i]->name);
618 (void) fprintf(file,"\n");
620 coder_info=(const CoderInfo **) RelinquishMagickMemory((void *) coder_info);
626 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
630 + L o a d C o d e r L i s t %
634 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
636 % LoadCoderList() loads the coder configuration file which provides a
637 % mapping between coder attributes and a coder name.
639 % The format of the LoadCoderList coder is:
641 % MagickBooleanType LoadCoderList(const char *xml,const char *filename,
642 % const size_t depth,ExceptionInfo *exception)
644 % A description of each parameter follows:
646 % o xml: The coder list in XML format.
648 % o filename: The coder list filename.
650 % o depth: depth of <include /> statements.
652 % o exception: return any errors or warnings in this structure.
656 static void *DestroyCoderNode(void *coder_info)
661 p=(CoderInfo *) coder_info;
662 if (p->exempt == MagickFalse)
664 if (p->path != (char *) NULL)
665 p->path=DestroyString(p->path);
666 if (p->name != (char *) NULL)
667 p->name=DestroyString(p->name);
668 if (p->magick != (char *) NULL)
669 p->magick=DestroyString(p->magick);
671 return(RelinquishMagickMemory(p));
674 static MagickBooleanType LoadCoderList(const char *xml,const char *filename,
675 const size_t depth,ExceptionInfo *exception)
678 keyword[MaxTextExtent],
691 Load the coder map file.
693 (void) LogMagickEvent(ConfigureEvent,GetMagickModule(),
694 "Loading coder configuration file \"%s\" ...",filename);
695 if (xml == (const char *) NULL)
697 if (coder_list == (SplayTreeInfo *) NULL)
699 coder_list=NewSplayTree(CompareSplayTreeString,RelinquishMagickMemory,
701 if (coder_list == (SplayTreeInfo *) NULL)
703 ThrowFileException(exception,ResourceLimitError,
704 "MemoryAllocationFailed",filename);
709 coder_info=(CoderInfo *) NULL;
710 token=AcquireString(xml);
711 for (q=(char *) xml; *q != '\0'; )
716 GetMagickToken(q,&q,token);
719 (void) CopyMagickString(keyword,token,MaxTextExtent);
720 if (LocaleNCompare(keyword,"<!DOCTYPE",9) == 0)
725 while ((LocaleNCompare(q,"]>",2) != 0) && (*q != '\0'))
726 GetMagickToken(q,&q,token);
729 if (LocaleNCompare(keyword,"<!--",4) == 0)
734 while ((LocaleNCompare(q,"->",2) != 0) && (*q != '\0'))
735 GetMagickToken(q,&q,token);
738 if (LocaleCompare(keyword,"<include") == 0)
743 while (((*token != '/') && (*(token+1) != '>')) && (*q != '\0'))
745 (void) CopyMagickString(keyword,token,MaxTextExtent);
746 GetMagickToken(q,&q,token);
749 GetMagickToken(q,&q,token);
750 if (LocaleCompare(keyword,"file") == 0)
753 (void) ThrowMagickException(exception,GetMagickModule(),
754 ConfigureError,"IncludeNodeNestedTooDeeply","`%s'",token);
761 GetPathComponent(filename,HeadPath,path);
763 (void) ConcatenateMagickString(path,DirectorySeparator,
765 if (*token == *DirectorySeparator)
766 (void) CopyMagickString(path,token,MaxTextExtent);
768 (void) ConcatenateMagickString(path,token,MaxTextExtent);
769 xml=FileToString(path,~0,exception);
770 if (xml != (char *) NULL)
772 status=LoadCoderList(xml,path,depth+1,exception);
773 xml=(char *) RelinquishMagickMemory(xml);
780 if (LocaleCompare(keyword,"<coder") == 0)
785 coder_info=(CoderInfo *) AcquireAlignedMemory(1,sizeof(*coder_info));
786 if (coder_info == (CoderInfo *) NULL)
787 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
788 (void) ResetMagickMemory(coder_info,0,sizeof(*coder_info));
789 coder_info->path=ConstantString(filename);
790 coder_info->exempt=MagickFalse;
791 coder_info->signature=MagickSignature;
794 if (coder_info == (CoderInfo *) NULL)
796 if (LocaleCompare(keyword,"/>") == 0)
798 status=AddValueToSplayTree(coder_list,ConstantString(
799 coder_info->magick),coder_info);
800 if (status == MagickFalse)
801 (void) ThrowMagickException(exception,GetMagickModule(),
802 ResourceLimitError,"MemoryAllocationFailed","`%s'",
804 coder_info=(CoderInfo *) NULL;
806 GetMagickToken(q,(const char **) NULL,token);
809 GetMagickToken(q,&q,token);
810 GetMagickToken(q,&q,token);
816 if (LocaleCompare((char *) keyword,"magick") == 0)
818 coder_info->magick=ConstantString(token);
826 if (LocaleCompare((char *) keyword,"name") == 0)
828 coder_info->name=ConstantString(token);
836 if (LocaleCompare((char *) keyword,"stealth") == 0)
838 coder_info->stealth=IsMagickTrue(token);
847 token=(char *) RelinquishMagickMemory(token);
852 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
856 % L o a d C o d e r L i s t s %
860 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
862 % LoadCoderLists() loads one or more coder configuration file which
863 % provides a mapping between coder attributes and a coder name.
865 % The format of the LoadCoderLists coder is:
867 % MagickBooleanType LoadCoderLists(const char *filename,
868 % ExceptionInfo *exception)
870 % A description of each parameter follows:
872 % o filename: the font file name.
874 % o exception: return any errors or warnings in this structure.
877 static MagickBooleanType LoadCoderLists(const char *filename,
878 ExceptionInfo *exception)
893 Load built-in coder map.
896 if (coder_list == (SplayTreeInfo *) NULL)
898 coder_list=NewSplayTree(CompareSplayTreeString,RelinquishMagickMemory,
900 if (coder_list == (SplayTreeInfo *) NULL)
902 ThrowFileException(exception,ResourceLimitError,
903 "MemoryAllocationFailed",filename);
907 for (i=0; i < (ssize_t) (sizeof(CoderMap)/sizeof(*CoderMap)); i++)
912 register const CoderMapInfo
916 coder_info=(CoderInfo *) AcquireAlignedMemory(1,sizeof(*coder_info));
917 if (coder_info == (CoderInfo *) NULL)
919 (void) ThrowMagickException(exception,GetMagickModule(),
920 ResourceLimitError,"MemoryAllocationFailed","`%s'",coder_info->name);
923 (void) ResetMagickMemory(coder_info,0,sizeof(*coder_info));
924 coder_info->path=(char *) "[built-in]";
925 coder_info->magick=(char *) p->magick;
926 coder_info->name=(char *) p->name;
927 coder_info->exempt=MagickTrue;
928 coder_info->signature=MagickSignature;
929 status=AddValueToSplayTree(coder_list,ConstantString(coder_info->magick),
931 if (status == MagickFalse)
932 (void) ThrowMagickException(exception,GetMagickModule(),
933 ResourceLimitError,"MemoryAllocationFailed","`%s'",coder_info->name);
936 Load external coder map.
938 options=GetConfigureOptions(filename,exception);
939 option=(const StringInfo *) GetNextValueInLinkedList(options);
940 while (option != (const StringInfo *) NULL)
942 status|=LoadCoderList((const char *) GetStringInfoDatum(option),
943 GetStringInfoPath(option),0,exception);
944 option=(const StringInfo *) GetNextValueInLinkedList(options);
946 options=DestroyConfigureOptions(options);
947 return(status != 0 ? MagickTrue : MagickFalse);