granicus.if.org Git - imagemagick/blob - www/conjure.html

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