2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
8 % W W W AAAAA N N N D D %
13 % MagickWand Support Methods %
20 % Copyright 1999-2018 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 % https://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 "MagickWand/studio.h"
43 #include "MagickWand/MagickWand.h"
44 #include "MagickWand/magick-wand-private.h"
45 #include "MagickWand/wand.h"
48 *wand_ids = (SplayTreeInfo *) NULL;
50 static MagickBooleanType
51 instantiate_wand = MagickFalse;
54 *wand_semaphore = (SemaphoreInfo *) NULL;
57 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
61 % A c q u i r e W a n d I d %
65 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
67 % AcquireWandId() returns a unique wand id.
69 % The format of the AcquireWandId() method is:
71 % size_t AcquireWandId()
74 WandExport size_t AcquireWandId(void)
82 if (wand_semaphore == (SemaphoreInfo *) NULL)
83 ActivateSemaphoreInfo(&wand_semaphore);
84 LockSemaphoreInfo(wand_semaphore);
85 if (wand_ids == (SplayTreeInfo *) NULL)
86 wand_ids=NewSplayTree((int (*)(const void *,const void *)) NULL,
87 (void *(*)(void *)) NULL,(void *(*)(void *)) NULL);
89 (void) AddValueToSplayTree(wand_ids,(const void *) wand_id,
90 (const void *) wand_id);
91 instantiate_wand=MagickTrue;
92 UnlockSemaphoreInfo(wand_semaphore);
97 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
101 % D e s t r o y W a n d I d s %
105 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
107 % DestroyWandIds() deallocates memory associated with the wand id's.
109 % The format of the DestroyWandIds() method is:
111 % void DestroyWandIds(void)
113 % A description of each parameter follows:
116 WandExport void DestroyWandIds(void)
118 if (wand_semaphore == (SemaphoreInfo *) NULL)
119 ActivateSemaphoreInfo(&wand_semaphore);
120 LockSemaphoreInfo(wand_semaphore);
121 if (wand_ids != (SplayTreeInfo *) NULL)
122 wand_ids=DestroySplayTree(wand_ids);
123 instantiate_wand=MagickFalse;
124 UnlockSemaphoreInfo(wand_semaphore);
125 RelinquishSemaphoreInfo(&wand_semaphore);
129 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
133 % R e l i n q u i s h W a n d I d %
137 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
139 % RelinquishWandId() relinquishes a unique wand id.
141 % The format of the RelinquishWandId() method is:
143 % void RelinquishWandId(const size_t *id)
145 % A description of each parameter follows:
147 % o id: a unique wand id.
150 WandExport void RelinquishWandId(const size_t id)
152 LockSemaphoreInfo(wand_semaphore);
153 if (wand_ids != (SplayTreeInfo *) NULL)
154 (void) DeleteNodeFromSplayTree(wand_ids,(const void *) id);
155 UnlockSemaphoreInfo(wand_semaphore);