MagickWand  7.0.7
Convert, Edit, Or Compose Bitmap Images
wand.c
Go to the documentation of this file.
1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % %
4 % %
5 % %
6 % W W AAA N N DDDD %
7 % W W A A NN N D D %
8 % W W W AAAAA N N N D D %
9 % WW WW A A N NN D D %
10 % W W A A N N DDDD %
11 % %
12 % %
13 % MagickWand Support Methods %
14 % %
15 % Software Design %
16 % Cristy %
17 % May 2004 %
18 % %
19 % %
20 % Copyright 1999-2018 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
22 % %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
25 % %
26 % https://www.imagemagick.org/script/license.php %
27 % %
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. %
33 % %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
35 %
36 %
37 */
38 
39 /*
40  Include declarations.
41 */
42 #include "MagickWand/studio.h"
43 #include "MagickWand/MagickWand.h"
45 #include "MagickWand/wand.h"
46 
47 static SplayTreeInfo
48  *wand_ids = (SplayTreeInfo *) NULL;
49 
50 static MagickBooleanType
51  instantiate_wand = MagickFalse;
52 
53 static SemaphoreInfo
54  *wand_semaphore = (SemaphoreInfo *) NULL;
55 
56 /*
57 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
58 % %
59 % %
60 % %
61 % A c q u i r e W a n d I d %
62 % %
63 % %
64 % %
65 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
66 %
67 % AcquireWandId() returns a unique wand id.
68 %
69 % The format of the AcquireWandId() method is:
70 %
71 % size_t AcquireWandId()
72 %
73 */
75 {
76  static size_t
77  id = 0;
78 
79  size_t
80  wand_id;
81 
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);
88  wand_id=id++;
89  (void) AddValueToSplayTree(wand_ids,(const void *) wand_id,
90  (const void *) wand_id);
91  instantiate_wand=MagickTrue;
92  UnlockSemaphoreInfo(wand_semaphore);
93  return(wand_id);
94 }
95 
96 /*
97 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
98 % %
99 % %
100 % %
101 % D e s t r o y W a n d I d s %
102 % %
103 % %
104 % %
105 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
106 %
107 % DestroyWandIds() deallocates memory associated with the wand id's.
108 %
109 % The format of the DestroyWandIds() method is:
110 %
111 % void DestroyWandIds(void)
112 %
113 % A description of each parameter follows:
114 %
115 */
117 {
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);
126 }
127 
128 /*
129 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
130 % %
131 % %
132 % %
133 % R e l i n q u i s h W a n d I d %
134 % %
135 % %
136 % %
137 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
138 %
139 % RelinquishWandId() relinquishes a unique wand id.
140 %
141 % The format of the RelinquishWandId() method is:
142 %
143 % void RelinquishWandId(const size_t *id)
144 %
145 % A description of each parameter follows:
146 %
147 % o id: a unique wand id.
148 %
149 */
150 WandExport void RelinquishWandId(const size_t id)
151 {
152  LockSemaphoreInfo(wand_semaphore);
153  if (wand_ids != (SplayTreeInfo *) NULL)
154  (void) DeleteNodeFromSplayTree(wand_ids,(const void *) id);
155  UnlockSemaphoreInfo(wand_semaphore);
156 }
static SemaphoreInfo * wand_semaphore
Definition: wand.c:54
WandExport size_t AcquireWandId(void)
Definition: wand.c:74
#define WandExport
size_t id
Definition: wand-view.c:65
WandExport void RelinquishWandId(const size_t id)
Definition: wand.c:150
static MagickBooleanType instantiate_wand
Definition: wand.c:51
WandExport void DestroyWandIds(void)
Definition: wand.c:116
static SplayTreeInfo * wand_ids
Definition: wand.c:48