Penguin
Recent Changes
Annotated edit history of conjure(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 conjure
2 !!!conjure
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 MAGICK SCRIPTING LANGUAGE
8 SEE ALSO
9 COPYRIGHT
10 AUTHORS
11 ----
12 !!NAME
13
14
15 conjure - process a Magick Scripting Language (MSL) script
16
17
18 __WARNING: Conjure and MSL are in very early development
19 and the syntax is subject to change!__
20 !!SYNOPSIS
21
22
23 __conjure [[__ ''options'' __]__ ''script.msl''
24 __[[ [[__ ''options'' __]__ ''script.msl''
25 __]__
26 !!DESCRIPTION
27
28
29 The Magick scripting language (MSL) will primarily benefit
30 those that want to accomplish custom image processing tasks
31 but do not wish to program, or those that do not have access
32 to a Perl interpreter or a compiler. The interpreter is
33 called conjure and here is an example script:
34
35
36
37
38 invoked with
39
40
41 conjure -dimensions 400x400 incantation.msl
42
43
44 All operations will closely follow the key/value pairs
2 perry 45 defined in !PerlMagick, unless otherwise noted.
1 perry 46
47
48 __Conjure__ is in the early stages of development as of
49 April 2002.
50
51
2 perry 52 This early announcement is to allow !ImageMagick users to
1 perry 53 contribute ideas early in the process so when the scripting
54 language is released it will be useful/stable from the
55 get-go! If you want to contribute suggestions about the
56 Magick scripting language (MSL), post them to
57 magick-developers@imagemagick.org.
58 !!OPTIONS
59
60
61 Options are processed in command line order. Any option you
62 specify on the command line remains in effect until it is
63 explicitly changed by specifying the option again with a
64 different effect, or if it is changed by a statement in the
65 scripting language.
66
67
68 You can define your own keyword/value pairs on the command
69 line. The script can then use this information when setting
70 values by including %[[keyword] in the string. For example,
71 if you included
72
73
74 The keyword can be any string except for the following
75 reserved strings (in any upper, lower, or mixed case
76 variant): __debug__, __help__, and __verbose__,
77 whose usage is described below.
78
79
80 The value can be any string. If either the keyword or the
81 value contains white space or any symbols that have special
82 meanings to your shell such as
83
84
85 Keywords and values are case dependent.
86
87
88 For a more detailed description of each option, see
2 perry 89 ''!ImageMagick(1)''.
1 perry 90
91
92 __-debug__
93
94
95 enable debug printout
96
97
98 __-help__
99
100
101 print usage instructions
102
103
104 __-verbose__
105
106
107 print detailed information about the image
108 !!MAGICK SCRIPTING LANGUAGE
109
110
111 The Magick Scripting Language (MSL) presently defines the
112 following elements and their attributes:
113
114
115 ____
116
117
118 Define a new image object. ____ destroys
119 it. Because of this, if you wish to reference multiple
120 __image__ element inside of another. For
121 example:
122
123
124
125
126
127
128 ____
129
130
131 Define a new group of image objects. By default, images are
132 only valid for the life of their
133 ____element.
134
135
136
137
138 However, in a group, all images in that group will stay
139 around for the life of the group:
140
141
142
143
144 ____
145
146
147 Read a new image from a disk file.
148
149
150
151
152 To read two images use
153
154
155
156
157 ____
158
159
160 Write the image(s) to disk, either as a single
161 multiple-image file or multiple ones if
162 necessary.
163
164
165
166
167 ____
168
169
2 perry 170 Get any attribute recognized by !PerlMagick's !GetAttribute()
1 perry 171 and stores it as an image attribute for later use. Currently
172 only ''width'' and ''height'' are
173 supported.
174
175
176
177
178 ____
179
180
181 background, bordercolor, clip-mask, colorspace, density,
182 magtick, mattecolor, opacity. Set an attribute recognized by
2 perry 183 !PerlMagick's !GetAttribute().
1 perry 184
185
186 ____
187
188
189 fill, geometry, height, width
190
191
192 ____
193
194
195 radius, sigma
196
197
198 ____
199
200
201 radius, sigma
202
203
204 ____
205
206
207 geometry, height, width, x, y
208
209
210 ____
211
212
213 geometry, height, width, x, y
214
215
216 ____
217
218
219 ____
220
221
222 radius, sigma
223
224
225 ____
226
227
228 ____
229
230
231 ____
232
233
234 ____
235
236
237 ____
238
239
240 fill, geometry, height, width, x, y, inner,
241 outer
242
243
244 ____
245
246
247 height, width
248
249
250 ____
251
252
253 background, color, id, size
254
255
256 ____
257
258
259 ____
260
261
262 ____
263
264
265 ____
266
267
268 output
269
270
271 ____
272
273
274 ____
275
276
277 blur, filter, geometry, height, width
278
279
280 ____
281
282
283 geometry, x, y
284
285
286 ____
287
288
289 degrees
290
291
292 ____
293
294
295 geometry, height, width
296
297
298 ____
299
300
301 geometry, height, width
302
303
304 ____
305
306
307 radius, sigma
308
309
310 ____
311
312
313 geometry, height, width
314
315
316 ____
317
318
319 x, y
320
321
322 ____
323
324
325 threshold
326
327
328 ____
329
330
331 radius
332
333
334 ____
335
336
337 image
338
339
340 ____
341
342
343 image
344
345
346 ____
347
348
349 degrees
350
351
352 ____
353
354
355 image
356
357
358 ____
359
360
361 threshold
362
363
364 ____
365
366
367 color
368
369
370 ____
371 !!SEE ALSO
372
373
374 animate(1), display(1), composite(1), convert(1),
375 identify(1), import(1), mogrify(1), montage(1)
376 !!COPYRIGHT
377
378
2 perry 379 __Copyright (C) 2002 !ImageMagick Studio__
1 perry 380
381
382 __Permission is hereby granted, free of charge, to any
383 person obtaining a copy of this software and associated
384 documentation files (
385 __
386
387
388 __The above copyright notice and this permission notice
389 shall be included in all copies or substantial portions of
2 perry 390 !ImageMagick.__
1 perry 391
392
393 __The software is provided
394 __
395
396
397 __Except as contained in this notice, the name of the
2 perry 398 !ImageMagick Studio LLC shall not be used in advertising or
1 perry 399 otherwise to promote the sale, use or other dealings in
2 perry 400 !ImageMagick without prior written authorization from the
401 !ImageMagick Studio.__
1 perry 402 !!AUTHORS
403
404
2 perry 405 ''John Cristy, !ImageMagick Studio LLC, Glenn
406 Randers-Pehrson, !ImageMagick Studio LLC, Leonard Rosenthol,
407 !ImageMagick Studio LLC.''
1 perry 408 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.