| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % RRRR EEEEE GGG IIIII SSSSS TTTTT RRRR Y Y % |
| % R R E G I SS T R R Y Y % |
| % RRRR EEE G GGG I SSS T RRRR Y % |
| % R R E G G I SS T R R Y % |
| % R R EEEEE GGG IIIII SSSSS T R R Y % |
| % % |
| % % |
| % MagickCore Registry Methods % |
| % % |
| % Software Design % |
| % Cristy % |
| % March 2000 % |
| % % |
| % % |
| % Copyright 1999-2019 ImageMagick Studio LLC, a non-profit organization % |
| % dedicated to making software imaging solutions freely available. % |
| % % |
| % You may not use this file except in compliance with the License. You may % |
| % obtain a copy of the License at % |
| % % |
| % https://imagemagick.org/script/license.php % |
| % % |
| % Unless required by applicable law or agreed to in writing, software % |
| % distributed under the License is distributed on an "AS IS" BASIS, % |
| % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. % |
| % See the License for the specific language governing permissions and % |
| % limitations under the License. % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % |
| % |
| */ |
| |
| /* |
| Include declarations. |
| */ |
| #include "MagickCore/studio.h" |
| #include "MagickCore/exception.h" |
| #include "MagickCore/exception-private.h" |
| #include "MagickCore/image.h" |
| #include "MagickCore/list.h" |
| #include "MagickCore/memory_.h" |
| #include "MagickCore/memory-private.h" |
| #include "MagickCore/registry.h" |
| #include "MagickCore/registry-private.h" |
| #include "MagickCore/splay-tree.h" |
| #include "MagickCore/string_.h" |
| #include "MagickCore/utility.h" |
| |
| /* |
| Typedef declarations. |
| */ |
| typedef struct _RegistryInfo |
| { |
| RegistryType |
| type; |
| |
| void |
| *value; |
| |
| size_t |
| signature; |
| } RegistryInfo; |
| |
| /* |
| Static declarations. |
| */ |
| static SplayTreeInfo |
| *registry = (SplayTreeInfo *) NULL; |
| |
| static SemaphoreInfo |
| *registry_semaphore = (SemaphoreInfo *) NULL; |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % D e f i n e I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % DefineImageRegistry() associates a key/value pair with the image registry. |
| % |
| % The format of the DefineImageRegistry method is: |
| % |
| % MagickBooleanType DefineImageRegistry(const RegistryType type, |
| % const char *option,ExceptionInfo *exception) |
| % |
| % A description of each parameter follows: |
| % |
| % o type: the type. |
| % |
| % o option: the option. |
| % |
| % o exception: the exception. |
| % |
| */ |
| MagickExport MagickBooleanType DefineImageRegistry(const RegistryType type, |
| const char *option,ExceptionInfo *exception) |
| { |
| char |
| key[MagickPathExtent], |
| value[MagickPathExtent]; |
| |
| register char |
| *p; |
| |
| assert(option != (const char *) NULL); |
| (void) CopyMagickString(key,option,MagickPathExtent); |
| for (p=key; *p != '\0'; p++) |
| if (*p == '=') |
| break; |
| *value='\0'; |
| if (*p == '=') |
| (void) CopyMagickString(value,p+1,MagickPathExtent); |
| *p='\0'; |
| return(SetImageRegistry(type,key,value,exception)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % D e l e t e I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % DeleteImageRegistry() deletes a key from the image registry. |
| % |
| % The format of the DeleteImageRegistry method is: |
| % |
| % MagickBooleanType DeleteImageRegistry(const char *key) |
| % |
| % A description of each parameter follows: |
| % |
| % o key: the registry. |
| % |
| */ |
| MagickExport MagickBooleanType DeleteImageRegistry(const char *key) |
| { |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",key); |
| if (registry == (void *) NULL) |
| return(MagickFalse); |
| return(DeleteNodeFromSplayTree(registry,key)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % G e t I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % GetImageRegistry() returns a value associated with an image registry key. |
| % |
| % The format of the GetImageRegistry method is: |
| % |
| % void *GetImageRegistry(const RegistryType type,const char *key, |
| % ExceptionInfo *exception) |
| % |
| % A description of each parameter follows: |
| % |
| % o type: the type. |
| % |
| % o key: the key. |
| % |
| % o exception: the exception. |
| % |
| */ |
| MagickExport void *GetImageRegistry(const RegistryType type,const char *key, |
| ExceptionInfo *exception) |
| { |
| void |
| *value; |
| |
| RegistryInfo |
| *registry_info; |
| |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",key); |
| if (registry == (void *) NULL) |
| return((void *) NULL); |
| registry_info=(RegistryInfo *) GetValueFromSplayTree(registry,key); |
| if (registry_info == (void *) NULL) |
| return((void *) NULL); |
| value=(void *) NULL; |
| switch (type) |
| { |
| case ImageRegistryType: |
| { |
| if (type == registry_info->type) |
| value=(void *) CloneImageList((Image *) registry_info->value,exception); |
| break; |
| } |
| case ImageInfoRegistryType: |
| { |
| if (type == registry_info->type) |
| value=(void *) CloneImageInfo((ImageInfo *) registry_info->value); |
| break; |
| } |
| case StringRegistryType: |
| { |
| switch (registry_info->type) |
| { |
| case ImageRegistryType: |
| { |
| value=(Image *) ConstantString(((Image *) |
| registry_info->value)->filename); |
| break; |
| } |
| case ImageInfoRegistryType: |
| { |
| value=(Image *) ConstantString(((ImageInfo *) |
| registry_info->value)->filename); |
| break; |
| } |
| case StringRegistryType: |
| { |
| value=(void *) ConstantString((char *) registry_info->value); |
| break; |
| } |
| default: |
| break; |
| } |
| break; |
| } |
| default: |
| break; |
| } |
| return(value); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % G e t N e x t I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % GetNextImageRegistry() gets the next image registry value. |
| % |
| % The format of the GetNextImageRegistry method is: |
| % |
| % char *GetNextImageRegistry(void) |
| % |
| */ |
| MagickExport char *GetNextImageRegistry(void) |
| { |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"..."); |
| if (registry == (void *) NULL) |
| return((char *) NULL); |
| return((char *) GetNextKeyInSplayTree(registry)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| + R e g i s t r y C o m p o n e n t G e n e s i s % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RegistryComponentGenesis() instantiates the registry component. |
| % |
| % The format of the RegistryComponentGenesis method is: |
| % |
| % MagickBooleanType RegistryComponentGenesis(void) |
| % |
| */ |
| MagickPrivate MagickBooleanType RegistryComponentGenesis(void) |
| { |
| if (registry_semaphore == (SemaphoreInfo *) NULL) |
| registry_semaphore=AcquireSemaphoreInfo(); |
| return(MagickTrue); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e g i s t r y C o m p o n e n t T e r m i n u s % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RegistryComponentTerminus() destroys the registry component. |
| % |
| % The format of the DestroyDefines method is: |
| % |
| % void RegistryComponentTerminus(void) |
| % |
| */ |
| MagickPrivate void RegistryComponentTerminus(void) |
| { |
| if (registry_semaphore == (SemaphoreInfo *) NULL) |
| ActivateSemaphoreInfo(®istry_semaphore); |
| LockSemaphoreInfo(registry_semaphore); |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"..."); |
| if (registry != (void *) NULL) |
| registry=DestroySplayTree(registry); |
| UnlockSemaphoreInfo(registry_semaphore); |
| RelinquishSemaphoreInfo(®istry_semaphore); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e m o v e I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RemoveImageRegistry() removes a key from the image registry and returns its |
| % value. |
| % |
| % The format of the RemoveImageRegistry method is: |
| % |
| % void *RemoveImageRegistry(const char *key) |
| % |
| % A description of each parameter follows: |
| % |
| % o key: the registry. |
| % |
| */ |
| MagickExport void *RemoveImageRegistry(const char *key) |
| { |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",key); |
| if (registry == (void *) NULL) |
| return((void *) NULL); |
| return(RemoveNodeFromSplayTree(registry,key)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e s e t I m a g e R e g i s t r y I t e r a t o r % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % ResetImageRegistryIterator() resets the registry iterator. Use it in |
| % conjunction with GetNextImageRegistry() to iterate over all the values |
| % in the image registry. |
| % |
| % The format of the ResetImageRegistryIterator method is: |
| % |
| % ResetImageRegistryIterator(void) |
| % |
| */ |
| MagickExport void ResetImageRegistryIterator(void) |
| { |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"..."); |
| if (registry == (void *) NULL) |
| return; |
| ResetSplayTreeIterator(registry); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % S e t I m a g e R e g i s t r y % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % SetImageRegistry() associates a value with an image registry key. |
| % |
| % The format of the SetImageRegistry method is: |
| % |
| % MagickBooleanType SetImageRegistry(const RegistryType type, |
| % const char *key,const void *value,ExceptionInfo *exception) |
| % |
| % A description of each parameter follows: |
| % |
| % o type: the type. |
| % |
| % o key: the key. |
| % |
| % o value: the value. |
| % |
| % o exception: the exception. |
| % |
| */ |
| |
| static void *DestroyRegistryNode(void *registry_info) |
| { |
| register RegistryInfo |
| *p; |
| |
| p=(RegistryInfo *) registry_info; |
| switch (p->type) |
| { |
| case StringRegistryType: |
| default: |
| { |
| p->value=RelinquishMagickMemory(p->value); |
| break; |
| } |
| case ImageRegistryType: |
| { |
| p->value=(void *) DestroyImageList((Image *) p->value); |
| break; |
| } |
| case ImageInfoRegistryType: |
| { |
| p->value=(void *) DestroyImageInfo((ImageInfo *) p->value); |
| break; |
| } |
| } |
| return(RelinquishMagickMemory(p)); |
| } |
| |
| MagickExport MagickBooleanType SetImageRegistry(const RegistryType type, |
| const char *key,const void *value,ExceptionInfo *exception) |
| { |
| MagickBooleanType |
| status; |
| |
| RegistryInfo |
| *registry_info; |
| |
| void |
| *clone_value; |
| |
| if (IsEventLogging() != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",key); |
| if (value == (const void *) NULL) |
| return(MagickFalse); |
| clone_value=(void *) NULL; |
| switch (type) |
| { |
| case StringRegistryType: |
| default: |
| { |
| const char |
| *string; |
| |
| string=(const char *) value; |
| clone_value=(void *) ConstantString(string); |
| break; |
| } |
| case ImageRegistryType: |
| { |
| const Image |
| *image; |
| |
| image=(const Image *) value; |
| if (image->signature != MagickCoreSignature) |
| { |
| (void) ThrowMagickException(exception,GetMagickModule(),RegistryError, |
| "UnableToSetRegistry","%s",key); |
| return(MagickFalse); |
| } |
| clone_value=(void *) CloneImageList(image,exception); |
| break; |
| } |
| case ImageInfoRegistryType: |
| { |
| const ImageInfo |
| *image_info; |
| |
| image_info=(const ImageInfo *) value; |
| if (image_info->signature != MagickCoreSignature) |
| { |
| (void) ThrowMagickException(exception,GetMagickModule(),RegistryError, |
| "UnableToSetRegistry","%s",key); |
| return(MagickFalse); |
| } |
| clone_value=(void *) CloneImageInfo(image_info); |
| break; |
| } |
| } |
| if (clone_value == (void *) NULL) |
| return(MagickFalse); |
| registry_info=(RegistryInfo *) AcquireCriticalMemory(sizeof(*registry_info)); |
| (void) memset(registry_info,0,sizeof(*registry_info)); |
| registry_info->type=type; |
| registry_info->value=clone_value; |
| registry_info->signature=MagickCoreSignature; |
| if (registry == (SplayTreeInfo *) NULL) |
| { |
| if (registry_semaphore == (SemaphoreInfo *) NULL) |
| ActivateSemaphoreInfo(®istry_semaphore); |
| LockSemaphoreInfo(registry_semaphore); |
| if (registry == (SplayTreeInfo *) NULL) |
| registry=NewSplayTree(CompareSplayTreeString,RelinquishMagickMemory, |
| DestroyRegistryNode); |
| UnlockSemaphoreInfo(registry_semaphore); |
| } |
| status=AddValueToSplayTree(registry,ConstantString(key),registry_info); |
| return(status); |
| } |
