]> granicus.if.org Git - imagemagick/blob - www/conjure.html
(no commit message)
[imagemagick] / www / conjure.html
1
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4 <html version="-//W3C//DTD XHTML 1.1//EN"
5       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
6       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7       xsi:schemaLocation="http://www.w3.org/1999/xhtml
8                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
9 <head>
10   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
11   <meta name=viewport content="width=device-width, initial-scale=0.3333334">
12   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"/>
13   <title>ImageMagick: Command-line Tools: Conjure</title>
14   <meta http-equiv="content-language" content="en-US"/>
15   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
16   <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
17   <meta name="application-name" content="ImageMagick"/>
18   <meta name="description" content="A collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats."/>
19   <meta name="application-url" content="http://www.imagemagick.org"/>
20   <meta name="generator" content="PHP"/>
21   <meta name="keywords" content="command-line, tools:, conjure, convert, edit, compose, image, pixel"/>
22   <meta name="rating" content="GENERAL"/>
23   <meta name="robots" content="INDEX, FOLLOW"/>
24   <meta name="generator" content="ImageMagick Studio LLC"/>
25   <meta name="author" content="ImageMagick Studio LLC"/>
26   <meta name="revisit-after" content="2 DAYS"/>
27   <meta name="resource-type" content="document"/>
28   <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
29   <meta name="distribution" content="Global"/>
30   <link rel="icon" href="../images/wand.png"/>
31   <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
32   <link rel="canonical" href="http://www.imagemagick.org" />
33   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
34
35   <!-- Add jQuery library -->
36   <script type="text/javascript" src="http://localhost/ajax/libs/jquery/2.1.0/jquery.min.js"></script>
37   
38   <!-- Add mousewheel plugin (this is optional) -->
39   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
40   
41   <!-- Add fancyBox -->
42   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.1.5" type="text/css" media="screen" />
43   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
44   
45   <!-- Optionally add helpers - button, thumbnail and/or media -->
46   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.5" type="text/css" media="screen" />
47   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.5"></script>
48   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.6"></script>
49   
50   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=1.0.7" type="text/css" media="screen" />
51   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=1.0.7"></script>
52   
53   <script type="text/javascript">
54         $(document).ready(function() {
55                 $(".fancybox").fancybox();
56         });
57   </script>
58
59   <!-- ImageMagick style -->
60   <style type="text/css" media="all">
61     @import url("../www/magick.css");
62   </style>
63 </head>
64
65 <body id="www-imagemagick-org">
66
67 <script type="text/javascript">
68   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
69   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
70   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
71   })(window,document,'offline-script','//www.google-analytics.com/analytics.js','ga');
72
73   ga('create', 'UA-40133312-1', 'imagemagick.org');
74   ga('send', 'pageview');
75 </script>
76
77 <div class="titlebar">
78 <div style="margin: 17px auto; float: left;">
79   <script type="text/javascript">
80   <!--
81     google_ad_client = "pub-3129977114552745";
82     google_ad_slot = "5439289906";
83     google_ad_width = 728;
84     google_ad_height = 90;
85   //-->
86   </script>
87   <script type="text/javascript"
88     src="http://localhost/pagead/show_ads.js">
89   </script>
90 </div>
91 <a href="../discourse-server">
92   <img src="../images/logo.jpg"
93   alt="ImageMagick Logo" width="123" height="118"
94   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
95 <a href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">
96   <img src="../images/sprite.jpg"
97   alt="ImageMagick Sprite" width="114" height="118"
98   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
99 </div>
100
101 <div class="westbar">
102
103 <div class="menu">
104   <a title="About ImageMagick" href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">About ImageMagick</a>
105 </div>
106 <div class="menu">
107   <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
108 </div>
109 <div class="sub">
110     <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
111 </div>
112 <div class="sub">
113     <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
114 </div>
115 <div class="sub">
116     <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
117 </div>
118 <div class="sub">
119     <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
120 </div>
121 <div class="sep"></div>
122 <div class="menu">
123   <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
124 </div>
125 <div class="sub">
126     <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
127 </div>
128 <div class="sub">
129     <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
130 </div>
131 <div class="sub">
132     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
133 </div>
134 <div class="menu">
135   <a title="Program Interfaces" href="api.html">Program Interfaces</a>
136 </div>
137 <div class="sub">
138     <a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
139 </div>
140 <div class="sub">
141     <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
142 </div>
143 <div class="sub">
144     <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
145 </div>
146 <div class="sub">
147     <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
148 </div>
149 <div class="sep"></div>
150 <div  class="menu">
151    <a title="Install from Source" href="install-source.html">Install from Source</a>
152 </div>
153 <div class="sub">
154     <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
155 </div>
156 <div class="sub">
157     <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
158  </div>
159 <div class="menu">
160   <a title="Resources" href="resources.html">Resources</a>
161 </div>
162 <div class="menu">
163   <a title="Architecture" href="architecture.html">Architecture</a>
164 </div>
165 <div class="menu">
166   <a title="Download" href="download.html">Download</a>
167 </div>
168 <div class="sep"></div>
169 <div class="menu">
170   <a title="Search" href="search.html">Search</a>
171 </div>
172 <div class="sep"></div>
173 <div class="menu">
174   <a title="Site Map" href="sitemap.html">Site Map</a>
175 </div>
176 <div  class="sub">
177   <a title="Site Map: Links" href="links.html">Links</a>
178 </div>
179 <div class="sep"></div>
180 </div>
181
182 <div class="eastbar">
183   <script type="text/javascript">
184     /* <![CDATA[ */
185     window.___gcfg = {
186       lang: 'en-US'
187     };
188
189     (function() {
190       var po = document.createElement('offline-script');
191       po.type = 'text/javascript';
192       po.async = true;
193       po.src = 'https://apis.google.com/js/plusone.js';
194       var script = document.getElementsByTagName('offline-script')[0];
195       script.parentNode.insertBefore(po, script);
196     })();
197     var gplusone = document.getElementById("gplusone");
198     gplusone.setAttribute("data-size","medium");
199     gplusone.setAttribute("data-count","true");
200     /* ]]> */
201   </script>
202   <script type="text/javascript">
203     /* <![CDATA[ */
204     (function() {
205         var po = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
206         po.type = 'text/javascript';
207         po.async = true;
208         po.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
209         var script = document.getElementsByTagName('offline-script')[0];
210         script.parentNode.insertBefore(po, script);
211     })();
212     /* ]]> */
213   </script>
214   <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://www.imagemagick.org/"></a></div>
215   <noscript>
216     <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
217     <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0" /></a>
218   </noscript>
219   <div class="g-plusone" data-size="standard" data-count="true"></div>
220 </div>
221
222 <div class="main">
223
224 <h1>ImageMagick Conjure Command-line Tool</h1>
225 <p class="navigation-index">[<a href="conjure.html#usage">Example Usage</a> • <a href="conjure.html#options">Option Summary</a>bull; <a href="conjure.html#msl">Magick Scripting Language (MSL)</a> ]</p>
226
227 <div class="doc-section">
228 <p>The <code>conjure</code> program gives you the ability to perform custom image processing tasks from a script written in the Magick Scripting Language (MSL).  MSL is XML-based and consists of action statements with attributes.  Actions include reading an image, processing an image, getting attributes from an image, writing an image, and more.  An attribute is a key/value pair that modifies the behavior of an action.  See <a href="command-line-processing.html">Command Line Processing</a> for advice on how to structure your <code>conjure</code> command or see below for example usages of the command.</p>
229 </div>
230
231 <h2><a id="usage"></a>Example Usage</h2>
232 <div class="doc-section">
233
234 <p>We list a few examples of the <code>conjure</code> command here to illustrate its usefulness and ease of use. To get started, here is simple <code>conjure</code> command:</p>
235
236 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>conjure -dimensions 400x400 incantation.msl</span></p>
237 <p>The MSL script <a href="../source/incantation.msl">incantation.msl</a> used above is here:</p>
238
239 <pre class="text">
240   &lt;?xml version="1.0" encoding="UTF-8"?&gt;
241   &lt;image&gt;
242     &lt;read filename="image.gif" /&gt;
243     &lt;get width="base-width" height="base-height" /&gt;
244     &lt;resize geometry="%[dimensions]" /&gt;
245     &lt;get width="resize-width" height="resize-height" /&gt;
246     &lt;print output="Image sized from %[base-width]x%[base-height] to %[resize-width]x%[resize-height].\n" /&gt;
247     &lt;write filename="image.png" /&gt;
248   &lt;/image&gt;
249 </pre>
250
251 <p>In this example, a family stayed home for their vacation but as far as their friends are concerned they went to a beautiful beach in the Caribbean:</p>
252
253 <pre class="text">
254   &lt;?xml version="1.0" encoding="UTF-8"?>
255   &lt;group>
256       &lt;image id="family">
257           &lt;read filename="family.gif"/>
258           &lt;resize geometry="300x300"/>
259       &lt;/image>
260       &lt;image id="palm-trees">
261           &lt;read filename="palm-trees.gif"/>
262           &lt;resize geometry="300x100"/>
263       &lt;/image>
264       &lt;image>
265           &lt;read filename="beach.jpg"/>
266           &lt;composite image="family" geometry="+30+40"/>
267           &lt;composite image="palm-trees" geometry="+320+90"/>
268       &lt;/image>
269       &lt;write filename="family-vacation.png"/>
270   &lt;/group>
271 </pre>
272
273 <p>Here we display the width in pixels of text for a particular font and pointsize.</p>
274
275 <pre class="text">
276   &lt;?xml version="1.0" encoding="UTF-8"?&gt;
277   &lt;image&gt;
278     &lt;query-font-metrics text="ImageMagick" font="helvetica" pointsize="48" /&gt;
279     &lt;print output="Text width is %[msl:font-metrics.width] pixels.\n" /&gt;
280   &lt;/image&gt;
281 </pre>
282
283 <p>The <code>query-font-metrics</code> tag supports these properties:</p>
284
285 <pre class="text">
286     msl:font-metrics.pixels_per_em.x
287     msl:font-metrics.pixels_per_em.y
288     msl:font-metrics.ascent
289     msl:font-metrics.descent
290     msl:font-metrics.width
291     msl:font-metrics.height
292     msl:font-metrics.max_advance
293     msl:font-metrics.bounds.x1
294     msl:font-metrics.bounds.y1
295     msl:font-metrics.bounds.x2
296     msl:font-metrics.bounds.y2
297     msl:font-metrics.origin.x
298     msl:font-metrics.origin.y
299 </pre>
300
301 <p>MSL supports most methods and attributes discussed in the <a href="perl-magick.html">Perl API for ImageMagick</a>.
302 </p>
303
304 <p>In addition, MSL supports the <code>swap</code> element with a single <code>indexes</code> element.</p>
305
306 <p>You can find additional examples of using <code>conjure</code> in <a href="http://www.ibm.com/developerworks/library/l-graf/?ca=dnt-428">Graphics from the Command Line</a>.  Further discussion is available in <a href="http://www.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine">More Graphics from the Command Line</a> and <a href="http://www.imagemagick.org/Usage/">Examples of ImageMagick Usage</a>.</p>
307
308 </div>
309
310 <h2><a id="options"></a>Option Summary</h2>
311 <div class="doc-section">
312
313 <p>The <code>conjure</code> command recognizes these options.  Click on an option to get more details about how that option works.</p>
314
315 <table class="doc">
316   <tbody>
317   <tr>
318     <th align="left">Option</th>
319     <th align="left">Description</th>
320   </tr>
321
322   <tr>
323     <td valign="top"><a href="command-line-options.html#debug">-debug <em class="option">events</em></a></td>
324     <td valign="top">display copious debugging information</td>
325   </tr>
326
327   <tr>
328     <td valign="top"><a href="command-line-options.html#help">-help</a></td>
329     <td valign="top">print program options</td>
330   </tr>
331
332   <tr>
333     <td valign="top"><a href="command-line-options.html#log">-log <em class="option">format</em></a></td>
334     <td valign="top">format of debugging information</td>
335   </tr>
336
337   <tr>
338     <td valign="top"><a href="command-line-options.html#monitor">-monitor</a></td>
339     <td valign="top">monitor progress</td>
340   </tr>
341
342   <tr>
343     <td valign="top"><a href="command-line-options.html#quiet">-quiet</a></td>
344     <td valign="top">suppress all warning messages</td>
345   </tr>
346
347   <tr>
348     <td valign="top"><a href="command-line-options.html#regard-warnings">-regard-warnings</a></td>
349     <td valign="top">pay attention to warning messages.</td>
350   </tr>
351
352   <tr>
353     <td valign="top"><a href="command-line-options.html#seed">-seed <em class="option">value</em></a></td>
354     <td valign="top">seed a new sequence of pseudo-random numbers</td>
355   </tr>
356
357   <tr>
358     <td valign="top"><a href="command-line-options.html#verbose">-verbose</a></td>
359     <td valign="top">print detailed information about the image</td>
360   </tr>
361
362   <tr>
363     <td valign="top"><a href="command-line-options.html#version">-version</a></td>
364     <td valign="top">print version information</td>
365   </tr>
366
367   </tbody>
368 </table>
369
370 </div>
371 <h2><a id="msl"></a>Magick Scripting Language</h2>
372 <p>The <code>conjure</code> command recognizes these MSL elements.  Any element with a strike-thru is not supported yet.</p>
373 <div class="doc-section">
374 <table class="doc">
375 <caption>Magick Scripting Language (MSL)</caption>
376 <tbody>
377   <tr>
378     <th>Method</th>
379     <th style="width: 40%;">Parameters</th>
380     <th style="width: 40%;">Description</th>
381   </tr>
382   <tr>
383     <td valign="top"><strike>adaptiveblur</strike></td>
384     <td valign="top">geometry="geometry", radius="double", sigma="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
385
386     <td valign="top">adaptively blur the image with a Gaussian operator of the given radius and standard deviation (sigma).  Decrease the effect near edges.</td>
387   </tr>
388
389   <tr>
390     <td valign="top"><strike>adaptiveresize</strike></td>
391     <td valign="top">geometry="geometry", width="integer", height="integer", filter="Point, Box, Triangle, Hermite, Hanning, Hamming, Blackman, Gaussian, Quadratic, Cubic, Catrom, Mitchell, Lanczos, Bessel, Sinc", support="double", blur="double"</td>
392
393     <td valign="top">adaptively resize image using data dependant triangulation. Specify blur &gt; 1 for blurry or &lt; 1 for sharp</td>
394   </tr>
395
396   <tr>
397     <td valign="top"><strike>adaptivesharpen</strike></td>
398
399     <td valign="top">geometry="geometry", radius="double", sigma="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
400     <td valign="top">adaptively sharpen the image with a Gaussian operator of the given radius and standard deviation (sigma).  Increase the effect near edges.</td>
401   </tr>
402
403   <tr>
404     <td valign="top"><strike>adaptivethreshold</strike></td>
405     <td valign="top">geometry="geometry", width="integer", height="integer", offset="integer"</td>
406     <td valign="top">local adaptive thresholding.</td>
407
408   </tr>
409
410   <tr>
411     <td valign="top"><strike>addnoise</strike></td>
412     <td valign="top">noise="Uniform, Gaussian, Multiplicative, Impulse, Laplacian, Poisson", attenuate="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
413     <td valign="top">add noise to an image</td>
414
415   </tr>
416
417   <tr>
418     <td valign="top"><strike>affinetransform</strike></td>
419     <td valign="top">affine="array of float values", translate="float, float", scale= "float, float", rotate="float", skewX="float", skewY="float", interpolate="Average, Bicubic, Bilinear, Filter, Integer, Mesh, NearestNeighbor", background="color name"</td>
420
421     <td valign="top">affine transform image</td>
422   </tr>
423
424   <tr>
425     <td valign="top"><strike>affinity</strike></td>
426     <td valign="top">image="image-handle", method="None, FloydSteinberg, Riemersma"</td>
427
428     <td valign="top">choose a particular set of colors from this image</td>
429   </tr>
430
431   <tr>
432     <td valign="top">&lt;annotate&gt;</td>
433     <td valign="top">text="string", font="string", family="string", style="Normal, Italic, Oblique, Any", stretch="Normal, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, SemiExpanded, Expanded, ExtraExpanded, UltraExpanded", weight="integer", pointsize="integer", density="geometry", stroke="color name", strokewidth="integer", fill="color name", undercolor="color name", kerning="float", geometry="geometry", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast", antialias="true, false", x="integer", y="integer", affine="array of float values", translate="float, float", scale="float, float", rotate="float". skewX="float", skewY= "float", align="Left, Center, Right", encoding="UTF-8", interline-spacing="double", interword-spacing="double", direction="right-to-left, left-to-right"</td>
434
435     <td valign="top">annotate an image with text. See QueryFontMetrics to get font metrics without rendering any text.</td>
436   </tr>
437
438   <tr>
439     <td valign="top"><strike>autogamma</strike></td>
440     <td valign="top">channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
441
442     <td valign="top">automagically adjust gamma level of image</td>
443   </tr>
444
445   <tr>
446     <td valign="top"><strike>autolevel</strike></td>
447     <td valign="top">channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
448     <td valign="top">automagically adjust color levels of image</td>
449
450   </tr>
451
452   <tr>
453     <td valign="top"><strike>autoorient</strike></td>
454     <td valign="top"> </td>
455     <td valign="top">adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation)</td>
456   </tr>
457
458   <tr>
459
460     <td valign="top"><strike>blackthreshold</strike></td>
461     <td valign="top">threshold="string", , channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
462     <td valign="top">force all pixels below the threshold intensity into black</td>
463   </tr>
464
465   <tr>
466
467     <td valign="top"><strike>blueshift</strike></td>
468     <td valign="top">factor="double",</td>
469     <td valign="top">simulate a scene at nighttime in the moonlight.  Start with a factor of 1.5.</td>
470   </tr>
471
472   <tr>
473     <td valign="top">&lt;blur&gt;</td>
474
475     <td valign="top">geometry="geometry", radius="double", sigma="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
476     <td valign="top">reduce image noise and reduce detail levels with a Gaussian operator of the given radius and standard deviation (sigma).</td>
477   </tr>
478
479   <tr>
480     <td valign="top">&lt;border&gt;</td>
481     <td valign="top">geometry="geometry", width="integer", height="integer", bordercolor="color name",  compose="Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyOpacity, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor ",</td>
482
483     <td valign="top">surround the image with a border of color</td>
484   </tr>
485
486   <tr>
487     <td valign="top">&lt;charcoal&gt;</td>
488     <td valign="top">geometry="geometry", radius="double", sigma="double"</td>
489
490     <td valign="top">simulate a charcoal drawing</td>
491   </tr>
492
493   <tr>
494     <td valign="top">&lt;chop&gt;</td>
495     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer"</td>
496
497     <td valign="top">chop an image</td>
498   </tr>
499
500   <tr>
501     <td valign="top"><strike>clamp</strike></td>
502     <td valign="top">channel="Red, RGB, All, etc."</td>
503     <td valign="top">set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.</td>
504
505   </tr>
506
507   <tr>
508     <td valign="top"><strike>clip</strike></td>
509     <td valign="top">id="name", inside=""true, false"",</td>
510     <td valign="top">apply along a named path from the 8BIM profile.</td>
511
512   </tr>
513
514   <tr>
515     <td valign="top"><strike>clipmask</strike></td>
516     <td valign="top">mask="image-handle"</td>
517     <td valign="top">clip image as defined by the image mask</td>
518   </tr>
519
520   <tr>
521     <td valign="top"><strike>clut</strike></td>
522     <td valign="top">image="image-handle",  interpolate="Average, Bicubic, Bilinear, Filter, Integer, Mesh, NearestNeighbor", channel="Red, RGB, All, etc."</td>
523     <td valign="top">apply a color lookup table to an image sequence</td>
524   </tr>
525
526   <tr>
527     <td valign="top"><strike>coalesce</strike></td>
528     <td valign="top"> </td>
529     <td valign="top">merge a sequence of images</td>
530   </tr>
531
532   <tr>
533     <td valign="top"><strike>color</strike></td>
534
535     <td valign="top">color="color name"</td>
536     <td valign="top">set the entire image to this color.</td>
537   </tr>
538
539   <tr>
540     <td valign="top"><strike>colordecisionlist</strike></td>
541     <td valign="top">filename="string",</td>
542
543     <td valign="top">color correct with a color decision list.</td>
544   </tr>
545
546   <tr>
547     <td valign="top">&lt;colorize&gt;</td>
548     <td valign="top">fill="color name", blend="string"</td>
549
550     <td valign="top">colorize the image with the fill color</td>
551   </tr>
552
553   <tr>
554     <td valign="top"><strike>colormatrix</strike></td>
555     <td valign="top">matrix="array of float values"</td>
556     <td valign="top">apply color correction to the image.  Although you can use variable sized matrices, typically you use a 5 x 5 for an RGBA image and a 6x6 for CMYKA.  A 6x6 matrix is required for offsets (populate the last column with normalized values).</td>
557
558   </tr>
559
560   <tr>
561     <td valign="top">&lt;comment&gt;</td>
562     <td valign="top">string</td>
563     <td valign="top">add a comment to your image</td>
564   </tr>
565
566   <tr>
567     <td valign="top"><strike>comparelayers</strike></td>
568     <td valign="top">method="any, clear, overlay"</td>
569     <td valign="top">compares each image with the next in a sequence and returns the minimum bounding region of any pixel differences it discovers.  Images do not have to be the same size, though it is best that all the images are coalesced (images are all the same size, on a flattened canvas, so as to represent exactly how a specific frame should look).</td>
570   </tr>
571
572   <tr>
573
574     <td valign="top">&lt;composite&gt;</td>
575     <td valign="top">image="image-handle", compose="Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyOpacity, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor ", mask="image-handle", geometry="geometry", x="integer", y="integer", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast", opacity="integer", tile="True, False", rotate="double", color="color name", blend="geometry", interpolate="undefined, average, bicubic, bilinear, filter, integer, mesh, nearest-neighbor, spline"</td>
576
577     <td valign="top">composite one image onto another.  Use the rotate parameter in concert with the tile parameter.</td>
578   </tr>
579
580   <tr>
581     <td valign="top">&lt;contrast&gt;</td>
582     <td valign="top">sharpen="True, False"</td>
583     <td valign="top">enhance or reduce the image contrast</td>
584
585   </tr>
586
587   <tr>
588     <td valign="top"><strike>contraststretch</strike></td>
589     <td valign="top">levels="string", 'black-point'="double", 'white-point'="double", channel="Red, RGB, All, etc."</td>
590
591     <td valign="top">improve the contrast in an image by `stretching' the range of intensity values</td>
592   </tr>
593
594   <tr>
595     <td valign="top"><strike>convolve</strike></td>
596     <td valign="top">coefficients="array of float values", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", bias="double"</td>
597
598     <td valign="top">apply a convolution kernel to the image. Given a kernel "order" , you would supply "order*order" float values (e.g. 3x3 implies 9 values).</td>
599   </tr>
600
601   <tr>
602     <td valign="top">&lt;crop&gt;</td>
603
604     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer", fuzz="double", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast"</td>
605     <td valign="top">crop an image</td>
606
607   </tr>
608
609   <tr>
610     <td valign="top"><strike>cyclecolormap</strike></td>
611     <td valign="top">amount="integer"</td>
612     <td valign="top">displace image colormap by amount</td>
613   </tr>
614
615   <tr>
616     <td valign="top"><strike>decipher</strike></td>
617     <td valign="top">passphrase="string"</td>
618     <td valign="top">convert cipher pixels to plain pixels</td>
619   </tr>
620
621   <tr>
622
623     <td valign="top"><strike>deconstruct</strike></td>
624     <td valign="top"> </td>
625     <td valign="top">break down an image sequence into constituent parts</td>
626   </tr>
627
628   <tr>
629     <td valign="top"><strike>deskew</strike></td>
630     <td valign="top">geometry="string",threshold="double"</td>
631
632     <td valign="top">straighten the image</td>
633   </tr>
634
635   <tr>
636     <td valign="top">&lt;despeckle&gt;</td>
637     <td valign="top"> </td>
638     <td valign="top">reduce the speckles within an image</td>
639   </tr>
640
641   <tr>
642     <td valign="top"><strike>difference</strike></td>
643     <td valign="top">image="image-handle"</td>
644     <td valign="top">compute the difference metrics between two images </td>
645   </tr>
646
647   <tr>
648
649     <td valign="top"><strike>distort</strike></td>
650     <td valign="top">points="array of float values", method="Affine, AffineProjection, Bilinear, Perspective, Resize, ScaleRotateTranslate", virtual-pixel="Background Black Constant Dither Edge Gray Mirror Random Tile Transparent White", best-fit="True, False"</td>
651     <td valign="top">distort image</td>
652   </tr>
653
654   <tr>
655     <td valign="top">&lt;draw&gt;</td>
656     <td valign="top">primitive="point, line, rectangle, arc, ellipse, circle, path, polyline, polygon, bezier, color, matte, text, @"filename"", points="string" , method=""Point, Replace, Floodfill, FillToBorder, Reset"", stroke="color name", fill="color name", font="string", pointsize="integer", strokewidth="float", antialias="true, false", bordercolor="color name", x="float", y="float", dash-offset="float", dash-pattern="array of float values", affine="array of float values", translate="float, float", scale="float, float", rotate="float",  skewX="float", skewY="float", interpolate="undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline", kerning="float", text="string", vector-graphics="string", interline-spacing="double", interword-spacing="double", direction="right-to-left, left-to-right"</td>
657
658     <td valign="top">annotate an image with one or more graphic primitives.</td>
659   </tr>
660
661   <tr>
662     <td valign="top"><strike>encipher</strike></td>
663     <td valign="top">passphrase="string"</td>
664     <td valign="top">convert plain pixels to cipher pixels</td>
665
666   </tr>
667
668   <tr>
669     <td valign="top">&lt;edge&gt;</td>
670     <td valign="top">radius="double"</td>
671     <td valign="top">enhance edges within the image with a convolution filter of the given radius.</td>
672   </tr>
673
674   <tr>
675     <td valign="top">&lt;emboss&gt;</td>
676     <td valign="top">geometry="geometry", radius="double", sigma="double"</td>
677     <td valign="top">emboss the image with a convolution filter of the given radius and standard deviation (sigma).</td>
678
679   </tr>
680
681   <tr>
682     <td valign="top">&lt;enhance&gt;</td>
683     <td valign="top"> </td>
684     <td valign="top">apply a digital filter to enhance a noisy image</td>
685   </tr>
686
687   <tr>
688
689     <td valign="top">&lt;equalize&gt;</td>
690     <td valign="top">channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow" </td>
691     <td valign="top">perform histogram equalization to the image</td>
692   </tr>
693
694   <tr>
695     <td valign="top"><strike>extent</strike></td>
696
697     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer", fuzz="double", background="color name", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast"</td>
698
699     <td valign="top">set the image size</td>
700   </tr>
701
702   <tr>
703     <td valign="top"><strike>evaluate</strike></td>
704     <td valign="top">value="double", operator=""Add, And, Divide, LeftShift, Max, Min, Multiply, Or, Rightshift, Subtract, Xor"", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow" </td>
705
706     <td valign="top">apply an arithmetic, relational, or logical expression to the image</td>
707   </tr>
708
709   <tr>
710     <td valign="top"><strike>filter</strike></td>
711     <td valign="top">kernel="string", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", bias="double"</td>
712
713     <td valign="top">apply a convolution kernel to the image.</td>
714   </tr>
715
716   <tr>
717     <td valign="top">&lt;flip&gt;</td>
718     <td valign="top"> </td>
719     <td valign="top">reflect the image scanlines in the vertical direction</td>
720   </tr>
721
722   <tr>
723     <td valign="top">&lt;flop&gt;</td>
724     <td valign="top"> </td>
725     <td valign="top">reflect the image scanlines in the horizontal direction</td>
726   </tr>
727
728   <tr>
729     <td valign="top"><strike>floodfillpaint</strike></td>
730
731     <td valign="top">geometry="geometry", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", x="integer", y="integer" , fill="color name", bordercolor="color name", fuzz="double", invert="True, False"</td>
732
733     <td valign="top">changes the color value of any pixel that matches the color of the target pixel and is a neighbor. If you specify a border color, the color value is changed for any neighbor pixel that is not that color.</td>
734   </tr>
735
736   <tr>
737     <td valign="top"><strike>forwardfouriertransform</strike></td>
738     <td valign="top">magnitude="True, False"</td>
739     <td valign="top">implements the forward discrete Fourier transform (DFT)</td>
740
741   </tr>
742
743   <tr>
744     <td valign="top">&lt;frame&gt;</td>
745     <td valign="top">geometry="geometry", width="integer", height="integer", inner="integer", outer="integer", fill="color name",  compose="Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyOpacity, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor ",</td>
746
747     <td valign="top">surround the image with an ornamental border</td>
748   </tr>
749
750   <tr>
751     <td valign="top"><strike>function</strike></td>
752     <td valign="top">parameters="array of float values", function="Sin", virtual-pixel="Background Black Constant Dither Edge Gray Mirror Random Tile Transparent White"</td>
753
754     <td valign="top">apply a function to the image</td>
755   </tr>
756
757   <tr>
758     <td valign="top">&lt;gamma&gt;</td>
759     <td valign="top">gamma="string", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
760
761     <td valign="top">gamma correct the image</td>
762   </tr>
763
764   <tr>
765     <td valign="top"><strike>gaussianblur</strike></td>
766     <td valign="top">geometry="geometry", radius="double", sigma="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
767
768     <td valign="top">reduce image noise and reduce detail levels with a Gaussian operator of the given radius and standard deviation (sigma).</td>
769   </tr>
770
771   <tr>
772     <td valign="top"><strike>getpixel</strike></td>
773     <td valign="top">geometry="geometry", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", normalize="true, false", x="integer", y="integer"</td>
774
775     <td valign="top">get a single pixel. By default normalized pixel values are returned.</td>
776   </tr>
777
778   <tr>
779     <td valign="top"><strike>getpixels</strike></td>
780     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer", map="string", normalize="true, false"</td>
781
782     <td valign="top">get image pixels as defined by the map (e.g. "RGB", "RGBA", etc.).  By default non-normalized pixel values are returned.</td>
783   </tr>
784
785   <tr>
786     <td valign="top"><strike>grayscale</strike></td>
787     <td valign="top">channel="Average, Brightness, Lightness, Rec601Luma, Rec601Luminance, Rec709Luma, Rec709Luminance, RMS"</td>
788     <td valign="top">convert image to grayscale</td>
789
790   </tr>
791
792   <tr>
793     <td valign="top"><strike>haldclut</strike></td>
794     <td valign="top">image="image-handle",  channel="Red, RGB, All, etc."</td>
795     <td valign="top">apply a Hald color lookup table to an image sequence</td>
796
797   </tr>
798
799   <tr>
800     <td valign="top"><strike>identify</strike></td>
801     <td valign="top">file="file", features="distance", unique="True, False"</td>
802     <td valign="top">identify the attributes of an image</td>
803
804   </tr>
805
806   <tr>
807     <td valign="top">&lt;implode&gt;</td>
808     <td valign="top">amount="double", interpolate="undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline"</td>
809     <td valign="top">implode image pixels about the center</td>
810
811   </tr>
812
813   <tr>
814     <td valign="top"><strike>inversediscretefouriertransform</strike></td>
815     <td valign="top">magnitude="True, False"</td>
816     <td valign="top">implements the inverse discrete Fourier transform (DFT)</td>
817   </tr>
818
819   <tr>
820     <td valign="top">&lt;label&gt;</td>
821     <td valign="top">string</td>
822     <td valign="top">assign a label to an image</td>
823   </tr>
824
825   <tr>
826
827     <td valign="top"><strike>layers</strike></td>
828     <td valign="top">method="coalesce, compare-any, compare-clear, compare-over, composite, dispose, flatten, merge, mosaic, optimize, optimize-image, optimize-plus, optimize-trans, remove-dups, remove-zero",  compose="Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyOpacity, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, LinearLight, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor ", dither="true, false"</td>
829     <td valign="top">compare each image the GIF disposed forms of the previous image in the sequence.  From this, attempt to select the smallest cropped image to replace each frame, while preserving the results of the animation.</td>
830   </tr>
831
832   <tr>
833
834     <td valign="top">&lt;level&gt;</td>
835     <td valign="top">levels="string", 'black-point'="double", 'gamma'="double", 'white-point'="double", channel="Red, RGB, All, etc."</td>
836     <td valign="top">adjust the level of image contrast</td>
837
838   </tr>
839
840   <tr>
841     <td valign="top"><strike>levelcolors</strike></td>
842     <td valign="top">invert=&gt;"True, False", 'black-point'="string",  'white-point'="string", channel="Red, RGB, All, etc."</td>
843
844     <td valign="top">level image with the given colors</td>
845   </tr>
846
847   <tr>
848     <td valign="top"><strike>linearstretch</strike></td>
849     <td valign="top">levels="string", 'black-point'="double", 'white-point'="double"</td>
850
851     <td valign="top">linear with saturation stretch</td>
852   </tr>
853
854   <tr>
855     <td valign="top"><strike>liquidresize</strike></td>
856     <td valign="top">geometry="geometry", width="integer", height="integer", delta-x="double", rigidity="double"</td>
857
858     <td valign="top">rescale image with seam-carving.</td>
859   </tr>
860
861   <tr>
862     <td valign="top">&lt;magnify&gt;</td>
863     <td valign="top"> </td>
864     <td valign="top">double the size of the image with pixel art scaling</td>
865   </tr>
866
867   <tr>
868     <td valign="top"><strike>mask</strike></td>
869     <td valign="top">mask="image-handle"</td>
870     <td valign="top">composite image pixels as defined by the mask</td>
871   </tr>
872
873   <tr>
874
875     <td valign="top"><strike>mattefloodfill</strike></td>
876     <td valign="top">geometry="geometry", x="integer", y="integer" , matte="integer", bordercolor="color name", fuzz="double", invert="True, False"</td>
877
878     <td valign="top">changes the matte value of any pixel that matches the color of the target pixel and is a neighbor. If you specify a border color, the matte value is changed for any neighbor pixel that is not that color.</td>
879   </tr>
880
881   <tr>
882     <td valign="top"><strike>medianfilter</strike></td>
883     <td valign="top">geometry="geometry", width="integer", height="integer", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
884
885     <td valign="top">replace each pixel with the median intensity pixel of a neighborhood.</td>
886   </tr>
887
888   <tr>
889     <td valign="top">&lt;minify&gt;</td>
890     <td valign="top"> </td>
891     <td valign="top">half the size of an image</td>
892   </tr>
893
894   <tr>
895     <td valign="top"><strike>mode</strike></td>
896     <td valign="top">geometry="geometry", width="integer", height="integer", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
897     <td valign="top">make each pixel the "predominant color" of the neighborhood.</td>
898
899   </tr>
900
901   <tr>
902     <td valign="top">&lt;modulate&gt;</td>
903     <td valign="top">factor="geometry", brightness="double", saturation="double", hue="double", lightness="double", whiteness="double", blackness="double" </td>
904
905     <td valign="top">vary the brightness, saturation, and hue of an image by the specified percentage</td>
906   </tr>
907
908   <tr>
909     <td valign="top"><strike>morphology</strike></td>
910     <td valign="top">kernel="string", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", iterations="integer"</td>
911
912     <td valign="top">apply a morphology method to the image.</td>
913   </tr>
914
915   <tr>
916     <td valign="top"><strike>motionblur</strike></td>
917     <td valign="top">geometry="geometry", radius="double", sigma="double", angle="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
918
919     <td valign="top">reduce image noise and reduce detail levels with a Gaussian operator of the given radius and standard deviation (sigma) at the given angle to simulate the effect of motion</td>
920   </tr>
921
922   <tr>
923     <td valign="top">&lt;negate&gt;</td>
924     <td valign="top">gray="True, False", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
925     <td valign="top">replace each pixel with its complementary color (white becomes black, yellow becomes blue, etc.)</td>
926
927   </tr>
928
929   <tr>
930     <td valign="top">&lt;normalize&gt;</td>
931     <td valign="top">channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow" </td>
932     <td valign="top">transform image to span the full range of color values</td>
933   </tr>
934
935   <tr>
936     <td valign="top"><strike>oilpaint</strike></td>
937     <td valign="top">radius="integer"</td>
938     <td valign="top">simulate an oil painting</td>
939   </tr>
940
941   <tr>
942
943     <td valign="top">&lt;opaque&gt;</td>
944     <td valign="top">color="color name",
945 fill="color name", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", invert="True, False"</td>
946     <td valign="top">change this color to the fill color within the image</td>
947   </tr>
948
949   <tr>
950     <td valign="top"><strike>ordereddither</strike></td>
951     <td valign="top">threshold="threshold, checks, o2x2, o3x3, o4x4, o8x8, h4x4a, h6x6a, h8x8a, h4x4o, h6x6o, h8x8o, h16x16o, hlines6x4", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
952     <td valign="top">order dither image</td>
953   </tr>
954
955   <tr>
956     <td valign="top"><strike>perceptible</strike></td>
957     <td valign="top">epsilon="double", channel="Red, RGB, All, etc."</td>
958     <td valign="top">set each pixel whose value is less than |"epsilon"| to "-epsilon" or "epsilon" (whichever is closer) otherwise the pixel value remains unchanged..</td>
959
960   </tr>
961
962   <tr>
963     <td valign="top"><strike>polaroid</strike></td>
964     <td valign="top">caption="string", angle="double", pointsize="double", font="string", stroke= "color name", strokewidth="integer", fill="color name", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast",  background="color name"</td>
965
966     <td valign="top">simulate a Polaroid picture.</td>
967   </tr>
968
969   <tr>
970     <td valign="top"><strike>posterize</strike></td>
971     <td valign="top">levels="integer", dither="True, False"</td>
972
973     <td valign="top">reduce the image to a limited number of color level</td>
974   </tr>
975
976   <tr>
977     <td valign="top">&lt;profile&gt;</td>
978     <td valign="top">name="string", profile="blob", rendering-intent="Undefined, Saturation, Perceptual, Absolute, Relative", black-point-compensation="True, False"</td>
979
980     <td valign="top">add or remove ICC or IPTC image profile; name is formal name (e.g. ICC or filename; set profile to '' to remove profile</td>
981   </tr>
982
983   <tr>
984     <td valign="top">&lt;quantize&gt;</td>
985     <td valign="top">colors="integer", colorspace="RGB, Gray, Transparent, OHTA, XYZ, YCbCr, YIQ, YPbPr, YUV, CMYK, sRGB, HSL, HSB", treedepth= "integer", dither="True, False", dither-method="Riemersma, Floyd-Steinberg", measure_error="True, False", global_colormap="True, False", transparent-color="color"</td>
986
987     <td valign="top">preferred number of colors in the image</td>
988   </tr>
989
990   <tr>
991     <td valign="top"><strike>radialblur</strike></td>
992     <td valign="top">geometry="geometry", angle="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
993
994     <td valign="top">radial blur the image.</td>
995   </tr>
996
997   <tr>
998     <td valign="top">&lt;raise&gt;</td>
999     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer", raise="True, False"</td>
1000
1001     <td valign="top">lighten or darken image edges to create a 3-D effect</td>
1002   </tr>
1003
1004   <tr>
1005     <td valign="top"><strike>reducenoise</strike></td>
1006     <td valign="top">geometry="geometry", width="integer", height="integer", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1007
1008     <td valign="top">reduce noise in the image with a noise peak elimination filter</td>
1009   </tr>
1010
1011   <tr>
1012     <td valign="top"><strike>remap</strike></td>
1013     <td valign="top">image="image-handle",  dither="true, false", dither-method="Riemersma, Floyd-Steinberg"</td>
1014
1015     <td valign="top">replace the colors of an image with the closest color from a reference image.</td>
1016   </tr>
1017
1018   <tr>
1019     <td valign="top">&lt;resample&gt;</td>
1020     <td valign="top">density="geometry", x="double", y="double", filter="Point, Box, Triangle, Hermite, Hanning, Hamming, Blackman, Gaussian, Quadratic, Cubic, Catrom, Mitchell, Lanczos, Bessel, Sinc", support="double"</td>
1021
1022     <td valign="top">resample image to desired resolution. Specify blur &gt; 1 for blurry or &lt; 1 for sharp</td>
1023   </tr>
1024
1025   <tr>
1026     <td valign="top">&lt;resize&gt;</td>
1027
1028     <td valign="top">geometry="geometry", width="integer", height="integer", filter="Point, Box, Triangle, Hermite, Hanning, Hamming, Blackman, Gaussian, Quadratic, Cubic, Catrom, Mitchell, Lanczos, Bessel, Sinc", support="double", blur="double"</td>
1029     <td valign="top">scale image to desired size. Specify blur &gt; 1 for blurry or &lt; 1 for sharp</td>
1030
1031   </tr>
1032
1033   <tr>
1034     <td valign="top">&lt;roll&gt;</td>
1035     <td valign="top">geometry="geometry", x="integer", y="integer"</td>
1036     <td valign="top">roll an image vertically or horizontally</td>
1037
1038   </tr>
1039
1040   <tr>
1041     <td valign="top">&lt;rotate&gt;</td>
1042     <td valign="top">degrees="double", background="color name"</td>
1043     <td valign="top">rotate an image</td>
1044
1045   </tr>
1046
1047   <tr>
1048     <td valign="top">&lt;sample&gt;</td>
1049     <td valign="top">geometry="geometry", width="integer", height="integer"</td>
1050     <td valign="top">scale image with pixel sampling.</td>
1051
1052   </tr>
1053
1054   <tr>
1055     <td valign="top">&lt;scale&gt;</td>
1056     <td valign="top">geometry="geometry", width="integer", height="integer"</td>
1057     <td valign="top">scale image to desired size</td>
1058
1059   </tr>
1060
1061   <tr>
1062     <td valign="top">&lt;segment&gt;</td>
1063     <td valign="top">colorspace="RGB, Gray, Transparent, OHTA, XYZ, YCbCr, YCC, YIQ, YPbPr, YUV, CMYK", verbose="True, False", cluster-threshold="double", smoothing-threshold="double"</td>
1064     <td valign="top">segment an image by analyzing the histograms of the color components and identifying units that are homogeneous</td>
1065
1066   </tr>
1067
1068   <tr>
1069     <td valign="top"><strike>selectiveblur</strike></td>
1070     <td valign="top">geometry="geometry", radius="double", sigma="double", threshold="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1071
1072     <td valign="top">selectively blur pixels within a contrast threshold.</td>
1073   </tr>
1074   <tr>
1075     <td valign="top"><strike>separate</strike></td>
1076     <td valign="top">channel="Red, RGB, All, etc."</td>
1077     <td valign="top">separate a channel from the image into a grayscale image</td>
1078
1079   </tr>
1080
1081   <tr>
1082     <td valign="top">&lt;shade&gt;</td>
1083     <td valign="top">geometry="geometry", azimuth="double", elevation="double", gray="true, false"</td>
1084
1085     <td valign="top">shade the image using a distant light source</td>
1086   </tr>
1087
1088   <tr>
1089     <td valign="top"><strike>setpixel</strike></td>
1090     <td valign="top">geometry="geometry", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", color="array of float values", x="integer", y="integer", color="array of float values"</td>
1091
1092     <td valign="top">set a single pixel.  By default normalized pixel values are expected.</td>
1093   </tr>
1094
1095   <tr>
1096     <td valign="top">&lt;shadow&gt;</td>
1097     <td valign="top">geometry="geometry", opacity="double", sigma="double", x="integer", y="integer"</td>
1098
1099     <td valign="top">simulate an image shadow</td>
1100   </tr>
1101
1102   <tr>
1103     <td valign="top">&lt;sharpen&gt;</td>
1104     <td valign="top">geometry="geometry", radius="double", sigma="double", bias="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1105
1106     <td valign="top">sharpen the image with a Gaussian operator of the given radius and standard deviation (sigma).</td>
1107   </tr>
1108
1109   <tr>
1110     <td valign="top">&lt;shave&gt;</td>
1111     <td valign="top">geometry="geometry", width="integer", height="integer"</td>
1112
1113     <td valign="top">shave pixels from the image edges</td>
1114   </tr>
1115
1116   <tr>
1117     <td valign="top">&lt;shear&gt;</td>
1118     <td valign="top">geometry="geometry", x="double", y="double" fill="color name"</td>
1119
1120     <td valign="top">shear the image along the X or Y axis by a positive or negative shear angle</td>
1121   </tr>
1122
1123   <tr>
1124     <td valign="top"><strike>sigmoidalcontrast</strike></td>
1125     <td valign="top">geometry="string", 'contrast'="double", 'mid-point'="double" channel="Red, RGB, All, etc.", sharpen="True, False"</td>
1126
1127     <td valign="top">sigmoidal non-lineraity contrast control.  Increase the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows. Contrast" indicates how much to increase the contrast (0 is none; 3 is typical; 20 is a lot);  mid-point" indicates where midtones fall in the resultant image (0 is white; 50% is middle-gray; 100% is black). To decrease contrast, set sharpen to False.</td>
1128   </tr>
1129
1130   <tr>
1131     <td valign="top">&lt;signature&gt;</td>
1132
1133     <td valign="top"> </td>
1134     <td valign="top">generate an SHA-256 message digest for the image pixel stream</td>
1135   </tr>
1136
1137   <tr>
1138     <td valign="top"><strike>sketch</strike></td>
1139     <td valign="top">geometry="geometry", radius="double", sigma="double", angle="double"</td>
1140
1141     <td valign="top">sketch the image with a Gaussian operator of the given radius and standard deviation (sigma) at the given angle</td>
1142   </tr>
1143
1144   <tr>
1145     <td valign="top">&lt;solarize&gt;</td>
1146     <td valign="top">geometry="string", threshold="double", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1147
1148     <td valign="top">negate all pixels above the threshold level</td>
1149   </tr>
1150
1151   <tr>
1152     <td valign="top"><strike>sparsecolor</strike></td>
1153     <td valign="top">points="array of float values", method="Barycentric, Bilinear, Shepards, Voronoi", virtual-pixel="Background Black Constant Dither Edge Gray Mirror Random Tile Transparent White"</td>
1154
1155     <td valign="top">interpolate the image colors around the supplied points</td>
1156   </tr>
1157
1158   <tr>
1159     <td valign="top"><strike>splice</strike></td>
1160     <td valign="top">geometry="geometry", width="integer", height="integer", x="integer", y="integer", fuzz="double", background="color name", gravity="NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast"</td>
1161
1162     <td valign="top">splice an image</td>
1163   </tr>
1164
1165   <tr>
1166     <td valign="top">&lt;spread&gt;</td>
1167     <td valign="top">radius="double", interpolate="undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline"</td>
1168
1169     <td valign="top">displace image pixels by a random amount</td>
1170   </tr>
1171
1172   <tr>
1173     <td valign="top"><strike>statistic</strike></td>
1174     <td valign="top">geometry="geometry", width="integer", height="integer", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow", type="Median, Mode, Mean, Maximum, Minimum, ReduceNoise"</td>
1175
1176     <td valign="top">replace each pixel with corresponding statistic from the neighborhood.</td>
1177   </tr>
1178   <tr>
1179     <td valign="top">&lt;stegano&gt;</td>
1180     <td valign="top">image="image-handle", offset="integer"</td>
1181     <td valign="top">hide a digital watermark within the image</td>
1182
1183   </tr>
1184
1185   <tr>
1186     <td valign="top">&lt;stereo&gt;</td>
1187     <td valign="top">image="image-handle", x="integer", y="integer"</td>
1188     <td valign="top">composites two images and produces a single image that is the composite of a left and right image of a stereo pair</td>
1189
1190   </tr>
1191
1192   <tr>
1193     <td valign="top">&lt;strip&gt;</td>
1194     <td valign="top"> </td>
1195     <td valign="top">strip an image of all profiles and comments.</td>
1196   </tr>
1197
1198   <tr>
1199
1200     <td valign="top">&lt;swirl&gt;</td>
1201     <td valign="top">degrees="double", interpolate="undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline"</td>
1202     <td valign="top">swirl image pixels about the center</td>
1203   </tr>
1204
1205   <tr>
1206
1207     <td valign="top"><strike>texture</strike></td>
1208     <td valign="top">texture="image-handle"</td>
1209     <td valign="top">name of texture to tile onto the image background</td>
1210   </tr>
1211
1212   <tr>
1213     <td valign="top"><strike>thumbnail</strike></td>
1214
1215     <td valign="top">geometry="geometry", width="integer", height="integer"</td>
1216     <td valign="top">changes the size of an image to the given dimensions and removes any associated profiles.</td>
1217   </tr>
1218
1219   <tr>
1220     <td valign="top">&lt;threshold&gt;</td>
1221
1222     <td valign="top">threshold="string", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1223     <td valign="top">threshold the image</td>
1224   </tr>
1225
1226   <tr>
1227     <td valign="top"><strike>tint</strike></td>
1228
1229     <td valign="top">fill="color name", blend="string"</td>
1230     <td valign="top">tint the image with the fill color.</td>
1231   </tr>
1232
1233   <tr>
1234     <td valign="top">&lt;transparent&gt;</td>
1235
1236     <td valign="top">color="color name", invert="True, False"</td>
1237     <td valign="top">make this color transparent within the image</td>
1238   </tr>
1239
1240   <tr>
1241     <td valign="top"><strike>transpose</strike></td>
1242
1243     <td valign="top"> </td>
1244     <td valign="top">flip image in the vertical direction and rotate 90 degrees</td>
1245   </tr>
1246
1247   <tr>
1248     <td valign="top"><strike>transverse</strike></td>
1249     <td valign="top"> </td>
1250     <td valign="top">flop image in the horizontal direction and rotate 270 degrees</td>
1251
1252   </tr>
1253
1254   <tr>
1255     <td valign="top">&lt;trim&gt;</td>
1256     <td valign="top"> </td>
1257     <td valign="top">remove edges that are the background color from the image</td>
1258   </tr>
1259
1260   <tr>
1261
1262     <td valign="top"><strike>unsharpmask</strike></td>
1263     <td valign="top">geometry="geometry", radius="double", sigma="double", gain="double", threshold="double"</td>
1264     <td valign="top">sharpen the image with the unsharp mask algorithm.</td>
1265
1266   </tr>
1267
1268   <tr>
1269     <td valign="top"><strike>vignette</strike></td>
1270     <td valign="top">geometry="geometry", radius="double", sigma="double", x="integer", y="integer", background="color name"</td>
1271
1272     <td valign="top">offset the edges of the image in vignette style</td>
1273   </tr>
1274
1275   <tr>
1276     <td valign="top"><strike>wave</strike></td>
1277     <td valign="top">geometry="geometry", amplitude="double", wavelength="double", interpolate="undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline"</td>
1278
1279     <td valign="top">alter an image along a sine wave</td>
1280   </tr>
1281
1282   <tr>
1283     <td valign="top"><strike>whitethreshold</strike></td>
1284     <td valign="top">threshold="string", , channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow"</td>
1285
1286     <td valign="top">force all pixels above the threshold intensity into white</td>
1287   </tr>
1288 </tbody>
1289 </table>
1290 </div>
1291
1292 </div>
1293
1294 <div id="linkbar">
1295     <span id="linkbar-west"> </span>
1296
1297     <span id="linkbar-center">
1298       <a href="../discourse-server">Discourse Server</a> •
1299       <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
1300       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
1301       <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
1302     </span>
1303     <span id="linkbar-east"> </span>
1304 </div>
1305 <div class="footer">
1306   <span id="footer-west">©  1999-2014 ImageMagick Studio LLC</span>
1307   <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
1308 </div>
1309 <div style="clear: both; margin: 0; width: 100%; "></div>
1310 </body>
1311 </html>