1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2
"http://www.w3.org/TR/html4/loose.dtd">
5
<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=us-ascii">
6
<title>GraphicsMagick GM Utility</title>
9
@page { size: 8.5in 11in }
10
TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
11
P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
12
A:link { color: #00B04F }
13
A:visited { color: #007B37 }
18
<body LANG="en-US" TEXT="#000000" LINK="#00B04F" VLINK="#007B37" BGCOLOR="#ffffff">
20
<table border=0 cellpadding=10 cellspacing=0 style="margin-top:-17px" width="100%"><tr><td>
22
<table BORDER=0 WIDTH="100%">
24
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
25
SRC="images/right_triangle.png" ALT=">" BORDER=0
26
height=14 width=15><b><font face="Helvetica, Arial"><font
27
color="#00B04F"><font size="+1">
28
<a NAME="compare"></a>gm compare
29
</font></font></font></b></td></tr></table>
30
<table width="94%" border="0" cellspacing="0" cellpadding="8">
31
<tr><td width="3%"><br></td><td>
32
<table BORDER=0 WIDTH="100%">
34
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
35
SRC="images/right_triangle.png" ALT=">" BORDER=0
36
height=14 width=15><b><font face="Helvetica, Arial"><font
37
color="#00B04F"><font size="+1">
38
<a NAME="comp-top"></a>NAME
39
</font></font></font></b></td></tr></table>
40
<table width="94%" border="0" cellspacing="0" cellpadding="8">
41
<tr><td width="3%"><br></td><td>
42
compare - compare two images.
44
<table BORDER=0 WIDTH="100%">
46
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
47
SRC="images/right_triangle.png" ALT=">" BORDER=0
48
height=14 width=15><b><font face="Helvetica, Arial"><font
49
color="#00B04F"><font size="+1">
50
<a NAME="comp-contents"></a>Contents
51
</font></font></font></b></td></tr></table>
52
<table width="94%" border="0" cellspacing="0" cellpadding="8">
53
<tr><td width="3%"><br></td><td>
56
<a href="#comp-syno">Synopsis</a>
59
<a href="#comp-desc">Description</a>
62
<a href="#comp-exam">Examples</a>
65
<a href="#comp-opti">Options</a>
68
<a href="#comp-envi">Environment</a>
71
<a href="#comp-file">Configuration Files</a>
74
<a href="#auth">Authors</a>
77
<a href="#copy">Copyright</a>
81
<table BORDER=0 WIDTH="100%">
83
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
84
SRC="images/right_triangle.png" ALT=">" BORDER=0
85
height=14 width=15><b><font face="Helvetica, Arial"><font
86
color="#00B04F"><font size="+1">
87
<a NAME="comp-syno"></a>Synopsis
88
</font></font></font></b></td></tr></table>
89
<table width="94%" border="0" cellspacing="0" cellpadding="8">
90
<tr><td width="3%"><br></td><td>
92
<strong>compare</strong> <strong>[</strong> <em>options</em> <strong>... ]</strong> <em>reference-image</em>
93
<strong>[</strong> <em>options</em> <strong>... ]</strong> <em>compare-image</em>
94
<strong>[</strong> <em>options</em> <strong>... ]</strong>
96
<table BORDER=0 WIDTH="100%">
98
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
99
SRC="images/right_triangle.png" ALT=">" BORDER=0
100
height=14 width=15><b><font face="Helvetica, Arial"><font
101
color="#00B04F"><font size="+1">
102
<a NAME="comp-desc"></a>Description
103
</font></font></font></b></td></tr></table>
104
<table width="94%" border="0" cellspacing="0" cellpadding="8">
105
<tr><td width="3%"><br></td><td>
107
<strong>compare</strong> compares two similar images using a specified statistical
108
method (see <strong>-metric</strong>) and/or by writing a difference image
109
(<strong>-file</strong>), with the altered pixels annotated using a specified
110
method (see <strong>-highlight-style</strong>) and color (see
111
<strong>-highlight-color</strong>). <p><em>Reference-image</em> is the original
112
image and <em>compare-image</em> is the (possibly) altered version, which
113
should have the same dimensions as <em>reference-image</em>.
115
<table BORDER=0 WIDTH="100%">
117
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
118
SRC="images/right_triangle.png" ALT=">" BORDER=0
119
height=14 width=15><b><font face="Helvetica, Arial"><font
120
color="#00B04F"><font size="+1">
121
<a NAME="comp-exam"></a>Examples
122
</font></font></font></b></td></tr></table>
123
<table width="94%" border="0" cellspacing="0" cellpadding="8">
124
<tr><td width="3%"><br></td><td>
126
To compare two images using Mean Square Error (MSE) statistical analysis
129
compare -metric mse original.miff compare.miff
132
To create an annotated difference image use:
134
compare -algorithm annotate -highlight-color purple -file diff.miff original.miff compare.miff
138
<i><a href="#top">Back to Contents</a></i>
140
<table BORDER=0 WIDTH="100%">
142
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
143
SRC="images/right_triangle.png" ALT=">" BORDER=0
144
height=14 width=15><b><font face="Helvetica, Arial"><font
145
color="#00B04F"><font size="+1">
146
<a NAME="comp-opti"></a>Options
147
</font></font></font></b></td></tr></table>
148
<table width="94%" border="0" cellspacing="0" cellpadding="8">
149
<tr><td width="3%"><br></td><td>
151
Options are processed in command line order. Any option you specify on
152
the command line remains in effect only for the image that follows. All
153
options are reset to their default values after each image is read.
155
For a more detailed description of each option, see
157
<a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
159
<table BORDER=0 WIDTH="94%">
161
<td width="3%"><br></td>
162
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
163
<img SRC="images/right_triangle_option.png"
164
ALT=">" BORDER=0 height=14
165
width=15><b><font face="Helvetica, Arial"
166
><font color="#00B04F"><font size="+1">
167
<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>
168
</font></font></font></b></td></tr></table>
169
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>
170
<table BORDER=0 WIDTH="94%">
172
<td width="3%"><br></td>
173
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
174
<img SRC="images/right_triangle_option.png"
175
ALT=">" BORDER=0 height=14
176
width=15><b><font face="Helvetica, Arial"
177
><font color="#00B04F"><font size="+1">
178
<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>
179
</font></font></font></b></td></tr></table>
180
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>
181
<table BORDER=0 WIDTH="94%">
183
<td width="3%"><br></td>
184
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
185
<img SRC="images/right_triangle_option.png"
186
ALT=">" BORDER=0 height=14
187
width=15><b><font face="Helvetica, Arial"
188
><font color="#00B04F"><font size="+1">
189
-debug <i><events></i>
190
</font></font></font></b></td></tr></table>
191
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>
192
<table BORDER=0 WIDTH="94%">
194
<td width="3%"><br></td>
195
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
196
<img SRC="images/right_triangle_option.png"
197
ALT=">" BORDER=0 height=14
198
width=15><b><font face="Helvetica, Arial"
199
><font color="#00B04F"><font size="+1">
200
<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>
201
</font></font></font></b></td></tr></table>
202
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>
203
<table BORDER=0 WIDTH="94%">
205
<td width="3%"><br></td>
206
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
207
<img SRC="images/right_triangle_option.png"
208
ALT=">" BORDER=0 height=14
209
width=15><b><font face="Helvetica, Arial"
210
><font color="#00B04F"><font size="+1">
211
<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>
212
</font></font></font></b></td></tr></table>
213
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>
214
<table BORDER=0 WIDTH="94%">
216
<td width="3%"><br></td>
217
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
218
<img SRC="images/right_triangle_option.png"
219
ALT=">" BORDER=0 height=14
220
width=15><b><font face="Helvetica, Arial"
221
><font color="#00B04F"><font size="+1">
222
<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>
223
</font></font></font></b></td></tr></table>
224
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>
225
<table BORDER=0 WIDTH="94%">
227
<td width="3%"><br></td>
228
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
229
<img SRC="images/right_triangle_option.png"
230
ALT=">" BORDER=0 height=14
231
width=15><b><font face="Helvetica, Arial"
232
><font color="#00B04F"><font size="+1">
233
<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>
234
</font></font></font></b></td></tr></table>
235
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>
236
<table BORDER=0 WIDTH="94%">
238
<td width="3%"><br></td>
239
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
240
<img SRC="images/right_triangle_option.png"
241
ALT=">" BORDER=0 height=14
242
width=15><b><font face="Helvetica, Arial"
243
><font color="#00B04F"><font size="+1">
244
<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>
245
</font></font></font></b></td></tr></table>
246
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>
247
<table BORDER=0 WIDTH="94%">
249
<td width="3%"><br></td>
250
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
251
<img SRC="images/right_triangle_option.png"
252
ALT=">" BORDER=0 height=14
253
width=15><b><font face="Helvetica, Arial"
254
><font color="#00B04F"><font size="+1">
255
<a href="GraphicsMagick.html#details-file">-file</a> <i><filename></i>
256
</font></font></font></b></td></tr></table>
257
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write annotated difference image to file</td></tr></table>
258
<table BORDER=0 WIDTH="94%">
260
<td width="3%"><br></td>
261
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
262
<img SRC="images/right_triangle_option.png"
263
ALT=">" BORDER=0 height=14
264
width=15><b><font face="Helvetica, Arial"
265
><font color="#00B04F"><font size="+1">
267
</font></font></font></b></td></tr></table>
268
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>
269
<table BORDER=0 WIDTH="94%">
271
<td width="3%"><br></td>
272
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
273
<img SRC="images/right_triangle_option.png"
274
ALT=">" BORDER=0 height=14
275
width=15><b><font face="Helvetica, Arial"
276
><font color="#00B04F"><font size="+1">
277
<a href="GraphicsMagick.html#details-highlight-color">-highlight-color</a> <i><color></i>
278
</font></font></font></b></td></tr></table>
279
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation color</td></tr></table>
280
<table BORDER=0 WIDTH="94%">
282
<td width="3%"><br></td>
283
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
284
<img SRC="images/right_triangle_option.png"
285
ALT=">" BORDER=0 height=14
286
width=15><b><font face="Helvetica, Arial"
287
><font color="#00B04F"><font size="+1">
288
<a href="GraphicsMagick.html#details-highlight-style">-highlight-style</a> <i><style></i>
289
</font></font></font></b></td></tr></table>
290
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pixel annotation style</td></tr></table>
291
<table BORDER=0 WIDTH="94%">
293
<td width="3%"><br></td>
294
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
295
<img SRC="images/right_triangle_option.png"
296
ALT=">" BORDER=0 height=14
297
width=15><b><font face="Helvetica, Arial"
298
><font color="#00B04F"><font size="+1">
299
<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>
300
</font></font></font></b></td></tr></table>
301
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>
302
<table BORDER=0 WIDTH="94%">
304
<td width="3%"><br></td>
305
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
306
<img SRC="images/right_triangle_option.png"
307
ALT=">" BORDER=0 height=14
308
width=15><b><font face="Helvetica, Arial"
309
><font color="#00B04F"><font size="+1">
310
<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>
311
</font></font></font></b></td></tr></table>
312
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, or Pixels resource limit</td></tr></table>
313
<table BORDER=0 WIDTH="94%">
315
<td width="3%"><br></td>
316
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
317
<img SRC="images/right_triangle_option.png"
318
ALT=">" BORDER=0 height=14
319
width=15><b><font face="Helvetica, Arial"
320
><font color="#00B04F"><font size="+1">
321
<a href="GraphicsMagick.html#details-log">-log</a> <i><string></i>
322
</font></font></font></b></td></tr></table>
323
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>
324
<table BORDER=0 WIDTH="94%">
326
<td width="3%"><br></td>
327
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
328
<img SRC="images/right_triangle_option.png"
329
ALT=">" BORDER=0 height=14
330
width=15><b><font face="Helvetica, Arial"
331
><font color="#00B04F"><font size="+1">
332
<a href="GraphicsMagick.html#details-matte">-matte</a>
333
</font></font></font></b></td></tr></table>
334
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>
335
<table BORDER=0 WIDTH="94%">
337
<td width="3%"><br></td>
338
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
339
<img SRC="images/right_triangle_option.png"
340
ALT=">" BORDER=0 height=14
341
width=15><b><font face="Helvetica, Arial"
342
><font color="#00B04F"><font size="+1">
344
</font></font></font></b></td></tr></table>
345
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>show progress indication</td></tr></table>
346
<table BORDER=0 WIDTH="94%">
348
<td width="3%"><br></td>
349
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
350
<img SRC="images/right_triangle_option.png"
351
ALT=">" BORDER=0 height=14
352
width=15><b><font face="Helvetica, Arial"
353
><font color="#00B04F"><font size="+1">
354
<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>
355
</font></font></font></b></td></tr></table>
356
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table>
357
<table BORDER=0 WIDTH="94%">
359
<td width="3%"><br></td>
360
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
361
<img SRC="images/right_triangle_option.png"
362
ALT=">" BORDER=0 height=14
363
width=15><b><font face="Helvetica, Arial"
364
><font color="#00B04F"><font size="+1">
365
<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>
366
</font></font></font></b></td></tr></table>
367
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>
368
<table BORDER=0 WIDTH="94%">
370
<td width="3%"><br></td>
371
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
372
<img SRC="images/right_triangle_option.png"
373
ALT=">" BORDER=0 height=14
374
width=15><b><font face="Helvetica, Arial"
375
><font color="#00B04F"><font size="+1">
376
<a href="GraphicsMagick.html#details-type">-type</a> <i><type></i>
377
</font></font></font></b></td></tr></table>
378
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>
379
<table BORDER=0 WIDTH="94%">
381
<td width="3%"><br></td>
382
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
383
<img SRC="images/right_triangle_option.png"
384
ALT=">" BORDER=0 height=14
385
width=15><b><font face="Helvetica, Arial"
386
><font color="#00B04F"><font size="+1">
387
<a href="GraphicsMagick.html#details-verbose">-verbose</a>
388
</font></font></font></b></td></tr></table>
389
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>
390
<table BORDER=0 WIDTH="94%">
392
<td width="3%"><br></td>
393
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
394
<img SRC="images/right_triangle_option.png"
395
ALT=">" BORDER=0 height=14
396
width=15><b><font face="Helvetica, Arial"
397
><font color="#00B04F"><font size="+1">
398
<a href="GraphicsMagick.html#details-version">-version</a>
399
</font></font></font></b></td></tr></table>
400
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>
402
For a more detailed description of each option, see
404
<a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
408
<i><a href="#top">Back to Contents</a></i>
410
<table BORDER=0 WIDTH="100%">
412
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
413
SRC="images/right_triangle.png" ALT=">" BORDER=0
414
height=14 width=15><b><font face="Helvetica, Arial"><font
415
color="#00B04F"><font size="+1">
416
<a NAME="comp-envi"></a>Environment
417
</font></font></font></b></td></tr></table>
418
<table width="94%" border="0" cellspacing="0" cellpadding="8">
419
<tr><td width="3%"><br></td><td>
420
<table BORDER=0 WIDTH="94%">
422
<td width="3%"><br></td>
423
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
424
<img SRC="images/right_triangle_option.png"
425
ALT=">" BORDER=0 height=14
426
width=15><b><font face="Helvetica, Arial"
427
><font color="#00B04F"><font size="+1">
429
</font></font></font></b></td></tr></table>
430
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Output screen width. Used when formatting text for the screen. Many
431
Unix systems keep this shell variable up to date, but it may need to be
432
explicitly exported in order for GraphicsMagick to see it.</td></tr></table>
433
<table BORDER=0 WIDTH="94%">
435
<td width="3%"><br></td>
436
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
437
<img SRC="images/right_triangle_option.png"
438
ALT=">" BORDER=0 height=14
439
width=15><b><font face="Helvetica, Arial"
440
><font color="#00B04F"><font size="+1">
442
</font></font></font></b></td></tr></table>
443
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>X11 display ID (host, display number, and screen in the form
444
hostname:display.screen).</td></tr></table>
445
<table BORDER=0 WIDTH="94%">
447
<td width="3%"><br></td>
448
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
449
<img SRC="images/right_triangle_option.png"
450
ALT=">" BORDER=0 height=14
451
width=15><b><font face="Helvetica, Arial"
452
><font color="#00B04F"><font size="+1">
454
</font></font></font></b></td></tr></table>
455
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Location of user's home directory. GraphicsMagick searches for
456
configuration files in $HOME/.magick if the directory exists. See
457
<strong>MAGICK_CODER_MODULE_PATH</strong>, <strong>MAGICK_CONFIGURE_PATH</strong>, and
458
<strong>MAGICK_FILTER_MODULE_PATH</strong> if more flexibility is needed.</td></tr></table>
459
<table BORDER=0 WIDTH="94%">
461
<td width="3%"><br></td>
462
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
463
<img SRC="images/right_triangle_option.png"
464
ALT=">" BORDER=0 height=14
465
width=15><b><font face="Helvetica, Arial"
466
><font color="#00B04F"><font size="+1">
467
MAGICK_CODER_STABILITY
468
</font></font></font></b></td></tr></table>
469
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The minimum coder stability level before it will be used. The
470
available levels are <strong>PRIMARY</strong>, <strong>STABLE</strong>, and <strong>UNSTABLE</strong>.
471
The default minimum level is <strong>UNSTABLE</strong>, which means that all
472
available coders will be used. The purpose of this option is to reduce
473
the security exposure (or apparent complexity) due to the huge number of
474
formats supported. Coders at the <strong>PRIMARY</strong> level are commonly used
475
formats with very well maintained implementations. Coders at the
476
<strong>STABLE</strong> level are reasonably well maintained but represent less used
477
formats. Coders at the <strong>UNSTABLE</strong> level either have weak
478
implementations, the file format itself is weak, or the probability the
479
coder will be needed is vanishingly small.</td></tr></table>
480
<table BORDER=0 WIDTH="94%">
482
<td width="3%"><br></td>
483
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
484
<img SRC="images/right_triangle_option.png"
485
ALT=">" BORDER=0 height=14
486
width=15><b><font face="Helvetica, Arial"
487
><font color="#00B04F"><font size="+1">
488
MAGICK_CODER_MODULE_PATH
489
</font></font></font></b></td></tr></table>
490
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for image format coder modules.
491
This path allows the user to arbitrarily extend the image formats
492
supported by GraphicsMagick by adding loadable modules to an arbitrary
493
location rather than copying them into the GraphicsMagick installation
494
directory. The formatting of the search path is similar to operating
495
system search paths (i.e. colon delimited for Unix, and semi-colon
496
delimited for Microsoft Windows). This user specified search path is used
497
before trying the default search path.</td></tr></table>
498
<table BORDER=0 WIDTH="94%">
500
<td width="3%"><br></td>
501
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
502
<img SRC="images/right_triangle_option.png"
503
ALT=">" BORDER=0 height=14
504
width=15><b><font face="Helvetica, Arial"
505
><font color="#00B04F"><font size="+1">
506
MAGICK_CONFIGURE_PATH
507
</font></font></font></b></td></tr></table>
508
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for configuration (.mgk) files.
509
The formatting of the search path is similar to operating system search
510
paths (i.e. colon delimited for Unix, and semi-colon delimited for
511
Microsoft Windows). This user specified search path is used before trying
512
the default search path.</td></tr></table>
513
<table BORDER=0 WIDTH="94%">
515
<td width="3%"><br></td>
516
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
517
<img SRC="images/right_triangle_option.png"
518
ALT=">" BORDER=0 height=14
519
width=15><b><font face="Helvetica, Arial"
520
><font color="#00B04F"><font size="+1">
522
</font></font></font></b></td></tr></table>
523
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Debug options (see <strong>-debug</strong> for details)</td></tr></table>
524
<table BORDER=0 WIDTH="94%">
526
<td width="3%"><br></td>
527
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
528
<img SRC="images/right_triangle_option.png"
529
ALT=">" BORDER=0 height=14
530
width=15><b><font face="Helvetica, Arial"
531
><font color="#00B04F"><font size="+1">
532
MAGICK_FILTER_MODULE_PATH
533
</font></font></font></b></td></tr></table>
534
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for filter process modules
535
(invoked via <strong>-process</strong>). This path allows the user to arbitrarily
536
extend GraphicsMagick's image processing functionality by adding loadable
537
modules to an arbitrary location rather than copying them into the
538
GraphicsMagick installation directory. The formatting of the search path
539
is similar to operating system search paths (i.e. colon delimited for
540
Unix, and semi-colon delimited for Microsoft Windows). This user
541
specified search path is used before trying the default search path.</td></tr></table>
542
<table BORDER=0 WIDTH="94%">
544
<td width="3%"><br></td>
545
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
546
<img SRC="images/right_triangle_option.png"
547
ALT=">" BORDER=0 height=14
548
width=15><b><font face="Helvetica, Arial"
549
><font color="#00B04F"><font size="+1">
551
</font></font></font></b></td></tr></table>
552
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to top of GraphicsMagick installation directory. Only observed
553
by "uninstalled" builds of GraphicsMagick which do not have their location
554
hard-coded or set by an installer.</td></tr></table>
555
<table BORDER=0 WIDTH="94%">
557
<td width="3%"><br></td>
558
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
559
<img SRC="images/right_triangle_option.png"
560
ALT=">" BORDER=0 height=14
561
width=15><b><font face="Helvetica, Arial"
562
><font color="#00B04F"><font size="+1">
564
</font></font></font></b></td></tr></table>
565
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>If <strong>MAGICK_MMAP_READ</strong> is set to <strong>TRUE</strong>, GraphicsMagick
566
will attempt to memory-map the input file for reading. This usually
567
substantially improves read performance if the file has recently been
568
read. However, testing shows that performance may be reduced for files
569
accessed for the first time via a network since some operating systems
570
failed to do read-ahead over network mounts for memory mapped files.</td></tr></table>
571
<table BORDER=0 WIDTH="94%">
573
<td width="3%"><br></td>
574
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
575
<img SRC="images/right_triangle_option.png"
576
ALT=">" BORDER=0 height=14
577
width=15><b><font face="Helvetica, Arial"
578
><font color="#00B04F"><font size="+1">
580
</font></font></font></b></td></tr></table>
581
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>If <strong>MAGICK_MMAP_WRITE</strong> is set to <strong>TRUE</strong>, GraphicsMagick
582
will attempt to memory-map the output file for writing. This is an
583
experimental feature (which is currently broken). Write performance is
584
usually somewhat worse when using this approach rather than the default
585
one.</td></tr></table>
586
<table BORDER=0 WIDTH="94%">
588
<td width="3%"><br></td>
589
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
590
<img SRC="images/right_triangle_option.png"
591
ALT=">" BORDER=0 height=14
592
width=15><b><font face="Helvetica, Arial"
593
><font color="#00B04F"><font size="+1">
595
</font></font></font></b></td></tr></table>
596
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>If <strong>MAGICK_IO_FSYNC</strong> is set to <strong>TRUE</strong>, then GraphicsMagick
597
will request that the output file is fully flushed and synchronized to
598
disk when it is closed. This incurs a performance penalty, but has the
599
benefit that if the power fails or the system crashes, the file should be
600
valid on disk. If image files are referenced from a database, then this
601
option helps assure that the files referenced by the database are
602
valid.</td></tr></table>
603
<table BORDER=0 WIDTH="94%">
605
<td width="3%"><br></td>
606
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
607
<img SRC="images/right_triangle_option.png"
608
ALT=">" BORDER=0 height=14
609
width=15><b><font face="Helvetica, Arial"
610
><font color="#00B04F"><font size="+1">
612
</font></font></font></b></td></tr></table>
613
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The amount of I/O buffering (in bytes) to use when reading and
614
writing encoded files. The default is 16384, which is observed to work
615
well for many cases. The best value for a local filesystem is usually the
616
the native filesystem block size (e.g. 4096, 8192, or even 131,072 for
617
ZFS) in order to minimize the number of physical disk I/O operations.
618
I/O performance to files accessed over a network may benefit
619
significantly by tuning this option. Larger values are not necessarily
620
better (they may be slower!), and there is rarely any benefit from using
621
values larger than 32768. Use convert's <strong>-verbose</strong> option in order
622
to evaluate read and write rates in pixels per second while keeping in
623
mind that the operating system will try to cache files in RAM.</td></tr></table>
624
<table BORDER=0 WIDTH="94%">
626
<td width="3%"><br></td>
627
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
628
<img SRC="images/right_triangle_option.png"
629
ALT=">" BORDER=0 height=14
630
width=15><b><font face="Helvetica, Arial"
631
><font color="#00B04F"><font size="+1">
633
</font></font></font></b></td></tr></table>
634
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of disk space allowed for use by the pixel cache.</td></tr></table>
635
<table BORDER=0 WIDTH="94%">
637
<td width="3%"><br></td>
638
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
639
<img SRC="images/right_triangle_option.png"
640
ALT=">" BORDER=0 height=14
641
width=15><b><font face="Helvetica, Arial"
642
><font color="#00B04F"><font size="+1">
644
</font></font></font></b></td></tr></table>
645
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of open files.</td></tr></table>
646
<table BORDER=0 WIDTH="94%">
648
<td width="3%"><br></td>
649
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
650
<img SRC="images/right_triangle_option.png"
651
ALT=">" BORDER=0 height=14
652
width=15><b><font face="Helvetica, Arial"
653
><font color="#00B04F"><font size="+1">
655
</font></font></font></b></td></tr></table>
656
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum size of a memory map.</td></tr></table>
657
<table BORDER=0 WIDTH="94%">
659
<td width="3%"><br></td>
660
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
661
<img SRC="images/right_triangle_option.png"
662
ALT=">" BORDER=0 height=14
663
width=15><b><font face="Helvetica, Arial"
664
><font color="#00B04F"><font size="+1">
666
</font></font></font></b></td></tr></table>
667
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of memory to allocate from the heap.</td></tr></table>
668
<table BORDER=0 WIDTH="94%">
670
<td width="3%"><br></td>
671
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
672
<img SRC="images/right_triangle_option.png"
673
ALT=">" BORDER=0 height=14
674
width=15><b><font face="Helvetica, Arial"
675
><font color="#00B04F"><font size="+1">
677
</font></font></font></b></td></tr></table>
678
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to directory where GraphicsMagick should write temporary
679
files. The default is to use the system default, or the location set by
680
<strong>TMPDIR</strong>.</td></tr></table>
681
<table BORDER=0 WIDTH="94%">
683
<td width="3%"><br></td>
684
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
685
<img SRC="images/right_triangle_option.png"
686
ALT=">" BORDER=0 height=14
687
width=15><b><font face="Helvetica, Arial"
688
><font color="#00B04F"><font size="+1">
690
</font></font></font></b></td></tr></table>
691
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For POSIX-compatible systems (Unix-compatible), the path to the
692
directory where all applications should write temporary files.
693
Overridden by <strong>MAGICK_TMPDIR</strong> if it is set.</td></tr></table>
694
<table BORDER=0 WIDTH="94%">
696
<td width="3%"><br></td>
697
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
698
<img SRC="images/right_triangle_option.png"
699
ALT=">" BORDER=0 height=14
700
width=15><b><font face="Helvetica, Arial"
701
><font color="#00B04F"><font size="+1">
703
</font></font></font></b></td></tr></table>
704
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For Microsoft Windows, the path to the directory where applications
705
should write temporary files. Overridden by <strong>MAGICK_TMPDIR</strong> if it
706
is set.</td></tr></table>
707
<table BORDER=0 WIDTH="94%">
709
<td width="3%"><br></td>
710
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
711
<img SRC="images/right_triangle_option.png"
712
ALT=">" BORDER=0 height=14
713
width=15><b><font face="Helvetica, Arial"
714
><font color="#00B04F"><font size="+1">
716
</font></font></font></b></td></tr></table>
717
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>As per the OpenMP standard, this specifies the number of threads to
718
use in parallel regions. Some compilers default the number of threads to
719
use to the number of processor cores available while others default to
720
just one thread. See the OpenMP specification for other standard
721
adjustments and your compiler's manual for vendor-specific settings.</td></tr></table>
724
<i><a href="#top">Back to Contents</a></i>
726
<table BORDER=0 WIDTH="100%">
728
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
729
SRC="images/right_triangle.png" ALT=">" BORDER=0
730
height=14 width=15><b><font face="Helvetica, Arial"><font
731
color="#00B04F"><font size="+1">
732
<a NAME="comp-file"></a>Configuration Files
733
</font></font></font></b></td></tr></table>
734
<table width="94%" border="0" cellspacing="0" cellpadding="8">
735
<tr><td width="3%"><br></td><td>
736
<p>GraphicsMagick uses a number of XML format configuration files:
737
<table BORDER=0 WIDTH="94%">
739
<td width="3%"><br></td>
740
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
741
<img SRC="images/right_triangle_option.png"
742
ALT=">" BORDER=0 height=14
743
width=15><b><font face="Helvetica, Arial"
744
><font color="#00B04F"><font size="+1">
746
</font></font></font></b></td></tr></table>
747
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors configuration file</td></tr></table>
749
<?xml version="1.0"?>
751
<color name="AliceBlue" red="240" green="248" blue="255"
752
compliance="SVG, X11, XPM" />
755
<table BORDER=0 WIDTH="94%">
757
<td width="3%"><br></td>
758
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
759
<img SRC="images/right_triangle_option.png"
760
ALT=">" BORDER=0 height=14
761
width=15><b><font face="Helvetica, Arial"
762
><font color="#00B04F"><font size="+1">
764
</font></font></font></b></td></tr></table>
765
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>delegates configuration file</td></tr></table>
766
<table BORDER=0 WIDTH="94%">
768
<td width="3%"><br></td>
769
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
770
<img SRC="images/right_triangle_option.png"
771
ALT=">" BORDER=0 height=14
772
width=15><b><font face="Helvetica, Arial"
773
><font color="#00B04F"><font size="+1">
775
</font></font></font></b></td></tr></table>
776
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>logging configuration file</td></tr></table>
778
<?xml version="1.0"?>
780
<log events="None" />
781
<log output="stdout" />
782
<log filename="Magick-%d.log" />
783
<log generations="3" />
784
<log limit="2000" />
785
<log format="%t %r %u %p %m/%f/%l/%d:\n %e" />
788
<table BORDER=0 WIDTH="94%">
790
<td width="3%"><br></td>
791
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
792
<img SRC="images/right_triangle_option.png"
793
ALT=">" BORDER=0 height=14
794
width=15><b><font face="Helvetica, Arial"
795
><font color="#00B04F"><font size="+1">
797
</font></font></font></b></td></tr></table>
798
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>file header magic test configuration file</td></tr></table>
800
<?xml version="1.0"?>
802
<magic name="AVI" offset="0" target="RIFF" />
805
<table BORDER=0 WIDTH="94%">
807
<td width="3%"><br></td>
808
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
809
<img SRC="images/right_triangle_option.png"
810
ALT=">" BORDER=0 height=14
811
width=15><b><font face="Helvetica, Arial"
812
><font color="#00B04F"><font size="+1">
814
</font></font></font></b></td></tr></table>
815
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>loadable modules configuration file</td></tr></table>
817
<?xml version="1.0"?>
819
<module magick="8BIM" name="META" />
822
<table BORDER=0 WIDTH="94%">
824
<td width="3%"><br></td>
825
<td ALIGN=LEFT BGCOLOR="#FFFFFF">
826
<img SRC="images/right_triangle_option.png"
827
ALT=">" BORDER=0 height=14
828
width=15><b><font face="Helvetica, Arial"
829
><font color="#00B04F"><font size="+1">
831
</font></font></font></b></td></tr></table>
832
<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>master type (fonts) configuration file</td></tr></table>
834
<?xml version="1.0"?>
836
<<strong></strong>include file="type-windows.mgk" />
838
name="AvantGarde-Book"
839
fullname="AvantGarde Book"
846
metrics="/usr/local/share/ghostscript/fonts/a010013l.afm"
847
glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb"
853
<i><a href="#top">Back to Contents</a></i>
855
<table BORDER=0 WIDTH="100%">
857
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
858
SRC="images/right_triangle.png" ALT=">" BORDER=0
859
height=14 width=15><b><font face="Helvetica, Arial"><font
860
color="#00B04F"><font size="+1">
861
<a NAME="auth"></a>Authors
862
</font></font></font></b></td></tr></table>
863
<table width="94%" border="0" cellspacing="0" cellpadding="8">
864
<tr><td width="3%"><br></td><td>
869
Glenn Randers-Pehrson,<br>
870
William Radcliff,<br>
876
<i><a href="#top">Back to Contents</a></i>
878
<table BORDER=0 WIDTH="100%">
880
<td ALIGN=LEFT bgcolor="#FFFFFF"><img
881
SRC="images/right_triangle.png" ALT=">" BORDER=0
882
height=14 width=15><b><font face="Helvetica, Arial"><font
883
color="#00B04F"><font size="+1">
884
<a NAME="copy"></a>Copyright
885
</font></font></font></b></td></tr></table>
886
<table width="94%" border="0" cellspacing="0" cellpadding="8">
887
<tr><td width="3%"><br></td><td>
889
<strong>Copyright (C) 2002 - 2009 GraphicsMagick Group, an organization
890
dedicated to making software imaging solutions freely available.</strong>
892
<strong>Permission is hereby granted, free of charge, to any person obtaining a
893
copy of this software and associated documentation files
894
("GraphicsMagick"), to deal in GraphicsMagick without restriction,
895
including without limitation the rights to use, copy, modify, merge,
896
publish, distribute, sublicense, and/or sell copies of GraphicsMagick,
897
and to permit persons to whom GraphicsMagick is furnished to do so,
898
subject to the following conditions:</strong>
900
<strong>The above copyright notice and this permission notice shall be included
901
in all copies or substantial portions of GraphicsMagick.</strong>
903
<strong>The software is provided "as is", without warranty of any kind,
904
express or implied, including but not limited to the warranties of
905
merchantability, fitness for a particular purpose and noninfringement.
906
In no event shall GraphicsMagick Group be liable for any claim, damages
907
or other liability, whether in an action of contract, tort or otherwise,
908
arising from, out of or in connection with GraphicsMagick or the use or
909
other dealings in GraphicsMagick.</strong>
911
<strong>Except as contained in this notice, the name of the GraphicsMagick
912
Group shall not be used in advertising or otherwise to promote the sale,
913
use or other dealings in GraphicsMagick without prior written
914
authorization from the GraphicsMagick Group.</strong>
916
<strong>Additional copyrights and licenses apply to this software. You should
917
have received a copy of Copyright.txt with this package, which describes
918
additional copyrights and licenses which apply to this software;
919
otherwise see http://www.graphicsmagick.org/www/Copyright.html.</strong>
922
<i><a href="#top">Back to Contents</a></i>
926
[<a href="../index.html">Home</a>] [<a href="utilities.html">Utilities Index</a>]
928
<p align=center <a href="Copyright.html">Copyright © GraphicsMagick Group 2002 - 2008</a></p></td>