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" },
122 { "FRACTAL", "PLASMA" },
130 { "GRANITE", "MAGICK" },
131 { "GROUP4", "TIFF" },
141 { "IMPLICIT", "***" },
143 { "IPTCTEXT", "META" },
144 { "IPTCWTEXT", "META" },
145 { "ISOBRL", "BRAILLE" },
153 { "LOGO", "MAGICK" },
165 { "NETSCAPE", "MAGICK" },
191 { "RADIAL-GRADIENT", "GRADIENT" },
198 { "ROSE", "MAGICK" },
204 { "TIFF64", "TIFF" },
207 { "UBRL", "BRAILLE" },
211 { "WMFWIN32", "EMF" },
215 { "XTRNARRAY", "XTRN" },
216 { "XTRNBLOB", "XTRN" },
217 { "XTRNBSTR", "XTRN" },
218 { "XTRNFILE", "XTRN" },
219 { "XTRNIMAGE", "XTRN" },
220 { "XTRNSTREAM", "XTRN" },
223 { "YCbCrA", "YCbCr" }
227 *coder_semaphore = (SemaphoreInfo *) NULL;
230 *coder_list = (SplayTreeInfo *) NULL;
232 static volatile MagickBooleanType
233 instantiate_coder = MagickFalse;
236 Forward declarations.
238 static MagickBooleanType
239 InitializeCoderList(ExceptionInfo *),
240 LoadCoderLists(const char *,ExceptionInfo *);
243 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
247 + C o d e r C o m p o n e n t G e n e s i s %
251 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
253 % CoderComponentGenesis() instantiates the coder component.
255 % The format of the CoderComponentGenesis method is:
257 % MagickBooleanType CoderComponentGenesis(void)
260 MagickExport MagickBooleanType CoderComponentGenesis(void)
262 AcquireSemaphoreInfo(&coder_semaphore);
267 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
271 + C o d e r C o m p o n e n t T e r m i n u s %
275 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
277 % CoderComponentTerminus() destroys the coder component.
279 % The format of the CoderComponentTerminus method is:
281 % CoderComponentTerminus(void)
284 MagickExport void CoderComponentTerminus(void)
286 if (coder_semaphore == (SemaphoreInfo *) NULL)
287 AcquireSemaphoreInfo(&coder_semaphore);
288 LockSemaphoreInfo(coder_semaphore);
289 if (coder_list != (SplayTreeInfo *) NULL)
290 coder_list=DestroySplayTree(coder_list);
291 instantiate_coder=MagickFalse;
292 UnlockSemaphoreInfo(coder_semaphore);
293 DestroySemaphoreInfo(&coder_semaphore);
297 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
301 + G e t C o d e r I n f o %
305 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
307 % GetCoderInfo searches the coder list for the specified name and if found
308 % returns attributes for that coder.
310 % The format of the GetCoderInfo method is:
312 % const CoderInfo *GetCoderInfo(const char *name,ExceptionInfo *exception)
314 % A description of each parameter follows:
316 % o name: the coder name.
318 % o exception: return any errors or warnings in this structure.
321 MagickExport const CoderInfo *GetCoderInfo(const char *name,
322 ExceptionInfo *exception)
324 assert(exception != (ExceptionInfo *) NULL);
325 if ((coder_list == (SplayTreeInfo *) NULL) ||
326 (instantiate_coder == MagickFalse))
327 if (InitializeCoderList(exception) == MagickFalse)
328 return((const CoderInfo *) NULL);
329 if ((coder_list == (SplayTreeInfo *) NULL) ||
330 (GetNumberOfNodesInSplayTree(coder_list) == 0))
331 return((const CoderInfo *) NULL);
332 if ((name == (const char *) NULL) || (LocaleCompare(name,"*") == 0))
334 ResetSplayTreeIterator(coder_list);
335 return((const CoderInfo *) GetNextValueInSplayTree(coder_list));
337 return((const CoderInfo *) GetValueFromSplayTree(coder_list,name));
341 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
345 % G e t C o d e r I n f o L i s t %
349 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
351 % GetCoderInfoList() returns any coder_map that match the specified pattern.
352 % The format of the GetCoderInfoList function is:
354 % const CoderInfo **GetCoderInfoList(const char *pattern,
355 % size_t *number_coders,ExceptionInfo *exception)
357 % A description of each parameter follows:
359 % o pattern: Specifies a pointer to a text string containing a pattern.
361 % o number_coders: This integer returns the number of coders in the list.
363 % o exception: return any errors or warnings in this structure.
367 static int CoderInfoCompare(const void *x,const void *y)
373 p=(const CoderInfo **) x,
374 q=(const CoderInfo **) y;
375 if (LocaleCompare((*p)->path,(*q)->path) == 0)
376 return(LocaleCompare((*p)->name,(*q)->name));
377 return(LocaleCompare((*p)->path,(*q)->path));
380 MagickExport const CoderInfo **GetCoderInfoList(const char *pattern,
381 size_t *number_coders,ExceptionInfo *exception)
386 register const CoderInfo
395 assert(pattern != (char *) NULL);
396 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
397 assert(number_coders != (size_t *) NULL);
399 p=GetCoderInfo("*",exception);
400 if (p == (const CoderInfo *) NULL)
401 return((const CoderInfo **) NULL);
402 coder_map=(const CoderInfo **) AcquireQuantumMemory((size_t)
403 GetNumberOfNodesInSplayTree(coder_list)+1UL,sizeof(*coder_map));
404 if (coder_map == (const CoderInfo **) NULL)
405 return((const CoderInfo **) NULL);
409 LockSemaphoreInfo(coder_semaphore);
410 ResetSplayTreeIterator(coder_list);
411 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
412 for (i=0; p != (const CoderInfo *) NULL; )
414 if ((p->stealth == MagickFalse) &&
415 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
417 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
419 UnlockSemaphoreInfo(coder_semaphore);
420 qsort((void *) coder_map,(size_t) i,sizeof(*coder_map),CoderInfoCompare);
421 coder_map[i]=(CoderInfo *) NULL;
422 *number_coders=(size_t) i;
427 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
431 % G e t C o d e r L i s t %
435 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
437 % GetCoderList() returns any coder_map that match the specified pattern.
439 % The format of the GetCoderList function is:
441 % char **GetCoderList(const char *pattern,size_t *number_coders,
442 % ExceptionInfo *exception)
444 % A description of each parameter follows:
446 % o pattern: Specifies a pointer to a text string containing a pattern.
448 % o number_coders: This integer returns the number of coders in the list.
450 % o exception: return any errors or warnings in this structure.
454 static int CoderCompare(const void *x,const void *y)
462 return(LocaleCompare(*p,*q));
465 MagickExport char **GetCoderList(const char *pattern,
466 size_t *number_coders,ExceptionInfo *exception)
471 register const CoderInfo
480 assert(pattern != (char *) NULL);
481 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
482 assert(number_coders != (size_t *) NULL);
484 p=GetCoderInfo("*",exception);
485 if (p == (const CoderInfo *) NULL)
486 return((char **) NULL);
487 coder_map=(char **) AcquireQuantumMemory((size_t)
488 GetNumberOfNodesInSplayTree(coder_list)+1UL,sizeof(*coder_map));
489 if (coder_map == (char **) NULL)
490 return((char **) NULL);
494 LockSemaphoreInfo(coder_semaphore);
495 ResetSplayTreeIterator(coder_list);
496 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
497 for (i=0; p != (const CoderInfo *) NULL; )
499 if ((p->stealth == MagickFalse) &&
500 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
501 coder_map[i++]=ConstantString(p->name);
502 p=(const CoderInfo *) GetNextValueInSplayTree(coder_list);
504 UnlockSemaphoreInfo(coder_semaphore);
505 qsort((void *) coder_map,(size_t) i,sizeof(*coder_map),CoderCompare);
506 coder_map[i]=(char *) NULL;
507 *number_coders=(size_t) i;
512 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
516 + I n i t i a l i z e C o d e r L i s t %
520 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
522 % InitializeCoderList() initializes the coder list.
524 % The format of the InitializeCoderList method is:
526 % MagickBooleanType InitializeCoderList(ExceptionInfo *exception)
528 % A description of each parameter follows.
530 % o exception: return any errors or warnings in this structure.
533 static MagickBooleanType InitializeCoderList(ExceptionInfo *exception)
535 if ((coder_list == (SplayTreeInfo *) NULL) &&
536 (instantiate_coder == MagickFalse))
538 if (coder_semaphore == (SemaphoreInfo *) NULL)
539 AcquireSemaphoreInfo(&coder_semaphore);
540 LockSemaphoreInfo(coder_semaphore);
541 if ((coder_list == (SplayTreeInfo *) NULL) &&
542 (instantiate_coder == MagickFalse))
544 (void) LoadCoderLists(MagickCoderFilename,exception);
545 instantiate_coder=MagickTrue;
547 UnlockSemaphoreInfo(coder_semaphore);
549 return(coder_list != (SplayTreeInfo *) NULL ? MagickTrue : MagickFalse);
553 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
557 % L i s t C o d e r I n f o %
561 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
563 % ListCoderInfo() lists the coder info to a file.
565 % The format of the ListCoderInfo coder is:
567 % MagickBooleanType ListCoderInfo(FILE *file,ExceptionInfo *exception)
569 % A description of each parameter follows.
571 % o file: An pointer to a FILE.
573 % o exception: return any errors or warnings in this structure.
576 MagickExport MagickBooleanType ListCoderInfo(FILE *file,
577 ExceptionInfo *exception)
594 if (file == (const FILE *) NULL)
596 coder_info=GetCoderInfoList("*",&number_coders,exception);
597 if (coder_info == (const CoderInfo **) NULL)
599 path=(const char *) NULL;
600 for (i=0; i < (ssize_t) number_coders; i++)
602 if (coder_info[i]->stealth != MagickFalse)
604 if ((path == (const char *) NULL) ||
605 (LocaleCompare(path,coder_info[i]->path) != 0))
607 if (coder_info[i]->path != (char *) NULL)
608 (void) fprintf(file,"\nPath: %s\n\n",coder_info[i]->path);
609 (void) fprintf(file,"Magick Coder\n");
610 (void) fprintf(file,"-------------------------------------------------"
611 "------------------------------\n");
613 path=coder_info[i]->path;
614 (void) fprintf(file,"%s",coder_info[i]->magick);
615 for (j=(ssize_t) strlen(coder_info[i]->magick); j <= 11; j++)
616 (void) fprintf(file," ");
617 if (coder_info[i]->name != (char *) NULL)
618 (void) fprintf(file,"%s",coder_info[i]->name);
619 (void) fprintf(file,"\n");
621 coder_info=(const CoderInfo **) RelinquishMagickMemory((void *) coder_info);
627 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
631 + L o a d C o d e r L i s t %
635 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
637 % LoadCoderList() loads the coder configuration file which provides a
638 % mapping between coder attributes and a coder name.
640 % The format of the LoadCoderList coder is:
642 % MagickBooleanType LoadCoderList(const char *xml,const char *filename,
643 % const size_t depth,ExceptionInfo *exception)
645 % A description of each parameter follows:
647 % o xml: The coder list in XML format.
649 % o filename: The coder list filename.
651 % o depth: depth of <include /> statements.
653 % o exception: return any errors or warnings in this structure.
657 static void *DestroyCoderNode(void *coder_info)
662 p=(CoderInfo *) coder_info;
663 if (p->exempt == MagickFalse)
665 if (p->path != (char *) NULL)
666 p->path=DestroyString(p->path);
667 if (p->name != (char *) NULL)
668 p->name=DestroyString(p->name);
669 if (p->magick != (char *) NULL)
670 p->magick=DestroyString(p->magick);
672 return(RelinquishMagickMemory(p));
675 static MagickBooleanType LoadCoderList(const char *xml,const char *filename,
676 const size_t depth,ExceptionInfo *exception)
679 keyword[MaxTextExtent],
692 Load the coder map file.
694 (void) LogMagickEvent(ConfigureEvent,GetMagickModule(),
695 "Loading coder configuration file \"%s\" ...",filename);
696 if (xml == (const char *) NULL)
698 if (coder_list == (SplayTreeInfo *) NULL)
700 coder_list=NewSplayTree(CompareSplayTreeString,RelinquishMagickMemory,
702 if (coder_list == (SplayTreeInfo *) NULL)
704 ThrowFileException(exception,ResourceLimitError,
705 "MemoryAllocationFailed",filename);
710 coder_info=(CoderInfo *) NULL;
711 token=AcquireString(xml);
712 for (q=(char *) xml; *q != '\0'; )
717 GetMagickToken(q,&q,token);
720 (void) CopyMagickString(keyword,token,MaxTextExtent);
721 if (LocaleNCompare(keyword,"<!DOCTYPE",9) == 0)
726 while ((LocaleNCompare(q,"]>",2) != 0) && (*q != '\0'))
727 GetMagickToken(q,&q,token);
730 if (LocaleNCompare(keyword,"<!--",4) == 0)
735 while ((LocaleNCompare(q,"->",2) != 0) && (*q != '\0'))
736 GetMagickToken(q,&q,token);
739 if (LocaleCompare(keyword,"<include") == 0)
744 while (((*token != '/') && (*(token+1) != '>')) && (*q != '\0'))
746 (void) CopyMagickString(keyword,token,MaxTextExtent);
747 GetMagickToken(q,&q,token);
750 GetMagickToken(q,&q,token);
751 if (LocaleCompare(keyword,"file") == 0)
754 (void) ThrowMagickException(exception,GetMagickModule(),
755 ConfigureError,"IncludeNodeNestedTooDeeply","`%s'",token);
762 GetPathComponent(filename,HeadPath,path);
764 (void) ConcatenateMagickString(path,DirectorySeparator,
766 if (*token == *DirectorySeparator)
767 (void) CopyMagickString(path,token,MaxTextExtent);
769 (void) ConcatenateMagickString(path,token,MaxTextExtent);
770 xml=FileToString(path,~0,exception);
771 if (xml != (char *) NULL)
773 status=LoadCoderList(xml,path,depth+1,exception);
774 xml=(char *) RelinquishMagickMemory(xml);
781 if (LocaleCompare(keyword,"<coder") == 0)
786 coder_info=(CoderInfo *) AcquireAlignedMemory(1,sizeof(*coder_info));
787 if (coder_info == (CoderInfo *) NULL)
788 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
789 (void) ResetMagickMemory(coder_info,0,sizeof(*coder_info));
790 coder_info->path=ConstantString(filename);
791 coder_info->exempt=MagickFalse;
792 coder_info->signature=MagickSignature;
795 if (coder_info == (CoderInfo *) NULL)
797 if (LocaleCompare(keyword,"/>") == 0)
799 status=AddValueToSplayTree(coder_list,ConstantString(
800 coder_info->magick),coder_info);
801 if (status == MagickFalse)
802 (void) ThrowMagickException(exception,GetMagickModule(),
803 ResourceLimitError,"MemoryAllocationFailed","`%s'",
805 coder_info=(CoderInfo *) NULL;
807 GetMagickToken(q,(const char **) NULL,token);
810 GetMagickToken(q,&q,token);
811 GetMagickToken(q,&q,token);
817 if (LocaleCompare((char *) keyword,"magick") == 0)
819 coder_info->magick=ConstantString(token);
827 if (LocaleCompare((char *) keyword,"name") == 0)
829 coder_info->name=ConstantString(token);
837 if (LocaleCompare((char *) keyword,"stealth") == 0)
839 coder_info->stealth=IsMagickTrue(token);
848 token=(char *) RelinquishMagickMemory(token);
853 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
857 % L o a d C o d e r L i s t s %
861 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
863 % LoadCoderLists() loads one or more coder configuration file which
864 % provides a mapping between coder attributes and a coder name.
866 % The format of the LoadCoderLists coder is:
868 % MagickBooleanType LoadCoderLists(const char *filename,
869 % ExceptionInfo *exception)
871 % A description of each parameter follows:
873 % o filename: the font file name.
875 % o exception: return any errors or warnings in this structure.
878 static MagickBooleanType LoadCoderLists(const char *filename,
879 ExceptionInfo *exception)
894 Load built-in coder map.
897 if (coder_list == (SplayTreeInfo *) NULL)
899 coder_list=NewSplayTree(CompareSplayTreeString,RelinquishMagickMemory,
901 if (coder_list == (SplayTreeInfo *) NULL)
903 ThrowFileException(exception,ResourceLimitError,
904 "MemoryAllocationFailed",filename);
908 for (i=0; i < (ssize_t) (sizeof(CoderMap)/sizeof(*CoderMap)); i++)
913 register const CoderMapInfo
917 coder_info=(CoderInfo *) AcquireAlignedMemory(1,sizeof(*coder_info));
918 if (coder_info == (CoderInfo *) NULL)
920 (void) ThrowMagickException(exception,GetMagickModule(),
921 ResourceLimitError,"MemoryAllocationFailed","`%s'",coder_info->name);
924 (void) ResetMagickMemory(coder_info,0,sizeof(*coder_info));
925 coder_info->path=(char *) "[built-in]";
926 coder_info->magick=(char *) p->magick;
927 coder_info->name=(char *) p->name;
928 coder_info->exempt=MagickTrue;
929 coder_info->signature=MagickSignature;
930 status=AddValueToSplayTree(coder_list,ConstantString(coder_info->magick),
932 if (status == MagickFalse)
933 (void) ThrowMagickException(exception,GetMagickModule(),
934 ResourceLimitError,"MemoryAllocationFailed","`%s'",coder_info->name);
937 Load external coder map.
939 options=GetConfigureOptions(filename,exception);
940 option=(const StringInfo *) GetNextValueInLinkedList(options);
941 while (option != (const StringInfo *) NULL)
943 status|=LoadCoderList((const char *) GetStringInfoDatum(option),
944 GetStringInfoPath(option),0,exception);
945 option=(const StringInfo *) GetNextValueInLinkedList(options);
947 options=DestroyConfigureOptions(options);
948 return(status != 0 ? MagickTrue : MagickFalse);