granicus.if.org Git - imagemagick/blob - www/magick-vector-graphics.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   4 <head>\r
   5   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   7   <style type="text/css" media="screen,projection"><!--\r
   8     @import url("../www/magick.css");\r
   9   --></style>\r
  10   <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  11   <title>ImageMagick: Magick Vector Graphics</title>
  12   <meta http-equiv="Content-Language" content="en-US"/>
  13   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  14   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  15   <meta name="Generator" content="PHP"/>
  16   <meta name="Keywords" content="magick, vector, graphics, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  17   <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
  18   <meta name="Rating" content="GENERAL"/>
  19   <meta name="Robots" content="INDEX, FOLLOW"/>
  20   <meta name="Generator" content="ImageMagick Studio LLC"/>
  21   <meta name="Author" content="ImageMagick Studio LLC"/>
  22   <meta name="Revisit-after" content="2 DAYS"/>
  23   <meta name="Resource-type" content="document"/>
  24   <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
  25   <meta name="Distribution" content="Global"/>
  26 </head>\r
  27 \r
  28 <body id="www-imagemagick-org">\r
  29 <div class="titlebar">\r
  30 <a href="../index.html">\r
  31   <img src="../images/script.png" alt="[ImageMagick]"\r
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  33 <a href="http://www.networkredux.com">\r
  34   <img src="../images/networkredux.png" alt="[sponsor]"\r
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  36 <a href="http://www.imagemagick.org/discourse-server/">\r
  37   <img src="../images/logo.jpg" alt=""\r
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  39 <a href="../index.html">\r
  40   <img src="../images/sprite.jpg" alt=""\r
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  42 </div>\r
  43 \r
  44 <div class="eastbar">\r
  45 \r
  46 <div class="menu">
  47   <a href="../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>\r
  50 <div class="menu">
  51   <a href="../www/command-line-tools.html">Command-line Tools</a>
  52 </div>
  53 <div class="sub">
  54     <a href="../www/command-line-processing.html">Processing</a>
  55 </div>
  56 <div class="sub">
  57     <a href="../www/command-line-options.html">Options</a>
  58 </div>
  59 <div class="sub">
  60     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  61 </div>
  62 <div class="menu">
  63   <a href="../www/api.html">Program Interfaces</a>
  64 </div>
  65 <div class="sub">
  66     <a href="../www/magick-wand.html">MagickWand</a>
  67 </div>
  68 <div class="sub">
  69     <a href="../www/magick-core.html">MagickCore</a>
  70 </div>
  71 <div class="sub">
  72     <a href="../www/perl-magick.html">PerlMagick</a>
  73 </div>
  74 <div class="sub">
  75     <a href="../Magick++/">Magick++</a>
  76 </div>
  77 <div class="menu">
  78   <a href="../www/architecture.html">Architecture</a>
  79 </div>
  80 <div class="sep"></div>\r
  81 <div  class="menu">
  82    <a href="../www/install-source.html">Install from Source</a>
  83 </div>
  84 <div class="sub">
  85     <a href="../www/install-source.html#unix">Unix</a>
  86 </div>
  87 <div class="sub">
  88     <a href="../www/install-source.html#windows">Windows</a>
  89  </div>
  90 <div class="menu">
  91   <a href="../www/binary-releases.html">Binary Releases</a>
  92 </div>
  93 <div class="sub">
  94     <a href="../www/binary-releases.html#unix">Unix</a>
  95 </div>
  96 <div class="sub">
  97     <a href="../www/binary-releases.html#macosx">Mac OS X</a>
  98 </div>
  99 <div class="sub">
 100     <a href="../www/binary-releases.html#windows">Windows</a>
 101 </div>
 102 <div class="menu">
 103   <a href="../www/resources.html">Resources</a>
 104 </div>
 105 <div class="sep"></div>\r
 106 <div class="menu">
 107   <a href="../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div class="menu">
 111   <a href="http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a href="../www/sitemap.html">Site Map</a>
 116 </div>
 117 <div  class="sub">
 118     <a href="../www/links.html">Links</a>
 119 </div>
 120 <div class="sep"></div>\r
 121 <div  class="menu">
 122   <a href="../www/sponsors.html">Sponsors:</a>
 123
 124 <div class="sponsbox">
 125 <div  class="sponsor">
 126    <a href="http://www.buerodruck.de/stempel-service/index.html">Stempel bestellen</a><!-- 200910000035+ -->
 127 </div>
 128 <div  class="sponsor">
 129    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 130 </div>
 131 <div  class="sponsor">
 132    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 142 </div>
 143 <div  class="sponsor">
 144   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 145 </div>
 146 </div>
 147 </div>
 148 \r
 149 \r
 150 </div>\r
 151 \r
 152 <div class="main">\r
 153 \r
 154 \r
 155 <p class="navigation-index">[<a href="#intro">Introduction to Vector Graphics</a> &bull; <a href="#overview">MVG Overview</a> &bull; <a href="#primitives">Drawing Primitives</a>]</p>
 156
 157 <h2><a name="intro"></a>Introduction to Vector Graphics</h2>
 158 <div class="doc-section">
 159
 160 <p>This specification defines the features and syntax for Magick Vector Graphics (MVG), a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick.  You can use the language to draw from the
 161 command line, from an MVG file, from an <a href="http://www.w3.org/TR/SVG/" >SVG -- Scalable Vector Graphics</a> file or from one of the ImageMagick <a href="../www/api.html">program interfaces</a>.  Use this command, for example, to render an arc:</p>
 162
 163 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert -size 100x60 xc:skyblue -fill white -stroke black \  <br/>
 164     -draw "path 'M 30,40  A 30,20  20  0,0 70,20 A 30,20  20  1,0 30,40 Z '" \ <br/>
 165     arc.png</span></p>
 166 <p>and here is the result:</p>
 167
 168 <p class="image">
 169   <a href="../images/arc.png"><img src="../images/arc.png" width="100" height="60" alt="arc" /></a>
 170 </p>
 171
 172 <p>When the drawing gets sufficiently complex, we recommend you assemble the graphic primitives into a MVG file. For our example, we use <a href="../www/source/piechart.mvg">piechart.mvg</a>:</p>
 173
 174 <div class="viewport">
 175 <pre class="code">
 176   push graphic-context
 177     viewbox 0 0 624 369
 178     affine 0.283636 0 0 0.283846 -0 -0
 179     push graphic-context
 180       push graphic-context
 181         fill 'darkslateblue'
 182         stroke 'blue'
 183         stroke-width 1
 184         rectangle 1,1 2199,1299
 185       pop graphic-context
 186       push graphic-context
 187         font-size 40
 188         fill 'white'
 189         stroke-width 1
 190         text 600,1100 'Average: 20.0'
 191       pop graphic-context
 192       push graphic-context
 193         fill 'red'
 194         stroke 'black'
 195         stroke-width 5
 196         path 'M700.0,600.0 L340.0,600.0 A360.0,360.0 0 0,1 408.1452123287954,389.2376150414973 z'
 197       pop graphic-context
 198       push graphic-context
 199         font-size 40
 200         fill 'white'
 201         stroke-width 1
 202         text 1400,140 'MagickWand for PHP'
 203       pop graphic-context
 204       push graphic-context
 205         font-size 30
 206         fill 'white'
 207         stroke-width 1
 208         text 1800,140 '(10.0%)'
 209       pop graphic-context
 210       push graphic-context
 211         fill 'red'
 212         stroke 'black'
 213         stroke-width 4
 214         rectangle 1330,100 1370,140
 215       pop graphic-context
 216       push graphic-context
 217         fill 'yellow'
 218         stroke 'black'
 219         stroke-width 5
 220         path 'M700.0,600.0 L408.1452123287954,389.2376150414973 A360.0,360.0 0 0,1 976.5894480359858,369.56936567559273 z'
 221       pop graphic-context
 222       push graphic-context
 223         font-size 40
 224         fill 'white'
 225         stroke-width 1
 226         text 1400,220 'MagickCore'
 227       pop graphic-context
 228       push graphic-context
 229         font-size 30
 230         fill 'white'
 231         stroke-width 1
 232         text 1800,220 '(29.0%)'
 233       pop graphic-context
 234       push graphic-context
 235         fill 'yellow'
 236         stroke 'black'
 237         stroke-width 4
 238         rectangle 1330,180 1370,220
 239       pop graphic-context
 240       push graphic-context
 241         fill 'fuchsia'
 242         stroke 'black'
 243         stroke-width 5
 244         path 'M700.0,600.0 L976.5894480359858,369.56936567559273 A360.0,360.0 0 0,1 964.2680466142854,844.4634932636567 z'
 245       pop graphic-context
 246       push graphic-context
 247         font-size 40
 248         fill 'white'
 249         stroke-width 1
 250         text 1400,300 'MagickWand'
 251       pop graphic-context
 252       push graphic-context
 253         font-size 30
 254         fill 'white'
 255         stroke-width 1
 256         text 1800,300 '(22.9%)'
 257       pop graphic-context
 258       push graphic-context
 259         fill 'fuchsia'
 260         stroke 'black'
 261         stroke-width 4
 262         rectangle 1330,260 1370,300
 263       pop graphic-context
 264       push graphic-context
 265         fill 'blue'
 266         stroke 'black'
 267         stroke-width 5
 268         path 'M700.0,600.0 L964.2680466142854,844.4634932636567 A360.0,360.0 0 0,1 757.853099990584,955.3210081341651 z'
 269       pop graphic-context
 270       push graphic-context
 271         font-size 40
 272         fill 'white'
 273         stroke-width 1
 274         text 1400,380 'JMagick'
 275       pop graphic-context
 276       push graphic-context
 277         font-size 30
 278         fill 'white'
 279         stroke-width 1
 280         text 1800,380 '(10.6%)'
 281       pop graphic-context
 282       push graphic-context
 283         fill 'blue'
 284         stroke 'black'
 285         stroke-width 4
 286         rectangle 1330,340 1370,380
 287       pop graphic-context
 288       push graphic-context
 289         fill 'lime'
 290         stroke 'black'
 291         stroke-width 5
 292         path 'M700.0,600.0 L757.853099990584,955.3210081341651 A360.0,360.0 0 0,1 340.0,600.0 z'
 293       pop graphic-context
 294       push graphic-context
 295         font-size 40
 296         fill 'white'
 297         stroke-width 1
 298         text 1400,460 'Magick++'
 299       pop graphic-context
 300       push graphic-context
 301         font-size 30
 302         fill 'white'
 303         stroke-width 1
 304         text 1800,460 '(27.5%)'
 305       pop graphic-context
 306       push graphic-context
 307         fill 'lime'
 308         stroke 'black'
 309         stroke-width 4
 310         rectangle 1330,420 1370,460
 311       pop graphic-context
 312       push graphic-context
 313         font-size 100
 314         fill 'white'
 315         stroke-width 1
 316         text 100,150 'ImageMagick'
 317       pop graphic-context
 318       push graphic-context
 319         fill 'none'
 320         stroke 'black'
 321         stroke-width 5
 322         circle 700,600 700,960
 323       pop graphic-context
 324     pop graphic-context
 325   pop graphic-context
 326 </pre>
 327 </div>
 328
 329 <p>to render a pie chart with this command:</p>
 330
 331 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert piechart.mvg piechart.png</span></p>
 332 <p>which produces this rendering:</p>
 333
 334 <p class="image">
 335   <a href="../images/piechart.png"><img src="../images/piechart.png" width="624" height="369" alt="piechart" /></a>
 336 </p>
 337
 338 <p>However, in general, MVG is sufficiently difficult to work with that you probably want to use a program to generate your graphics in the SVG format.  ImageMagick automagically converts SVG to MVG and renders your image, for example, we render <a href="../www/source/piechart.svg">piechart.svg</a> with this command:</p>
 339
 340 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert piechart.svg piechart.jpg</span></p>
 341
 342 <p>to produce the same pie chart we created with the MVG language.</p>
 343
 344 <p>Drawing is available from many of the ImageMagick <a href="../www/api.html">program interfaces</a> as well.  ImageMagick converts the drawing API calls to MVG and renders it.  Here is example code written in the <a href="../www/magick-wand.html">MagickWand</a> language: </p>
 345
 346 <div class="viewport">
 347 <pre class="code">
 348    (void) PushDrawingWand(draw_wand);
 349    {
 350      const PointInfo points[6] =
 351      {
 352        { 180,504 },
 353        { 282.7,578.6 },
 354        { 243.5,699.4 },
 355        { 116.5,699.4 },
 356        { 77.26,578.6 },
 357        { 180,504 }
 358      };
 359
 360      DrawSetStrokeAntialias(draw_wand,True);
 361      DrawSetStrokeWidth(draw_wand,9);
 362      DrawSetStrokeLineCap(draw_wand,RoundCap);
 363      DrawSetStrokeLineJoin(draw_wand,RoundJoin);
 364      (void) DrawSetStrokeDashArray(draw_wand,0,(const double *)NULL);
 365      (void) PixelSetColor(color,"#4000c2");
 366      DrawSetStrokeColor(draw_wand,color);
 367      DrawSetFillRule(draw_wand,EvenOddRule);
 368      (void) PixelSetColor(color,"#800000");
 369      DrawSetFillColor(draw_wand,color);
 370      DrawPolygon(draw_wand,6,points);
 371    }
 372    (void) PopDrawingWand(draw_wand);
 373 </pre>
 374 </div>
 375
 376 </div>
 377
 378 <h2><a name="overview"></a>MVG Overview</h2>
 379 <div class="doc-section">
 380
 381 <p>MVG ignores all white-space between commands. This allows multiple MVG commands per line. It is common convention to terminate each MVG command with a new line to make MVG easier to edit and read. This syntax description uses indentation in MVG sequences to aid with understanding. Indentation is supported but is not required.</p>
 382
 383 <p>Metafile wrapper syntax (to support stand-alone MVG files):</p>
 384
 385 <pre class="text">
 386   push graphic-context
 387     viewbox 0 0 width height
 388     [ any other MVG commands ]
 389   pop graphic-context
 390 </pre>
 391
 392 <p>Pattern syntax (saving and restoring context):</p>
 393
 394 <pre class="text">
 395   push pattern id x,y width,height
 396    push graphic-context
 397     [ drawing commands ]
 398    pop graphic-context
 399   pop pattern
 400 </pre>
 401
 402 <p>an example is (%s is a identifier string):</p>
 403
 404 <pre class="text">
 405   push defs
 406    push pattern %s 10,10 20,20
 407     push graphic-context
 408      fill red
 409      rectangle 5,5 15,15
 410     pop graphic-context
 411     push graphic-context
 412      fill green
 413      rectangle 10,10 20,20
 414     pop graphic-context
 415    pop pattern
 416   pop defs
 417 </pre>
 418
 419 <p>For image tiling use:</p>
 420
 421 <pre class="text">
 422   push pattern id x,y width,height
 423    image Copy ...
 424   pop pattern
 425 </pre>
 426
 427 <p>Note you can use the pattern for either the fill or stroke like:</p>
 428
 429 <pre class="text">
 430   stroke url(#%s)
 431 </pre>
 432
 433 <p>or</p>
 434
 435 <pre class="text">
 436   fill url(#%s)
 437 </pre>
 438
 439 <p>The clip path defines a clipping area, where only the contained area to be drawn upon.  Areas outside of the clipping areare masked.</p>
 440
 441 <pre class="text">
 442   push defs
 443    push clip-path %s
 444     push graphic-context
 445      rectangle 10,10 20,20
 446     pop graphic-context
 447    pop clip-path
 448   pop defs
 449   clip-path url(#%s)
 450 </pre>
 451
 452 </div>
 453
 454 <h2><a name="primitives"></a>Drawing Primitives</h2>
 455 <div class="doc-section">
 456
 457 <p>Here is a complete description of the MVG drawing primitives:</p>
 458
 459 <dl class="doc">
 460
 461   <dt class="doc"><a name="affine" id="affine"></a>affine <em class="option">s<sub>x</sub></em>,<em class="option">r<sub>x</sub></em>,<em class="option">r<sub>y</sub></em>,<em class="option">s<sub>y</sub></em>,<em class="option">t<sub>x</sub></em>,<em class="option">t<sub>y</sub></em></dt>
 462
 463   <dd></dd>
 464
 465
 466
 467   <dt class="doc"><a name="arc" id="arc"></a>arc <em class="option">x<sub>0</sub></em>,<em class="option">y<sub>0</sub></em>&nbsp; &nbsp;<em class="option">x<sub>1</sub></em>,<em class="option">y<sub>1</sub></em>&nbsp; &nbsp;<em class="option">a<sub>0</sub></em>,<em class="option">a<sub>1</sub></em></dt>
 468
 469   <dd></dd>
 470
 471   <dt class="doc"><a name="bezier" id="bezier"></a>bezier <em class="option">x<sub>0</sub></em>,<em class="option">y<sub>0</sub></em> ... <em class="option">x<sub>n</sub></em>,<em class="option">y<sub>n</sub></em></dt>
 472
 473   <dd>
 474   <p><kbd>Bezier</kbd> (spline) requires three or more x,y coordinates to define its shape. The first and last points are the knots (preserved coordinates) and any intermediate coordinates are the control points. If two control points are specified, the line between each end knot and its sequentially respective control point determines the tangent direction of the curve at that end. If one control point is specified, the lines from the end knots to the one control point determines the tangent directions of the curve at each end. If more than two control points are specified, then the additional control points act in combination to determine the intermediate shape of the curve. In order to
 475   draw complex curves, it is highly recommended either to use the <kbd>Path</kbd> primitive or to draw multiple four-point bezier segments with the start and end knots of each successive segment repeated.</p>
 476   </dd>
 477
 478   <dt class="doc"><a name="border-color" id="border-color"></a>border-color <em class="option">color</em></dt>
 479
 480   <dd></dd>
 481
 482   <dt class="doc"><a name="circle" id="circle"></a>circle <em class="option">origin<sub>x</sub></em>,<em class="option">origin<sub>y</sub></em>&nbsp; &nbsp;<em class="option">perimeter<sub>x</sub></em>,<em class="option">perimeter<sub>y</sub></em></dt>
 483
 484   <dd></dd>
 485
 486   <dt class="doc"><a name="clip-path" id="clip-path"></a>clip-path url(<em class="option">name</em>)</dt>
 487
 488   <dd></dd>
 489
 490   <dt class="doc"><a name="clip-rule" id="clip-rule"></a>clip-rule <em class="option">rule</em></dt>
 491
 492   <dd>Choose from these rule types:
 493
 494         <p class="text">
 495           evenodd <br/>
 496           nonzero
 497         </p>
 498    </dd>
 499
 500   <dt class="doc"><a name="clip-units" id="clip-units"></a>clip-units <em class="option">units</em></dt>
 501
 502   <dd>Choose from these unit types:
 503
 504         <p class="text">
 505           userSpace <br/>
 506           userSpaceOnUse  <br/>
 507           objectBoundingBox <br/>
 508         </p>
 509   </dd>
 510
 511   <dt class="doc"><a name="color" id="color"></a>color <em class="option">x</em>,<em class="option">y</em> <em class="option">method</em></dt>
 512
 513
 514
 515
 516
 517
 518
 519
 520
 521
 522
 523 <dd>Choose from these method types:
 524
 525 <pre class="text">
 526   point
 527   replace
 528   floodfill
 529   filltoborder
 530   reset
 531 </pre>
 532
 533 </dd>
 534
 535   <dt class="doc"><a name="decorate" id="decorate"></a>decorate <em class="option">type</em></dt>
 536
 537
 538 <dd>Choose from these types of decorations:
 539
 540 <pre class="text">
 541   none
 542   line-through
 543   overline
 544   underline
 545 </pre>
 546
 547 </dd>
 548
 549   <dt class="doc"><a name="ellipse" id="ellipse"></a>ellipse <em class="option">center<sub>x</sub></em>,<em class="option">center<sub>y</sub></em>&nbsp; &nbsp;<em class="option">radius<sub>x</sub></em>,<em class="option">radius<sub>y</sub></em>&nbsp; &nbsp;<em class="option">arc<sub>start</sub></em>,<em class="option">arc<sub>stop</sub></em></dt>
 550
 551   <dt class="doc"><a name="fill" id="fill"></a>fill <em class="option">color</em></dt>
 552
 553 <dd>Choose from any of these <a href="../www/color.html">colors</a>.
 554 </dd>
 555
 556   <dt class="doc"><a name="fill-opacity" id="fill-opacity"></a>fill-opacity <em class="option">opacity</em></dt>
 557
 558
 559 <dd>The opacity ranges from 0.0 (fully transparent) to 1.0 (fully opaque) or as a percentage (e.g. 50%).
 560 </dd>
 561
 562   <dt class="doc"><a name="fill-rule" id="fill-rule"></a>fill-rule <em class="option">rule</em></dt>
 563
 564
 565 <dd>Choose from these rule types:
 566
 567 <pre class="text">
 568   evenodd
 569   nonzero
 570 </pre>
 571
 572 </dd>
 573
 574   <dt class="doc"><a name="font" id="font"></a>font <em class="option">name</em></dt>
 575
 576 <dd></dd>
 577
 578   <dt class="doc"><a name="font-family" id="font-family"></a>font-family <em class="option">family</em></dt>
 579
 580 <dd></dd>
 581
 582   <dt class="doc"><a name="font-size" id="font-size"></a>font-size <em class="option">point-size</em></dt>
 583
 584 <dd></dd>
 585
 586   <dt class="doc"><a name="font-stretch" id="font-stretch"></a>font-stretch <em class="option">type</em></dt>
 587
 588 <dd>Choose from these stretch types:
 589
 590 <pre class="text">
 591   all
 592   normal
 593   ultra-condensed
 594   extra-condensed
 595   condensed
 596   semi-condensed
 597   semi-expanded
 598   expanded
 599   extra-expanded
 600   ultra-expanded
 601 </pre>
 602
 603 </dd>
 604
 605   <dt class="doc"><a name="font-style" id="font-style"></a>font-style <em class="option">style</em></dt>
 606
 607
 608 <dd>Choose from these styles:
 609
 610 <pre class="text">
 611   all
 612   normal
 613   italic
 614   oblique
 615 </pre>
 616
 617 </dd>
 618
 619   <dt class="doc"><a name="font-weight" id="font-weight"></a>font-weight <em class="option">weight</em></dt>
 620
 621 <dd>Choose from these weights:
 622
 623 <pre class="text">
 624   all
 625   normal
 626   bold
 627   100
 628   200
 629   300
 630   400
 631   500
 632   600
 633   700
 634   800
 635   900
 636 </pre>
 637
 638 </dd>
 639
 640   <dt class="doc"><a name="gradient-units" id="gradient-units"></a>gradient-units <em class="option">units</em></dt>
 641
 642 <dd>Choose from these units:
 643
 644 <pre class="text">
 645   userSpace
 646   userSpaceOnUse
 647   objectBoundingBox
 648 </pre>
 649
 650 </dd>
 651
 652   <dt class="doc"><a name="gravity" id="gravity"></a>gravity <em class="option">type</em></dt>
 653
 654 <dd>Choose from these gravity types:
 655
 656 <pre class="text">
 657   NorthWest
 658   North
 659   NorthEast
 660   West
 661   Center
 662   East
 663   SouthWest
 664   South
 665   SouthEast
 666 </pre>
 667
 668 </dd>
 669
 670   <dt class="doc"><a name="image" id="image"></a>image <em class="option">compose x,y width,height 'filename'</em></dt>
 671
 672 <dd>Choose from these compose operations:
 673
 674 <table id="table" cellpadding="2" cellspacing="0" style="width: 93%">
 675   <tbody>
 676   <tr valign="top">
 677     <th align="left" style="width: 8%">Method</th>
 678     <th align="left">Description</th>
 679   </tr>
 680
 681   <tr valign="top">
 682     <td valign="top">clear</td>
 683     <td valign="top">Both the color and the alpha of the destination are cleared. Neither the source nor the destination are used as input.</td>
 684   </tr>
 685
 686   <tr valign="top">
 687     <td valign="top">src</td>
 688     <td valign="top">The source is copied to the destination. The destination is not used as input.</td>
 689   </tr>
 690
 691   <tr valign="top">
 692     <td valign="top">dst</td>
 693     <td valign="top">The destination is left untouched.</td>
 694   </tr>
 695
 696   <tr valign="top">
 697     <td valign="top"><b>src-over</b></td>
 698     <td valign="top">The source is composited over the destination.</td>
 699   </tr>
 700
 701   <tr valign="top">
 702     <td valign="top">dst-over</td>
 703     <td valign="top">The destination is composited over the source and the result replaces the destination.</td>
 704   </tr>
 705
 706   <tr valign="top">
 707     <td valign="top">src-in</td>
 708     <td valign="top">The part of the source lying inside of the destination replaces the destination.</td>
 709   </tr>
 710
 711   <tr valign="top">
 712     <td valign="top">dst-in</td>
 713     <td valign="top">The part of the destination lying inside of the source replaces the destination.</td>
 714   </tr>
 715
 716   <tr valign="top">
 717     <td valign="top">src-out</td>
 718     <td valign="top">The part of the source lying outside of the destination replaces the destination.</td>
 719   </tr>
 720
 721   <tr valign="top">
 722     <td valign="top">dst-out</td>
 723     <td valign="top">The part of the destination lying outside of the source         replaces the destination.</td>
 724   </tr>
 725
 726   <tr valign="top">
 727     <td valign="top">src-atop</td>
 728     <td valign="top">The part of the source lying inside of the destination is  composited onto the destination.</td>
 729   </tr>
 730
 731   <tr valign="top">
 732     <td valign="top">dst-atop</td>
 733     <td valign="top">The part of the destination lying inside of the source is composited over the source and replaces the destination.</td>
 734   </tr>
 735
 736   <tr valign="top">
 737     <td valign="top">multiply</td>
 738     <td valign="top">The source is multiplied by the destination and replaces the destination. The resultant color is always at least as dark as either of the two constituent colors. Multiplying any color with black produces black. Multiplying any color with white leaves the original color unchanged.</td>
 739   </tr>
 740
 741   <tr valign="top">
 742     <td valign="top">screen</td>
 743     <td valign="top">The source and destination are complemented and then multiplied and then replace the destination. The resultant color is always at least as light as either of the two constituent colors. Screening any color with white produces white. Screening any color with black leaves the original color unchanged.</td>
 744   </tr>
 745
 746   <tr valign="top">
 747     <td valign="top">overlay</td>
 748     <td valign="top">Multiplies or screens the colors, dependent on the destination color. Source colors overlay the destination whilst preserving its highlights and shadows. The destination color is not replaced, but is mixed with the source color to reflect the lightness or darkness of the destination.</td>
 749   </tr>
 750
 751   <tr valign="top">
 752     <td valign="top">darken</td>
 753     <td valign="top">Selects the darker of the destination and source colors.  The destination is replaced with the source when the source is darker, otherwise it is left unchanged.</td>
 754   </tr>
 755
 756   <tr valign="top">
 757     <td valign="top">lighten</td>
 758     <td valign="top">Selects the lighter of the destination and source colors.  The destination is replaced with the source when the source is lighter, otherwise it is left unchanged.</td>
 759   </tr>
 760
 761   <tr valign="top">
 762     <td valign="top">linear-light</td>
 763     <td valign="top">Increase contrast slightly with an impact on the foreground's tonal values.</td>
 764   </tr>
 765
 766   <tr valign="top">
 767     <td valign="top">color-dodge</td>
 768     <td valign="top">Brightens the destination color to reflect the source color. Painting with black produces no change.</td>
 769   </tr>
 770
 771   <tr valign="top">
 772     <td valign="top">color-burn</td>
 773     <td valign="top">Darkens the destination color to reflect the source color.  Painting with white produces no change.</td>
 774   </tr>
 775
 776   <tr valign="top">
 777     <td valign="top">hard-light</td>
 778     <td valign="top">Multiplies or screens the colors, dependent on the source color value. If the source color is lighter than 0.5, the destination is lightened as if it were screened. If the source color is darker than 0.5, the destination is darkened, as if it were multiplied. The degree of lightening or darkening is proportional to the difference between the source color and 0.5. If it is equal to 0.5 the destination is unchanged. Painting with pure black or white produces black or white.</td>
 779   </tr>
 780
 781   <tr valign="top">
 782     <td valign="top">soft-light</td>
 783     <td valign="top">Darkens or lightens the colors, dependent on the source color value. If the source color is lighter than 0.5, the destination is lightened. If the source color is darker than 0.5, the destination is darkened, as if it were burned in. The degree of darkening or lightening is proportional to the difference between the source color and 0.5. If it is equal to 0.5, the destination is unchanged. Painting with pure black or white produces a distinctly darker or lighter area, but does not result in pure black or white.</td>
 784   </tr>
 785
 786   <tr valign="top">
 787     <td valign="top">plus</td>
 788     <td valign="top">The source is added to the destination and replaces the destination. This operator is useful for animating a dissolve between two images.</td>
 789   </tr>
 790
 791   <tr valign="top">
 792     <td valign="top">add</td>
 793     <td valign="top">As per 'plus' but transparency data is treated as matte
 794         values. As such any transparent areas in either image remain
 795         transparent. </td>
 796   </tr>
 797
 798   <tr valign="top">
 799     <td valign="top">minus</td>
 800     <td valign="top">Subtract the colors in the source image from the
 801         destination image. When transparency is involved, Opaque areas will be
 802         subtracted from any destination opaque areas. </td>
 803   </tr>
 804
 805   <tr valign="top">
 806     <td valign="top">subtract</td>
 807     <td valign="top">Subtract the colors in the source image from the
 808         destination image. When transparency is involved transparent areas are
 809         subtracted, so only the opaque areas in the source remain opaque in
 810         the destination image. </td>
 811   </tr>
 812
 813   <tr valign="top">
 814     <td valign="top">difference</td>
 815     <td valign="top">Subtracts the darker of the two constituent colors from the lighter. Painting with white inverts the destination color. Painting with black produces no change.</td>
 816   </tr>
 817
 818   <tr valign="top">
 819     <td valign="top">exclusion</td>
 820     <td valign="top">Produces an effect similar to that of 'difference', but appears as lower contrast. Painting with white inverts the destination color. Painting with black produces no change.</td>
 821   </tr>
 822
 823   <tr valign="top">
 824     <td valign="top">xor</td>
 825     <td valign="top">The part of the source that lies outside of the destination is combined with the part of the destination that lies outside of the source.</td>
 826   </tr>
 827
 828   <tr valign="top">
 829     <td valign="top">copy-*</td>
 830     <td valign="top">Copy the specificed channel in the source image to the
 831         same channel in the destination image.  If the channel specified in
 832         the source image does not exist, (which can only happen for methods,
 833         '<kbd>copy-opacity</kbd>' or '<kbd>copy-black</kbd>') then it is
 834         assumed that the source image is a special grayscale channel image
 835         of the values to be copied. </td>
 836     </tr>
 837
 838   <tr valign="top">
 839     <td valign="top">change-mask</td>
 840     <td valign="top">Replace any destination pixel that is the similar to the source images pixel (as defined by the current <a href="#fuzz">-fuzz</a> factor), with transparency. </td>
 841   </tr>
 842   </tbody>
 843 </table>
 844
 845 </dd>
 846
 847   <dt class="doc"><a name="interline-spacing" id="interline-spacing"></a>interline-spacing <em class="option">pixels</em></dt>
 848
 849   <dd></dd>
 850
 851   <dt class="doc"><a name="interword-spacing" id="interword-spacing"></a>interword-spacing <em class="option">pixels</em></dt>
 852
 853   <dd></dd>
 854
 855   <dt class="doc"><a name="kerning" id="kerning"></a>kerning <em class="option">pixels</em></dt>
 856
 857   <dd></dd>
 858
 859   <dt class="doc"><a name="line" id="line"></a>line <em class="option">x,y x<sub>1</sub>,y<sub>1</sub></em></dt>
 860
 861   <dd></dd>
 862
 863   <dt class="doc"><a name="matte" id="matte"></a>matte <em class="option">x,y method</em></dt>
 864
 865 <dd>Choose from these methods:
 866
 867 <pre class="text">
 868   point
 869   replace
 870   floodfill
 871   filltoborder
 872   reset
 873 </pre>
 874
 875 </dd>
 876
 877   <dt class="doc"><a name="offset" id="offset"></a>offset <em class="option">offset</em></dt>
 878
 879   <dd></dd>
 880
 881   <dt class="doc"><a name="opacity" id="opacity"></a>opacity <em class="option">opacity</em></dt>
 882
 883 <dd>Use percent (e.g. 50%).</dd>
 884
 885   <dt class="doc"><a name="path" id="path"></a>path <em class="option">path</em></dt>
 886
 887   <dd></dd>
 888
 889   <dt class="doc"><a name="point" id="point"></a>point <em class="option">x,y</em></dt>
 890
 891   <dd></dd>
 892
 893   <dt class="doc"><a name="polygon" id="polygon"></a>polygon <em class="option">x,y x<sub>1</sub>,y<sub>1</sub>, ..., x<sub>n</sub>,y<sub>n</sub></em></dt>
 894
 895   <dd></dd>
 896
 897   <dt class="doc"><a name="polyline" id="polyline"></a>polyline <em class="option">x,y x<sub>1</sub>,y<sub>1</sub>, ..., x<sub>n</sub>,y<sub>n</sub></em></dt>
 898
 899   <dd></dd>
 900
 901   <dt class="doc"><a name="pop-clip-path" id="pop-clip-path"></a>pop clip-path</dt>
 902
 903   <dd></dd>
 904
 905   <dt class="doc"><a name="pop-defs" id="pop-defs"></a>pop defs</dt>
 906
 907   <dd></dd>
 908
 909   <dt class="doc"><a name="pop-gradient" id="pop-gradient"></a>pop gradient</dt>
 910
 911   <dd></dd>
 912
 913   <dt class="doc"><a name="pop-graphic-context" id="pop-graphic-context"></a>pop graphic-context</dt>
 914
 915   <dd></dd>
 916
 917   <dt class="doc"><a name="pop-pattern" id="pop-pattern"></a>pop pattern</dt>
 918
 919   <dd></dd>
 920
 921   <dt class="doc"><a name="push" id="push"></a>push clip-path <em class="option">name</em></dt>
 922
 923   <dd></dd>
 924
 925   <dt class="doc"><a name="push-defs" id="push-defs"></a>push defs</dt>
 926
 927   <dd></dd>
 928
 929   <dt class="doc"><a name="push-gradient-linear" id="push-gradient-linear"></a>push gradient <em class="option">id linear x,y x<sub>1</sub>,y<sub>1</sub></em></dt>
 930
 931   <dd></dd>
 932
 933   <dt class="doc"><a name="push-gradient-radial" id="push-gradient-radial"></a>push gradient <em class="option">id radial x<sub>c</sub>,c<sub>y</sub> x<sub>f</sub>,y<sub>f</sub> radius</em></dt>
 934
 935   <dd></dd>
 936
 937   <dt class="doc"><a name="push-graphic-context" id="push-graphic-context"></a>push graphic-context</dt>
 938
 939   <dd></dd>
 940
 941   <dt class="doc"><a name="push-pattern" id="push-pattern"></a>push pattern <em class="option">id radial x,y width,height</em></dt>
 942
 943   <dd></dd>
 944
 945   <dt class="doc"><a name="rectangle" id="rectangle"></a>rectangle <em class="option">x,y x<sub>1</sub>,y<sub>1</sub></em></dt>
 946
 947   <dd></dd>
 948
 949   <dt class="doc"><a name="rotate" id="rotate"></a>rotate <em class="option">angle</em></dt>
 950
 951   <dd></dd>
 952
 953   <dt class="doc"><a name="roundrectangle" id="roundrectangle"></a>roundrectangle <em class="option">x,y x<sub>1</sub>,y<sub>1</sub> width,height</em></dt>
 954
 955   <dd></dd>
 956
 957   <dt class="doc"><a name="scale" id="scale"></a>scale <em class="option">x,y</em></dt>
 958
 959   <dd></dd>
 960
 961   <dt class="doc"><a name="skewX" id="skewX"></a>skewX <em class="option">angle</em></dt>
 962
 963   <dd></dd>
 964
 965   <dt class="doc"><a name="skewY" id="skewY"></a>skewX <em class="option">angle</em></dt>
 966
 967   <dd></dd>
 968
 969   <dt class="doc"><a name="stop-color" id="stop-color"></a>stop-color <em class="option">color offset</em></dt>
 970
 971   <dd></dd>
 972
 973   <dt class="doc"><a name="stroke" id="stroke"></a>stroke <em class="option">color</em></dt>
 974
 975   <dd></dd>
 976
 977   <dt class="doc"><a name="stroke-antialias" id="stroke-antialias"></a>stroke-antialias <em class="option">0 &bull; 1</em></dt>
 978
 979   <dd></dd>
 980
 981   <dt class="doc"><a name="stroke-dasharray" id="stroke-dasharray"></a>stroke-dasharray <em class="option">none &bull; numeric-list</em></dt>
 982
 983   <dd></dd>
 984
 985   <dt class="doc"><a name="stroke-dashoffset" id="stroke-dashoffset"></a>stroke-dashoffset <em class="option">offset</em></dt>
 986
 987   <dd></dd>
 988
 989   <dt class="doc"><a name="stroke-linecap" id="stroke-linecap"></a>stroke-linecap <em class="option">type</em></dt>
 990
 991
 992   <dd>Choose from these cap types:
 993
 994 <pre class="text">
 995   butt
 996   round
 997   square
 998 </pre>
 999
1000   </dd>
1001
1002   <dt class="doc"><a name="stroke-linejoin" id="stroke-linejoin"></a>stroke-linejoin <em class="option">type</em></dt>
1003
1004   <dd>Choose from these join types:
1005
1006 <pre class="text">
1007   bevel
1008   miter
1009   round
1010 </pre>
1011
1012   </dd>
1013
1014   <dt class="doc"><a name="stroke-miterlimit" id="stroke-miterlimit"></a>stroke-miterlimit <em class="option">limit</em></dt>
1015
1016   <dd></dd>
1017
1018   <dt class="doc"><a name="stroke-opacity" id="stroke-opacity"></a>stroke-opacity <em class="option">opacity</em></dt>
1019
1020   <dd>The opacity ranges from 0.0 (fully transparent) to 1.0 (fully opaque) or as a percentage (e.g. 50%).
1021   </dd>
1022
1023   <dt class="doc"><a name="stroke-width" id="stroke-width"></a>stroke-width <em class="option">width</em></dt>
1024
1025   <dd></dd>
1026
1027   <dt class="doc"><a name="text" id="text"></a>text <em class="option">"text"</em></dt>
1028
1029   <dd></dd>
1030
1031   <dt class="doc"><a name="text-antialias" id="text-antialias"></a>text-antialias <em class="option">0 &bull; 1</em></dt>
1032
1033   <dd></dd>
1034
1035   <dt class="doc"><a name="text-undercolor" id="text-undercolor"></a>text-undercolor <em class="option">color</em></dt>
1036
1037   <dd></dd>
1038
1039   <dt class="doc"><a name="translate" id="translate"></a>translate <em class="option">x,y</em></dt>
1040
1041   <dd></dd>
1042
1043   <dt class="doc"><a name="viewbox" id="viewbox"></a>viewbox <em class="option">x,y x<sub>1</sub>,y<sub>1</sub></em></dt>
1044
1045   <dd></dd>
1046
1047 </dl>
1048
1049 </div>
1050
1051
1052 \r
1053 </div>\r
1054 \r
1055 <div id="linkbar">\r
1056  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
1057     <span id="linkbar-center">\r
1058       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
1059       <a href="../www/mailing-list.html">Mailing Lists</a> &bull;\r
1060     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
1061     </span>\r
1062     <span id="linkbar-east">&nbsp;</span>\r
1063   </div>\r
1064   <div class="footer">\r
1065     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
1066     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
1067   </div>\r
1068   <div style="clear: both; margin: 0; width: 100%; "></div>\r
1069 </body>\r
1070 </html>\r