]> granicus.if.org Git - imagemagick/blob - magick/option.c
(no commit message)
[imagemagick] / magick / option.c
1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 %                                                                             %
4 %                                                                             %
5 %                                                                             %
6 %                   OOO   PPPP   TTTTT  IIIII   OOO   N   N                   %
7 %                  O   O  P   P    T      I    O   O  NN  N                   %
8 %                  O   O  PPPP     T      I    O   O  N N N                   %
9 %                  O   O  P        T      I    O   O  N  NN                   %
10 %                   OOO   P        T    IIIII   OOO   N   N                   %
11 %                                                                             %
12 %                                                                             %
13 %                         MagickCore Option Methods                           %
14 %                                                                             %
15 %                              Software Design                                %
16 %                                John Cristy                                  %
17 %                                 March 2000                                  %
18 %                                                                             %
19 %                                                                             %
20 %  Copyright 1999-2011 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 %    http://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 \f
40 /*
41   Include declarations.
42 */
43 #include "magick/studio.h"
44 #include "magick/artifact.h"
45 #include "magick/cache.h"
46 #include "magick/color.h"
47 #include "magick/compare.h"
48 #include "magick/constitute.h"
49 #include "magick/distort.h"
50 #include "magick/draw.h"
51 #include "magick/effect.h"
52 #include "magick/exception.h"
53 #include "magick/exception-private.h"
54 #include "magick/fx.h"
55 #include "magick/gem.h"
56 #include "magick/geometry.h"
57 #include "magick/image.h"
58 #include "magick/image-private.h"
59 #include "magick/layer.h"
60 #include "magick/mime-private.h"
61 #include "magick/memory_.h"
62 #include "magick/monitor.h"
63 #include "magick/montage.h"
64 #include "magick/morphology.h"
65 #include "magick/option.h"
66 #include "magick/policy.h"
67 #include "magick/property.h"
68 #include "magick/quantize.h"
69 #include "magick/quantum.h"
70 #include "magick/resample.h"
71 #include "magick/resource_.h"
72 #include "magick/splay-tree.h"
73 #include "magick/statistic.h"
74 #include "magick/string_.h"
75 #include "magick/token.h"
76 #include "magick/utility.h"
77 \f
78 /*
79   ImageMagick options.
80 */
81 static const OptionInfo
82   AlignOptions[] =
83   {
84     { "Undefined", (ssize_t) UndefinedAlign, MagickTrue },
85     { "Center", (ssize_t) CenterAlign, MagickFalse },
86     { "End", (ssize_t) RightAlign, MagickFalse },
87     { "Left", (ssize_t) LeftAlign, MagickFalse },
88     { "Middle", (ssize_t) CenterAlign, MagickFalse },
89     { "Right", (ssize_t) RightAlign, MagickFalse },
90     { "Start", (ssize_t) LeftAlign, MagickFalse },
91     { (char *) NULL, (ssize_t) UndefinedAlign, MagickFalse }
92   },
93   AlphaOptions[] =
94   {
95     { "Undefined", (ssize_t) UndefinedAlphaChannel, MagickTrue },
96     { "Activate", (ssize_t) ActivateAlphaChannel, MagickFalse },
97     { "Background", (ssize_t) BackgroundAlphaChannel, MagickFalse },
98     { "Copy", (ssize_t) CopyAlphaChannel, MagickFalse },
99     { "Deactivate", (ssize_t) DeactivateAlphaChannel, MagickFalse },
100     { "Extract", (ssize_t) ExtractAlphaChannel, MagickFalse },
101     { "Off", (ssize_t) DeactivateAlphaChannel, MagickFalse },
102     { "On", (ssize_t) ActivateAlphaChannel, MagickFalse },
103     { "Opaque", (ssize_t) OpaqueAlphaChannel, MagickFalse },
104     { "Set", (ssize_t) SetAlphaChannel, MagickFalse },
105     { "Shape", (ssize_t) ShapeAlphaChannel, MagickFalse },
106     { "Reset", (ssize_t) SetAlphaChannel, MagickTrue },  /* deprecated */
107     { "Transparent", (ssize_t) TransparentAlphaChannel, MagickFalse },
108     { (char *) NULL, (ssize_t) UndefinedAlphaChannel, MagickFalse }
109   },
110   BooleanOptions[] =
111   {
112     { "False", 0L, MagickFalse },
113     { "True", 1L, MagickFalse },
114     { "0", 0L, MagickFalse },
115     { "1", 1L, MagickFalse },
116     { (char *) NULL, 0L, MagickFalse }
117   },
118   ChannelOptions[] =
119   {
120     { "Undefined", (ssize_t) UndefinedChannel, MagickTrue },
121     { "All", (ssize_t) AllChannels, MagickFalse },
122     { "Alpha", (ssize_t) OpacityChannel, MagickFalse },
123     { "Black", (ssize_t) BlackChannel, MagickFalse },
124     { "Blue", (ssize_t) BlueChannel, MagickFalse },
125     { "Cyan", (ssize_t) CyanChannel, MagickFalse },
126     { "Default", (ssize_t) DefaultChannels, MagickFalse },
127     { "Gray", (ssize_t) GrayChannel, MagickFalse },
128     { "Green", (ssize_t) GreenChannel, MagickFalse },
129     { "Hue", (ssize_t) RedChannel, MagickFalse },
130     { "Index", (ssize_t) IndexChannel, MagickFalse },
131     { "Lightness", (ssize_t) BlueChannel, MagickFalse },
132     { "Luminance", (ssize_t) BlueChannel, MagickFalse },
133     { "Luminosity", (ssize_t) BlueChannel, MagickFalse },  /* deprecated */
134     { "Magenta", (ssize_t) MagentaChannel, MagickFalse },
135     { "Matte", (ssize_t) OpacityChannel, MagickFalse },
136     { "Opacity", (ssize_t) OpacityChannel, MagickFalse },
137     { "Red", (ssize_t) RedChannel, MagickFalse },
138     { "Saturation", (ssize_t) GreenChannel, MagickFalse },
139     { "Yellow", (ssize_t) YellowChannel, MagickFalse },
140     { "Sync", (ssize_t) SyncChannels, MagickFalse },
141     { (char *) NULL, (ssize_t) UndefinedChannel, MagickFalse }
142   },
143   ClassOptions[] =
144   {
145     { "Undefined", (ssize_t) UndefinedClass, MagickTrue },
146     { "DirectClass", (ssize_t) DirectClass, MagickFalse },
147     { "PseudoClass", (ssize_t) PseudoClass, MagickFalse },
148     { (char *) NULL, (ssize_t) UndefinedClass, MagickFalse }
149   },
150   ClipPathOptions[] =
151   {
152     { "Undefined", (ssize_t) UndefinedPathUnits, MagickTrue },
153     { "ObjectBoundingBox", (ssize_t) ObjectBoundingBox, MagickFalse },
154     { "UserSpace", (ssize_t) UserSpace, MagickFalse },
155     { "UserSpaceOnUse", (ssize_t) UserSpaceOnUse, MagickFalse },
156     { (char *) NULL, (ssize_t) UndefinedPathUnits, MagickFalse }
157   },
158   CommandOptions[] =
159   {
160     { "+adjoin", 0L, MagickFalse },
161     { "-adjoin", 0L, MagickFalse },
162     { "+adaptive-sharpen", 1L, MagickFalse },
163     { "-adaptive-sharpen", 1L, MagickFalse },
164     { "+adaptive-threshold", 1L, MagickFalse },
165     { "-adaptive-threshold", 1L, MagickFalse },
166     { "+affine", 0L, MagickFalse },
167     { "-affine", 1L, MagickFalse },
168     { "+affinity", 0L, MagickFalse },
169     { "-affinity", 1L, MagickFalse },
170     { "+alpha", 1L, MagickFalse },
171     { "-alpha", 1L, MagickFalse },
172     { "+annotate", 0L, MagickFalse },
173     { "-annotate", 2L, MagickFalse },
174     { "+antialias", 0L, MagickFalse },
175     { "-antialias", 0L, MagickFalse },
176     { "+append", 0L, MagickFalse },
177     { "-append", 0L, MagickFalse },
178     { "+authenticate", 0L, MagickFalse },
179     { "-authenticate", 1L, MagickFalse },
180     { "+auto-gamma", 0L, MagickTrue },
181     { "-auto-gamma", 0L, MagickTrue },
182     { "+auto-level", 0L, MagickTrue },
183     { "-auto-level", 0L, MagickTrue },
184     { "+auto-orient", 0L, MagickFalse },
185     { "-auto-orient", 0L, MagickFalse },
186     { "+average", 0L, MagickFalse },
187     { "-average", 0L, MagickFalse },
188     { "+backdrop", 0L, MagickFalse },
189     { "-backdrop", 1L, MagickFalse },
190     { "+background", 0L, MagickFalse },
191     { "-background", 1L, MagickFalse },
192     { "+bench", 0L, MagickTrue },
193     { "-bench", 1L, MagickTrue },
194     { "+bias", 0L, MagickFalse },
195     { "-bias", 1L, MagickFalse },
196     { "+black-threshold", 0L, MagickFalse },
197     { "-black-threshold", 1L, MagickFalse },
198     { "+blend", 0L, MagickFalse },
199     { "-blend", 1L, MagickFalse },
200     { "+blue-primary", 0L, MagickFalse },
201     { "-blue-primary", 1L, MagickFalse },
202     { "+blue-shift", 1L, MagickFalse },
203     { "-blue-shift", 1L, MagickFalse },
204     { "+blur", 0L, MagickFalse },
205     { "-blur", 1L, MagickFalse },
206     { "+border", 0L, MagickFalse },
207     { "-border", 1L, MagickFalse },
208     { "+bordercolor", 0L, MagickFalse },
209     { "-bordercolor", 1L, MagickFalse },
210     { "+borderwidth", 0L, MagickFalse },
211     { "-borderwidth", 1L, MagickFalse },
212     { "+box", 0L, MagickFalse },
213     { "-box", 1L, MagickFalse },
214     { "+brightness-contrast", 0L, MagickFalse },
215     { "-brightness-contrast", 1L, MagickFalse },
216     { "+cache", 0L, MagickFalse },
217     { "-cache", 1L, MagickFalse },
218     { "+cdl", 1L, MagickFalse },
219     { "-cdl", 1L, MagickFalse },
220     { "+channel", 0L, MagickFalse },
221     { "-channel", 1L, MagickFalse },
222     { "+charcoal", 0L, MagickFalse },
223     { "-charcoal", 0L, MagickFalse },
224     { "+chop", 0L, MagickFalse },
225     { "-chop", 1L, MagickFalse },
226     { "+clip", 0L, MagickFalse },
227     { "-clip", 0L, MagickFalse },
228     { "+clip-mask", 0L, MagickFalse },
229     { "-clip-mask", 1L, MagickFalse },
230     { "+clip-path", 0L, MagickFalse },
231     { "-clip-path", 1L, MagickFalse },
232     { "+clone", 0L, MagickFalse },
233     { "-clone", 1L, MagickFalse },
234     { "+clut", 0L, MagickFalse },
235     { "-clut", 0L, MagickFalse },
236     { "+coalesce", 0L, MagickFalse },
237     { "-coalesce", 0L, MagickFalse },
238     { "+colorize", 0L, MagickFalse },
239     { "-colorize", 1L, MagickFalse },
240     { "+colormap", 0L, MagickFalse },
241     { "-colormap", 1L, MagickFalse },
242     { "+color-matrix", 0L, MagickFalse },
243     { "-color-matrix", 1L, MagickFalse },
244     { "+colors", 0L, MagickFalse },
245     { "-colors", 1L, MagickFalse },
246     { "+colorspace", 0L, MagickFalse },
247     { "-colorspace", 1L, MagickFalse },
248     { "+combine", 0L, MagickFalse },
249     { "-combine", 0L, MagickFalse },
250     { "+comment", 0L, MagickFalse },
251     { "-comment", 1L, MagickFalse },
252     { "+compose", 0L, MagickFalse },
253     { "-compose", 1L, MagickFalse },
254     { "+composite", 0L, MagickFalse },
255     { "-composite", 0L, MagickFalse },
256     { "+compress", 0L, MagickFalse },
257     { "-compress", 1L, MagickFalse },
258     { "+concurrent", 0L, MagickTrue },
259     { "-concurrent", 0L, MagickTrue },
260     { "+contrast", 0L, MagickFalse },
261     { "-contrast", 0L, MagickFalse },
262     { "+contrast-stretch", 0L, MagickFalse },
263     { "-contrast-stretch", 1L, MagickFalse },
264     { "+convolve", 0L, MagickFalse },
265     { "-convolve", 1L, MagickFalse },
266     { "+crop", 0L, MagickFalse },
267     { "-crop", 1L, MagickFalse },
268     { "+cycle", 0L, MagickFalse },
269     { "-cycle", 1L, MagickFalse },
270     { "+debug", 0L, MagickFalse },
271     { "-debug", 1L, MagickFalse },
272     { "+decipher", 1L, MagickFalse },
273     { "-decipher", 1L, MagickFalse },
274     { "+deconstruct", 0L, MagickFalse },
275     { "-deconstruct", 0L, MagickFalse },
276     { "+define", 1L, MagickFalse },
277     { "-define", 1L, MagickFalse },
278     { "+delay", 0L, MagickFalse },
279     { "-delay", 1L, MagickFalse },
280     { "+delete", 0L, MagickFalse },
281     { "-delete", 1L, MagickFalse },
282     { "+density", 0L, MagickFalse },
283     { "-density", 1L, MagickFalse },
284     { "+depth", 0L, MagickFalse },
285     { "-depth", 1L, MagickFalse },
286     { "+descend", 0L, MagickFalse },
287     { "-descend", 1L, MagickFalse },
288     { "+deskew", 0L, MagickFalse },
289     { "-deskew", 1L, MagickFalse },
290     { "+despeckle", 0L, MagickFalse },
291     { "-despeckle", 0L, MagickFalse },
292     { "+direction", 0L, MagickFalse },
293     { "-direction", 1L, MagickFalse },
294     { "+displace", 0L, MagickFalse },
295     { "-displace", 1L, MagickFalse },
296     { "+display", 0L, MagickFalse },
297     { "-display", 1L, MagickFalse },
298     { "+dispose", 0L, MagickFalse },
299     { "-dispose", 1L, MagickFalse },
300     { "+dissolve", 0L, MagickFalse },
301     { "-dissolve", 1L, MagickFalse },
302     { "+distort", 2L, MagickFalse },
303     { "-distort", 2L, MagickFalse },
304     { "+dither", 0L, MagickFalse },
305     { "-dither", 1L, MagickFalse },
306     { "+draw", 0L, MagickFalse },
307     { "-draw", 1L, MagickFalse },
308     { "+duration", 1L, MagickTrue },
309     { "-duration", 1L, MagickTrue },
310     { "+edge", 0L, MagickFalse },
311     { "-edge", 1L, MagickFalse },
312     { "+emboss", 0L, MagickFalse },
313     { "-emboss", 1L, MagickFalse },
314     { "+encipher", 1L, MagickFalse },
315     { "-encipher", 1L, MagickFalse },
316     { "+encoding", 0L, MagickFalse },
317     { "-encoding", 1L, MagickFalse },
318     { "+endian", 0L, MagickFalse },
319     { "-endian", 1L, MagickFalse },
320     { "+enhance", 0L, MagickFalse },
321     { "-enhance", 0L, MagickFalse },
322     { "+equalize", 0L, MagickFalse },
323     { "-equalize", 0L, MagickFalse },
324     { "+evaluate", 0L, MagickFalse },
325     { "-evaluate", 2L, MagickFalse },
326     { "+evaluate-sequence", 0L, MagickFalse },
327     { "-evaluate-sequence", 1L, MagickFalse },
328     { "+extent", 0L, MagickFalse },
329     { "-extent", 1L, MagickFalse },
330     { "+extract", 0L, MagickFalse },
331     { "-extract", 1L, MagickFalse },
332     { "+family", 0L, MagickFalse },
333     { "-family", 1L, MagickFalse },
334     { "+fft", 0L, MagickFalse },
335     { "-fft", 0L, MagickFalse },
336     { "+fill", 0L, MagickFalse },
337     { "-fill", 1L, MagickFalse },
338     { "+filter", 0L, MagickFalse },
339     { "-filter", 1L, MagickFalse },
340     { "+flatten", 0L, MagickFalse },
341     { "-flatten", 0L, MagickFalse },
342     { "+flip", 0L, MagickFalse },
343     { "-flip", 0L, MagickFalse },
344     { "+floodfill", 0L, MagickFalse },
345     { "-floodfill", 2L, MagickFalse },
346     { "+flop", 0L, MagickFalse },
347     { "-flop", 0L, MagickFalse },
348     { "+font", 0L, MagickFalse },
349     { "-font", 1L, MagickFalse },
350     { "+foreground", 0L, MagickFalse },
351     { "-foreground", 1L, MagickFalse },
352     { "+format", 0L, MagickFalse },
353     { "-format", 1L, MagickFalse },
354     { "+frame", 0L, MagickFalse },
355     { "-frame", 1L, MagickFalse },
356     { "+fuzz", 0L, MagickFalse },
357     { "-fuzz", 1L, MagickFalse },
358     { "+fx", 0L, MagickFalse },
359     { "-fx", 1L, MagickFalse },
360     { "+gamma", 0L, MagickFalse },
361     { "-gamma", 1L, MagickFalse },
362     { "+gaussian", 0L, MagickFalse },
363     { "-gaussian", 1L, MagickFalse },
364     { "+gaussian-blur", 0L, MagickFalse },
365     { "-gaussian-blur", 1L, MagickFalse },
366     { "+geometry", 0L, MagickFalse },
367     { "-geometry", 1L, MagickFalse },
368     { "+gravity", 0L, MagickFalse },
369     { "-gravity", 1L, MagickFalse },
370     { "+green-primary", 0L, MagickFalse },
371     { "-green-primary", 1L, MagickFalse },
372     { "+hald-clut", 0L, MagickFalse },
373     { "-hald-clut", 0L, MagickFalse },
374     { "+help", 0L, MagickFalse },
375     { "-help", 0L, MagickFalse },
376     { "+highlight-color", 1L, MagickFalse },
377     { "-highlight-color", 1L, MagickFalse },
378     { "+iconGeometry", 0L, MagickFalse },
379     { "-iconGeometry", 1L, MagickFalse },
380     { "+iconic", 0L, MagickFalse },
381     { "-iconic", 1L, MagickFalse },
382     { "+identify", 0L, MagickFalse },
383     { "-identify", 0L, MagickFalse },
384     { "+immutable", 0L, MagickFalse },
385     { "-immutable", 0L, MagickFalse },
386     { "+implode", 0L, MagickFalse },
387     { "-implode", 1L, MagickFalse },
388     { "+insert", 0L, MagickFalse },
389     { "-insert", 1L, MagickFalse },
390     { "+intent", 0L, MagickFalse },
391     { "-intent", 1L, MagickFalse },
392     { "+interlace", 0L, MagickFalse },
393     { "-interlace", 1L, MagickFalse },
394     { "+interpolate", 0L, MagickFalse },
395     { "-interpolate", 1L, MagickFalse },
396     { "+interword-spacing", 0L, MagickFalse },
397     { "-interword-spacing", 1L, MagickFalse },
398     { "+kerning", 0L, MagickFalse },
399     { "-kerning", 1L, MagickFalse },
400     { "+label", 0L, MagickFalse },
401     { "-label", 1L, MagickFalse },
402     { "+lat", 0L, MagickFalse },
403     { "-lat", 1L, MagickFalse },
404     { "+layers", 0L, MagickFalse },
405     { "-layers", 1L, MagickFalse },
406     { "+level", 1L, MagickFalse },
407     { "-level", 1L, MagickFalse },
408     { "+level-colors", 1L, MagickFalse },
409     { "-level-colors", 1L, MagickFalse },
410     { "+limit", 0L, MagickFalse },
411     { "-limit", 2L, MagickFalse },
412     { "+linear-stretch", 0L, MagickFalse },
413     { "-linear-stretch", 1L, MagickFalse },
414     { "+linewidth", 0L, MagickFalse },
415     { "-linewidth", 1L, MagickFalse },
416     { "+liquid-rescale", 0L, MagickFalse },
417     { "-liquid-rescale", 1L, MagickFalse },
418     { "+list", 0L, MagickFalse },
419     { "-list", 1L, MagickFalse },
420     { "+log", 0L, MagickFalse },
421     { "-log", 1L, MagickFalse },
422     { "+loop", 0L, MagickFalse },
423     { "-loop", 1L, MagickFalse },
424     { "+lowlight-color", 1L, MagickFalse },
425     { "-lowlight-color", 1L, MagickFalse },
426     { "+magnify", 0L, MagickFalse },
427     { "-magnify", 1L, MagickFalse },
428     { "+map", 0L, MagickFalse },
429     { "-map", 1L, MagickFalse },
430     { "+mask", 0L, MagickFalse },
431     { "-mask", 1L, MagickFalse },
432     { "+matte", 0L, MagickFalse },
433     { "-matte", 0L, MagickFalse },
434     { "+mattecolor", 0L, MagickFalse },
435     { "-mattecolor", 1L, MagickFalse },
436     { "+maximum", 0L, MagickFalse },
437     { "-maximum", 0L, MagickFalse },
438     { "+median", 0L, MagickFalse },
439     { "-median", 1L, MagickFalse },
440     { "+metric", 0L, MagickFalse },
441     { "-metric", 1L, MagickFalse },
442     { "+minimum", 0L, MagickFalse },
443     { "-minimum", 0L, MagickFalse },
444     { "+mode", 0L, MagickFalse },
445     { "-mode", 1L, MagickFalse },
446     { "+modulate", 0L, MagickFalse },
447     { "-modulate", 1L, MagickFalse },
448     { "+monitor", 0L, MagickFalse },
449     { "-monitor", 0L, MagickFalse },
450     { "+monochrome", 0L, MagickFalse },
451     { "-monochrome", 0L, MagickFalse },
452     { "+morph", 0L, MagickFalse },
453     { "-morph", 1L, MagickFalse },
454     { "+morphology", 0L, MagickFalse },
455     { "-morphology", 2L, MagickFalse },
456     { "+mosaic", 0L, MagickFalse },
457     { "-mosaic", 0L, MagickFalse },
458     { "+motion-blur", 0L, MagickFalse },
459     { "-motion-blur", 1L, MagickFalse },
460     { "+name", 0L, MagickFalse },
461     { "-name", 1L, MagickFalse },
462     { "+negate", 0L, MagickFalse },
463     { "-negate", 0L, MagickFalse },
464     { "+noise", 1L, MagickFalse },
465     { "-noise", 1L, MagickFalse },
466     { "+noop", 0L, MagickFalse },
467     { "-noop", 0L, MagickFalse },
468     { "+normalize", 0L, MagickFalse },
469     { "-normalize", 0L, MagickFalse },
470     { "+opaque", 1L, MagickFalse },
471     { "-opaque", 1L, MagickFalse },
472     { "+ordered-dither", 0L, MagickFalse },
473     { "-ordered-dither", 1L, MagickFalse },
474     { "+orient", 0L, MagickFalse },
475     { "-orient", 1L, MagickFalse },
476     { "+origin", 0L, MagickFalse },
477     { "-origin", 1L, MagickFalse },
478     { "+page", 0L, MagickFalse },
479     { "-page", 1L, MagickFalse },
480     { "+paint", 0L, MagickFalse },
481     { "-paint", 1L, MagickFalse },
482     { "+path", 0L, MagickFalse },
483     { "-path", 1L, MagickFalse },
484     { "+pause", 0L, MagickFalse },
485     { "-pause", 1L, MagickFalse },
486     { "+passphrase", 0L, MagickFalse },
487     { "-passphrase", 1L, MagickFalse },
488     { "+pen", 0L, MagickFalse },
489     { "-pen", 1L, MagickFalse },
490     { "+ping", 0L, MagickFalse },
491     { "-ping", 0L, MagickFalse },
492     { "+pointsize", 0L, MagickFalse },
493     { "-pointsize", 1L, MagickFalse },
494     { "+polaroid", 0L, MagickFalse },
495     { "-polaroid", 1L, MagickFalse },
496     { "+posterize", 0L, MagickFalse },
497     { "-posterize", 1L, MagickFalse },
498     { "+preview", 0L, MagickFalse },
499     { "-preview", 1L, MagickFalse },
500     { "+process", 0L, MagickFalse },
501     { "-process", 1L, MagickFalse },
502     { "+profile", 1L, MagickFalse },
503     { "-profile", 1L, MagickFalse },
504     { "+quality", 0L, MagickFalse },
505     { "-quality", 1L, MagickFalse },
506     { "+quiet", 0L, MagickFalse },
507     { "-quiet", 0L, MagickFalse },
508     { "+radial-blur", 0L, MagickFalse },
509     { "-radial-blur", 1L, MagickFalse },
510     { "+raise", 0L, MagickFalse },
511     { "-raise", 1L, MagickFalse },
512     { "+random-threshold", 0L, MagickFalse },
513     { "-random-threshold", 1L, MagickFalse },
514     { "+recolor", 0L, MagickFalse },
515     { "-recolor", 1L, MagickFalse },
516     { "+red-primary", 0L, MagickFalse },
517     { "-red-primary", 1L, MagickFalse },
518     { "+regard-warnings", 0L, MagickFalse },
519     { "-regard-warnings", 0L, MagickFalse },
520     { "+region", 0L, MagickFalse },
521     { "-region", 1L, MagickFalse },
522     { "+remote", 0L, MagickFalse },
523     { "-remote", 1L, MagickFalse },
524     { "+render", 0L, MagickFalse },
525     { "-render", 0L, MagickFalse },
526     { "+repage", 0L, MagickFalse },
527     { "-repage", 1L, MagickFalse },
528     { "+resample", 0L, MagickFalse },
529     { "-resample", 1L, MagickFalse },
530     { "+resize", 0L, MagickFalse },
531     { "-resize", 1L, MagickFalse },
532     { "+respect-parenthesis", 0L, MagickFalse },
533     { "-respect-parenthesis", 0L, MagickFalse },
534     { "+reverse", 0L, MagickFalse },
535     { "-reverse", 0L, MagickFalse },
536     { "+roll", 0L, MagickFalse },
537     { "-roll", 1L, MagickFalse },
538     { "+rotate", 0L, MagickFalse },
539     { "-rotate", 1L, MagickFalse },
540     { "+sample", 0L, MagickFalse },
541     { "-sample", 1L, MagickFalse },
542     { "+sampling-factor", 0L, MagickFalse },
543     { "-sampling-factor", 1L, MagickFalse },
544     { "+sans", 0L, MagickFalse },
545     { "-sans", 1L, MagickFalse },
546     { "+sans0", 0L, MagickFalse },
547     { "-sans0", 0L, MagickFalse },
548     { "+sans2", 2L, MagickFalse },
549     { "-sans2", 2L, MagickFalse },
550     { "+scale", 0L, MagickFalse },
551     { "-scale", 1L, MagickFalse },
552     { "+scene", 0L, MagickFalse },
553     { "-scene", 1L, MagickFalse },
554     { "+scenes", 0L, MagickFalse },
555     { "-scenes", 1L, MagickFalse },
556     { "+screen", 0L, MagickFalse },
557     { "-screen", 1L, MagickFalse },
558     { "+seed", 0L, MagickFalse },
559     { "-seed", 1L, MagickFalse },
560     { "+segment", 0L, MagickFalse },
561     { "-segment", 1L, MagickFalse },
562     { "+separate", 0L, MagickFalse },
563     { "-separate", 0L, MagickFalse },
564     { "+sepia-tone", 0L, MagickFalse },
565     { "-sepia-tone", 1L, MagickFalse },
566     { "+set", 1L, MagickFalse },
567     { "-set", 2L, MagickFalse },
568     { "+shade", 0L, MagickFalse },
569     { "-shade", 1L, MagickFalse },
570     { "+shadow", 0L, MagickFalse },
571     { "-shadow", 1L, MagickFalse },
572     { "+shared-memory", 0L, MagickFalse },
573     { "-shared-memory", 1L, MagickFalse },
574     { "+sharpen", 0L, MagickFalse },
575     { "-sharpen", 1L, MagickFalse },
576     { "+shave", 0L, MagickFalse },
577     { "-shave", 1L, MagickFalse },
578     { "+shear", 0L, MagickFalse },
579     { "-shear", 1L, MagickFalse },
580     { "+sigmoidal-contrast", 0L, MagickFalse },
581     { "-sigmoidal-contrast", 1L, MagickFalse },
582     { "+silent", 0L, MagickFalse },
583     { "-silent", 1L, MagickFalse },
584     { "+size", 0L, MagickFalse },
585     { "-size", 1L, MagickFalse },
586     { "+sketch", 0L, MagickFalse },
587     { "-sketch", 1L, MagickFalse },
588     { "+snaps", 0L, MagickFalse },
589     { "-snaps", 1L, MagickFalse },
590     { "+solarize", 0L, MagickFalse },
591     { "-solarize", 1L, MagickFalse },
592     { "+splice", 0L, MagickFalse },
593     { "-splice", 1L, MagickFalse },
594     { "+sparse-color", 2L, MagickFalse },
595     { "-sparse-color", 2L, MagickFalse },
596     { "+spread", 0L, MagickFalse },
597     { "-spread", 1L, MagickFalse },
598     { "+stegano", 0L, MagickFalse },
599     { "-stegano", 1L, MagickFalse },
600     { "+stereo", 0L, MagickFalse },
601     { "-stereo", 1L, MagickFalse },
602     { "+stretch", 0L, MagickFalse },
603     { "-stretch", 1L, MagickFalse },
604     { "+strip", 0L, MagickFalse },
605     { "-strip", 0L, MagickFalse },
606     { "+stroke", 0L, MagickFalse },
607     { "-stroke", 1L, MagickFalse },
608     { "+strokewidth", 0L, MagickFalse },
609     { "-strokewidth", 1L, MagickFalse },
610     { "+style", 0L, MagickFalse },
611     { "-style", 1L, MagickFalse },
612     { "+subimage-search", 0L, MagickFalse },
613     { "-subimage-search", 0L, MagickFalse },
614     { "+swap", 0L, MagickFalse },
615     { "-swap", 1L, MagickFalse },
616     { "+swirl", 0L, MagickFalse },
617     { "-swirl", 1L, MagickFalse },
618     { "+synchronize", 0L, MagickFalse },
619     { "-synchronize", 0L, MagickFalse },
620     { "+taint", 0L, MagickFalse },
621     { "-taint", 0L, MagickFalse },
622     { "+text-font", 0L, MagickFalse },
623     { "-text-font", 1L, MagickFalse },
624     { "+texture", 0L, MagickFalse },
625     { "-texture", 1L, MagickFalse },
626     { "+threshold", 0L, MagickFalse },
627     { "-threshold", 1L, MagickFalse },
628     { "+thumbnail", 0L, MagickFalse },
629     { "-thumbnail", 1L, MagickFalse },
630     { "+thumnail", 0L, MagickFalse },
631     { "-thumnail", 1L, MagickFalse },
632     { "+tile", 0L, MagickFalse },
633     { "-tile", 1L, MagickFalse },
634     { "+tile-offset", 0L, MagickFalse },
635     { "-tile-offset", 1L, MagickFalse },
636     { "+tint", 0L, MagickFalse },
637     { "-tint", 1L, MagickFalse },
638     { "+title", 0L, MagickFalse },
639     { "-title", 1L, MagickFalse },
640     { "+transform", 0L, MagickFalse },
641     { "-transform", 0L, MagickFalse },
642     { "+transparent", 1L, MagickFalse },
643     { "-transparent", 1L, MagickFalse },
644     { "+transparent-color", 1L, MagickFalse },
645     { "-transparent-color", 1L, MagickFalse },
646     { "+transpose", 0L, MagickFalse },
647     { "-transpose", 0L, MagickFalse },
648     { "+transverse", 0L, MagickFalse },
649     { "-transverse", 0L, MagickFalse },
650     { "+treedepth", 0L, MagickFalse },
651     { "-treedepth", 1L, MagickFalse },
652     { "+trim", 0L, MagickFalse },
653     { "-trim", 0L, MagickFalse },
654     { "+type", 0L, MagickFalse },
655     { "-type", 1L, MagickFalse },
656     { "+undercolor", 0L, MagickFalse },
657     { "-undercolor", 1L, MagickFalse },
658     { "+unique-colors", 0L, MagickFalse },
659     { "-unique-colors", 0L, MagickFalse },
660     { "+units", 0L, MagickFalse },
661     { "-units", 1L, MagickFalse },
662     { "+unsharp", 0L, MagickFalse },
663     { "-unsharp", 1L, MagickFalse },
664     { "+update", 0L, MagickFalse },
665     { "-update", 1L, MagickFalse },
666     { "+use-pixmap", 0L, MagickFalse },
667     { "-use-pixmap", 1L, MagickFalse },
668     { "+verbose", 0L, MagickFalse },
669     { "-verbose", 0L, MagickFalse },
670     { "+version", 0L, MagickFalse },
671     { "-version", 1L, MagickFalse },
672     { "+view", 0L, MagickFalse },
673     { "-view", 1L, MagickFalse },
674     { "+vignette", 0L, MagickFalse },
675     { "-vignette", 1L, MagickFalse },
676     { "+virtual-pixel", 0L, MagickFalse },
677     { "-virtual-pixel", 1L, MagickFalse },
678     { "+visual", 0L, MagickFalse },
679     { "-visual", 1L, MagickFalse },
680     { "+watermark", 0L, MagickFalse },
681     { "-watermark", 1L, MagickFalse },
682     { "+wave", 0L, MagickFalse },
683     { "-wave", 1L, MagickFalse },
684     { "+weight", 0L, MagickFalse },
685     { "-weight", 1L, MagickFalse },
686     { "+white-point", 0L, MagickFalse },
687     { "-white-point", 1L, MagickFalse },
688     { "+white-threshold", 0L, MagickFalse },
689     { "-white-threshold", 1L, MagickFalse },
690     { "+window", 0L, MagickFalse },
691     { "-window", 1L, MagickFalse },
692     { "+window-group", 0L, MagickFalse },
693     { "-window-group", 1L, MagickFalse },
694     { "+write", 1L, MagickFalse },
695     { "-write", 1L, MagickFalse },
696     { (char *) NULL, (ssize_t) 0L, MagickFalse }
697   },
698   ComposeOptions[] =
699   {
700     { "Undefined", (ssize_t) UndefinedCompositeOp, MagickTrue },
701     { "Atop", (ssize_t) AtopCompositeOp, MagickFalse },
702     { "Blend", (ssize_t) BlendCompositeOp, MagickFalse },
703     { "Blur", (ssize_t) BlurCompositeOp, MagickFalse },
704     { "Bumpmap", (ssize_t) BumpmapCompositeOp, MagickFalse },
705     { "ChangeMask", (ssize_t) ChangeMaskCompositeOp, MagickFalse },
706     { "Clear", (ssize_t) ClearCompositeOp, MagickFalse },
707     { "ColorBurn", (ssize_t) ColorBurnCompositeOp, MagickFalse },
708     { "ColorDodge", (ssize_t) ColorDodgeCompositeOp, MagickFalse },
709     { "Colorize", (ssize_t) ColorizeCompositeOp, MagickFalse },
710     { "CopyBlack", (ssize_t) CopyBlackCompositeOp, MagickFalse },
711     { "CopyBlue", (ssize_t) CopyBlueCompositeOp, MagickFalse },
712     { "CopyCyan", (ssize_t) CopyCyanCompositeOp, MagickFalse },
713     { "CopyGreen", (ssize_t) CopyGreenCompositeOp, MagickFalse },
714     { "Copy", (ssize_t) CopyCompositeOp, MagickFalse },
715     { "CopyMagenta", (ssize_t) CopyMagentaCompositeOp, MagickFalse },
716     { "CopyOpacity", (ssize_t) CopyOpacityCompositeOp, MagickFalse },
717     { "CopyRed", (ssize_t) CopyRedCompositeOp, MagickFalse },
718     { "CopyYellow", (ssize_t) CopyYellowCompositeOp, MagickFalse },
719     { "Darken", (ssize_t) DarkenCompositeOp, MagickFalse },
720     { "Divide", (ssize_t) DivideCompositeOp, MagickFalse },
721     { "Dst", (ssize_t) DstCompositeOp, MagickFalse },
722     { "Difference", (ssize_t) DifferenceCompositeOp, MagickFalse },
723     { "Displace", (ssize_t) DisplaceCompositeOp, MagickFalse },
724     { "Dissolve", (ssize_t) DissolveCompositeOp, MagickFalse },
725     { "Distort", (ssize_t) DistortCompositeOp, MagickFalse },
726     { "DstAtop", (ssize_t) DstAtopCompositeOp, MagickFalse },
727     { "DstIn", (ssize_t) DstInCompositeOp, MagickFalse },
728     { "DstOut", (ssize_t) DstOutCompositeOp, MagickFalse },
729     { "DstOver", (ssize_t) DstOverCompositeOp, MagickFalse },
730     { "Dst", (ssize_t) DstCompositeOp, MagickFalse },
731     { "Exclusion", (ssize_t) ExclusionCompositeOp, MagickFalse },
732     { "HardLight", (ssize_t) HardLightCompositeOp, MagickFalse },
733     { "Hue", (ssize_t) HueCompositeOp, MagickFalse },
734     { "In", (ssize_t) InCompositeOp, MagickFalse },
735     { "Lighten", (ssize_t) LightenCompositeOp, MagickFalse },
736     { "LinearBurn", (ssize_t) LinearBurnCompositeOp, MagickFalse },
737     { "LinearDodge", (ssize_t) LinearDodgeCompositeOp, MagickFalse },
738     { "LinearLight", (ssize_t) LinearLightCompositeOp, MagickFalse },
739     { "Luminize", (ssize_t) LuminizeCompositeOp, MagickFalse },
740     { "Mathematics", (ssize_t) MathematicsCompositeOp, MagickFalse },
741     { "Minus", (ssize_t) MinusCompositeOp, MagickFalse },
742     { "Modulate", (ssize_t) ModulateCompositeOp, MagickFalse },
743     { "ModulusAdd", (ssize_t) ModulusAddCompositeOp, MagickFalse },
744     { "ModulusSubtract", (ssize_t) ModulusSubtractCompositeOp, MagickFalse },
745     { "Multiply", (ssize_t) MultiplyCompositeOp, MagickFalse },
746     { "None", (ssize_t) NoCompositeOp, MagickFalse },
747     { "Out", (ssize_t) OutCompositeOp, MagickFalse },
748     { "Overlay", (ssize_t) OverlayCompositeOp, MagickFalse },
749     { "Over", (ssize_t) OverCompositeOp, MagickFalse },
750     { "PegtopLight", (ssize_t) PegtopLightCompositeOp, MagickFalse },
751     { "PinLight", (ssize_t) PinLightCompositeOp, MagickFalse },
752     { "Plus", (ssize_t) PlusCompositeOp, MagickFalse },
753     { "Replace", (ssize_t) ReplaceCompositeOp, MagickFalse },
754     { "Saturate", (ssize_t) SaturateCompositeOp, MagickFalse },
755     { "Screen", (ssize_t) ScreenCompositeOp, MagickFalse },
756     { "SoftLight", (ssize_t) SoftLightCompositeOp, MagickFalse },
757     { "Src", (ssize_t) SrcCompositeOp, MagickFalse },
758     { "SrcAtop", (ssize_t) SrcAtopCompositeOp, MagickFalse },
759     { "SrcIn", (ssize_t) SrcInCompositeOp, MagickFalse },
760     { "SrcOut", (ssize_t) SrcOutCompositeOp, MagickFalse },
761     { "SrcOver", (ssize_t) SrcOverCompositeOp, MagickFalse },
762     { "Src", (ssize_t) SrcCompositeOp, MagickFalse },
763     { "VividLight", (ssize_t) VividLightCompositeOp, MagickFalse },
764     { "Xor", (ssize_t) XorCompositeOp, MagickFalse },
765     { "Add", (ssize_t) AddCompositeOp, MagickTrue }, /* deprecate */
766     { "Subtract", (ssize_t) SubtractCompositeOp, MagickTrue }, /* deprecate */
767     { "Threshold", (ssize_t) ThresholdCompositeOp, MagickTrue }, /* deprecate */
768     { (char *) NULL, (ssize_t) UndefinedCompositeOp, MagickFalse }
769   },
770   CompressOptions[] =
771   {
772     { "Undefined", (ssize_t) UndefinedCompression, MagickTrue },
773     { "B44", (ssize_t) B44Compression, MagickFalse },
774     { "B44A", (ssize_t) B44ACompression, MagickFalse },
775     { "BZip", (ssize_t) BZipCompression, MagickFalse },
776     { "DXT1", (ssize_t) DXT1Compression, MagickFalse },
777     { "DXT3", (ssize_t) DXT3Compression, MagickFalse },
778     { "DXT5", (ssize_t) DXT5Compression, MagickFalse },
779     { "Fax", (ssize_t) FaxCompression, MagickFalse },
780     { "Group4", (ssize_t) Group4Compression, MagickFalse },
781     { "JPEG", (ssize_t) JPEGCompression, MagickFalse },
782     { "JPEG2000", (ssize_t) JPEG2000Compression, MagickFalse },
783     { "Lossless", (ssize_t) LosslessJPEGCompression, MagickFalse },
784     { "LosslessJPEG", (ssize_t) LosslessJPEGCompression, MagickFalse },
785     { "LZW", (ssize_t) LZWCompression, MagickFalse },
786     { "None", (ssize_t) NoCompression, MagickFalse },
787     { "Piz", (ssize_t) PizCompression, MagickFalse },
788     { "Pxr24", (ssize_t) Pxr24Compression, MagickFalse },
789     { "RLE", (ssize_t) RLECompression, MagickFalse },
790     { "Zip", (ssize_t) ZipCompression, MagickFalse },
791     { "RunlengthEncoded", (ssize_t) RLECompression, MagickFalse },
792     { "ZipS", (ssize_t) ZipSCompression, MagickFalse },
793     { (char *) NULL, (ssize_t) UndefinedCompression, MagickFalse }
794   },
795   ColorspaceOptions[] =
796   {
797     { "Undefined", (ssize_t) UndefinedColorspace, MagickTrue },
798     { "CMY", (ssize_t) CMYColorspace, MagickFalse },
799     { "CMYK", (ssize_t) CMYKColorspace, MagickFalse },
800     { "Gray", (ssize_t) GRAYColorspace, MagickFalse },
801     { "HSB", (ssize_t) HSBColorspace, MagickFalse },
802     { "HSL", (ssize_t) HSLColorspace, MagickFalse },
803     { "HWB", (ssize_t) HWBColorspace, MagickFalse },
804     { "Lab", (ssize_t) LabColorspace, MagickFalse },
805     { "Log", (ssize_t) LogColorspace, MagickFalse },
806     { "OHTA", (ssize_t) OHTAColorspace, MagickFalse },
807     { "Rec601Luma", (ssize_t) Rec601LumaColorspace, MagickFalse },
808     { "Rec601YCbCr", (ssize_t) Rec601YCbCrColorspace, MagickFalse },
809     { "Rec709Luma", (ssize_t) Rec709LumaColorspace, MagickFalse },
810     { "Rec709YCbCr", (ssize_t) Rec709YCbCrColorspace, MagickFalse },
811     { "RGB", (ssize_t) RGBColorspace, MagickFalse },
812     { "sRGB", (ssize_t) sRGBColorspace, MagickFalse },
813     { "Transparent", (ssize_t) TransparentColorspace, MagickFalse },
814     { "XYZ", (ssize_t) XYZColorspace, MagickFalse },
815     { "YCbCr", (ssize_t) YCbCrColorspace, MagickFalse },
816     { "YCC", (ssize_t) YCCColorspace, MagickFalse },
817     { "YIQ", (ssize_t) YIQColorspace, MagickFalse },
818     { "YPbPr", (ssize_t) YPbPrColorspace, MagickFalse },
819     { "YUV", (ssize_t) YUVColorspace, MagickFalse },
820     { (char *) NULL, (ssize_t) UndefinedColorspace, MagickFalse }
821   },
822   DataTypeOptions[] =
823   {
824     { "Undefined", (ssize_t) UndefinedData, MagickTrue },
825     { "Byte", (ssize_t) ByteData, MagickFalse },
826     { "Long", (ssize_t) LongData, MagickFalse },
827     { "Short", (ssize_t) ShortData, MagickFalse },
828     { "String", (ssize_t) StringData, MagickFalse },
829     { (char *) NULL, (ssize_t) UndefinedData, MagickFalse }
830   },
831   DecorateOptions[] =
832   {
833     { "Undefined", (ssize_t) UndefinedDecoration, MagickTrue },
834     { "LineThrough", (ssize_t) LineThroughDecoration, MagickFalse },
835     { "None", (ssize_t) NoDecoration, MagickFalse },
836     { "Overline", (ssize_t) OverlineDecoration, MagickFalse },
837     { "Underline", (ssize_t) UnderlineDecoration, MagickFalse },
838     { (char *) NULL, (ssize_t) UndefinedDecoration, MagickFalse }
839   },
840   DirectionOptions[] =
841   {
842     { "Undefined", (ssize_t) UndefinedDirection, MagickTrue },
843     { "right-to-left", (ssize_t) RightToLeftDirection, MagickFalse },
844     { "left-to-right", (ssize_t) LeftToRightDirection, MagickFalse },
845     { (char *) NULL, (ssize_t) UndefinedDirection, MagickFalse }
846   },
847   DisposeOptions[] =
848   {
849     { "Undefined", (ssize_t) UndefinedDispose, MagickTrue },
850     { "Background", (ssize_t) BackgroundDispose, MagickFalse },
851     { "None", (ssize_t) NoneDispose, MagickFalse },
852     { "Previous", (ssize_t) PreviousDispose, MagickFalse },
853     { "Undefined", (ssize_t) UndefinedDispose, MagickFalse },
854     { "0", (ssize_t) UndefinedDispose, MagickFalse },
855     { "1", (ssize_t) NoneDispose, MagickFalse },
856     { "2", (ssize_t) BackgroundDispose, MagickFalse },
857     { "3", (ssize_t) PreviousDispose, MagickFalse },
858     { (char *) NULL, (ssize_t) UndefinedDispose, MagickFalse }
859   },
860   DistortOptions[] =
861   {
862     { "Undefined", (ssize_t) UndefinedDistortion, MagickTrue },
863     { "Affine", (ssize_t) AffineDistortion, MagickFalse },
864     { "AffineProjection", (ssize_t) AffineProjectionDistortion, MagickFalse },
865     { "ScaleRotateTranslate", (ssize_t) ScaleRotateTranslateDistortion, MagickFalse },
866     { "SRT", (ssize_t) ScaleRotateTranslateDistortion, MagickFalse },
867     { "Perspective", (ssize_t) PerspectiveDistortion, MagickFalse },
868     { "PerspectiveProjection", (ssize_t) PerspectiveProjectionDistortion, MagickFalse },
869     { "Bilinear", (ssize_t) BilinearForwardDistortion, MagickTrue },
870     { "BilinearForward", (ssize_t) BilinearForwardDistortion, MagickFalse },
871     { "BilinearReverse", (ssize_t) BilinearReverseDistortion, MagickFalse },
872     { "Polynomial", (ssize_t) PolynomialDistortion, MagickFalse },
873     { "Arc", (ssize_t) ArcDistortion, MagickFalse },
874     { "Polar", (ssize_t) PolarDistortion, MagickFalse },
875     { "DePolar", (ssize_t) DePolarDistortion, MagickFalse },
876     { "Barrel", (ssize_t) BarrelDistortion, MagickFalse },
877     { "BarrelInverse", (ssize_t) BarrelInverseDistortion, MagickFalse },
878     { "Shepards", (ssize_t) ShepardsDistortion, MagickFalse },
879     { (char *) NULL, (ssize_t) UndefinedDistortion, MagickFalse }
880   },
881   DitherOptions[] =
882   {
883     { "Undefined", (ssize_t) UndefinedDitherMethod, MagickTrue },
884     { "None", (ssize_t) NoDitherMethod, MagickFalse },
885     { "FloydSteinberg", (ssize_t) FloydSteinbergDitherMethod, MagickFalse },
886     { "Riemersma", (ssize_t) RiemersmaDitherMethod, MagickFalse },
887     { (char *) NULL, (ssize_t) UndefinedEndian, MagickFalse }
888   },
889   EndianOptions[] =
890   {
891     { "Undefined", (ssize_t) UndefinedEndian, MagickTrue },
892     { "LSB", (ssize_t) LSBEndian, MagickFalse },
893     { "MSB", (ssize_t) MSBEndian, MagickFalse },
894     { (char *) NULL, (ssize_t) UndefinedEndian, MagickFalse }
895   },
896   EvaluateOptions[] =
897   {
898     { "Undefined", (ssize_t) UndefinedEvaluateOperator, MagickTrue },
899     { "Abs", (ssize_t) AbsEvaluateOperator, MagickFalse },
900     { "Add", (ssize_t) AddEvaluateOperator, MagickFalse },
901     { "AddModulus", (ssize_t) AddModulusEvaluateOperator, MagickFalse },
902     { "And", (ssize_t) AndEvaluateOperator, MagickFalse },
903     { "Cos", (ssize_t) CosineEvaluateOperator, MagickFalse },
904     { "Cosine", (ssize_t) CosineEvaluateOperator, MagickFalse },
905     { "Divide", (ssize_t) DivideEvaluateOperator, MagickFalse },
906     { "Exp", (ssize_t) ExponentialEvaluateOperator, MagickFalse },
907     { "Exponential", (ssize_t) ExponentialEvaluateOperator, MagickFalse },
908     { "GaussianNoise", (ssize_t) GaussianNoiseEvaluateOperator, MagickFalse },
909     { "ImpulseNoise", (ssize_t) ImpulseNoiseEvaluateOperator, MagickFalse },
910     { "LaplacianNoise", (ssize_t) LaplacianNoiseEvaluateOperator, MagickFalse },
911     { "LeftShift", (ssize_t) LeftShiftEvaluateOperator, MagickFalse },
912     { "Log", (ssize_t) LogEvaluateOperator, MagickFalse },
913     { "Max", (ssize_t) MaxEvaluateOperator, MagickFalse },
914     { "Mean", (ssize_t) MeanEvaluateOperator, MagickFalse },
915     { "Median", (ssize_t) MedianEvaluateOperator, MagickFalse },
916     { "Min", (ssize_t) MinEvaluateOperator, MagickFalse },
917     { "MultiplicativeNoise", (ssize_t) MultiplicativeNoiseEvaluateOperator, MagickFalse },
918     { "Multiply", (ssize_t) MultiplyEvaluateOperator, MagickFalse },
919     { "Or", (ssize_t) OrEvaluateOperator, MagickFalse },
920     { "PoissonNoise", (ssize_t) PoissonNoiseEvaluateOperator, MagickFalse },
921     { "Pow", (ssize_t) PowEvaluateOperator, MagickFalse },
922     { "RightShift", (ssize_t) RightShiftEvaluateOperator, MagickFalse },
923     { "Set", (ssize_t) SetEvaluateOperator, MagickFalse },
924     { "Sin", (ssize_t) SineEvaluateOperator, MagickFalse },
925     { "Sine", (ssize_t) SineEvaluateOperator, MagickFalse },
926     { "Subtract", (ssize_t) SubtractEvaluateOperator, MagickFalse },
927     { "Threshold", (ssize_t) ThresholdEvaluateOperator, MagickFalse },
928     { "ThresholdBlack", (ssize_t) ThresholdBlackEvaluateOperator, MagickFalse },
929     { "ThresholdWhite", (ssize_t) ThresholdWhiteEvaluateOperator, MagickFalse },
930     { "UniformNoise", (ssize_t) UniformNoiseEvaluateOperator, MagickFalse },
931     { "Xor", (ssize_t) XorEvaluateOperator, MagickFalse },
932     { (char *) NULL, (ssize_t) UndefinedEvaluateOperator, MagickFalse }
933   },
934   FillRuleOptions[] =
935   {
936     { "Undefined", (ssize_t) UndefinedRule, MagickTrue },
937     { "Evenodd", (ssize_t) EvenOddRule, MagickFalse },
938     { "NonZero", (ssize_t) NonZeroRule, MagickFalse },
939     { (char *) NULL, (ssize_t) UndefinedRule, MagickFalse }
940   },
941   FilterOptions[] =
942   {
943     { "Undefined", (ssize_t) UndefinedFilter, MagickTrue },
944     { "Bartlett", (ssize_t) BartlettFilter, MagickFalse },
945     { "Blackman", (ssize_t) BlackmanFilter, MagickFalse },
946     { "Bohman", (ssize_t) BohmanFilter, MagickFalse },
947     { "Box", (ssize_t) BoxFilter, MagickFalse },
948     { "Catrom", (ssize_t) CatromFilter, MagickFalse },
949     { "Cubic", (ssize_t) CubicFilter, MagickFalse },
950     { "Gaussian", (ssize_t) GaussianFilter, MagickFalse },
951     { "Hamming", (ssize_t) HammingFilter, MagickFalse },
952     { "Hanning", (ssize_t) HanningFilter, MagickFalse },
953     { "Hermite", (ssize_t) HermiteFilter, MagickFalse },
954     { "Jinc", (ssize_t) JincFilter, MagickFalse },
955     { "Kaiser", (ssize_t) KaiserFilter, MagickFalse },
956     { "Lagrange", (ssize_t) LagrangeFilter, MagickFalse },
957     { "Lanczos", (ssize_t) LanczosFilter, MagickFalse },
958     { "LanczosSharp", (ssize_t) LanczosSharpFilter, MagickFalse },
959     { "Lanczos2", (ssize_t) Lanczos2Filter, MagickFalse },
960     { "Lanczos2Sharp", (ssize_t) Lanczos2SharpFilter, MagickFalse },
961     { "Mitchell", (ssize_t) MitchellFilter, MagickFalse },
962     { "Parzen", (ssize_t) ParzenFilter, MagickFalse },
963     { "Point", (ssize_t) PointFilter, MagickFalse },
964     { "Quadratic", (ssize_t) QuadraticFilter, MagickFalse },
965     { "Robidoux", (ssize_t) RobidouxFilter, MagickFalse },
966     { "Sinc", (ssize_t) SincFilter, MagickFalse },
967     { "SincFast", (ssize_t) SincFastFilter, MagickFalse },
968     { "Triangle", (ssize_t) TriangleFilter, MagickFalse },
969     { "Welsh", (ssize_t) WelshFilter, MagickFalse },
970     /* For backward compatibility - must be after "Jinc" */
971     { "Bessel", (ssize_t) JincFilter, MagickTrue },
972     { (char *) NULL, (ssize_t) UndefinedFilter, MagickFalse }
973   },
974   FunctionOptions[] =
975   {
976     { "Undefined", (ssize_t) UndefinedFunction, MagickTrue },
977     { "Polynomial", (ssize_t) PolynomialFunction, MagickFalse },
978     { "Sinusoid", (ssize_t) SinusoidFunction, MagickFalse },
979     { "ArcSin", (ssize_t) ArcsinFunction, MagickFalse },
980     { "ArcTan", (ssize_t) ArctanFunction, MagickFalse },
981     { (char *) NULL, (ssize_t) UndefinedFunction, MagickFalse }
982   },
983   GravityOptions[] =
984   {
985     { "Undefined", (ssize_t) UndefinedGravity, MagickTrue },
986     { "None", (ssize_t) UndefinedGravity, MagickFalse },
987     { "Center", (ssize_t) CenterGravity, MagickFalse },
988     { "East", (ssize_t) EastGravity, MagickFalse },
989     { "Forget", (ssize_t) ForgetGravity, MagickFalse },
990     { "NorthEast", (ssize_t) NorthEastGravity, MagickFalse },
991     { "North", (ssize_t) NorthGravity, MagickFalse },
992     { "NorthWest", (ssize_t) NorthWestGravity, MagickFalse },
993     { "SouthEast", (ssize_t) SouthEastGravity, MagickFalse },
994     { "South", (ssize_t) SouthGravity, MagickFalse },
995     { "SouthWest", (ssize_t) SouthWestGravity, MagickFalse },
996     { "West", (ssize_t) WestGravity, MagickFalse },
997     { "Static", (ssize_t) StaticGravity, MagickFalse },
998     { (char *) NULL, UndefinedGravity, MagickFalse }
999   },
1000   ImageListOptions[] =
1001   {
1002     { "append", MagickTrue, MagickFalse },
1003     { "affinity", MagickTrue, MagickFalse },
1004     { "average", MagickTrue, MagickFalse },
1005     { "clut", MagickTrue, MagickFalse },
1006     { "coalesce", MagickTrue, MagickFalse },
1007     { "combine", MagickTrue, MagickFalse },
1008     { "composite", MagickTrue, MagickFalse },
1009     { "crop", MagickTrue, MagickFalse },
1010     { "debug", MagickTrue, MagickFalse },
1011     { "deconstruct", MagickTrue, MagickFalse },
1012     { "delete", MagickTrue, MagickFalse },
1013     { "evaluate-sequence", MagickTrue, MagickFalse },
1014     { "fft", MagickTrue, MagickFalse },
1015     { "flatten", MagickTrue, MagickFalse },
1016     { "fx", MagickTrue, MagickFalse },
1017     { "hald-clut", MagickTrue, MagickFalse },
1018     { "ift", MagickTrue, MagickFalse },
1019     { "identify", MagickTrue, MagickFalse },
1020     { "insert", MagickTrue, MagickFalse },
1021     { "layers", MagickTrue, MagickFalse },
1022     { "limit", MagickTrue, MagickFalse },
1023     { "map", MagickTrue, MagickFalse },
1024     { "maximum", MagickTrue, MagickFalse },
1025     { "minimum", MagickTrue, MagickFalse },
1026     { "morph", MagickTrue, MagickFalse },
1027     { "mosaic", MagickTrue, MagickFalse },
1028     { "optimize", MagickTrue, MagickFalse },
1029     { "print", MagickTrue, MagickFalse },
1030     { "process", MagickTrue, MagickFalse },
1031     { "quiet", MagickTrue, MagickFalse },
1032     { "separate", MagickTrue, MagickFalse },
1033     { "swap", MagickTrue, MagickFalse },
1034     { "write", MagickTrue, MagickFalse },
1035     { (char *) NULL, MagickFalse, MagickFalse }
1036   },
1037   IntentOptions[] =
1038   {
1039     { "Undefined", (ssize_t) UndefinedIntent, MagickTrue },
1040     { "Absolute", (ssize_t) AbsoluteIntent, MagickFalse },
1041     { "Perceptual", (ssize_t) PerceptualIntent, MagickFalse },
1042     { "Relative", (ssize_t) RelativeIntent, MagickFalse },
1043     { "Saturation", (ssize_t) SaturationIntent, MagickFalse },
1044     { (char *) NULL, (ssize_t) UndefinedIntent, MagickFalse }
1045   },
1046   InterlaceOptions[] =
1047   {
1048     { "Undefined", (ssize_t) UndefinedInterlace, MagickTrue },
1049     { "Line", (ssize_t) LineInterlace, MagickFalse },
1050     { "None", (ssize_t) NoInterlace, MagickFalse },
1051     { "Plane", (ssize_t) PlaneInterlace, MagickFalse },
1052     { "Partition", (ssize_t) PartitionInterlace, MagickFalse },
1053     { "GIF", (ssize_t) GIFInterlace, MagickFalse },
1054     { "JPEG", (ssize_t) JPEGInterlace, MagickFalse },
1055     { "PNG", (ssize_t) PNGInterlace, MagickFalse },
1056     { (char *) NULL, (ssize_t) UndefinedInterlace, MagickFalse }
1057   },
1058   InterpolateOptions[] =
1059   {
1060     { "Undefined", (ssize_t) UndefinedInterpolatePixel, MagickTrue },
1061     { "Average", (ssize_t) AverageInterpolatePixel, MagickFalse },
1062     { "Bicubic", (ssize_t) BicubicInterpolatePixel, MagickFalse },
1063     { "Bilinear", (ssize_t) BilinearInterpolatePixel, MagickFalse },
1064     { "filter", (ssize_t) FilterInterpolatePixel, MagickFalse },
1065     { "Integer", (ssize_t) IntegerInterpolatePixel, MagickFalse },
1066     { "Mesh", (ssize_t) MeshInterpolatePixel, MagickFalse },
1067     { "NearestNeighbor", (ssize_t) NearestNeighborInterpolatePixel, MagickFalse },
1068     { "Spline", (ssize_t) SplineInterpolatePixel, MagickFalse },
1069     { (char *) NULL, (ssize_t) UndefinedInterpolatePixel, MagickFalse }
1070   },
1071   KernelOptions[] =
1072   {
1073     { "Undefined", (ssize_t) UndefinedKernel, MagickTrue },
1074     { "Unity", (ssize_t) UnityKernel, MagickFalse },
1075     { "Gaussian", (ssize_t) GaussianKernel, MagickFalse },
1076     { "DoG", (ssize_t) DoGKernel, MagickFalse },
1077     { "LoG", (ssize_t) LoGKernel, MagickFalse },
1078     { "Blur", (ssize_t) BlurKernel, MagickFalse },
1079     { "Comet", (ssize_t) CometKernel, MagickFalse },
1080     { "Laplacian", (ssize_t) LaplacianKernel, MagickFalse },
1081     { "Sobel", (ssize_t) SobelKernel, MagickFalse },
1082     { "FreiChen", (ssize_t) FreiChenKernel, MagickFalse },
1083     { "Roberts", (ssize_t) RobertsKernel, MagickFalse },
1084     { "Prewitt", (ssize_t) PrewittKernel, MagickFalse },
1085     { "Compass", (ssize_t) CompassKernel, MagickFalse },
1086     { "Kirsch", (ssize_t) KirschKernel, MagickFalse },
1087     { "Rectangle", (ssize_t) RectangleKernel, MagickFalse },
1088     { "Square", (ssize_t) SquareKernel, MagickFalse },
1089     { "Diamond", (ssize_t) DiamondKernel, MagickFalse },
1090     { "Disk", (ssize_t) DiskKernel, MagickFalse },
1091     { "Plus", (ssize_t) PlusKernel, MagickFalse },
1092     { "Cross", (ssize_t) CrossKernel, MagickFalse },
1093     { "Ring", (ssize_t) RingKernel, MagickFalse },
1094     { "Peaks", (ssize_t) PeaksKernel, MagickFalse },
1095     { "Edges", (ssize_t) EdgesKernel, MagickFalse },
1096     { "Corners", (ssize_t) CornersKernel, MagickFalse },
1097     { "ThinDiagonals", (ssize_t) ThinDiagonalsKernel, MagickFalse },
1098     { "LineEnds", (ssize_t) LineEndsKernel, MagickFalse },
1099     { "LineJunctions", (ssize_t) LineJunctionsKernel, MagickFalse },
1100     { "Ridges", (ssize_t) RidgesKernel, MagickFalse },
1101     { "ConvexHull", (ssize_t) ConvexHullKernel, MagickFalse },
1102     { "Skeleton", (ssize_t) SkeletonKernel, MagickFalse },
1103     { "Chebyshev", (ssize_t) ChebyshevKernel, MagickFalse },
1104     { "Manhattan", (ssize_t) ManhattanKernel, MagickFalse },
1105     { "Euclidean", (ssize_t) EuclideanKernel, MagickFalse },
1106     { "User Defined", (ssize_t) UserDefinedKernel, MagickTrue }, /* internal */
1107     { (char *) NULL, (ssize_t) UndefinedKernel, MagickFalse }
1108   },
1109   LayerOptions[] =
1110   {
1111     { "Undefined", (ssize_t) UndefinedLayer, MagickTrue },
1112     { "Coalesce", (ssize_t) CoalesceLayer, MagickFalse },
1113     { "CompareAny", (ssize_t) CompareAnyLayer, MagickFalse },
1114     { "CompareClear", (ssize_t) CompareClearLayer, MagickFalse },
1115     { "CompareOverlay", (ssize_t) CompareOverlayLayer, MagickFalse },
1116     { "Dispose", (ssize_t) DisposeLayer, MagickFalse },
1117     { "Optimize", (ssize_t) OptimizeLayer, MagickFalse },
1118     { "OptimizeFrame", (ssize_t) OptimizeImageLayer, MagickFalse },
1119     { "OptimizePlus", (ssize_t) OptimizePlusLayer, MagickFalse },
1120     { "OptimizeTransparency", (ssize_t) OptimizeTransLayer, MagickFalse },
1121     { "RemoveDups", (ssize_t) RemoveDupsLayer, MagickFalse },
1122     { "RemoveZero", (ssize_t) RemoveZeroLayer, MagickFalse },
1123     { "Composite", (ssize_t) CompositeLayer, MagickFalse },
1124     { "Merge", (ssize_t) MergeLayer, MagickFalse },
1125     { "Flatten", (ssize_t) FlattenLayer, MagickFalse },
1126     { "Mosaic", (ssize_t) MosaicLayer, MagickFalse },
1127     { "TrimBounds", (ssize_t) TrimBoundsLayer, MagickFalse },
1128     { (char *) NULL, (ssize_t) UndefinedLayer, MagickFalse }
1129   },
1130   LineCapOptions[] =
1131   {
1132     { "Undefined", (ssize_t) UndefinedCap, MagickTrue },
1133     { "Butt", (ssize_t) ButtCap, MagickFalse },
1134     { "Round", (ssize_t) RoundCap, MagickFalse },
1135     { "Square", (ssize_t) SquareCap, MagickFalse },
1136     { (char *) NULL, (ssize_t) UndefinedCap, MagickFalse }
1137   },
1138   LineJoinOptions[] =
1139   {
1140     { "Undefined", (ssize_t) UndefinedJoin, MagickTrue },
1141     { "Bevel", (ssize_t) BevelJoin, MagickFalse },
1142     { "Miter", (ssize_t) MiterJoin, MagickFalse },
1143     { "Round", (ssize_t) RoundJoin, MagickFalse },
1144     { (char *) NULL, (ssize_t) UndefinedJoin, MagickFalse }
1145   },
1146   ListOptions[] =
1147   {
1148     { "Align", (ssize_t) MagickAlignOptions, MagickFalse },
1149     { "Alpha", (ssize_t) MagickAlphaOptions, MagickFalse },
1150     { "Boolean", (ssize_t) MagickBooleanOptions, MagickFalse },
1151     { "Channel", (ssize_t) MagickChannelOptions, MagickFalse },
1152     { "Class", (ssize_t) MagickClassOptions, MagickFalse },
1153     { "ClipPath", (ssize_t) MagickClipPathOptions, MagickFalse },
1154     { "Coder", (ssize_t) MagickCoderOptions, MagickFalse },
1155     { "Color", (ssize_t) MagickColorOptions, MagickFalse },
1156     { "Colorspace", (ssize_t) MagickColorspaceOptions, MagickFalse },
1157     { "Command", (ssize_t) MagickCommandOptions, MagickFalse },
1158     { "Compose", (ssize_t) MagickComposeOptions, MagickFalse },
1159     { "Compress", (ssize_t) MagickCompressOptions, MagickFalse },
1160     { "Configure", (ssize_t) MagickConfigureOptions, MagickFalse },
1161     { "DataType", (ssize_t) MagickDataTypeOptions, MagickFalse },
1162     { "Debug", (ssize_t) MagickDebugOptions, MagickFalse },
1163     { "Decoration", (ssize_t) MagickDecorateOptions, MagickFalse },
1164     { "Delegate", (ssize_t) MagickDelegateOptions, MagickFalse },
1165     { "Direction", (ssize_t) MagickDirectionOptions, MagickFalse },
1166     { "Dispose", (ssize_t) MagickDisposeOptions, MagickFalse },
1167     { "Distort", (ssize_t) MagickDistortOptions, MagickFalse },
1168     { "Dither", (ssize_t) MagickDitherOptions, MagickFalse },
1169     { "Endian", (ssize_t) MagickEndianOptions, MagickFalse },
1170     { "Evaluate", (ssize_t) MagickEvaluateOptions, MagickFalse },
1171     { "FillRule", (ssize_t) MagickFillRuleOptions, MagickFalse },
1172     { "Filter", (ssize_t) MagickFilterOptions, MagickFalse },
1173     { "Font", (ssize_t) MagickFontOptions, MagickFalse },
1174     { "Format", (ssize_t) MagickFormatOptions, MagickFalse },
1175     { "Function", (ssize_t) MagickFunctionOptions, MagickFalse },
1176     { "Gravity", (ssize_t) MagickGravityOptions, MagickFalse },
1177     { "ImageList", (ssize_t) MagickImageListOptions, MagickFalse },
1178     { "Intent", (ssize_t) MagickIntentOptions, MagickFalse },
1179     { "Interlace", (ssize_t) MagickInterlaceOptions, MagickFalse },
1180     { "Interpolate", (ssize_t) MagickInterpolateOptions, MagickFalse },
1181     { "Kernel", (ssize_t) MagickKernelOptions, MagickFalse },
1182     { "Layers", (ssize_t) MagickLayerOptions, MagickFalse },
1183     { "LineCap", (ssize_t) MagickLineCapOptions, MagickFalse },
1184     { "LineJoin", (ssize_t) MagickLineJoinOptions, MagickFalse },
1185     { "List", (ssize_t) MagickListOptions, MagickFalse },
1186     { "Locale", (ssize_t) MagickLocaleOptions, MagickFalse },
1187     { "LogEvent", (ssize_t) MagickLogEventOptions, MagickFalse },
1188     { "Log", (ssize_t) MagickLogOptions, MagickFalse },
1189     { "Magic", (ssize_t) MagickMagicOptions, MagickFalse },
1190     { "Method", (ssize_t) MagickMethodOptions, MagickFalse },
1191     { "Metric", (ssize_t) MagickMetricOptions, MagickFalse },
1192     { "Mime", (ssize_t) MagickMimeOptions, MagickFalse },
1193     { "Mode", (ssize_t) MagickModeOptions, MagickFalse },
1194     { "Morphology", (ssize_t) MagickMorphologyOptions, MagickFalse },
1195     { "Module", (ssize_t) MagickModuleOptions, MagickFalse },
1196     { "Noise", (ssize_t) MagickNoiseOptions, MagickFalse },
1197     { "Orientation", (ssize_t) MagickOrientationOptions, MagickFalse },
1198     { "Policy", (ssize_t) MagickPolicyOptions, MagickFalse },
1199     { "PolicyDomain", (ssize_t) MagickPolicyDomainOptions, MagickFalse },
1200     { "PolicyRights", (ssize_t) MagickPolicyRightsOptions, MagickFalse },
1201     { "Preview", (ssize_t) MagickPreviewOptions, MagickFalse },
1202     { "Primitive", (ssize_t) MagickPrimitiveOptions, MagickFalse },
1203     { "QuantumFormat", (ssize_t) MagickQuantumFormatOptions, MagickFalse },
1204     { "Resource", (ssize_t) MagickResourceOptions, MagickFalse },
1205     { "SparseColor", (ssize_t) MagickSparseColorOptions, MagickFalse },
1206     { "Storage", (ssize_t) MagickStorageOptions, MagickFalse },
1207     { "Stretch", (ssize_t) MagickStretchOptions, MagickFalse },
1208     { "Style", (ssize_t) MagickStyleOptions, MagickFalse },
1209     { "Threshold", (ssize_t) MagickThresholdOptions, MagickFalse },
1210     { "Type", (ssize_t) MagickTypeOptions, MagickFalse },
1211     { "Units", (ssize_t) MagickResolutionOptions, MagickFalse },
1212     { "Undefined", (ssize_t) MagickUndefinedOptions, MagickTrue },
1213     { "Validate", (ssize_t) MagickValidateOptions, MagickFalse },
1214     { "VirtualPixel", (ssize_t) MagickVirtualPixelOptions, MagickFalse },
1215     { (char *) NULL, (ssize_t) MagickUndefinedOptions, MagickFalse }
1216   },
1217   LogEventOptions[] =
1218   {
1219     { "Undefined", (ssize_t) UndefinedEvents, MagickTrue },
1220     { "All", (ssize_t) (AllEvents &~ TraceEvent), MagickFalse },
1221     { "Annotate", (ssize_t) AnnotateEvent, MagickFalse },
1222     { "Blob", (ssize_t) BlobEvent, MagickFalse },
1223     { "Cache", (ssize_t) CacheEvent, MagickFalse },
1224     { "Coder", (ssize_t) CoderEvent, MagickFalse },
1225     { "Configure", (ssize_t) ConfigureEvent, MagickFalse },
1226     { "Deprecate", (ssize_t) DeprecateEvent, MagickFalse },
1227     { "Draw", (ssize_t) DrawEvent, MagickFalse },
1228     { "Exception", (ssize_t) ExceptionEvent, MagickFalse },
1229     { "Locale", (ssize_t) LocaleEvent, MagickFalse },
1230     { "Module", (ssize_t) ModuleEvent, MagickFalse },
1231     { "None", (ssize_t) NoEvents, MagickFalse },
1232     { "Policy", (ssize_t) PolicyEvent, MagickFalse },
1233     { "Resource", (ssize_t) ResourceEvent, MagickFalse },
1234     { "Trace", (ssize_t) TraceEvent, MagickFalse },
1235     { "Transform", (ssize_t) TransformEvent, MagickFalse },
1236     { "User", (ssize_t) UserEvent, MagickFalse },
1237     { "Wand", (ssize_t) WandEvent, MagickFalse },
1238     { "X11", (ssize_t) X11Event, MagickFalse },
1239     { (char *) NULL, (ssize_t) UndefinedEvents, MagickFalse }
1240   },
1241   MetricOptions[] =
1242   {
1243     { "Undefined", (ssize_t) UndefinedMetric, MagickTrue },
1244     { "AE", (ssize_t) AbsoluteErrorMetric, MagickFalse },
1245     { "Fuzz", (ssize_t) FuzzErrorMetric, MagickFalse },
1246     { "MAE", (ssize_t) MeanAbsoluteErrorMetric, MagickFalse },
1247     { "MEPP", (ssize_t) MeanErrorPerPixelMetric, MagickFalse },
1248     { "MSE", (ssize_t) MeanSquaredErrorMetric, MagickFalse },
1249     { "NCC", (ssize_t) NormalizedCrossCorrelationErrorMetric, MagickFalse },
1250     { "PAE", (ssize_t) PeakAbsoluteErrorMetric, MagickFalse },
1251     { "PSNR", (ssize_t) PeakSignalToNoiseRatioMetric, MagickFalse },
1252     { "RMSE", (ssize_t) RootMeanSquaredErrorMetric, MagickFalse },
1253     { (char *) NULL, (ssize_t) UndefinedMetric, MagickFalse }
1254   },
1255   MethodOptions[] =
1256   {
1257     { "Undefined", (ssize_t) UndefinedMethod, MagickTrue },
1258     { "FillToBorder", (ssize_t) FillToBorderMethod, MagickFalse },
1259     { "Floodfill", (ssize_t) FloodfillMethod, MagickFalse },
1260     { "Point", (ssize_t) PointMethod, MagickFalse },
1261     { "Replace", (ssize_t) ReplaceMethod, MagickFalse },
1262     { "Reset", (ssize_t) ResetMethod, MagickFalse },
1263     { (char *) NULL, (ssize_t) UndefinedMethod, MagickFalse }
1264   },
1265   ModeOptions[] =
1266   {
1267     { "Undefined", (ssize_t) UndefinedMode, MagickTrue },
1268     { "Concatenate", (ssize_t) ConcatenateMode, MagickFalse },
1269     { "Frame", (ssize_t) FrameMode, MagickFalse },
1270     { "Unframe", (ssize_t) UnframeMode, MagickFalse },
1271     { (char *) NULL, (ssize_t) UndefinedMode, MagickFalse }
1272   },
1273   MorphologyOptions[] =
1274   {
1275     { "Undefined", (ssize_t) UndefinedMorphology, MagickTrue },
1276     { "Correlate", (ssize_t) CorrelateMorphology, MagickFalse },
1277     { "Convolve", (ssize_t) ConvolveMorphology, MagickFalse },
1278     { "Dilate", (ssize_t) DilateMorphology, MagickFalse },
1279     { "Erode", (ssize_t) ErodeMorphology, MagickFalse },
1280     { "Close", (ssize_t) CloseMorphology, MagickFalse },
1281     { "Open", (ssize_t) OpenMorphology, MagickFalse },
1282     { "DilateIntensity", (ssize_t) DilateIntensityMorphology, MagickFalse },
1283     { "ErodeIntensity", (ssize_t) ErodeIntensityMorphology, MagickFalse },
1284     { "CloseIntensity", (ssize_t) CloseIntensityMorphology, MagickFalse },
1285     { "OpenIntensity", (ssize_t) OpenIntensityMorphology, MagickFalse },
1286     { "DilateI", (ssize_t) DilateIntensityMorphology, MagickFalse },
1287     { "ErodeI", (ssize_t) ErodeIntensityMorphology, MagickFalse },
1288     { "CloseI", (ssize_t) CloseIntensityMorphology, MagickFalse },
1289     { "OpenI", (ssize_t) OpenIntensityMorphology, MagickFalse },
1290     { "Smooth", (ssize_t) SmoothMorphology, MagickFalse },
1291     { "EdgeOut", (ssize_t) EdgeOutMorphology, MagickFalse },
1292     { "EdgeIn", (ssize_t) EdgeInMorphology, MagickFalse },
1293     { "Edge", (ssize_t) EdgeMorphology, MagickFalse },
1294     { "TopHat", (ssize_t) TopHatMorphology, MagickFalse },
1295     { "BottomHat", (ssize_t) BottomHatMorphology, MagickFalse },
1296     { "Distance", (ssize_t) DistanceMorphology, MagickFalse },
1297     { "HitAndMiss", (ssize_t) HitAndMissMorphology, MagickFalse },
1298     { "Thinning", (ssize_t) ThinningMorphology, MagickFalse },
1299     { "Thicken", (ssize_t) ThickenMorphology, MagickFalse },
1300     { (char *) NULL, (ssize_t) UndefinedMorphology, MagickFalse }
1301   },
1302   NoiseOptions[] =
1303   {
1304     { "Undefined", (ssize_t) UndefinedNoise, MagickTrue },
1305     { "Gaussian", (ssize_t) (ssize_t) GaussianNoise, MagickFalse },
1306     { "Impulse", (ssize_t) ImpulseNoise, MagickFalse },
1307     { "Laplacian", (ssize_t) LaplacianNoise, MagickFalse },
1308     { "Multiplicative", (ssize_t) MultiplicativeGaussianNoise, MagickFalse },
1309     { "Poisson", (ssize_t) PoissonNoise, MagickFalse },
1310     { "Random", (ssize_t) RandomNoise, MagickFalse },
1311     { "Uniform", (ssize_t) UniformNoise, MagickFalse },
1312     { (char *) NULL, (ssize_t) UndefinedNoise, MagickFalse }
1313   },
1314   OrientationOptions[] =
1315   {
1316     { "Undefined", (ssize_t) UndefinedOrientation, MagickTrue },
1317     { "TopLeft", (ssize_t) TopLeftOrientation, MagickFalse },
1318     { "TopRight", (ssize_t) TopRightOrientation, MagickFalse },
1319     { "BottomRight", (ssize_t) BottomRightOrientation, MagickFalse },
1320     { "BottomLeft", (ssize_t) BottomLeftOrientation, MagickFalse },
1321     { "LeftTop", (ssize_t) LeftTopOrientation, MagickFalse },
1322     { "RightTop", (ssize_t) RightTopOrientation, MagickFalse },
1323     { "RightBottom", (ssize_t) RightBottomOrientation, MagickFalse },
1324     { "LeftBottom", (ssize_t) LeftBottomOrientation, MagickFalse },
1325     { (char *) NULL, (ssize_t) UndefinedOrientation, MagickFalse }
1326   },
1327   PolicyDomainOptions[] =
1328   {
1329     { "Undefined", (ssize_t) UndefinedPolicyDomain, MagickTrue },
1330     { "Coder", (ssize_t) CoderPolicyDomain, MagickFalse },
1331     { "Delegate", (ssize_t) DelegatePolicyDomain, MagickFalse },
1332     { "Filter", (ssize_t) FilterPolicyDomain, MagickFalse },
1333     { "Path", (ssize_t) PathPolicyDomain, MagickFalse },
1334     { "Resource", (ssize_t) ResourcePolicyDomain, MagickFalse },
1335     { "System", (ssize_t) SystemPolicyDomain, MagickFalse },
1336     { (char *) NULL, (ssize_t) UndefinedPolicyDomain, MagickFalse }
1337   },
1338   PolicyRightsOptions[] =
1339   {
1340     { "Undefined", (ssize_t) UndefinedPolicyRights, MagickTrue },
1341     { "None", (ssize_t) NoPolicyRights, MagickFalse },
1342     { "Read", (ssize_t) ReadPolicyRights, MagickFalse },
1343     { "Write", (ssize_t) WritePolicyRights, MagickFalse },
1344     { "Execute", (ssize_t) ExecutePolicyRights, MagickFalse },
1345     { (char *) NULL, (ssize_t) UndefinedPolicyRights, MagickFalse }
1346   },
1347   PreviewOptions[] =
1348   {
1349     { "Undefined", (ssize_t) UndefinedPreview, MagickTrue },
1350     { "AddNoise", (ssize_t) AddNoisePreview, MagickFalse },
1351     { "Blur", (ssize_t) BlurPreview, MagickFalse },
1352     { "Brightness", (ssize_t) BrightnessPreview, MagickFalse },
1353     { "Charcoal", (ssize_t) CharcoalDrawingPreview, MagickFalse },
1354     { "Despeckle", (ssize_t) DespecklePreview, MagickFalse },
1355     { "Dull", (ssize_t) DullPreview, MagickFalse },
1356     { "EdgeDetect", (ssize_t) EdgeDetectPreview, MagickFalse },
1357     { "Gamma", (ssize_t) GammaPreview, MagickFalse },
1358     { "Grayscale", (ssize_t) GrayscalePreview, MagickFalse },
1359     { "Hue", (ssize_t) HuePreview, MagickFalse },
1360     { "Implode", (ssize_t) ImplodePreview, MagickFalse },
1361     { "JPEG", (ssize_t) JPEGPreview, MagickFalse },
1362     { "OilPaint", (ssize_t) OilPaintPreview, MagickFalse },
1363     { "Quantize", (ssize_t) QuantizePreview, MagickFalse },
1364     { "Raise", (ssize_t) RaisePreview, MagickFalse },
1365     { "ReduceNoise", (ssize_t) ReduceNoisePreview, MagickFalse },
1366     { "Roll", (ssize_t) RollPreview, MagickFalse },
1367     { "Rotate", (ssize_t) RotatePreview, MagickFalse },
1368     { "Saturation", (ssize_t) SaturationPreview, MagickFalse },
1369     { "Segment", (ssize_t) SegmentPreview, MagickFalse },
1370     { "Shade", (ssize_t) ShadePreview, MagickFalse },
1371     { "Sharpen", (ssize_t) SharpenPreview, MagickFalse },
1372     { "Shear", (ssize_t) ShearPreview, MagickFalse },
1373     { "Solarize", (ssize_t) SolarizePreview, MagickFalse },
1374     { "Spiff", (ssize_t) SpiffPreview, MagickFalse },
1375     { "Spread", (ssize_t) SpreadPreview, MagickFalse },
1376     { "Swirl", (ssize_t) SwirlPreview, MagickFalse },
1377     { "Threshold", (ssize_t) ThresholdPreview, MagickFalse },
1378     { "Wave", (ssize_t) WavePreview, MagickFalse },
1379     { (char *) NULL, (ssize_t) UndefinedPreview, MagickFalse }
1380   },
1381   PrimitiveOptions[] =
1382   {
1383     { "Undefined", (ssize_t) UndefinedPrimitive, MagickTrue },
1384     { "Arc", (ssize_t) ArcPrimitive, MagickFalse },
1385     { "Bezier", (ssize_t) BezierPrimitive, MagickFalse },
1386     { "Circle", (ssize_t) CirclePrimitive, MagickFalse },
1387     { "Color", (ssize_t) ColorPrimitive, MagickFalse },
1388     { "Ellipse", (ssize_t) EllipsePrimitive, MagickFalse },
1389     { "Image", (ssize_t) ImagePrimitive, MagickFalse },
1390     { "Line", (ssize_t) LinePrimitive, MagickFalse },
1391     { "Matte", (ssize_t) MattePrimitive, MagickFalse },
1392     { "Path", (ssize_t) PathPrimitive, MagickFalse },
1393     { "Point", (ssize_t) PointPrimitive, MagickFalse },
1394     { "Polygon", (ssize_t) PolygonPrimitive, MagickFalse },
1395     { "Polyline", (ssize_t) PolylinePrimitive, MagickFalse },
1396     { "Rectangle", (ssize_t) RectanglePrimitive, MagickFalse },
1397     { "roundRectangle", (ssize_t) RoundRectanglePrimitive, MagickFalse },
1398     { "Text", (ssize_t) TextPrimitive, MagickFalse },
1399     { (char *) NULL, (ssize_t) UndefinedPrimitive, MagickFalse }
1400   },
1401   QuantumFormatOptions[] =
1402   {
1403     { "Undefined", (ssize_t) UndefinedQuantumFormat, MagickTrue },
1404     { "FloatingPoint", (ssize_t) FloatingPointQuantumFormat, MagickFalse },
1405     { "Signed", (ssize_t) SignedQuantumFormat, MagickFalse },
1406     { "Unsigned", (ssize_t) UnsignedQuantumFormat, MagickFalse },
1407     { (char *) NULL, (ssize_t) FloatingPointQuantumFormat, MagickFalse }
1408   },
1409   ResolutionOptions[] =
1410   {
1411     { "Undefined", (ssize_t) UndefinedResolution, MagickTrue },
1412     { "PixelsPerInch", (ssize_t) PixelsPerInchResolution, MagickFalse },
1413     { "PixelsPerCentimeter", (ssize_t) PixelsPerCentimeterResolution, MagickFalse },
1414     { (char *) NULL, (ssize_t) UndefinedResolution, MagickFalse }
1415   },
1416   ResourceOptions[] =
1417   {
1418     { "Undefined", (ssize_t) UndefinedResource, MagickTrue },
1419     { "Area", (ssize_t) AreaResource, MagickFalse },
1420     { "Disk", (ssize_t) DiskResource, MagickFalse },
1421     { "File", (ssize_t) FileResource, MagickFalse },
1422     { "Map", (ssize_t) MapResource, MagickFalse },
1423     { "Memory", (ssize_t) MemoryResource, MagickFalse },
1424     { "Thread", (ssize_t) ThreadResource, MagickFalse },
1425     { "Time", (ssize_t) TimeResource, MagickFalse },
1426     { (char *) NULL, (ssize_t) UndefinedResource, MagickFalse }
1427   },
1428   SparseColorOptions[] =
1429   {
1430     { "Undefined", (ssize_t) UndefinedDistortion, MagickTrue },
1431     { "Barycentric", (ssize_t) BarycentricColorInterpolate, MagickFalse },
1432     { "Bilinear", (ssize_t) BilinearColorInterpolate, MagickFalse },
1433     { "Shepards", (ssize_t) ShepardsColorInterpolate, MagickFalse },
1434     { "Voronoi", (ssize_t) VoronoiColorInterpolate, MagickFalse },
1435     { (char *) NULL, (ssize_t) UndefinedResource, MagickFalse }
1436   },
1437   StorageOptions[] =
1438   {
1439     { "Undefined", (ssize_t) UndefinedPixel, MagickTrue },
1440     { "Char", (ssize_t) CharPixel, MagickFalse },
1441     { "Double", (ssize_t) DoublePixel, MagickFalse },
1442     { "Float", (ssize_t) FloatPixel, MagickFalse },
1443     { "Integer", (ssize_t) IntegerPixel, MagickFalse },
1444     { "Long", (ssize_t) LongPixel, MagickFalse },
1445     { "Quantum", (ssize_t) QuantumPixel, MagickFalse },
1446     { "Short", (ssize_t) ShortPixel, MagickFalse },
1447     { (char *) NULL, (ssize_t) UndefinedResource, MagickFalse }
1448   },
1449   StretchOptions[] =
1450   {
1451     { "Undefined", (ssize_t) UndefinedStretch, MagickTrue },
1452     { "Any", (ssize_t) AnyStretch, MagickFalse },
1453     { "Condensed", (ssize_t) CondensedStretch, MagickFalse },
1454     { "Expanded", (ssize_t) ExpandedStretch, MagickFalse },
1455     { "ExtraCondensed", (ssize_t) ExtraCondensedStretch, MagickFalse },
1456     { "ExtraExpanded", (ssize_t) ExtraExpandedStretch, MagickFalse },
1457     { "Normal", (ssize_t) NormalStretch, MagickFalse },
1458     { "SemiCondensed", (ssize_t) SemiCondensedStretch, MagickFalse },
1459     { "SemiExpanded", (ssize_t) SemiExpandedStretch, MagickFalse },
1460     { "UltraCondensed", (ssize_t) UltraCondensedStretch, MagickFalse },
1461     { "UltraExpanded", (ssize_t) UltraExpandedStretch, MagickFalse },
1462     { (char *) NULL, (ssize_t) UndefinedStretch, MagickFalse }
1463   },
1464   StyleOptions[] =
1465   {
1466     { "Undefined", (ssize_t) UndefinedStyle, MagickTrue },
1467     { "Any", (ssize_t) AnyStyle, MagickFalse },
1468     { "Italic", (ssize_t) ItalicStyle, MagickFalse },
1469     { "Normal", (ssize_t) NormalStyle, MagickFalse },
1470     { "Oblique", (ssize_t) ObliqueStyle, MagickFalse },
1471     { (char *) NULL, (ssize_t) UndefinedStyle, MagickFalse }
1472   },
1473   TypeOptions[] =
1474   {
1475     { "Undefined", (ssize_t) UndefinedType, MagickTrue },
1476     { "Bilevel", (ssize_t) BilevelType, MagickFalse },
1477     { "ColorSeparation", (ssize_t) ColorSeparationType, MagickFalse },
1478     { "ColorSeparationMatte", (ssize_t) ColorSeparationMatteType, MagickFalse },
1479     { "Grayscale", (ssize_t) GrayscaleType, MagickFalse },
1480     { "GrayscaleMatte", (ssize_t) GrayscaleMatteType, MagickFalse },
1481     { "Optimize", (ssize_t) OptimizeType, MagickFalse },
1482     { "Palette", (ssize_t) PaletteType, MagickFalse },
1483     { "PaletteBilevelMatte", (ssize_t) PaletteBilevelMatteType, MagickFalse },
1484     { "PaletteMatte", (ssize_t) PaletteMatteType, MagickFalse },
1485     { "TrueColorMatte", (ssize_t) TrueColorMatteType, MagickFalse },
1486     { "TrueColor", (ssize_t) TrueColorType, MagickFalse },
1487     { (char *) NULL, (ssize_t) UndefinedType, MagickFalse }
1488   },
1489   ValidateOptions[] =
1490   {
1491     { "Undefined", (ssize_t) UndefinedValidate, MagickTrue },
1492     { "All", (ssize_t) AllValidate, MagickFalse },
1493     { "Compare", (ssize_t) CompareValidate, MagickFalse },
1494     { "Composite", (ssize_t) CompositeValidate, MagickFalse },
1495     { "Convert", (ssize_t) ConvertValidate, MagickFalse },
1496     { "FormatsInMemory", (ssize_t) FormatsInMemoryValidate, MagickFalse },
1497     { "FormatsOnDisk", (ssize_t) FormatsOnDiskValidate, MagickFalse },
1498     { "Identify", (ssize_t) IdentifyValidate, MagickFalse },
1499     { "ImportExport", (ssize_t) ImportExportValidate, MagickFalse },
1500     { "Montage", (ssize_t) MontageValidate, MagickFalse },
1501     { "Stream", (ssize_t) StreamValidate, MagickFalse },
1502     { "None", (ssize_t) NoValidate, MagickFalse },
1503     { (char *) NULL, (ssize_t) UndefinedValidate, MagickFalse }
1504   },
1505   VirtualPixelOptions[] =
1506   {
1507     { "Undefined", (ssize_t) UndefinedVirtualPixelMethod, MagickTrue },
1508     { "Background", (ssize_t) BackgroundVirtualPixelMethod, MagickFalse },
1509     { "Black", (ssize_t) BlackVirtualPixelMethod, MagickFalse },
1510     { "Constant", (ssize_t) BackgroundVirtualPixelMethod, MagickTrue }, /* deprecated */
1511     { "CheckerTile", (ssize_t) CheckerTileVirtualPixelMethod, MagickFalse },
1512     { "Dither", (ssize_t) DitherVirtualPixelMethod, MagickFalse },
1513     { "Edge", (ssize_t) EdgeVirtualPixelMethod, MagickFalse },
1514     { "Gray", (ssize_t) GrayVirtualPixelMethod, MagickFalse },
1515     { "HorizontalTile", (ssize_t) HorizontalTileVirtualPixelMethod, MagickFalse },
1516     { "HorizontalTileEdge", (ssize_t) HorizontalTileEdgeVirtualPixelMethod, MagickFalse },
1517     { "Mirror", (ssize_t) MirrorVirtualPixelMethod, MagickFalse },
1518     { "Random", (ssize_t) RandomVirtualPixelMethod, MagickFalse },
1519     { "Tile", (ssize_t) TileVirtualPixelMethod, MagickFalse },
1520     { "Transparent", (ssize_t) TransparentVirtualPixelMethod, MagickFalse },
1521     { "VerticalTile", (ssize_t) VerticalTileVirtualPixelMethod, MagickFalse },
1522     { "VerticalTileEdge", (ssize_t) VerticalTileEdgeVirtualPixelMethod, MagickFalse },
1523     { "White", (ssize_t) WhiteVirtualPixelMethod, MagickFalse },
1524     { (char *) NULL, (ssize_t) UndefinedVirtualPixelMethod, MagickFalse }
1525   };
1526 \f
1527 /*
1528 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1529 %                                                                             %
1530 %                                                                             %
1531 %                                                                             %
1532 %   C l o n e I m a g e O p t i o n s                                         %
1533 %                                                                             %
1534 %                                                                             %
1535 %                                                                             %
1536 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1537 %
1538 %  CloneImageOptions() clones one or more image options.
1539 %
1540 %  The format of the CloneImageOptions method is:
1541 %
1542 %      MagickBooleanType CloneImageOptions(ImageInfo *image_info,
1543 %        const ImageInfo *clone_info)
1544 %
1545 %  A description of each parameter follows:
1546 %
1547 %    o image_info: the image info.
1548 %
1549 %    o clone_info: the clone image info.
1550 %
1551 */
1552 MagickExport MagickBooleanType CloneImageOptions(ImageInfo *image_info,
1553   const ImageInfo *clone_info)
1554 {
1555   assert(image_info != (ImageInfo *) NULL);
1556   assert(image_info->signature == MagickSignature);
1557   if (image_info->debug != MagickFalse)
1558     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
1559       image_info->filename);
1560   assert(clone_info != (const ImageInfo *) NULL);
1561   assert(clone_info->signature == MagickSignature);
1562   if (clone_info->options != (void *) NULL)
1563     image_info->options=CloneSplayTree((SplayTreeInfo *) clone_info->options,
1564       (void *(*)(void *)) ConstantString,(void *(*)(void *)) ConstantString);
1565   return(MagickTrue);
1566 }
1567 \f
1568 /*
1569 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1570 %                                                                             %
1571 %                                                                             %
1572 %                                                                             %
1573 %   D e f i n e I m a g e O p t i o n                                         %
1574 %                                                                             %
1575 %                                                                             %
1576 %                                                                             %
1577 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1578 %
1579 %  DefineImageOption() associates a key/value pair with an image option.
1580 %
1581 %  The format of the DefineImageOption method is:
1582 %
1583 %      MagickBooleanType DefineImageOption(ImageInfo *image_info,
1584 %        const char *option)
1585 %
1586 %  A description of each parameter follows:
1587 %
1588 %    o image_info: the image info.
1589 %
1590 %    o option: the image option.
1591 %
1592 */
1593 MagickExport MagickBooleanType DefineImageOption(ImageInfo *image_info,
1594   const char *option)
1595 {
1596   char
1597     key[MaxTextExtent],
1598     value[MaxTextExtent];
1599
1600   register char
1601     *p;
1602
1603   assert(image_info != (ImageInfo *) NULL);
1604   assert(option != (const char *) NULL);
1605   (void) CopyMagickString(key,option,MaxTextExtent);
1606   for (p=key; *p != '\0'; p++)
1607     if (*p == '=')
1608       break;
1609   *value='\0';
1610   if (*p == '=')
1611     (void) CopyMagickString(value,p+1,MaxTextExtent);
1612   *p='\0';
1613   return(SetImageOption(image_info,key,value));
1614 }
1615 \f
1616 /*
1617 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1618 %                                                                             %
1619 %                                                                             %
1620 %                                                                             %
1621 %   D e l e t e I m a g e O p t i o n                                         %
1622 %                                                                             %
1623 %                                                                             %
1624 %                                                                             %
1625 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1626 %
1627 %  DeleteImageOption() deletes an key from the image map.
1628 %
1629 %  The format of the DeleteImageOption method is:
1630 %
1631 %      MagickBooleanType DeleteImageOption(ImageInfo *image_info,
1632 %        const char *key)
1633 %
1634 %  A description of each parameter follows:
1635 %
1636 %    o image_info: the image info.
1637 %
1638 %    o option: the image option.
1639 %
1640 */
1641 MagickExport MagickBooleanType DeleteImageOption(ImageInfo *image_info,
1642   const char *option)
1643 {
1644   assert(image_info != (ImageInfo *) NULL);
1645   assert(image_info->signature == MagickSignature);
1646   if (image_info->debug != MagickFalse)
1647     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
1648       image_info->filename);
1649   if (image_info->options == (void *) NULL)
1650     return(MagickFalse);
1651   return(DeleteNodeFromSplayTree((SplayTreeInfo *) image_info->options,option));
1652 }
1653 \f
1654 /*
1655 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1656 %                                                                             %
1657 %                                                                             %
1658 %                                                                             %
1659 %   D e s t r o y I m a g e O p t i o n s                                     %
1660 %                                                                             %
1661 %                                                                             %
1662 %                                                                             %
1663 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1664 %
1665 %  DestroyImageOptions() releases memory associated with image option values.
1666 %
1667 %  The format of the DestroyDefines method is:
1668 %
1669 %      void DestroyImageOptions(ImageInfo *image_info)
1670 %
1671 %  A description of each parameter follows:
1672 %
1673 %    o image_info: the image info.
1674 %
1675 */
1676 MagickExport void DestroyImageOptions(ImageInfo *image_info)
1677 {
1678   assert(image_info != (ImageInfo *) NULL);
1679   assert(image_info->signature == MagickSignature);
1680   if (image_info->debug != MagickFalse)
1681     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
1682       image_info->filename);
1683   if (image_info->options != (void *) NULL)
1684     image_info->options=DestroySplayTree((SplayTreeInfo *) image_info->options);
1685 }
1686 \f
1687 /*
1688 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1689 %                                                                             %
1690 %                                                                             %
1691 %                                                                             %
1692 %   G e t I m a g e O p t i o n                                               %
1693 %                                                                             %
1694 %                                                                             %
1695 %                                                                             %
1696 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1697 %
1698 %  GetImageOption() gets a value associated with an image option.
1699 %
1700 %  The format of the GetImageOption method is:
1701 %
1702 %      const char *GetImageOption(const ImageInfo *image_info,
1703 %        const char *key)
1704 %
1705 %  A description of each parameter follows:
1706 %
1707 %    o image_info: the image info.
1708 %
1709 %    o key: the key.
1710 %
1711 */
1712 MagickExport const char *GetImageOption(const ImageInfo *image_info,
1713   const char *key)
1714 {
1715   const char
1716     *option;
1717
1718   assert(image_info != (ImageInfo *) NULL);
1719   assert(image_info->signature == MagickSignature);
1720   if (image_info->debug != MagickFalse)
1721     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
1722       image_info->filename);
1723   if (image_info->options == (void *) NULL)
1724     return((const char *) NULL);
1725   option=(const char *) GetValueFromSplayTree((SplayTreeInfo *)
1726     image_info->options,key);
1727   return(option);
1728 }
1729 \f
1730 /*
1731 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1732 %                                                                             %
1733 %                                                                             %
1734 %                                                                             %
1735 %   G e t M a g i c k O p t i o n s                                           %
1736 %                                                                             %
1737 %                                                                             %
1738 %                                                                             %
1739 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1740 %
1741 %  GetMagickOptions() returns a list of values.
1742 %
1743 %  The format of the GetMagickOptions method is:
1744 %
1745 %      const char **GetMagickOptions(const MagickOption value)
1746 %
1747 %  A description of each parameter follows:
1748 %
1749 %    o value: the value.
1750 %
1751 */
1752
1753 static const OptionInfo *GetOptionInfo(const MagickOption option)
1754 {
1755   switch (option)
1756   {
1757     case MagickAlignOptions: return(AlignOptions);
1758     case MagickAlphaOptions: return(AlphaOptions);
1759     case MagickBooleanOptions: return(BooleanOptions);
1760     case MagickChannelOptions: return(ChannelOptions);
1761     case MagickClassOptions: return(ClassOptions);
1762     case MagickClipPathOptions: return(ClipPathOptions);
1763     case MagickColorspaceOptions: return(ColorspaceOptions);
1764     case MagickCommandOptions: return(CommandOptions);
1765     case MagickComposeOptions: return(ComposeOptions);
1766     case MagickCompressOptions: return(CompressOptions);
1767     case MagickDataTypeOptions: return(DataTypeOptions);
1768     case MagickDebugOptions: return(LogEventOptions);
1769     case MagickDecorateOptions: return(DecorateOptions);
1770     case MagickDirectionOptions: return(DirectionOptions);
1771     case MagickDisposeOptions: return(DisposeOptions);
1772     case MagickDistortOptions: return(DistortOptions);
1773     case MagickDitherOptions: return(DitherOptions);
1774     case MagickEndianOptions: return(EndianOptions);
1775     case MagickEvaluateOptions: return(EvaluateOptions);
1776     case MagickFillRuleOptions: return(FillRuleOptions);
1777     case MagickFilterOptions: return(FilterOptions);
1778     case MagickFunctionOptions: return(FunctionOptions);
1779     case MagickGravityOptions: return(GravityOptions);
1780     case MagickImageListOptions: return(ImageListOptions);
1781     case MagickIntentOptions: return(IntentOptions);
1782     case MagickInterlaceOptions: return(InterlaceOptions);
1783     case MagickInterpolateOptions: return(InterpolateOptions);
1784     case MagickKernelOptions: return(KernelOptions);
1785     case MagickLayerOptions: return(LayerOptions);
1786     case MagickLineCapOptions: return(LineCapOptions);
1787     case MagickLineJoinOptions: return(LineJoinOptions);
1788     case MagickListOptions: return(ListOptions);
1789     case MagickLogEventOptions: return(LogEventOptions);
1790     case MagickMetricOptions: return(MetricOptions);
1791     case MagickMethodOptions: return(MethodOptions);
1792     case MagickModeOptions: return(ModeOptions);
1793     case MagickMorphologyOptions: return(MorphologyOptions);
1794     case MagickNoiseOptions: return(NoiseOptions);
1795     case MagickOrientationOptions: return(OrientationOptions);
1796     case MagickPolicyDomainOptions: return(PolicyDomainOptions);
1797     case MagickPolicyRightsOptions: return(PolicyRightsOptions);
1798     case MagickPreviewOptions: return(PreviewOptions);
1799     case MagickPrimitiveOptions: return(PrimitiveOptions);
1800     case MagickQuantumFormatOptions: return(QuantumFormatOptions);
1801     case MagickResolutionOptions: return(ResolutionOptions);
1802     case MagickResourceOptions: return(ResourceOptions);
1803     case MagickSparseColorOptions: return(SparseColorOptions);
1804     case MagickStorageOptions: return(StorageOptions);
1805     case MagickStretchOptions: return(StretchOptions);
1806     case MagickStyleOptions: return(StyleOptions);
1807     case MagickTypeOptions: return(TypeOptions);
1808     case MagickValidateOptions: return(ValidateOptions);
1809     case MagickVirtualPixelOptions: return(VirtualPixelOptions);
1810     default: break;
1811   }
1812   return((const OptionInfo *) NULL);
1813 }
1814
1815 MagickExport char **GetMagickOptions(const MagickOption value)
1816 {
1817   char
1818     **values;
1819
1820   const OptionInfo
1821     *option_info;
1822
1823   register ssize_t
1824     i;
1825
1826   option_info=GetOptionInfo(value);
1827   if (option_info == (const OptionInfo *) NULL)
1828     return((char **) NULL);
1829   for (i=0; option_info[i].mnemonic != (const char *) NULL; i++) ;
1830   values=(char **) AcquireQuantumMemory((size_t) i+1UL,sizeof(*values));
1831   if (values == (char **) NULL)
1832     ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
1833   for (i=0; option_info[i].mnemonic != (const char *) NULL; i++)
1834     values[i]=AcquireString(option_info[i].mnemonic);
1835   values[i]=(char *) NULL;
1836   return(values);
1837 }
1838 \f
1839 /*
1840 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1841 %                                                                             %
1842 %                                                                             %
1843 %                                                                             %
1844 %   G e t N e x t I m a g e O p t i o n                                       %
1845 %                                                                             %
1846 %                                                                             %
1847 %                                                                             %
1848 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1849 %
1850 %  GetNextImageOption() gets the next image option value.
1851 %
1852 %  The format of the GetNextImageOption method is:
1853 %
1854 %      char *GetNextImageOption(const ImageInfo *image_info)
1855 %
1856 %  A description of each parameter follows:
1857 %
1858 %    o image_info: the image info.
1859 %
1860 */
1861 MagickExport char *GetNextImageOption(const ImageInfo *image_info)
1862 {
1863   assert(image_info != (ImageInfo *) NULL);
1864   assert(image_info->signature == MagickSignature);
1865   if (image_info->debug != MagickFalse)
1866     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
1867       image_info->filename);
1868   if (image_info->options == (void *) NULL)
1869     return((char *) NULL);
1870   return((char *) GetNextKeyInSplayTree((SplayTreeInfo *) image_info->options));
1871 }
1872 \f
1873 /*
1874 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1875 %                                                                             %
1876 %                                                                             %
1877 %                                                                             %
1878 %     I s M a g i c k O p t i o n                                             %
1879 %                                                                             %
1880 %                                                                             %
1881 %                                                                             %
1882 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1883 %
1884 %  IsMagickOption() returns MagickTrue if the option begins with a - or + and
1885 %  the first character that follows is alphanumeric.
1886 %
1887 %  The format of the IsMagickOption method is:
1888 %
1889 %      MagickBooleanType IsMagickOption(const char *option)
1890 %
1891 %  A description of each parameter follows:
1892 %
1893 %    o option: the option.
1894 %
1895 */
1896 MagickExport MagickBooleanType IsMagickOption(const char *option)
1897 {
1898   assert(option != (const char *) NULL);
1899   if ((*option != '-') && (*option != '+'))
1900     return(MagickFalse);
1901   if (strlen(option) == 1)
1902     return(MagickFalse);
1903   option++;
1904   if (isalpha((int) ((unsigned char) *option)) == 0)
1905     return(MagickFalse);
1906   return(MagickTrue);
1907 }
1908 \f
1909 /*
1910 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1911 %                                                                             %
1912 %                                                                             %
1913 %                                                                             %
1914 %   M a g i c k O p t i o n T o M n e m o n i c                               %
1915 %                                                                             %
1916 %                                                                             %
1917 %                                                                             %
1918 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1919 %
1920 %  MagickOptionToMnemonic() returns an enumerated value as a mnemonic.
1921 %
1922 %  The format of the MagickOptionToMnemonic method is:
1923 %
1924 %      const char *MagickOptionToMnemonic(const MagickOption option,
1925 %        const ssize_t type)
1926 %
1927 %  A description of each parameter follows:
1928 %
1929 %    o option: the option.
1930 %
1931 %    o type: one or more values separated by commas.
1932 %
1933 */
1934 MagickExport const char *MagickOptionToMnemonic(const MagickOption option,
1935   const ssize_t type)
1936 {
1937   const OptionInfo
1938     *option_info;
1939
1940   register ssize_t
1941     i;
1942
1943   option_info=GetOptionInfo(option);
1944   if (option_info == (const OptionInfo *) NULL)
1945     return((const char *) NULL);
1946   for (i=0; option_info[i].mnemonic != (const char *) NULL; i++)
1947     if (type == option_info[i].type)
1948       break;
1949   if (option_info[i].mnemonic == (const char *) NULL)
1950     return("undefined");
1951   return(option_info[i].mnemonic);
1952 }
1953 \f
1954 /*
1955 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1956 %                                                                             %
1957 %                                                                             %
1958 %                                                                             %
1959 %   L i s t M a g i c k O p t i o n s                                         %
1960 %                                                                             %
1961 %                                                                             %
1962 %                                                                             %
1963 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1964 %
1965 %  ListMagickOptions() lists the contents of enumerated option type(s).
1966 %
1967 %  The format of the ListMagickOptions method is:
1968 %
1969 %      MagickBooleanType ListMagickOptions(FILE *file,const MagickOption option,
1970 %        ExceptionInfo *exception)
1971 %
1972 %  A description of each parameter follows:
1973 %
1974 %    o file:  list options to this file handle.
1975 %
1976 %    o option:  list these options.
1977 %
1978 %    o exception:  return any errors or warnings in this structure.
1979 %
1980 */
1981 MagickExport MagickBooleanType ListMagickOptions(FILE *file,
1982   const MagickOption option,ExceptionInfo *magick_unused(exception))
1983 {
1984   const OptionInfo
1985     *option_info;
1986
1987   register ssize_t
1988     i;
1989
1990   if (file == (FILE *) NULL)
1991     file=stdout;
1992   option_info=GetOptionInfo(option);
1993   if (option_info == (const OptionInfo *) NULL)
1994     return(MagickFalse);
1995   for (i=0; option_info[i].mnemonic != (char *) NULL; i++)
1996   {
1997     if (option_info[i].stealth != MagickFalse)
1998       continue;
1999     (void) fprintf(file,"%s\n",option_info[i].mnemonic);
2000   }
2001   return(MagickTrue);
2002 }
2003 \f
2004 /*
2005 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2006 %                                                                             %
2007 %                                                                             %
2008 %                                                                             %
2009 %   P a r s e C h a n n e l O p t i o n                                       %
2010 %                                                                             %
2011 %                                                                             %
2012 %                                                                             %
2013 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2014 %
2015 %  ParseChannelOption() parses a string and returns an enumerated channel
2016 %  type(s).
2017 %
2018 %  The format of the ParseChannelOption method is:
2019 %
2020 %      ssize_t ParseChannelOption(const char *channels)
2021 %
2022 %  A description of each parameter follows:
2023 %
2024 %    o options: One or more values separated by commas.
2025 %
2026 */
2027 MagickExport ssize_t ParseChannelOption(const char *channels)
2028 {
2029   register ssize_t
2030     i;
2031
2032   ssize_t
2033     channel;
2034
2035   channel=ParseMagickOption(MagickChannelOptions,MagickTrue,channels);
2036   if (channel >= 0)
2037     return(channel);
2038   channel=0;
2039   for (i=0; i < (ssize_t) strlen(channels); i++)
2040   {
2041     switch (channels[i])
2042     {
2043       case 'A':
2044       case 'a':
2045       {
2046         channel|=OpacityChannel;
2047         break;
2048       }
2049       case 'B':
2050       case 'b':
2051       {
2052         channel|=BlueChannel;
2053         break;
2054       }
2055       case 'C':
2056       case 'c':
2057       {
2058         channel|=CyanChannel;
2059         break;
2060       }
2061       case 'g':
2062       case 'G':
2063       {
2064         channel|=GreenChannel;
2065         break;
2066       }
2067       case 'I':
2068       case 'i':
2069       {
2070         channel|=IndexChannel;
2071         break;
2072       }
2073       case 'K':
2074       case 'k':
2075       {
2076         channel|=BlackChannel;
2077         break;
2078       }
2079       case 'M':
2080       case 'm':
2081       {
2082         channel|=MagentaChannel;
2083         break;
2084       }
2085       case 'o':
2086       case 'O':
2087       {
2088         channel|=OpacityChannel;
2089         break;
2090       }
2091       case 'R':
2092       case 'r':
2093       {
2094         channel|=RedChannel;
2095         break;
2096       }
2097       case 'Y':
2098       case 'y':
2099       {
2100         channel|=YellowChannel;
2101         break;
2102       }
2103       case ',':
2104       {
2105         ssize_t
2106           type;
2107
2108         /*
2109           Gather the additional channel flags and merge with shorthand.
2110         */
2111         type=ParseMagickOption(MagickChannelOptions,MagickTrue,channels+i+1);
2112         if (type < 0)
2113           return(type);
2114         channel|=type;
2115         return(channel);
2116       }
2117       default:
2118         return(-1);
2119     }
2120   }
2121   return(channel);
2122 }
2123 \f
2124 /*
2125 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2126 %                                                                             %
2127 %                                                                             %
2128 %                                                                             %
2129 %   P a r s e M a g i c k O p t i o n                                         %
2130 %                                                                             %
2131 %                                                                             %
2132 %                                                                             %
2133 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2134 %
2135 %  ParseMagickOption() parses a string and returns an enumerated option type(s).
2136 %
2137 %  The format of the ParseMagickOption method is:
2138 %
2139 %      ssize_t ParseMagickOption(const MagickOption option,
2140 %        const MagickBooleanType list,const char *options)
2141 %
2142 %  A description of each parameter follows:
2143 %
2144 %    o option: Index to the option table to lookup
2145 %
2146 %    o list: A option other than zero permits more than one option separated by
2147 %      a comma or pipe.
2148 %
2149 %    o options: One or more options separated by commas.
2150 %
2151 */
2152 MagickExport ssize_t ParseMagickOption(const MagickOption option,
2153   const MagickBooleanType list,const char *options)
2154 {
2155   char
2156     token[MaxTextExtent];
2157
2158   const OptionInfo
2159     *option_info;
2160
2161   int
2162     sentinel;
2163
2164   MagickBooleanType
2165     negate;
2166
2167   register char
2168     *q;
2169
2170   register const char
2171     *p;
2172
2173   register ssize_t
2174     i;
2175
2176   ssize_t
2177     option_types;
2178
2179   option_info=GetOptionInfo(option);
2180   if (option_info == (const OptionInfo *) NULL)
2181     return(-1);
2182   option_types=0;
2183   sentinel=',';
2184   if (strchr(options,'|') != (char *) NULL)
2185     sentinel='|';
2186   for (p=options; p != (char *) NULL; p=strchr(p,sentinel))
2187   {
2188     while (((isspace((int) ((unsigned char) *p)) != 0) || (*p == sentinel)) &&
2189            (*p != '\0'))
2190       p++;
2191     negate=(*p == '!') ? MagickTrue : MagickFalse;
2192     if (negate != MagickFalse)
2193       p++;
2194     q=token;
2195     while (((isspace((int) ((unsigned char) *p)) == 0) && (*p != sentinel)) &&
2196            (*p != '\0'))
2197     {
2198       if ((q-token) >= MaxTextExtent)
2199         break;
2200       *q++=(*p++);
2201     }
2202     *q='\0';
2203     for (i=0; option_info[i].mnemonic != (char *) NULL; i++)
2204       if (LocaleCompare(token,option_info[i].mnemonic) == 0)
2205         {
2206           if (*token == '!')
2207             option_types=option_types &~ option_info[i].type;
2208           else
2209             option_types=option_types | option_info[i].type;
2210           break;
2211         }
2212     if ((option_info[i].mnemonic == (char *) NULL) &&
2213         ((strchr(token+1,'-') != (char *) NULL) ||
2214          (strchr(token+1,'_') != (char *) NULL)))
2215       {
2216         while ((q=strchr(token+1,'-')) != (char *) NULL)
2217           (void) CopyMagickString(q,q+1,MaxTextExtent-strlen(q));
2218         while ((q=strchr(token+1,'_')) != (char *) NULL)
2219           (void) CopyMagickString(q,q+1,MaxTextExtent-strlen(q));
2220         for (i=0; option_info[i].mnemonic != (char *) NULL; i++)
2221           if (LocaleCompare(token,option_info[i].mnemonic) == 0)
2222             {
2223               if (*token == '!')
2224                 option_types=option_types &~ option_info[i].type;
2225               else
2226                 option_types=option_types | option_info[i].type;
2227               break;
2228             }
2229       }
2230     if (option_info[i].mnemonic == (char *) NULL)
2231       return(-1);
2232     if (list == MagickFalse)
2233       break;
2234   }
2235   return(option_types);
2236 }
2237 \f
2238 /*
2239 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2240 %                                                                             %
2241 %                                                                             %
2242 %                                                                             %
2243 %   R e m o v e I m a g e O p t i o n                                         %
2244 %                                                                             %
2245 %                                                                             %
2246 %                                                                             %
2247 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2248 %
2249 %  RemoveImageOption() removes an option from the image and returns its value.
2250 %
2251 %  The format of the RemoveImageOption method is:
2252 %
2253 %      char *RemoveImageOption(ImageInfo *image_info,const char *option)
2254 %
2255 %  A description of each parameter follows:
2256 %
2257 %    o image_info: the image info.
2258 %
2259 %    o option: the image option.
2260 %
2261 */
2262 MagickExport char *RemoveImageOption(ImageInfo *image_info,const char *option)
2263 {
2264   char
2265     *value;
2266
2267   assert(image_info != (ImageInfo *) NULL);
2268   assert(image_info->signature == MagickSignature);
2269   if (image_info->debug != MagickFalse)
2270     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
2271       image_info->filename);
2272   if (image_info->options == (void *) NULL)
2273     return((char *) NULL);
2274   value=(char *) RemoveNodeFromSplayTree((SplayTreeInfo *)
2275     image_info->options,option);
2276   return(value);
2277 }
2278 \f
2279 /*
2280 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2281 %                                                                             %
2282 %                                                                             %
2283 %                                                                             %
2284 %   R e s e t I m a g e O p t i o n                                           %
2285 %                                                                             %
2286 %                                                                             %
2287 %                                                                             %
2288 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2289 %
2290 %  ResetImageOptions() resets the image_info option.  That is, it deletes
2291 %  all options associated with the image_info structure.
2292 %
2293 %  The format of the ResetImageOptions method is:
2294 %
2295 %      ResetImageOptions(ImageInfo *image_info)
2296 %
2297 %  A description of each parameter follows:
2298 %
2299 %    o image_info: the image info.
2300 %
2301 */
2302 MagickExport void ResetImageOptions(const ImageInfo *image_info)
2303 {
2304   assert(image_info != (ImageInfo *) NULL);
2305   assert(image_info->signature == MagickSignature);
2306   if (image_info->debug != MagickFalse)
2307     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
2308       image_info->filename);
2309   if (image_info->options == (void *) NULL)
2310     return;
2311   ResetSplayTree((SplayTreeInfo *) image_info->options);
2312 }
2313 \f
2314 /*
2315 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2316 %                                                                             %
2317 %                                                                             %
2318 %                                                                             %
2319 %   R e s e t I m a g e O p t i o n I t e r a t o r                           %
2320 %                                                                             %
2321 %                                                                             %
2322 %                                                                             %
2323 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2324 %
2325 %  ResetImageOptionIterator() resets the image_info values iterator.  Use it
2326 %  in conjunction with GetNextImageOption() to iterate over all the values
2327 %  associated with an image option.
2328 %
2329 %  The format of the ResetImageOptionIterator method is:
2330 %
2331 %      ResetImageOptionIterator(ImageInfo *image_info)
2332 %
2333 %  A description of each parameter follows:
2334 %
2335 %    o image_info: the image info.
2336 %
2337 */
2338 MagickExport void ResetImageOptionIterator(const ImageInfo *image_info)
2339 {
2340   assert(image_info != (ImageInfo *) NULL);
2341   assert(image_info->signature == MagickSignature);
2342   if (image_info->debug != MagickFalse)
2343     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
2344       image_info->filename);
2345   if (image_info->options == (void *) NULL)
2346     return;
2347   ResetSplayTreeIterator((SplayTreeInfo *) image_info->options);
2348 }
2349 \f
2350 /*
2351 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2352 %                                                                             %
2353 %                                                                             %
2354 %                                                                             %
2355 %   S e t I m a g e O p t i o n                                               %
2356 %                                                                             %
2357 %                                                                             %
2358 %                                                                             %
2359 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2360 %
2361 %  SetImageOption() associates an value with an image option.
2362 %
2363 %  The format of the SetImageOption method is:
2364 %
2365 %      MagickBooleanType SetImageOption(ImageInfo *image_info,
2366 %        const char *option,const char *value)
2367 %
2368 %  A description of each parameter follows:
2369 %
2370 %    o image_info: the image info.
2371 %
2372 %    o option: the image option.
2373 %
2374 %    o values: the image option values.
2375 %
2376 */
2377 MagickExport MagickBooleanType SetImageOption(ImageInfo *image_info,
2378   const char *option,const char *value)
2379 {
2380   MagickBooleanType
2381     status;
2382
2383   assert(image_info != (ImageInfo *) NULL);
2384   assert(image_info->signature == MagickSignature);
2385   if (image_info->debug != MagickFalse)
2386     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
2387       image_info->filename);
2388   if (LocaleCompare(option,"size") == 0)
2389     (void) CloneString(&image_info->size,value);
2390   if (image_info->options == (void *) NULL)
2391     image_info->options=NewSplayTree(CompareSplayTreeString,
2392       RelinquishMagickMemory,RelinquishMagickMemory);
2393   status=AddValueToSplayTree((SplayTreeInfo *) image_info->options,
2394     ConstantString(option),ConstantString(value));
2395   return(status);
2396 }