MagickCore 7.1.2-37
Convert, Edit, Or Compose Bitmap Images
Loading...
Searching...
No Matches
thread.c
1/*
2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3% %
4% %
5% TTTTT H H RRRR EEEEE AAA DDDD %
6% T H H R R E A A D D %
7% T HHHHH RRRR EEE AAAAA D D %
8% T H H R R E A A D D %
9% T H H R R EEEEE A A DDDD %
10% %
11% %
12% MagickCore Thread Methods %
13% %
14% Software Design %
15% Cristy %
16% March 2003 %
17% %
18% %
19% Copyright @ 1999 ImageMagick Studio LLC, a non-profit organization %
20% dedicated to making software imaging solutions freely available. %
21% %
22% You may not use this file except in compliance with the License. You may %
23% obtain a copy of the License at %
24% %
25% https://imagemagick.org/license/ %
26% %
27% Unless required by applicable law or agreed to in writing, software %
28% distributed under the License is distributed on an "AS IS" BASIS, %
29% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
30% See the License for the specific language governing permissions and %
31% limitations under the License. %
32% %
33%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
34%
35%
36*/
37␌
38/*
39 Include declarations.
40*/
41#include "MagickCore/studio.h"
42#include "MagickCore/memory_.h"
43#include "MagickCore/thread_.h"
44#include "MagickCore/thread-private.h"
45␌
46/*
47 Typedef declarations.
48*/
49typedef struct _MagickThreadValue
50{
51 size_t
52 number_threads;
53
54 void
55 **values,
56 (*destructor)(void *);
57} MagickThreadValue;
58␌
59/*
60%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
61% %
62% %
63% %
64% C r e a t e M a g i c k T h r e a d K e y %
65% %
66% %
67% %
68%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
69%
70% CreateMagickThreadKey() creates a thread-specific data key visible to all
71% threads in the process.
72%
73% The format of the CreateMagickThreadKey method is:
74%
75% MagickBooleanType CreateMagickThreadKey(MagickThreadKey *key,
76% void (*destructor)(void *))
77%
78% A description of each parameter follows:
79%
80% o key: opaque objects used to locate thread-specific data.
81%
82% o destructor: associate an optional destructor with each key value.
83%
84*/
85MagickExport MagickBooleanType CreateMagickThreadKey(MagickThreadKey *key,
86 void (*destructor)(void *))
87{
88 if (key == (MagickThreadKey *) NULL)
89 return(MagickFalse);
90#if defined(MAGICKCORE_THREAD_SUPPORT)
91 return(pthread_key_create(key,destructor) == 0 ? MagickTrue : MagickFalse);
92#elif defined(MAGICKCORE_WINDOWS_SUPPORT)
93 magick_unreferenced(destructor);
94 *key=TlsAlloc();
95 return(*key != TLS_OUT_OF_INDEXES ? MagickTrue : MagickFalse);
96#else
97 {
98 MagickThreadValue
99 **keys;
100
101 keys=(MagickThreadValue **) key;
102 *keys=(MagickThreadValue *) AcquireMagickMemory(sizeof(**keys));
103 if (*keys != (MagickThreadValue *) NULL)
104 {
105 (*keys)->number_threads=GetOpenMPMaximumThreads();
106 if ((*keys)->number_threads == 0)
107 (*keys)->number_threads=1;
108 (*keys)->values=(void **) AcquireQuantumMemory((*keys)->number_threads,
109 sizeof(void *));
110 if ((*keys)->values == (void **) NULL)
111 *keys=(MagickThreadValue *) RelinquishMagickMemory(*keys);
112 else
113 {
114 (void) memset((*keys)->values,0,(*keys)->number_threads*
115 sizeof(void *));
116 (*keys)->destructor=destructor;
117 }
118 }
119 return((*keys != (MagickThreadValue *) NULL) ? MagickTrue : MagickFalse);
120 }
121#endif
122}
123␌
124/*
125%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
126% %
127% %
128% %
129% D e l e t e M a g i c k T h r e a d K e y %
130% %
131% %
132% %
133%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
134%
135% DeleteMagickThreadKey() deletes a thread-specific data key.
136%
137% The format of the DeleteMagickThreadKey method is:
138%
139% MagickBooleanType DeleteMagickThreadKey(MagickThreadKey key)
140%
141% A description of each parameter follows:
142%
143% o key: the thread key.
144%
145*/
146MagickExport MagickBooleanType DeleteMagickThreadKey(MagickThreadKey key)
147{
148#if defined(MAGICKCORE_THREAD_SUPPORT)
149 return(pthread_key_delete(key) == 0 ? MagickTrue : MagickFalse);
150#elif defined(MAGICKCORE_WINDOWS_SUPPORT)
151 if (key == TLS_OUT_OF_INDEXES)
152 return(MagickFalse);
153 return(TlsFree(key) != 0 ? MagickTrue : MagickFalse);
154#else
155 {
156 MagickThreadValue
157 *keys;
158
159 ssize_t
160 i;
161
162 keys=(MagickThreadValue *) key;
163 if (keys == (MagickThreadValue *) NULL)
164 return(MagickFalse);
165 if (keys->values != (void **) NULL)
166 {
167 for (i=0; i < (ssize_t) keys->number_threads; i++)
168 if ((keys->destructor != (void *) NULL) &&
169 (keys->values[i] != (void *) NULL))
170 {
171 keys->destructor(keys->values[i]);
172 keys->values[i]=(void *) NULL;
173 }
174 keys->values=(void **) RelinquishMagickMemory(keys->values);
175 }
176 keys=(MagickThreadValue *) RelinquishMagickMemory(keys);
177 }
178 return(MagickTrue);
179#endif
180}
181␌
182/*
183%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
184% %
185% %
186% %
187% G e t M a g i c k T h r e a d V a l u e %
188% %
189% %
190% %
191%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
192%
193% GetMagickThreadValue() returns the value currently bound to the specified
194% key on behalf of the calling thread.
195%
196% The format of the GetMagickThreadValue method is:
197%
198% void *GetMagickThreadValue(MagickThreadKey key)
199%
200% A description of each parameter follows:
201%
202% o key: the thread key.
203%
204*/
205MagickExport void *GetMagickThreadValue(MagickThreadKey key)
206{
207#if defined(MAGICKCORE_THREAD_SUPPORT)
208 return(pthread_getspecific(key));
209#elif defined(MAGICKCORE_WINDOWS_SUPPORT)
210 if (key == TLS_OUT_OF_INDEXES)
211 return((void *) NULL);
212 return(TlsGetValue(key));
213#else
214 {
215 MagickThreadValue
216 *keys;
217
218 size_t
219 thread_id;
220
221 keys=(MagickThreadValue *) key;
222 if ((keys == (MagickThreadValue *) NULL) ||
223 (keys->values == (void **) NULL))
224 return((void *) NULL);
225 thread_id=(size_t) GetOpenMPThreadId();
226 if (thread_id >= keys->number_threads)
227 return((void *) NULL);
228 return(keys->values[thread_id]);
229 }
230#endif
231}
232␌
233/*
234%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
235% %
236% %
237% %
238% S e t M a g i c k T h r e a d V a l u e %
239% %
240% %
241% %
242%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
243%
244% SetMagickThreadValue() binds a value to the specified key on behalf of the
245% calling thread.
246%
247% The format of the SetMagickThreadValue method is:
248%
249% MagickBooleanType SetMagickThreadValue(MagickThreadKey key,
250% const void *value)
251%
252% A description of each parameter follows:
253%
254% o key: the thread key.
255%
256% o value: the value.
257%
258*/
259MagickExport MagickBooleanType SetMagickThreadValue(MagickThreadKey key,
260 const void *value)
261{
262#if defined(MAGICKCORE_THREAD_SUPPORT)
263 return(pthread_setspecific(key,value) == 0 ? MagickTrue : MagickFalse);
264#elif defined(MAGICKCORE_WINDOWS_SUPPORT)
265 if (key == TLS_OUT_OF_INDEXES)
266 return(MagickFalse);
267 return(TlsSetValue(key,(void *) value) != 0 ? MagickTrue : MagickFalse);
268#else
269 {
270 MagickThreadValue
271 *keys;
272
273 size_t
274 thread_id;
275
276 keys=(MagickThreadValue *) key;
277 if ((keys == (MagickThreadValue *) NULL) ||
278 (keys->values == (void **) NULL))
279 return(MagickFalse);
280 thread_id=(size_t) GetOpenMPThreadId();
281 if (thread_id >= keys->number_threads)
282 return(MagickFalse);
283 keys->values[thread_id]=(void *) value;
284 }
285 return(MagickTrue);
286#endif
287}