2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % M M AAA GGGG IIIII CCCC K K %
7 % MM MM A A G I C K K %
8 % M M M AAAAA G GGG I C KKK %
9 % M M A A G G I C K K %
10 % M M A A GGGG IIIII CCCC K K %
13 % Methods to Read or List ImageMagick Image formats %
21 % Copyright 1999-2012 ImageMagick Studio LLC, a non-profit organization %
22 % dedicated to making software imaging solutions freely available. %
24 % You may not use this file except in compliance with the License. You may %
25 % obtain a copy of the License at %
27 % http://www.imagemagick.org/script/license.php %
29 % Unless required by applicable law or agreed to in writing, software %
30 % distributed under the License is distributed on an "AS IS" BASIS, %
31 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
32 % See the License for the specific language governing permissions and %
33 % limitations under the License. %
35 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
43 #include "MagickCore/studio.h"
44 #include "MagickCore/annotate-private.h"
45 #include "MagickCore/blob.h"
46 #include "MagickCore/blob-private.h"
47 #include "MagickCore/cache.h"
48 #include "MagickCore/cache-private.h"
49 #include "MagickCore/coder-private.h"
50 #include "MagickCore/client.h"
51 #include "MagickCore/color-private.h"
52 #include "MagickCore/configure-private.h"
53 #include "MagickCore/constitute-private.h"
54 #include "MagickCore/delegate-private.h"
55 #include "MagickCore/draw.h"
56 #include "MagickCore/exception.h"
57 #include "MagickCore/exception-private.h"
58 #include "MagickCore/locale-private.h"
59 #include "MagickCore/log-private.h"
60 #include "MagickCore/magic-private.h"
61 #include "MagickCore/magick.h"
62 #include "MagickCore/magick-private.h"
63 #include "MagickCore/memory_.h"
64 #include "MagickCore/mime-private.h"
65 #include "MagickCore/module.h"
66 #include "MagickCore/module-private.h"
67 #include "MagickCore/nt-base-private.h"
68 #include "MagickCore/random-private.h"
69 #include "MagickCore/registry.h"
70 #include "MagickCore/registry-private.h"
71 #include "MagickCore/resource_.h"
72 #include "MagickCore/resource-private.h"
73 #include "MagickCore/policy.h"
74 #include "MagickCore/policy-private.h"
75 #include "MagickCore/semaphore.h"
76 #include "MagickCore/semaphore-private.h"
77 #include "MagickCore/signature-private.h"
78 #include "MagickCore/splay-tree.h"
79 #include "MagickCore/string_.h"
80 #include "MagickCore/string-private.h"
81 #include "MagickCore/thread_.h"
82 #include "MagickCore/thread-private.h"
83 #include "MagickCore/type-private.h"
84 #include "MagickCore/token.h"
85 #include "MagickCore/utility.h"
86 #include "MagickCore/utility-private.h"
87 #include "MagickCore/xwindow-private.h"
92 #if !defined(MAGICKCORE_RETSIGTYPE)
93 # define MAGICKCORE_RETSIGTYPE void
96 # define SIG_DFL ((SignalHandler *) 0)
99 # define SIG_ERR ((SignalHandler *) -1)
106 Typedef declarations.
108 typedef MAGICKCORE_RETSIGTYPE
115 *magick_semaphore = (SemaphoreInfo *) NULL;
118 *signal_handlers[SIGMAX] = { (SignalHandler *) NULL };
121 *magick_list = (SplayTreeInfo *) NULL;
123 static volatile MagickBooleanType
124 instantiate_magick = MagickFalse,
125 instantiate_magickcore = MagickFalse;
128 Forward declarations.
130 static MagickBooleanType
131 InitializeMagickList(ExceptionInfo *);
134 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
138 + G e t I m a g e D e c o d e r %
142 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
144 % GetImageDecoder() returns the image decoder.
146 % The format of the GetImageDecoder method is:
148 % DecodeImageHandler *GetImageDecoder(const MagickInfo *magick_info)
150 % A description of each parameter follows:
152 % o magick_info: The magick info.
155 MagickExport DecodeImageHandler *GetImageDecoder(const MagickInfo *magick_info)
157 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
158 assert(magick_info != (MagickInfo *) NULL);
159 assert(magick_info->signature == MagickSignature);
160 return(magick_info->decoder);
164 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
168 + G e t I m a g e E n c o d e r %
172 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
174 % GetImageEncoder() returns the image encoder.
176 % The format of the GetImageEncoder method is:
178 % EncodeImageHandler *GetImageEncoder(const MagickInfo *magick_info)
180 % A description of each parameter follows:
182 % o magick_info: The magick info.
185 MagickExport EncodeImageHandler *GetImageEncoder(const MagickInfo *magick_info)
187 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
188 assert(magick_info != (MagickInfo *) NULL);
189 assert(magick_info->signature == MagickSignature);
190 return(magick_info->encoder);
194 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
198 + G e t I m a g e M a g i c k %
202 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
204 % GetImageMagick() searches for an image format that matches the specified
205 % magick string. If one is found, MagickTrue is returned otherwise
208 % The format of the GetImageMagick method is:
210 % MagickBooleanType GetImageMagick(const unsigned char *magick,
211 % const size_t length,char *format)
213 % A description of each parameter follows:
215 % o magick: the image format we are searching for.
217 % o length: the length of the binary string.
219 % o format: the image format as determined by the magick bytes.
222 MagickExport MagickBooleanType GetImageMagick(const unsigned char *magick,
223 const size_t length,char *format)
231 register const MagickInfo
234 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
235 assert(magick != (const unsigned char *) NULL);
236 exception=AcquireExceptionInfo();
237 p=GetMagickInfo("*",exception);
238 exception=DestroyExceptionInfo(exception);
239 if (p == (const MagickInfo *) NULL)
242 LockSemaphoreInfo(magick_semaphore);
243 ResetSplayTreeIterator(magick_list);
244 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
245 while (p != (const MagickInfo *) NULL)
247 if ((p->magick != (IsImageFormatHandler *) NULL) &&
248 (p->magick(magick,length) != 0))
251 (void) CopyMagickString(format,p->name,MaxTextExtent);
254 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
256 UnlockSemaphoreInfo(magick_semaphore);
261 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
265 + G e t M a g i c k A d j o i n %
269 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
271 % GetMagickAdjoin() returns MagickTrue if the magick adjoin is MagickTrue.
273 % The format of the GetMagickAdjoin method is:
275 % MagickBooleanType GetMagickAdjoin(const MagickInfo *magick_info)
277 % A description of each parameter follows:
279 % o magick_info: The magick info.
282 MagickExport MagickBooleanType GetMagickAdjoin(const MagickInfo *magick_info)
284 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
285 assert(magick_info != (MagickInfo *) NULL);
286 assert(magick_info->signature == MagickSignature);
287 return(magick_info->adjoin);
291 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
295 + G e t M a g i c k B l o b S u p p o r t %
299 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
301 % GetMagickBlobSupport() returns MagickTrue if the magick supports blobs.
303 % The format of the GetMagickBlobSupport method is:
305 % MagickBooleanType GetMagickBlobSupport(const MagickInfo *magick_info)
307 % A description of each parameter follows:
309 % o magick_info: The magick info.
312 MagickExport MagickBooleanType GetMagickBlobSupport(
313 const MagickInfo *magick_info)
315 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
316 assert(magick_info != (MagickInfo *) NULL);
317 assert(magick_info->signature == MagickSignature);
318 return(magick_info->blob_support);
322 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
326 + G e t M a g i c k D e s c r i p t i o n %
330 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
332 % GetMagickDescription() returns the magick description.
334 % The format of the GetMagickDescription method is:
336 % const char *GetMagickDescription(const MagickInfo *magick_info)
338 % A description of each parameter follows:
340 % o magick_info: The magick info.
343 MagickExport const char *GetMagickDescription(const MagickInfo *magick_info)
345 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
346 assert(magick_info != (MagickInfo *) NULL);
347 assert(magick_info->signature == MagickSignature);
348 return(magick_info->description);
352 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
356 + G e t M a g i c k E n d i a n S u p p o r t %
360 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
362 % GetMagickEndianSupport() returns the MagickTrue if the coder respects
363 % endianness other than MSBEndian.
365 % The format of the GetMagickEndianSupport method is:
367 % MagickBooleanType GetMagickEndianSupport(const MagickInfo *magick_info)
369 % A description of each parameter follows:
371 % o magick_info: The magick info.
374 MagickExport MagickBooleanType GetMagickEndianSupport(
375 const MagickInfo *magick_info)
377 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
378 assert(magick_info != (MagickInfo *) NULL);
379 assert(magick_info->signature == MagickSignature);
380 return(magick_info->endian_support);
384 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
388 + G e t M a g i c k I n f o %
392 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
394 % GetMagickInfo() returns a pointer MagickInfo structure that matches
395 % the specified name. If name is NULL, the head of the image format list
398 % The format of the GetMagickInfo method is:
400 % const MagickInfo *GetMagickInfo(const char *name,Exception *exception)
402 % A description of each parameter follows:
404 % o name: the image format we are looking for.
406 % o exception: return any errors or warnings in this structure.
409 MagickExport const MagickInfo *GetMagickInfo(const char *name,
410 ExceptionInfo *exception)
412 register const MagickInfo
415 assert(exception != (ExceptionInfo *) NULL);
416 if ((magick_list == (SplayTreeInfo *) NULL) ||
417 (instantiate_magick == MagickFalse))
418 if (InitializeMagickList(exception) == MagickFalse)
419 return((const MagickInfo *) NULL);
420 if ((name == (const char *) NULL) || (LocaleCompare(name,"*") == 0))
422 #if defined(MAGICKCORE_MODULES_SUPPORT)
423 if (LocaleCompare(name,"*") == 0)
424 (void) OpenModules(exception);
426 LockSemaphoreInfo(magick_semaphore);
427 ResetSplayTreeIterator(magick_list);
428 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
429 UnlockSemaphoreInfo(magick_semaphore);
435 LockSemaphoreInfo(magick_semaphore);
436 ResetSplayTreeIterator(magick_list);
437 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
438 while (p != (const MagickInfo *) NULL)
440 if (LocaleCompare(p->name,name) == 0)
442 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
444 #if defined(MAGICKCORE_MODULES_SUPPORT)
445 if (p == (const MagickInfo *) NULL)
448 (void) OpenModule(name,exception);
449 ResetSplayTreeIterator(magick_list);
450 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
451 while (p != (const MagickInfo *) NULL)
453 if (LocaleCompare(p->name,name) == 0)
455 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
459 UnlockSemaphoreInfo(magick_semaphore);
464 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
468 + G e t M a g i c k I n f o L i s t %
472 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
474 % GetMagickInfoList() returns any image formats that match the specified
477 % The format of the GetMagickInfoList function is:
479 % const MagickInfo **GetMagickInfoList(const char *pattern,
480 % size_t *number_formats,ExceptionInfo *exception)
482 % A description of each parameter follows:
484 % o pattern: Specifies a pointer to a text string containing a pattern.
486 % o number_formats: This integer returns the number of formats in the list.
488 % o exception: return any errors or warnings in this structure.
492 #if defined(__cplusplus) || defined(c_plusplus)
496 static int MagickInfoCompare(const void *x,const void *y)
502 p=(const MagickInfo **) x,
503 q=(const MagickInfo **) y;
504 return(LocaleCompare((*p)->name,(*q)->name));
507 #if defined(__cplusplus) || defined(c_plusplus)
511 MagickExport const MagickInfo **GetMagickInfoList(const char *pattern,
512 size_t *number_formats,ExceptionInfo *exception)
517 register const MagickInfo
524 Allocate magick list.
526 assert(pattern != (char *) NULL);
527 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
528 assert(number_formats != (size_t *) NULL);
530 p=GetMagickInfo("*",exception);
531 if (p == (const MagickInfo *) NULL)
532 return((const MagickInfo **) NULL);
533 formats=(const MagickInfo **) AcquireQuantumMemory((size_t)
534 GetNumberOfNodesInSplayTree(magick_list)+1UL,sizeof(*formats));
535 if (formats == (const MagickInfo **) NULL)
536 return((const MagickInfo **) NULL);
538 Generate magick list.
540 LockSemaphoreInfo(magick_semaphore);
541 ResetSplayTreeIterator(magick_list);
542 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
543 for (i=0; p != (const MagickInfo *) NULL; )
545 if ((p->stealth == MagickFalse) &&
546 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
548 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
550 UnlockSemaphoreInfo(magick_semaphore);
551 qsort((void *) formats,(size_t) i,sizeof(*formats),MagickInfoCompare);
552 formats[i]=(MagickInfo *) NULL;
553 *number_formats=(size_t) i;
558 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
562 + G e t M a g i c k L i s t %
566 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
568 % GetMagickList() returns any image formats that match the specified pattern.
570 % The format of the GetMagickList function is:
572 % char **GetMagickList(const char *pattern,size_t *number_formats,
573 % ExceptionInfo *exception)
575 % A description of each parameter follows:
577 % o pattern: Specifies a pointer to a text string containing a pattern.
579 % o number_formats: This integer returns the number of formats in the list.
581 % o exception: return any errors or warnings in this structure.
585 #if defined(__cplusplus) || defined(c_plusplus)
589 static int MagickCompare(const void *x,const void *y)
597 return(LocaleCompare(*p,*q));
600 #if defined(__cplusplus) || defined(c_plusplus)
604 MagickExport char **GetMagickList(const char *pattern,
605 size_t *number_formats,ExceptionInfo *exception)
610 register const MagickInfo
617 Allocate magick list.
619 assert(pattern != (char *) NULL);
620 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",pattern);
621 assert(number_formats != (size_t *) NULL);
623 p=GetMagickInfo("*",exception);
624 if (p == (const MagickInfo *) NULL)
625 return((char **) NULL);
626 formats=(char **) AcquireQuantumMemory((size_t)
627 GetNumberOfNodesInSplayTree(magick_list)+1UL,sizeof(*formats));
628 if (formats == (char **) NULL)
629 return((char **) NULL);
630 LockSemaphoreInfo(magick_semaphore);
631 ResetSplayTreeIterator(magick_list);
632 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
633 for (i=0; p != (const MagickInfo *) NULL; )
635 if ((p->stealth == MagickFalse) &&
636 (GlobExpression(p->name,pattern,MagickFalse) != MagickFalse))
637 formats[i++]=ConstantString(p->name);
638 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
640 UnlockSemaphoreInfo(magick_semaphore);
641 qsort((void *) formats,(size_t) i,sizeof(*formats),MagickCompare);
642 formats[i]=(char *) NULL;
643 *number_formats=(size_t) i;
648 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
652 % G e t M a g i c k P r e c i s i o n %
656 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
658 % GetMagickPrecision() returns the maximum number of significant digits to be
661 % The format of the GetMagickPrecision method is:
663 % int GetMagickPrecision(void)
666 MagickExport int GetMagickPrecision(void)
668 #define MagickPrecision 6
670 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
671 if (SetMagickPrecision(0) == 0)
676 (void) SetMagickPrecision(MagickPrecision);
677 limit=GetEnvironmentValue("MAGICK_PRECISION");
678 if (limit == (char *) NULL)
679 limit=GetPolicyValue("precision");
680 if (limit != (char *) NULL)
682 (void) SetMagickPrecision(StringToInteger(limit));
683 limit=DestroyString(limit);
686 return(SetMagickPrecision(0));
690 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
694 + G e t M a g i c k R a w S u p p o r t %
698 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
700 % GetMagickRawSupport() returns the MagickTrue if the coder is a raw format.
702 % The format of the GetMagickRawSupport method is:
704 % MagickBooleanType GetMagickRawSupport(const MagickInfo *magick_info)
706 % A description of each parameter follows:
708 % o magick_info: The magick info.
711 MagickExport MagickBooleanType GetMagickRawSupport(
712 const MagickInfo *magick_info)
714 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
715 assert(magick_info != (MagickInfo *) NULL);
716 assert(magick_info->signature == MagickSignature);
717 return(magick_info->raw);
721 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
725 + G e t M a g i c k S e e k a b l e S t r e a m %
729 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
731 % GetMagickSeekableStream() returns MagickTrue if the magick supports a
734 % The format of the GetMagickSeekableStream method is:
736 % MagickBooleanType GetMagickSeekableStream(const MagickInfo *magick_info)
738 % A description of each parameter follows:
740 % o magick_info: The magick info.
743 MagickExport MagickBooleanType GetMagickSeekableStream(
744 const MagickInfo *magick_info)
746 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
747 assert(magick_info != (MagickInfo *) NULL);
748 assert(magick_info->signature == MagickSignature);
749 return(magick_info->seekable_stream);
753 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
757 + G e t M a g i c k T h r e a d S u p p o r t %
761 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
763 % GetMagickThreadSupport() returns MagickTrue if the magick supports threads.
765 % The format of the GetMagickThreadSupport method is:
767 % MagickStatusType GetMagickThreadSupport(const MagickInfo *magick_info)
769 % A description of each parameter follows:
771 % o magick_info: The magick info.
774 MagickExport MagickStatusType GetMagickThreadSupport(
775 const MagickInfo *magick_info)
777 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
778 assert(magick_info != (MagickInfo *) NULL);
779 assert(magick_info->signature == MagickSignature);
780 return(magick_info->thread_support);
784 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
788 + I n i t i a l i z e M a g i c k L i s t %
792 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
794 % InitializeMagickList() initializes the magick list.
796 % The format of the InitializeMagickList() method is:
798 % InitializeMagickList(Exceptioninfo *exception)
800 % A description of each parameter follows.
802 % o exception: return any errors or warnings in this structure.
806 static void *DestroyMagickNode(void *magick_info)
811 p=(MagickInfo *) magick_info;
812 if (p->name != (char *) NULL)
813 p->name=DestroyString(p->name);
814 if (p->description != (char *) NULL)
815 p->description=DestroyString(p->description);
816 if (p->version != (char *) NULL)
817 p->version=DestroyString(p->version);
818 if (p->note != (char *) NULL)
819 p->note=DestroyString(p->note);
820 if (p->module != (char *) NULL)
821 p->module=DestroyString(p->module);
822 return(RelinquishMagickMemory(p));
825 static MagickBooleanType InitializeMagickList(ExceptionInfo *exception)
828 if ((magick_list == (SplayTreeInfo *) NULL) &&
829 (instantiate_magick == MagickFalse))
831 if (magick_semaphore == (SemaphoreInfo *) NULL)
832 AcquireSemaphoreInfo(&magick_semaphore);
833 LockSemaphoreInfo(magick_semaphore);
834 if ((magick_list == (SplayTreeInfo *) NULL) &&
835 (instantiate_magick == MagickFalse))
843 magick_list=NewSplayTree(CompareSplayTreeString,
844 (void *(*)(void *)) NULL,DestroyMagickNode);
845 if (magick_list == (SplayTreeInfo *) NULL)
846 ThrowFatalException(ResourceLimitFatalError,
847 "MemoryAllocationFailed");
848 magick_info=SetMagickInfo("ephemeral");
849 magick_info->stealth=MagickTrue;
850 status=AddValueToSplayTree(magick_list,magick_info->name,magick_info);
851 if (status == MagickFalse)
852 ThrowFatalException(ResourceLimitFatalError,
853 "MemoryAllocationFailed");
854 magick_info=SetMagickInfo("clipmask");
855 magick_info->stealth=MagickTrue;
856 status=AddValueToSplayTree(magick_list,magick_info->name,magick_info);
857 if (status == MagickFalse)
862 message=GetExceptionMessage(errno);
863 ThrowFatalException(ResourceLimitFatalError,
864 "MemoryAllocationFailed");
865 message=DestroyString(message);
867 #if defined(MAGICKCORE_MODULES_SUPPORT)
868 (void) GetModuleInfo((char *) NULL,exception);
870 #if !defined(MAGICKCORE_BUILD_MODULES)
871 RegisterStaticModules();
873 instantiate_magick=MagickTrue;
875 UnlockSemaphoreInfo(magick_semaphore);
877 return(magick_list != (SplayTreeInfo *) NULL ? MagickTrue : MagickFalse);
881 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
885 + I s M a g i c k C o n f l i c t %
889 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
891 % IsMagickConflict() returns MagickTrue if the image format conflicts with a
892 % logical drive (.e.g. X:).
894 % The format of the IsMagickConflict method is:
896 % MagickBooleanType IsMagickConflict(const char *magick)
898 % A description of each parameter follows:
900 % o magick: Specifies the image format.
903 MagickPrivate MagickBooleanType IsMagickConflict(const char *magick)
905 assert(magick != (char *) NULL);
906 #if defined(macintosh)
907 return(MACIsMagickConflict(magick));
909 return(VMSIsMagickConflict(magick));
910 #elif defined(MAGICKCORE_WINDOWS_SUPPORT)
911 return(NTIsMagickConflict(magick));
918 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
922 + L i s t M a g i c k I n f o %
926 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
928 % ListMagickInfo() lists the image formats to a file.
930 % The format of the ListMagickInfo method is:
932 % MagickBooleanType ListMagickInfo(FILE *file,ExceptionInfo *exception)
934 % A description of each parameter follows.
936 % o file: A file handle.
938 % o exception: return any errors or warnings in this structure.
941 MagickExport MagickBooleanType ListMagickInfo(FILE *file,
942 ExceptionInfo *exception)
956 if (file == (FILE *) NULL)
958 magick_info=GetMagickInfoList("*",&number_formats,exception);
959 if (magick_info == (const MagickInfo **) NULL)
961 ClearMagickException(exception);
962 #if !defined(MAGICKCORE_MODULES_SUPPORT)
963 (void) FormatLocaleFile(file," Format Mode Description\n");
965 (void) FormatLocaleFile(file," Format Module Mode Description\n");
967 (void) FormatLocaleFile(file,
968 "--------------------------------------------------------"
969 "-----------------------\n");
970 for (i=0; i < (ssize_t) number_formats; i++)
972 if (magick_info[i]->stealth != MagickFalse)
974 (void) FormatLocaleFile(file,"%9s%c ",
975 magick_info[i]->name != (char *) NULL ? magick_info[i]->name : "",
976 magick_info[i]->blob_support != MagickFalse ? '*' : ' ');
977 #if defined(MAGICKCORE_MODULES_SUPPORT)
980 module[MaxTextExtent];
983 if (magick_info[i]->module != (char *) NULL)
984 (void) CopyMagickString(module,magick_info[i]->module,MaxTextExtent);
985 (void) ConcatenateMagickString(module," ",MaxTextExtent);
987 (void) FormatLocaleFile(file,"%9s ",module);
990 (void) FormatLocaleFile(file,"%c%c%c ",magick_info[i]->decoder ? 'r' : '-',
991 magick_info[i]->encoder ? 'w' : '-',magick_info[i]->encoder != NULL &&
992 magick_info[i]->adjoin != MagickFalse ? '+' : '-');
993 if (magick_info[i]->description != (char *) NULL)
994 (void) FormatLocaleFile(file," %s",magick_info[i]->description);
995 if (magick_info[i]->version != (char *) NULL)
996 (void) FormatLocaleFile(file," (%s)",magick_info[i]->version);
997 (void) FormatLocaleFile(file,"\n");
998 if (magick_info[i]->note != (char *) NULL)
1003 text=StringToList(magick_info[i]->note);
1004 if (text != (char **) NULL)
1006 for (j=0; text[j] != (char *) NULL; j++)
1008 (void) FormatLocaleFile(file," %s\n",text[j]);
1009 text[j]=DestroyString(text[j]);
1011 text=(char **) RelinquishMagickMemory(text);
1015 (void) FormatLocaleFile(file,"\n* native blob support\n");
1016 (void) FormatLocaleFile(file,"r read support\n");
1017 (void) FormatLocaleFile(file,"w write support\n");
1018 (void) FormatLocaleFile(file,"+ support for multiple images\n");
1019 (void) fflush(file);
1020 magick_info=(const MagickInfo **) RelinquishMagickMemory((void *)
1026 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1030 % I s M a g i c k I n s t a n t i a t e d %
1034 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1036 % IsMagickInstantiated() returns MagickTrue if the ImageMagick environment
1037 % is currently instantiated: MagickCoreGenesis() has been called but
1038 % MagickDestroy() has not.
1040 % The format of the IsMagickInstantiated method is:
1042 % MagickBooleanType IsMagickInstantiated(void)
1045 MagickExport MagickBooleanType IsMagickInstantiated(void)
1047 return(instantiate_magick);
1051 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1055 + M a g i c k C o m p o n e n t G e n e s i s %
1059 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1061 % MagickComponentGenesis() instantiates the magick component.
1063 % The format of the MagickComponentGenesis method is:
1065 % MagickBooleanType MagickComponentGenesis(void)
1068 MagickPrivate MagickBooleanType MagickComponentGenesis(void)
1070 AcquireSemaphoreInfo(&magick_semaphore);
1075 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1079 + M a g i c k C o m p o n e n t T e r m i n u s %
1083 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1085 % MagickComponentTerminus() destroys the magick component.
1087 % The format of the MagickComponentTerminus method is:
1089 % void MagickComponentTerminus(void)
1092 MagickPrivate void MagickComponentTerminus(void)
1094 if (magick_semaphore == (SemaphoreInfo *) NULL)
1095 AcquireSemaphoreInfo(&magick_semaphore);
1096 LockSemaphoreInfo(magick_semaphore);
1097 if (magick_list != (SplayTreeInfo *) NULL)
1098 magick_list=DestroySplayTree(magick_list);
1099 instantiate_magick=MagickFalse;
1100 UnlockSemaphoreInfo(magick_semaphore);
1101 DestroySemaphoreInfo(&magick_semaphore);
1105 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1109 % M a g i c k C o r e G e n e s i s %
1113 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1115 % MagickCoreGenesis() initializes the MagickCore environment.
1117 % The format of the MagickCoreGenesis function is:
1119 % MagickCoreGenesis(const char *path,
1120 % const MagickBooleanType establish_signal_handlers)
1122 % A description of each parameter follows:
1124 % o path: the execution path of the current ImageMagick client.
1126 % o establish_signal_handlers: set to MagickTrue to use MagickCore's own
1127 % signal handlers for common signals.
1131 static SignalHandler *SetMagickSignalHandler(int signal_number,
1132 SignalHandler *handler)
1134 #if defined(MAGICKCORE_HAVE_SIGACTION) && defined(MAGICKCORE_HAVE_SIGEMPTYSET)
1146 sigaddset(&mask,signal_number);
1147 sigprocmask(SIG_BLOCK,&mask,NULL);
1148 action.sa_mask=mask;
1149 action.sa_handler=handler;
1151 #if defined(SA_INTERRUPT)
1152 action.sa_flags|=SA_INTERRUPT;
1154 status=sigaction(signal_number,&action,&previous_action);
1157 sigprocmask(SIG_UNBLOCK,&mask,NULL);
1158 return(previous_action.sa_handler);
1160 return(signal(signal_number,handler));
1164 static void MagickSignalHandler(int signal_number)
1166 #if !defined(MAGICKCORE_HAVE_SIGACTION)
1167 (void) signal(signal_number,SIG_IGN);
1169 AsynchronousResourceComponentTerminus();
1170 instantiate_magick=MagickFalse;
1171 (void) SetMagickSignalHandler(signal_number,signal_handlers[signal_number]);
1172 #if defined(MAGICKCORE_HAVE_RAISE)
1173 if (signal_handlers[signal_number] != MagickSignalHandler)
1174 raise(signal_number);
1176 #if defined(SIGQUIT)
1177 if (signal_number == SIGQUIT)
1180 #if defined(SIGABRT)
1181 if (signal_number == SIGABRT)
1185 if (signal_number == SIGFPE)
1188 #if defined(SIGXCPU)
1189 if (signal_number == SIGXCPU)
1192 #if defined(SIGXFSZ)
1193 if (signal_number == SIGXFSZ)
1196 #if defined(SIGSEGV)
1197 if (signal_number == SIGSEGV)
1200 #if !defined(MAGICKCORE_HAVE__EXIT)
1201 exit(signal_number);
1204 if (signal_number == SIGHUP)
1205 exit(signal_number);
1207 #if defined(SIGINT) && !defined(MAGICKCORE_WINDOWS_SUPPORT)
1208 if (signal_number == SIGINT)
1209 exit(signal_number);
1211 #if defined(SIGTERM)
1212 if (signal_number == SIGTERM)
1213 exit(signal_number);
1215 _exit(signal_number); /* do not invoke registered atexit() methods */
1219 static SignalHandler *RegisterMagickSignalHandler(int signal_number)
1224 handler=SetMagickSignalHandler(signal_number,MagickSignalHandler);
1225 if (handler == SIG_ERR)
1227 if (handler != SIG_DFL)
1228 handler=SetMagickSignalHandler(signal_number,handler);
1230 (void) LogMagickEvent(ConfigureEvent,GetMagickModule(),
1231 "Register handler for signal: %d",signal_number);
1235 MagickExport void MagickCoreGenesis(const char *path,
1236 const MagickBooleanType establish_signal_handlers)
1240 execution_path[MaxTextExtent],
1241 filename[MaxTextExtent];
1244 Initialize the Magick environment.
1247 if (instantiate_magickcore != MagickFalse)
1249 UnlockMagickMutex();
1252 (void) SemaphoreComponentGenesis();
1253 (void) LogComponentGenesis();
1254 (void) LocaleComponentGenesis();
1255 (void) RandomComponentGenesis();
1256 events=GetEnvironmentValue("MAGICK_DEBUG");
1257 if (events != (char *) NULL)
1259 (void) SetLogEventMask(events);
1260 events=DestroyString(events);
1262 #if defined(MAGICKCORE_WINDOWS_SUPPORT)
1263 #if defined(_DEBUG) && !defined(__BORLANDC__) && !defined(__MINGW32__)
1264 if (IsEventLogging() != MagickFalse)
1269 debug=_CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);
1270 debug|=_CRTDBG_CHECK_ALWAYS_DF |_CRTDBG_DELAY_FREE_MEM_DF |
1271 _CRTDBG_LEAK_CHECK_DF;
1274 debug=_CrtSetDbgFlag(debug);
1275 _ASSERTE(_CrtCheckMemory());
1281 Set client name and execution path.
1283 (void) GetExecutionPath(execution_path,MaxTextExtent);
1284 if ((path != (const char *) NULL) && (*path == *DirectorySeparator) &&
1285 (IsPathAccessible(path) != MagickFalse))
1286 (void) CopyMagickString(execution_path,path,MaxTextExtent);
1287 GetPathComponent(execution_path,TailPath,filename);
1288 (void) SetClientName(filename);
1289 GetPathComponent(execution_path,HeadPath,execution_path);
1290 (void) SetClientPath(execution_path);
1291 if (establish_signal_handlers != MagickFalse)
1294 Set signal handlers.
1296 #if defined(SIGABRT)
1297 if (signal_handlers[SIGABRT] == (SignalHandler *) NULL)
1298 signal_handlers[SIGABRT]=RegisterMagickSignalHandler(SIGABRT);
1300 #if defined(SIGSEGV)
1301 if (signal_handlers[SIGSEGV] == (SignalHandler *) NULL)
1302 signal_handlers[SIGSEGV]=RegisterMagickSignalHandler(SIGSEGV);
1305 if (signal_handlers[SIGFPE] == (SignalHandler *) NULL)
1306 signal_handlers[SIGFPE]=RegisterMagickSignalHandler(SIGFPE);
1309 if (signal_handlers[SIGHUP] == (SignalHandler *) NULL)
1310 signal_handlers[SIGHUP]=RegisterMagickSignalHandler(SIGHUP);
1312 #if defined(SIGINT) && !defined(MAGICKCORE_WINDOWS_SUPPORT)
1313 if (signal_handlers[SIGINT] == (SignalHandler *) NULL)
1314 signal_handlers[SIGINT]=RegisterMagickSignalHandler(SIGINT);
1316 #if defined(SIGQUIT)
1317 if (signal_handlers[SIGQUIT] == (SignalHandler *) NULL)
1318 signal_handlers[SIGQUIT]=RegisterMagickSignalHandler(SIGQUIT);
1320 #if defined(SIGTERM)
1321 if (signal_handlers[SIGTERM] == (SignalHandler *) NULL)
1322 signal_handlers[SIGTERM]=RegisterMagickSignalHandler(SIGTERM);
1324 #if defined(SIGXCPU)
1325 if (signal_handlers[SIGXCPU] == (SignalHandler *) NULL)
1326 signal_handlers[SIGXCPU]=RegisterMagickSignalHandler(SIGXCPU);
1328 #if defined(SIGXFSZ)
1329 if (signal_handlers[SIGXFSZ] == (SignalHandler *) NULL)
1330 signal_handlers[SIGXFSZ]=RegisterMagickSignalHandler(SIGXFSZ);
1334 Instantiate magick resources.
1336 (void) ConfigureComponentGenesis();
1337 (void) PolicyComponentGenesis();
1338 (void) CacheComponentGenesis();
1339 (void) RegistryComponentGenesis();
1340 (void) ResourceComponentGenesis();
1341 (void) CoderComponentGenesis();
1342 (void) MagickComponentGenesis();
1343 #if defined(MAGICKCORE_MODULES_SUPPORT)
1344 (void) ModuleComponentGenesis();
1346 (void) DelegateComponentGenesis();
1347 (void) MagicComponentGenesis();
1348 (void) ColorComponentGenesis();
1349 (void) TypeComponentGenesis();
1350 (void) MimeComponentGenesis();
1351 (void) ConstituteComponentGenesis();
1352 (void) AnnotateComponentGenesis();
1353 #if defined(MAGICKCORE_X11_DELEGATE)
1354 (void) XComponentGenesis();
1356 instantiate_magickcore=MagickTrue;
1357 UnlockMagickMutex();
1361 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1365 % M a g i c k C o r e T e r m i n u s %
1369 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1371 % MagickCoreTerminus() destroys the MagickCore environment.
1373 % The format of the MagickCoreTerminus function is:
1375 % MagickCoreTerminus(void)
1378 MagickExport void MagickCoreTerminus(void)
1381 if (instantiate_magickcore == MagickFalse)
1383 UnlockMagickMutex();
1386 #if defined(MAGICKCORE_X11_DELEGATE)
1387 XComponentTerminus();
1389 AnnotateComponentTerminus();
1390 ConstituteComponentTerminus();
1391 MimeComponentTerminus();
1392 TypeComponentTerminus();
1393 ColorComponentTerminus();
1394 #if defined(MAGICKCORE_WINDOWS_SUPPORT)
1395 NTGhostscriptUnLoadDLL();
1397 MagicComponentTerminus();
1398 DelegateComponentTerminus();
1399 MagickComponentTerminus();
1400 #if !defined(MAGICKCORE_BUILD_MODULES)
1401 UnregisterStaticModules();
1403 #if defined(MAGICKCORE_MODULES_SUPPORT)
1404 ModuleComponentTerminus();
1406 CoderComponentTerminus();
1407 ResourceComponentTerminus();
1408 RegistryComponentTerminus();
1409 CacheComponentTerminus();
1410 PolicyComponentTerminus();
1411 ConfigureComponentTerminus();
1412 RandomComponentTerminus();
1413 LocaleComponentTerminus();
1414 LogComponentTerminus();
1415 SemaphoreComponentTerminus();
1416 instantiate_magickcore=MagickFalse;
1417 UnlockMagickMutex();
1421 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1425 + R e g i s t e r M a g i c k I n f o %
1429 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1431 % RegisterMagickInfo() adds attributes for a particular image format to the
1432 % list of supported formats. The attributes include the image format name,
1433 % a method to read and/or write the format, whether the format supports the
1434 % saving of more than one frame to the same file or blob, whether the format
1435 % supports native in-memory I/O, and a brief description of the format.
1437 % The format of the RegisterMagickInfo method is:
1439 % MagickInfo *RegisterMagickInfo(MagickInfo *magick_info)
1441 % A description of each parameter follows:
1443 % o magick_info: the magick info.
1446 MagickExport MagickInfo *RegisterMagickInfo(MagickInfo *magick_info)
1452 Delete any existing name.
1454 assert(magick_info != (MagickInfo *) NULL);
1455 assert(magick_info->signature == MagickSignature);
1456 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",magick_info->name);
1457 if (magick_list == (SplayTreeInfo *) NULL)
1458 return((MagickInfo *) NULL);
1459 status=AddValueToSplayTree(magick_list,magick_info->name,magick_info);
1460 if (status == MagickFalse)
1461 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
1462 return(magick_info);
1466 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1470 + S e t M a g i c k I n f o %
1474 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1476 % SetMagickInfo() allocates a MagickInfo structure and initializes the members
1477 % to default values.
1479 % The format of the SetMagickInfo method is:
1481 % MagickInfo *SetMagickInfo(const char *name)
1483 % A description of each parameter follows:
1485 % o magick_info: Method SetMagickInfo returns the allocated and initialized
1486 % MagickInfo structure.
1488 % o name: a character string that represents the image format associated
1489 % with the MagickInfo structure.
1492 MagickExport MagickInfo *SetMagickInfo(const char *name)
1497 assert(name != (const char *) NULL);
1498 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",name);
1499 magick_info=(MagickInfo *) AcquireMagickMemory(sizeof(*magick_info));
1500 if (magick_info == (MagickInfo *) NULL)
1501 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
1502 (void) ResetMagickMemory(magick_info,0,sizeof(*magick_info));
1503 magick_info->name=ConstantString(name);
1504 magick_info->adjoin=MagickTrue;
1505 magick_info->blob_support=MagickTrue;
1506 magick_info->thread_support=(MagickStatusType) (DecoderThreadSupport |
1507 EncoderThreadSupport);
1508 magick_info->signature=MagickSignature;
1509 return(magick_info);
1513 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1517 % S e t M a g i c k P r e c i s i o n %
1521 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1523 % SetMagickPrecision() sets the maximum number of significant digits to be
1524 % printed and returns it.
1526 % The format of the SetMagickPrecision method is:
1528 % int SetMagickPrecision(const int precision)
1530 % A description of each parameter follows:
1532 % o precision: set the maximum number of significant digits to be printed.
1535 MagickExport int SetMagickPrecision(const int precision)
1538 magick_precision = 0;
1540 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
1542 magick_precision=precision;
1543 return(magick_precision);
1547 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1551 + U n r e g i s t e r M a g i c k I n f o %
1555 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1557 % UnregisterMagickInfo() removes a name from the magick info list. It returns
1558 % MagickFalse if the name does not exist in the list otherwise MagickTrue.
1560 % The format of the UnregisterMagickInfo method is:
1562 % MagickBooleanType UnregisterMagickInfo(const char *name)
1564 % A description of each parameter follows:
1566 % o name: a character string that represents the image format we are
1570 MagickExport MagickBooleanType UnregisterMagickInfo(const char *name)
1572 register const MagickInfo
1578 assert(name != (const char *) NULL);
1579 if (magick_list == (SplayTreeInfo *) NULL)
1580 return(MagickFalse);
1581 if (GetNumberOfNodesInSplayTree(magick_list) == 0)
1582 return(MagickFalse);
1583 LockSemaphoreInfo(magick_semaphore);
1584 ResetSplayTreeIterator(magick_list);
1585 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
1586 while (p != (const MagickInfo *) NULL)
1588 if (LocaleCompare(p->name,name) == 0)
1590 p=(const MagickInfo *) GetNextValueInSplayTree(magick_list);
1592 status=DeleteNodeByValueFromSplayTree(magick_list,p);
1593 UnlockSemaphoreInfo(magick_semaphore);