MagickCore  7.0.9
Convert, Edit, Or Compose Bitmap Images
option.h
Go to the documentation of this file.
1 /*
2  Copyright 1999-2020 ImageMagick Studio LLC, a non-profit organization
3  dedicated to making software imaging solutions freely available.
4 
5  You may not use this file except in compliance with the License. You may
6  obtain a copy of the License at
7 
8  https://imagemagick.org/script/license.php
9 
10  Unless required by applicable law or agreed to in writing, software
11  distributed under the License is distributed on an "AS IS" BASIS,
12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  See the License for the specific language governing permissions and
14  limitations under the License.
15 
16  MagickCore option methods.
17 */
18 #ifndef MAGICKCORE_OPTION_H
19 #define MAGICKCORE_OPTION_H
20 
21 #if defined(__cplusplus) || defined(c_plusplus)
22 extern "C" {
23 #endif
24 
25 typedef enum
26 {
108 } CommandOption;
109 
110 typedef enum
111 {
113  NoValidate = 0x00000,
115  CompareValidate = 0x00002,
116  CompositeValidate = 0x00004,
117  ConvertValidate = 0x00008,
121  IdentifyValidate = 0x00080,
123  MontageValidate = 0x00200,
124  StreamValidate = 0x00400,
125  AllValidate = 0x7fffffff
126 } ValidateType;
127 
128 /*
129  Flags to describe classes of image processing options.
130  These are used to determine how a option should be processed, and
131  avoid attempting to process all options in every way posible.
132 */
133 typedef enum
134 {
135  UndefinedOptionFlag = 0x0000, /* option flag is not in use */
136 
137  ImageInfoOptionFlag = 0x0001, /* Setting stored in ImageInfo */
138  DrawInfoOptionFlag = 0x0002, /* Setting stored in DrawInfo */
139  QuantizeInfoOptionFlag = 0x0004, /* Setting stored in QuantizeInfo */
140  GlobalOptionFlag = 0x0008, /* Global Setting or Control */
141  SettingOptionFlags = 0x000F, /* mask any setting option */
142 
143  NoImageOperatorFlag = 0x0010, /* Images not required operator */
144  SimpleOperatorFlag = 0x0020, /* Simple Image processing operator */
145  ListOperatorFlag = 0x0040, /* Multi-Image processing operator */
146  GenesisOptionFlag = 0x0080, /* MagickCommandGenesis() Only Option */
147 
148  SpecialOptionFlag = 0x0100, /* Operator with Special Requirements */
149  /* EG: for specific CLI commands */
150 
151  AlwaysInterpretArgsFlag = 0x0400, /* Always Interpret escapes in Args */
152  /* CF: "convert" compatibility mode */
153  NeverInterpretArgsFlag = 0x0800, /* Never Interpret escapes in Args */
154  /* EG: filename, or delayed escapes */
155 
156  NonMagickOptionFlag = 0x1000, /* Option not used by Magick Command */
157  FireOptionFlag = 0x2000, /* Convert operation seq firing point */
158  DeprecateOptionFlag = 0x4000, /* Deprecate option (no code) */
159  ReplacedOptionFlag = 0x8800 /* Replaced Option (but still works) */
160 
162 
163 typedef struct _OptionInfo
164 {
165  const char
167 
168  ssize_t
170  flags;
171 
174 } OptionInfo;
175 
176 
177 extern MagickExport char
179  *GetNextImageOption(const ImageInfo *),
180  *RemoveImageOption(ImageInfo *,const char *);
181 
182 extern MagickExport const char
183  *CommandOptionToMnemonic(const CommandOption,const ssize_t),
184  *GetImageOption(const ImageInfo *,const char *);
185 
188  DefineImageOption(ImageInfo *,const char *),
189  DeleteImageOption(ImageInfo *,const char *),
190  IsCommandOption(const char *),
191  IsOptionMember(const char *,const char *),
193  SetImageOption(ImageInfo *,const char *,const char *);
194 
195 extern MagickExport ssize_t
197  const char *),
198  ParseChannelOption(const char *),
199  ParsePixelChannelOption(const char *),
200  ParseCommandOption(const CommandOption,const MagickBooleanType,const char *);
201 
202 extern MagickExport void
204  ResetImageOptions(const ImageInfo *),
206 
207 extern MagickExport const OptionInfo
208  *GetCommandOptionInfo(const char *value);
209 
210 #if defined(__cplusplus) || defined(c_plusplus)
211 }
212 #endif
213 
214 #endif
Definition: option.h:100
Definition: option.h:102
Definition: option.h:159
MagickExport void ResetImageOptions(const ImageInfo *image_info)
Definition: option.c:3170
Definition: option.h:73
MagickExport MagickBooleanType IsOptionMember(const char *option, const char *options)
Definition: option.c:2730
Definition: option.h:43
Definition: option.h:90
Definition: option.h:30
Definition: option.h:89
Definition: option.h:37
Definition: option.h:93
Definition: option.h:79
MagickExport MagickBooleanType DeleteImageOption(ImageInfo *image_info, const char *option)
Definition: option.c:2231
Definition: option.h:104
Definition: option.h:50
Definition: option.h:117
Definition: option.h:123
MagickExport ssize_t ParseCommandOption(const CommandOption option, const MagickBooleanType list, const char *options)
Definition: option.c:2975
CommandOptionFlags
Definition: option.h:133
MagickBooleanType stealth
Definition: option.h:173
Definition: option.h:151
Definition: option.h:27
Definition: option.h:115
Definition: option.h:148
Definition: exception.h:101
MagickExport char ** GetCommandOptions(const CommandOption option)
Definition: option.c:2564
Definition: image.h:375
Definition: option.h:77
Definition: option.h:91
Definition: option.h:58
Definition: option.h:116
Definition: option.h:71
Definition: option.h:36
Definition: option.h:112
Definition: option.h:124
Definition: option.h:74
MagickExport const char * GetImageOption(const ImageInfo *image_info, const char *option)
Definition: option.c:2306
Definition: option.h:51
Definition: option.h:38
Definition: option.h:88
MagickExport ssize_t ParseChannelOption(const char *channels)
Definition: option.c:2851
MagickExport void DestroyImageOptions(ImageInfo *image_info)
Definition: option.c:2267
MagickExport MagickBooleanType SetImageOption(ImageInfo *image_info, const char *option, const char *value)
Definition: option.c:3245
Definition: option.h:122
Definition: option.h:65
MagickExport MagickBooleanType DefineImageOption(ImageInfo *image_info, const char *option)
Definition: option.c:2181
Definition: option.h:63
Definition: option.h:144
Definition: option.h:81
Definition: option.h:55
Definition: option.h:92
Definition: option.h:96
Definition: option.h:34
MagickBooleanType
Definition: magick-type.h:169
Definition: option.h:84
Definition: option.h:45
Definition: option.h:98
Definition: option.h:86
Definition: option.h:41
Definition: option.h:113
Definition: option.h:95
MagickExport const char * CommandOptionToMnemonic(const CommandOption option, const ssize_t type)
Definition: option.c:2684
struct _OptionInfo OptionInfo
Definition: option.h:139
Definition: option.h:67
Definition: option.h:61
Definition: option.h:76
const char * mnemonic
Definition: option.h:166
Definition: option.h:66
Definition: option.h:158
MagickExport const OptionInfo * GetCommandOptionInfo(const char *option)
Definition: option.c:2531
Definition: option.h:163
Definition: option.h:101
Definition: option.h:80
Definition: option.h:145
Definition: option.h:53
Definition: option.h:106
Definition: option.h:157
Definition: option.h:75
Definition: option.h:44
Definition: option.h:60
Definition: option.h:46
Definition: option.h:137
Definition: option.h:135
MagickExport void ResetImageOptionIterator(const ImageInfo *image_info)
Definition: option.c:3206
Definition: option.h:70
MagickExport ssize_t GetCommandOptionFlags(const CommandOption option, const MagickBooleanType list, const char *options)
Definition: option.c:2424
Definition: option.h:47
ssize_t type
Definition: option.h:169
Definition: option.h:56
Definition: option.h:85
Definition: option.h:114
Definition: option.h:68
Definition: option.h:119
Definition: option.h:121
ssize_t flags
Definition: option.h:169
Definition: option.h:103
Definition: option.h:49
Definition: option.h:48
Definition: option.h:52
MagickExport MagickBooleanType ListCommandOptions(FILE *file, const CommandOption option, ExceptionInfo *magick_unused(exception))
Definition: option.c:2804
Definition: option.h:107
Definition: option.h:54
MagickExport MagickBooleanType CloneImageOptions(ImageInfo *image_info, const ImageInfo *clone_info)
Definition: option.c:2134
Definition: option.h:141
Definition: option.h:99
Definition: option.h:28
Definition: option.h:156
Definition: option.h:118
Definition: option.h:153
Definition: option.h:64
ValidateType
Definition: option.h:110
Definition: option.h:39
Definition: option.h:83
Definition: option.h:87
Definition: option.h:143
Definition: option.h:125
Definition: option.h:140
Definition: option.h:105
MagickExport ssize_t ParsePixelChannelOption(const char *channels)
Definition: option.c:3081
Definition: option.h:29
Definition: option.h:138
Definition: option.h:32
MagickExport char * RemoveImageOption(ImageInfo *image_info, const char *option)
Definition: option.c:3130
Definition: option.h:31
#define MagickExport
Definition: method-attribute.h:80
Definition: option.h:42
CommandOption
Definition: option.h:25
Definition: option.h:97
Definition: option.h:62
Definition: option.h:120
Definition: option.h:59
MagickExport MagickBooleanType IsCommandOption(const char *option)
Definition: option.c:2645
Definition: option.h:82
Definition: option.h:146
Definition: option.h:40
Definition: option.h:35
Definition: option.h:57
MagickExport char * GetNextImageOption(const ImageInfo *image_info)
Definition: option.c:2610
Definition: option.h:69
Definition: option.h:33
Definition: option.h:94
Definition: option.h:78
Definition: option.h:72