rmagick 1.7.1

data/doc/css/doc.css

@@ -0,0 +1,299 @@
+
+/* Global styles. */
+
+a:link {
+  text-decoration: none;
+}
+
+a:visited {
+  color: #7F7FFF;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+a:active {
+  color: white;
+  background-color: blue;
+  text-decoration: underline;
+}
+
+body {
+    background-color: white;
+    color: black;
+    font-size: 100.01%;
+}
+
+img {
+  display: block;
+  border-width: 0;
+}
+
+h1 {
+  background-color: #900;
+  font-size: x-large;
+  font-weight: bold;
+  color: #ebebeb;
+  padding: .3em 5px .5em 5px;
+  margin: 0 0;
+}
+
+h6#header {
+    padding-top: 0.5em;
+    font-size: small;
+    font-weight: bold;
+    color: #545454;
+    letter-spacing: .5em;
+    text-align: center;
+    margin: 0 0;
+}
+
+/*
+ * Table of Contents styles
+ */
+#toc h2 {
+  background-color: #545454;
+  color: white;
+  padding: 5px .3em .3em .3em;
+  margin: 0 0;
+}
+
+#toc h3 {
+  clear: both;
+  padding-left: 5px;
+  padding-right: 1em;
+  border-bottom: thin solid black;
+}
+
+#toc ul {
+  list-style: none;
+}
+
+.toccol {
+  float: left;
+  width: 33%;
+}
+
+/*
+ * Navigation bar. Appears at both top and bottom.
+ */
+div.nav {
+  clear: both;
+  background-color: #900;
+  color: white;
+  font-size: 8pt;
+  font-family: sans-serif;
+  font-weight: bold;
+  margin-bottom: 0;
+  margin-top: 1em;    /* Separate from header at the top and  */
+                      /* from the last element at the bottom  */
+  padding: 2px;
+  padding-left: 8px;
+  padding-right: 8px;
+  text-align: right;
+}
+
+div.nav a:link {
+  text-decoration: none;
+  color: white;
+}
+
+div.nav a:visited {
+  text-decoration: none;
+  color: white;
+}
+
+div.nav a:hover {
+  background-color: white;
+  color: #900;
+}
+
+div.nav a:active {
+  text-decoration: none;
+  color: white;
+}
+
+span.superclass {
+  font-size: normal;
+  font-weight: normal;
+}
+
+span.mixin {
+  font-size: smaller;
+  padding-left: 1em;
+  }
+
+/*
+ * Method signatures, descriptions
+ */
+
+h2.methods  {           /* "class methods" */
+  margin-top: 2em;
+  margin-bottom: 0;
+  padding: .5em 5px .5em 5px;
+  background-color: #663;
+  color: white;
+  clear: both;
+}
+
+/*
+ * Method signatures
+ */
+
+div.sig {
+  margin-bottom: .5em;
+}
+
+.sig h3 {   /* method name: total width 210px */
+  background-color: #c0c0c0;
+  color: #000;
+  width: 225px;
+  float: left;
+  padding-left: 5px;
+  margin-top: 0;
+}
+
+.sig p {
+  background-color: #c0c0c0;
+  color: #000;
+  padding-right: 5px;
+  padding-left: 230px;
+  padding-bottom: 1em;
+  margin-top: 0;
+}
+
+/*
+ * Method descriptions
+ */
+
+.desc {
+  margin-left: 235px;
+  margin-bottom: 2em;
+}
+
+.desc h4 {
+  position: relative;
+  left: -235px;
+  padding-left: 5px;
+  background-image: url(../ex/images/graydient230x6.gif);
+  background-repeat: repeat-y;
+  color: black;
+  font-weight: normal;
+  font-size: small;
+  padding-bottom: 0;
+  margin-bottom: 0;
+  margin-top: 0;
+}
+
+.desc dl,p,pre,img,ul {
+  margin-top: 0;
+}
+
+.desc dt {
+  font-style: italic;
+  display: compact;
+}
+
+.arg {
+  font-style: italic;
+}
+
+/*
+ * The next 2 styles are for example scripts.
+ */
+.example, .desc pre {
+  padding: 0 .5em 1em .5em;   /* Tell Konq to not pad at the top. */
+  padd\ing-top: 1em;          /* Tell everybody else to use 1em padding at the top. */
+  background-color: #f8f8f8;
+  border-left: thin dotted black;
+  border-top: thin dotted black;
+  border-bottom: 4px solid #c0c0c0;
+  border-right: 4px solid #c0c0c0
+}
+
+.example {
+    margin-left: 100px;
+    margin-right: 100px;
+    margin-bottom: 1em;
+  }
+
+  .example_cutline {
+     margin-left: 100px;
+     margin-right: 100px;
+     font-style: italic;
+  }
+
+/*
+ *  The following three styles govern the display of example
+ *  images with rollover effects and the "spin" image that
+ *  accompanies them.
+ */
+/*
+ * This <p> encloses example images and the spin image.
+ */
+p.rollover {
+  position: relative;
+}
+
+/*
+ * Neither the example image nor the spin.gif get a border.
+ */
+.rollover img {
+  display: inline;
+  border-width: 0;
+}
+
+/*
+ * The spin.gif image must be positioned at the upper-right
+ * corner of the example image.
+ */
+img.spin {
+  position: absolute;
+  top: 0;
+  left: 204px;
+}
+
+/*
+ *  Plain small gray tables
+ */
+.simple_table {
+  border-collapse: collapse;
+  border: thin solid black;
+  background-color: #f8f8f8;
+  margin-bottom: 1em;
+  margin-top: 1em;
+  width: 100%;
+}
+.simple_table td {
+  padding: 3px 1em 3px 1em;
+}
+.simple_table caption {
+  font-weight: bold;
+}
+
+/*
+ * Miscellaneous styles
+ */
+/*
+ * Insert white space between elements when CSS not enabled.
+ */
+p.spacer {
+  display: none;
+}
+
+/*
+ * Text quoted from the xMagick doc.
+ */
+
+.imquote {
+  color: #545454;
+}
+.imquote p, .imquote ul {
+    margin-left: 100px;
+    margin-right: 100px;
+    padding-bottom: 1em;
+  }
+
+

data/doc/css/popup.css

@@ -0,0 +1,34 @@
+/* Styles for the example script popup */
+
+body {
+  background:#fffff0;
+  margin:10px;
+  }
+
+h1 {
+  color: #663;
+  width: 100%;
+  text-align: center;
+}
+
+.bodybox {
+  background-color:white;
+  border:1px solid black;
+  text-align:left;
+}
+
+.bodyfloat  {
+  padding:10px;
+  color:black;
+  text-align:left;
+}
+
+#close {
+  width: 100%;
+  text-align: center;
+}
+
+a:link {
+  color:#663;
+  font-weight:bold;
+}

data/doc/draw.html

@@ -0,0 +1,3108 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta name="generator" content=
+  "HTML Tidy for Linux/x86 (vers 1st September 2004), see www.w3.org" />
+
+  <title>RMagick: class Draw</title>
+  <meta http-equiv="Content-Type" content=
+  "text/html; charset=us-ascii" />
+  <meta name="GENERATOR" content="Quanta Plus" />
+  <meta name="Copyright" content=
+  "Copyright (C) 2004 by Timothy P. Hunter" />
+  <link rel="stylesheet" type="text/css" href="css/doc.css" />
+<script type="text/javascript" src="scripts/doc.js">
+</script>
+<style type="text/css">
+  /*<![CDATA[*/
+
+  /* Styles local to this page. */
+
+  /*]]>*/
+</style>
+</head>
+
+<body>
+  <h6 id="header">RMagick User's Guide and Reference</h6>
+
+  <div class="nav">
+    &laquo;&nbsp;<a href="image3.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "struct.html">Next</a>&nbsp;&raquo;
+  </div>
+
+  <h1>class Draw <span class="superclass">&lt; Object</span></h1>
+
+  <div id="toc">
+    <h2>Table of Contents</h2>
+
+    <h3>class methods</h3>
+
+    <ul>
+      <li><a href="#new">new</a></li>
+    </ul>
+
+    <h3>instance methods</h3>
+
+    <ul>
+      <li><a href="#annotate">annotate</a></li>
+
+      <li><a href="#clone">clone</a></li>
+
+      <li><a href="#draw">draw</a></li>
+
+      <li><a href="#dup">dup</a></li>
+
+      <li><a href=
+      "#get_multiline_type_metrics">get_multiline_type_metrics</a></li>
+
+      <li><a href="#get_type_metrics">get_type_metrics</a></li>
+
+      <li><a href="#inspect">inspect</a></li>
+    </ul>
+
+    <h3>drawing primitive methods</h3>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#affine">affine</a></li>
+
+        <li><a href="#arc">arc</a></li>
+
+        <li><a href="#bezier">bezier</a></li>
+
+        <li><a href="#circle">circle</a></li>
+
+        <li><a href="#clip_path">clip_path</a></li>
+
+        <li><a href="#clip_rule">clip_rule</a></li>
+
+        <li><a href="#clip_units">clip_units</a></li>
+
+        <li><a href="#color">color</a></li>
+
+        <li><a href="#composite">composite</a></li>
+
+        <li><a href="#decorate">decorate</a></li>
+
+        <li><a href="#define_clip_path">define_clip_path</a></li>
+
+        <li><a href="#ellipse">ellipse</a></li>
+
+        <li><a href="#encoding">encoding</a></li>
+
+        <li><a href="#fill">fill</a></li>
+
+        <li><a href="#fill_opacity">fill_opacity</a></li>
+
+        <li><a href="#fill_rule">fill_rule</a></li>
+
+        <li><a href="#font">font</a></li>
+
+        <li><a href="#font_family">font_family</a></li>
+      </ul>
+    </div>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#font_stretch">font_stretch</a></li>
+
+        <li><a href="#font_style">font_style</a></li>
+
+        <li><a href="#font_weight">font_weight</a></li>
+
+        <li><a href="#gravity">gravity</a></li>
+
+        <li><a href="#line">line</a></li>
+
+        <li><a href="#matte">matte</a></li>
+
+        <li><a href="#opacity">opacity</a></li>
+
+        <li><a href="#path">path</a></li>
+
+        <li><a href="#pattern">pattern</a></li>
+
+        <li><a href="#point">point</a></li>
+
+        <li><a href="#pointsize">pointsize</a></li>
+
+        <li><a href="#polygon">polygon</a></li>
+
+        <li><a href="#polyline">polyline</a></li>
+
+        <li><a href="#pop">pop</a></li>
+
+        <li><a href="#push">push</a></li>
+
+        <li><a href="#rectangle">rectangle</a></li>
+
+        <li><a href="#rotate">rotate</a></li>
+
+        <li><a href="#roundrectangle">roundrectangle</a></li>
+      </ul>
+    </div>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#scale">scale</a></li>
+
+        <li><a href="#skewx">skewx</a></li>
+
+        <li><a href="#skewy">skewy</a></li>
+
+        <li><a href="#stroke">stroke</a></li>
+
+        <li><a href="#stroke_antialias">stroke_antialias</a></li>
+
+        <li><a href="#stroke_dasharray">stroke_dasharray</a></li>
+
+        <li><a href="#stroke_dashoffset">stroke_dashoffset</a></li>
+
+        <li><a href="#stroke_linecap">stroke_linecap</a></li>
+
+        <li><a href="#stroke_linejoin">stroke_linejoin</a></li>
+
+        <li><a href="#stroke_miterlimit">stroke_miterlimit</a></li>
+
+        <li><a href="#stroke_opacity">stroke_opacity</a></li>
+
+        <li><a href="#stroke_width">stroke_width</a></li>
+
+        <li><a href="#text">text</a></li>
+
+        <li><a href="#text_align">text_align</a></li>
+
+        <li><a href="#text_anchor">text_anchor</a></li>
+
+        <li><a href="#text_antialias">text_antialias</a></li>
+
+        <li><a href="#text_undercolor">text_undercolor</a></li>
+
+        <li><a href="#translate">translate</a></li>
+      </ul>
+    </div>
+
+    <h3>annotate attributes</h3>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#affine_eq">affine</a></li>
+
+        <li><a href="#align_eq">align</a></li>
+
+        <li><a href="#decorate_eq">decorate</a></li>
+
+        <li><a href="#density_eq">density</a></li>
+
+        <li><a href="#encoding_eq">encoding</a></li>
+
+        <li><a href="#fill_eq">fill</a></li>
+      </ul>
+    </div>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#font_eq">font</a></li>
+
+        <li><a href="#font_family_eq">font_family</a></li>
+
+        <li><a href="#font_stretch_eq">font_stretch</a></li>
+
+        <li><a href="#font_style_eq">font_style</a></li>
+
+        <li><a href="#font_weight_eq">font_weight</a></li>
+
+        <li><a href="#gravity_eq">gravity</a></li>
+      </ul>
+    </div>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#pointsize_eq">pointsize</a></li>
+
+        <li><a href="#rotation_eq">rotation</a></li>
+
+        <li><a href="#stroke_eq">stroke</a></li>
+
+        <li><a href="#stroke_width_eq">stroke_width</a></li>
+
+        <li><a href="#text_antialias_eq">text_antialias</a></li>
+
+        <li><a href="#undercolor_eq">undercolor</a></li>
+      </ul>
+    </div>
+  </div>
+
+  <h2 class="methods">class methods</h2>
+
+  <div class="sig">
+    <h3 id="new">new</h3>
+
+    <p>Magick::Draw.new <span class="arg">[&nbsp;{ optional
+    parameters }&nbsp;]</span> -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates a new Draw object.</p>
+
+    <h4>Arguments</h4>
+
+    <p>If you plan to use the <code>annotate</code> method with
+    this object you can initialize the <a href=
+    "#attributes">attributes</a> in the associated block.</p>
+
+    <h4>Returns</h4>A new <code>Draw</code> object.
+
+    <h4>Example</h4>
+    <pre>
+gc = Draw.new
+</pre>
+  </div>
+
+  <h2 class="methods">instance methods</h2>
+
+  <div class="sig">
+    <h3 id="annotate">annotate</h3>
+
+    <p><span class="arg">draw.</span>annotate(<span class=
+    "arg">img, width, height, x, y, text</span>) <span class=
+    "arg">[&nbsp;{ additional parameters }&nbsp;]</span> -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Annotates a image with text. The text is positioned
+    according to the <code>gravity</code> attribute around the
+    rectangle described by the x, y, width, and height arguments.
+    If either of the width or height arguments are omitted, uses
+    the image width - x and the image height - y to compute the
+    rectangle width and height. The attributes described in
+    <a href="#attributes">annotate attributes</a>, below, influence
+    the appearance and position of the text. These attributes may
+    be set in the Draw object before calling <code>annotate</code>,
+    or within <code>annotate</code>'s optional <span class=
+    "arg">additional parameters</span> block.</p>
+
+    <p><em>Note</em>: all of the <code>annotate</code> attributes
+    are set-only.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>img</dt>
+
+      <dd>the image or imagelist to be annotated</dd>
+
+      <dt>width</dt>
+
+      <dd>width of the rectangle within which the text is
+      positioned</dd>
+
+      <dt>height</dt>
+
+      <dd>height of the rectangle within which the text is
+      positioned</dd>
+
+      <dt>x</dt>
+
+      <dd>x offset of the rectangle</dd>
+
+      <dt>y</dt>
+
+      <dd>y offset of the rectangle</dd>
+
+      <dt>text</dt>
+
+      <dd>the text</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example is an excerpt of <a href=
+    "javascript:popup('colors.rb.html')" title=
+    "Click to see the example script">colors.rb</a>. Many other
+    examples also use <code>annotate</code>.</p>
+    <pre>
+title.annotate(montage, 0,0,0,40, 'Named Colors') {
+    self.font_family = 'Helvetica'
+    self.fill = 'white'
+    self.stroke = 'transparent'
+    self.pointsize = 32
+    self.font_weight = BoldWeight
+    self.gravity = NorthGravity
+}
+</pre>
+
+    <h4>Special characters</h4>
+
+    <p>Escape a blank, quote, or apostrophe by preceding it with a
+    backslash ("\"). To include a backslash in the text, use two
+    consecutive backslashes. To include a '%' in the text, use
+    '%%'. You can include information about the image by including
+    one or more of the special character sequences shown in this
+    table.</p>
+
+    <table id="spec_chars_table" summary=
+    "annotate special characters" class="simple_table">
+      <caption>
+        Special characters
+      </caption>
+
+      <tr>
+        <th>Format</th>
+
+        <th>Replaced by</th>
+      </tr>
+
+      <tr>
+        <td>%b</td>
+
+        <td>file size in bytes</td>
+      </tr>
+
+      <tr>
+        <td>%c</td>
+
+        <td>"comment" property string</td>
+      </tr>
+
+      <tr>
+        <td>%d</td>
+
+        <td>directory in which the file resides</td>
+      </tr>
+
+      <tr>
+        <td>%e</td>
+
+        <td>filename extension</td>
+      </tr>
+
+      <tr>
+        <td>%f</td>
+
+        <td>original filename</td>
+      </tr>
+
+      <tr>
+        <td>%g</td>
+
+        <td>group number</td>
+      </tr>
+
+      <tr>
+        <td>%h</td>
+
+        <td>height</td>
+      </tr>
+
+      <tr>
+        <td>%i</td>
+
+        <td>current filename</td>
+      </tr>
+
+      <tr>
+        <td>%k</td>
+
+        <td>number of unique colors</td>
+      </tr>
+
+      <tr>
+        <td>%l</td>
+
+        <td>"label" property string</td>
+      </tr>
+
+      <tr>
+        <td>%m</td>
+
+        <td>file format</td>
+      </tr>
+
+      <tr>
+        <td>%n</td>
+
+        <td>number of images in the sequence (for RMagick, this is
+        always 1)</td>
+      </tr>
+
+      <tr>
+        <td>%o</td>
+
+        <td>output filename</td>
+      </tr>
+
+      <tr>
+        <td>%p</td>
+
+        <td>page number (for RMagick, this is always 1)</td>
+      </tr>
+
+      <tr>
+        <td>%q</td>
+
+        <td>depth</td>
+      </tr>
+
+      <tr>
+        <td>%r</td>
+
+        <td>A string of the form "ClasstypeColorspace," for example
+        "DirectClassRGB". If the image's <em>matte</em> attribute
+        is <code>true</code>, appends the word "Matte" to the end
+        of the string.</td>
+      </tr>
+
+      <tr>
+        <td>%s</td>
+
+        <td>scene number (always 1)</td>
+      </tr>
+
+      <tr>
+        <td>%t</td>
+
+        <td>filename without extension</td>
+      </tr>
+
+      <tr>
+        <td>%u</td>
+
+        <td>unique temporary filename</td>
+      </tr>
+
+      <tr>
+        <td>%w</td>
+
+        <td>width</td>
+      </tr>
+
+      <tr>
+        <td>%x</td>
+
+        <td>x resolution</td>
+      </tr>
+
+      <tr>
+        <td>%y</td>
+
+        <td>y resolution</td>
+      </tr>
+
+      <tr>
+        <td>%z</td>
+
+        <td>depth</td>
+      </tr>
+    </table>
+
+    <h4>See also</h4>
+
+    <p>This method is also defined in the <a href=
+    "image1.html#annotate">Image</a> class.</p>
+
+    <h4>Magick API</h4>
+
+    <p>AnnotateImage</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="clone">clone</h3>
+
+    <p><span class="arg">draw</span>.clone -&gt; <em>aDraw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Same as <a href="#dup">dup</a> except the frozen state of
+    the original is propogated to the copy.</p>
+
+    <h4>Returns</h4>
+
+    <p>A new Draw object.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="draw">draw</h3>
+
+    <p><span class="arg">draw</span>.draw(<span class=
+    "arg">img</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draws the list of graphic primitives on the specified image.
+    Calling <code>draw</code> does not affect the list of
+    primitives. Each time you call <code>draw</code> the primitives
+    will be re-executed from the beginning.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either an imagelist or a image. If an imagelist, draws on
+    the current image.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>See the other examples on this page.</p>
+
+    <h4>Magick API</h4>
+
+    <p>DrawImage</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="dup">dup</h3>
+
+    <p><span class="arg">draw</span>.dup -&gt; <em>aDraw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Duplicate a <code>Draw</code> object.</p>
+
+    <h4>Returns</h4>
+
+    <p>An exact copy of the receiver, including the list of drawing
+    primitives.</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#clone">clone</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="get_multiline_type_metrics">
+    get_multiline_type_metrics</h3>
+
+    <p><span class=
+    "arg">draw</span>.get_multiline_type_metrics([<span class=
+    "arg">anImage</span>,] <span class="arg">aString</span>) -&gt;
+    <em>aTypeMetric</em></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="get_type_metrics">get_type_metrics</h3>
+
+    <p><span class="arg">draw</span>.get_type_metrics([<span class=
+    "arg">anImage</span>,] <span class="arg">aString</span>) -&gt;
+    <em>aTypeMetric</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Returns information for a specific string if rendered on a
+    image. The <code>get_multiline_type_metrics</code> method is
+    the same as <code>get_type_metrics</code>, except the former
+    returns the maximum height and width for multiple lines of
+    text. (Text lines are separated by "\n" characters.)</p>
+
+    <p>The Magick++ documentation for its TypeMetric class provides
+    this useful additional information. (I've changed it a bit to
+    use RMagick names.)</p>
+
+    <blockquote>
+      <p class="imquote">The TypeMetric class provides the means to
+      pass data from the Draw class's get_type_metric method to the
+      user. It provides information regarding font metrics such as
+      ascent, descent, text width, text height, and maximum
+      horizontal advance. The units of these font metrics are in
+      pixels...(T)he metrics are dependent on the current Image
+      font (default Ghostscript's "Helvetica"), pointsize (default
+      12 points), and x/y resolution (default 72 DPI) settings.</p>
+
+      <p class="imquote">The pixel units may be converted to points
+      (the standard resolution-independent measure used by the
+      typesetting industry) via the following equation:</p>
+
+      <p><code>size_points = (size_pixels *
+      72)/resolution</code></p>
+
+      <p class="imquote">where resolution is in dots-per-inch
+      (DPI). This means that at the default image resolution, there
+      is one pixel per point.</p>
+
+      <p class="imquote">Note that a font's pointsize is only a
+      first-order approximation of the font height (ascender +
+      descender) in points. The relationship between the specified
+      pointsize and the rendered font height is determined by the
+      font designer.</p>
+
+      <p class="imquote">See <a href=
+      "http://freetype.sourceforge.net/freetype2/docs/glyphs/index.html">
+      FreeType Glyph Conventions</a> for a detailed description of
+      font metrics related issues.</p>
+    </blockquote>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>image <em>(optional)</em></dt>
+
+      <dd>The image on which the string will be rendered.
+      &times;Magick uses the attributes of the image (font name,
+      pointsize, etc.) to compute the metrics. If this argument is
+      omitted, <code>get_type_metrics</code> substitutes a dummy
+      image with default attributes. The <span class=
+      "arg">string</span> argument may not contain any of the
+      special characters shown in <a href=
+      "#spec_chars_table">this</a> table.</dd>
+
+      <dt>string</dt>
+
+      <dd>The string to be rendered. If <span class=
+      "arg">image</span> is specified, the string may contain
+      special characters that refer to the image attributes. See
+      <a href="#spec_chars_table">this</a> table.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>A Magick::TypeMetric struct. This structure has the
+    following attributes. (The descriptions are taken from the
+    <a href=
+    "http://www.imagemagick.org/www/Magick++/TypeMetric.html">Magick++</a>
+    documentation and source code.)</p>
+
+    <table summary="type metric attributes" class="simple_table">
+      <caption>
+        Magick::TypeMetric attributes
+      </caption>
+
+      <tr>
+        <th>Accessor</th>
+
+        <th>Description</th>
+      </tr>
+
+      <tr>
+        <td>ascent</td>
+
+        <td>Distance in pixels from the text baseline to the
+        highest/upper grid coordinate used to place an outline
+        point. Always a positive value.</td>
+      </tr>
+
+      <tr>
+        <td>descent</td>
+
+        <td>Distance in pixels from the baseline to the lowest grid
+        coordinate used to place an outline point. Always a
+        negative value.</td>
+      </tr>
+
+      <tr>
+        <td>width</td>
+
+        <td>Text width in pixels</td>
+      </tr>
+
+      <tr>
+        <td>height</td>
+
+        <td>Text height in pixels</td>
+      </tr>
+
+      <tr>
+        <td>max_advance</td>
+
+        <td>Maximum horizontal advance (advance from the beginning
+        of a character to the beginning of the next character) in
+        pixels.</td>
+      </tr>
+    </table>
+
+    <h4>Example</h4>
+
+    <p>This example shows the details of a TypeMetric struct.
+    <a href="javascript:popup('get_type_metrics.rb.html')" title=
+    "Click to see the example script"><img src=
+    "ex/get_type_metrics.gif" alt=
+    "get_type_metrics example" /></a></p>
+
+    <p>This example uses the <code>width</code> and
+    <code>height</code> values returned by
+    <code>get_multiline_type_metrics</code> to draw a border around
+    the text lines. <a href=
+    "javascript:popup('get_multiline_type_metrics.rb.html')" title=
+    "Click to see the example script"><img src=
+    "ex/get_multiline_type_metrics.gif" alt=
+    "get_multiline_type_metrics example" /></a></p>
+
+    <h4>Magick API</h4>
+
+    <p>GetTypeMetrics, GetMultilineTypeMetrics (available in
+    ImageMagick 6.1.5)</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="inspect">inspect</h3>
+
+    <p><span class="arg">draw</span>.inspect -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Displays the list of primitives that have been added to the
+    <code>draw</code> object. This is very handy for debugging.</p>
+
+    <h4>Example</h4>
+    <pre>
+draw.inspect &raquo;
+   "stroke red
+    fill transparent
+    rectangle 20,20 380,180
+    line 200,20 200,180
+    line 20,100 380,100
+    stroke transparent
+    fill black"
+</pre>
+  </div>
+
+  <h2 class="methods">drawing primitive methods</h2>
+
+  <div class="sig">
+    <h3 id="affine">affine</h3>
+
+    <p><span class="arg">draw</span>.affine(<span class="arg">sx,
+    rx, ry, sy, tx, ty</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Transforms the coordinate system by a 3x3 transformation
+    matrix. See <a href=
+    "http://www.w3.org/TR/SVG/coords.html#EstablishingANewUserSpace">
+    Coordinate system transformations</a> in the <cite>Scalable
+    Vector Graphics (SVG) 1.1 Specification</cite>.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>sx, sy</dt>
+
+      <dd>The amount of scaling in the <em>x</em> and <em>y</em>
+      directions</dd>
+
+      <dt>rx, ry</dt>
+
+      <dd>The rotation in the <em>x</em> and <em>y</em> directions,
+      in radians</dd>
+
+      <dt>tx, ty</dt>
+
+      <dd>The translation distances in the <em>x</em> and
+      <em>y</em> directions, in pixels</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example changes the default coordinate system to the
+    standard Cartesian coordinate system: the x-axis points
+    rightward and the y-axis points up.</p>
+
+    <p><code>gc.affine(1, 0, 0, -1, 0, max_y)</code></p>
+
+    <p><a href="javascript:popup('affine.rb.html')" title=
+    "Click to see the example script"><img src="ex/affine.gif" alt=
+    "affine example" /></a></p>
+
+    <h4>See also</h4><a href="#rotate">rotate</a>, <a href=
+    "#scale">scale</a>, <a href="#translate">translate</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="arc">arc</h3>
+
+    <p><span class="arg">draw</span>.arc(<span class="arg">start_x,
+    start_y, end_x, end_y, start_degrees, end_degrees</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draws an arc within a rectangle.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>start_x, start_y</dt>
+
+      <dd>one corner of the bounding rectangle</dd>
+
+      <dt>end_x, end_y</dt>
+
+      <dd>the opposite corner of the bounding rectangle</dd>
+
+      <dt>start_degrees</dt>
+
+      <dd>where to start drawing the arc</dd>
+
+      <dt>end_degrees</dt>
+
+      <dd>where the arc ends</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.arc(40, 50, 250, 180, 0, 270)</code></p>
+
+    <p><a href="javascript:popup('arc.rb.html')" title=
+    "Click to see the example script"><img src="ex/arc.gif" alt=
+    "arc example" /></a></p>
+
+    <h4>See also</h4><a href="#ellipse">ellipse</a>, <a href=
+    "#path">the SVG elliptical arc commands (A and a)</a>
+
+    <h4>Note</h4>
+
+    <p>The <code>arc</code> method is broken in all releases of
+    ImageMagick prior to 6.0.0, and all releases of GraphicsMagick
+    prior to 1.1. If you see a diagonal line here instead of an
+    arc, it's broken. Either upgrade to the newest version or use
+    one of the other methods listed above.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="bezier">bezier</h3>
+
+    <p><span class="arg">draw</span>.bezier(<span class=
+    "arg">x1</span>, <span class="arg">y1</span>, <span class=
+    "arg">cx1</span>, <span class="arg">cy1</span>, <span class=
+    "arg">cx2</span>, <span class="arg">cy2</span>, <span class=
+    "arg">x2</span>, <span class="arg">y2</span>...) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a cubic Bezier curve.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The arguments are pairs of points. At least 4 pairs must be
+    specified. Each point <span class="arg">xn</span>, <span class=
+    "arg">yn</span> on the curve is associated with a control point
+    <span class="arg">cxn</span>, <span class="arg">cyn</span>. The
+    first point, <span class="arg">x1</span>, <span class=
+    "arg">y1</span>, is the starting point. The last point,
+    <span class="arg">xn</span>, <span class="arg">yn</span>, is
+    the ending point. Other point/control point pairs specify
+    intermediate points on a polybezier curve.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Examples</h4>
+
+    <p>The following examples are taken from the <a href=
+    "http://www.w3.org/TR/SVG/paths.html">Paths</a> section of the
+    <cite>Scalable Vector Graphics (SVG) 1.1
+    Specification</cite>.</p>
+
+    <h4>Example 1</h4>
+
+    <p><code>gc.bezier(20,120, 20,20, 320,20, 320,120)</code></p>
+
+    <p><a href="javascript:popup('cbezier1.rb.html')"><img src=
+    "ex/cbezier1.gif" alt="bezier example 1" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 2</h4>
+
+    <p><code>gc.bezier(25,125, 100,25, 400,25, 325,125)</code></p>
+
+    <p><a href="javascript:popup('cbezier2.rb.html')"><img src=
+    "ex/cbezier2.gif" alt="bezier example 2" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 3</h4>
+
+    <p><code>gc.bezier(100,150, 25,50, 475,50, 400,150)</code></p>
+
+    <p><a href="javascript:popup('cbezier3.rb.html')"><img src=
+    "ex/cbezier3.gif" alt="bezier example 3" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 4</h4>
+
+    <p><code>gc.bezier(20,180, 20,30, 320,330, 320,180)</code></p>
+
+    <p><a href="javascript:popup('cbezier4.rb.html')"><img src=
+    "ex/cbezier4.gif" alt="bezier example 4" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 5</h4>
+
+    <p><code>gc.bezier(20,120, 95,20, 245,20, 320,120)</code></p>
+
+    <p><a href="javascript:popup('cbezier5.rb.html')"><img src=
+    "ex/cbezier5.gif" alt="bezier example 5" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 6</h4>
+
+    <p><code>gc.bezier(50,150, 50,50, 200,50, 200,150, 200,250,
+    350,250, 350,150)</code></p>
+
+    <p><a href="javascript:popup('cbezier6.rb.html')"><img src=
+    "ex/cbezier6.gif" alt="bezier example 6" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="circle">circle</h3>
+
+    <p><span class="arg">draw</span>.circle(<span class=
+    "arg">origin_x, origin_y, perim_x, perim_y</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <p>self</p>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a circle.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>origin_x, origin_y</dt>
+
+      <dd>The center of the circle.</dd>
+
+      <dt>perim_x, perim_y</dt>
+
+      <dd>A point on the perimeter of the circle.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.circle(125,125, 25,125)</code></p>
+
+    <p><a href="javascript:popup('circle.rb.html')"><img src=
+    "ex/circle.gif" alt="circle example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="clip_path">clip_path</h3>
+
+    <p><span class="arg">draw</span>.clip_path(<span class=
+    "arg">pathname</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p class="imquote">Draws the clip path on the image mask. The
+    clip path defines a clipping area, where only the contained
+    area will be drawn upon. Areas outside of the clipping area are
+    masked.</p>
+
+    <p>Before using a clip-path, you must create it using the
+    <a href="#define_clip_path">define_clip_path</a> method.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The name of the clip path.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>In this example, the picture of the girl is drawn onto the
+    canvas using a star-shaped clipping path.</p>
+
+    <p><a href="javascript:popup('clip_path.rb.html')" id=
+    "clip_path_ex" name="clip_path_ex"><img src="ex/clip_path.gif"
+    alt="clip_path example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href=
+    "#define_clip_path">define_clip_path</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="clip_rule">clip_rule</h3>
+
+    <p><span class=
+    "arg">draw</span>.clip_rule(<code>"evenodd"</code> or
+    <code>"nonzero"</code>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify how to determine if a point on the image is inside
+    clipping region. See <a href=
+    "http://www.w3.org/TR/SVG/painting.html#FillRuleProperty"><code>
+    the <b>'fill-rule'</b> property</code></a> in the
+    <cite>Scalable Vector Graphics (SVG) 1.1 Specification</cite>
+    for a complete description and examples.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either "evenodd" or "nonzero".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="clip_units">clip_units</h3>
+
+    <p><span class=
+    "arg">draw</span>.clip_units(<code>"userSpace"</code>
+    <span class="arg">or</span> <code>"userSpaceOnUse"</code> or
+    <code>"objectSpace"</code>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Defines the coordinate space within the clipping region. See
+    <a href=
+    "http://www.w3.org/TR/SVG/masking.html#EstablishingANewClippingPath">
+    Establishing a New Clipping Path</a> in the <cite>Scalable
+    Vector Graphics (SVG) 1.1 Specification</cite> for a complete
+    description and examples.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either "userSpace", "userSpaceOnUse", or "objectSpace".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="color">color</h3>
+
+    <p><span class="arg">draw</span>.color(<span class=
+    "arg">x</span>, <span class="arg">y</span>, <span class=
+    "arg">aPaintMethod</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Set color in image according to the specified <a href=
+    "constants.html#PaintMethod">PaintMethod</a> constant.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#PaintMethod">PaintMethod</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+  draw.color(x, y, Magick::ReplaceMethod)
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="composite">composite</h3>
+
+    <p><span class="arg">draw</span>.composite(<span class=
+    "arg">x</span>, <span class="arg">y</span>, <span class=
+    "arg">width</span>, <span class="arg">height</span>,
+    <span class="arg">composite_image</span>, <span class=
+    "arg">op</span>=<code>Magick::OverCompositeOp</code>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Composite <span class="arg">composite_image</span> with the
+    receiver image.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x, y</dt>
+
+      <dd>The offset of <span class="arg">composite_image</span>
+      relative to the receiver image.</dd>
+
+      <dt>width, height</dt>
+
+      <dd>Scale the <span class="arg">composite_image</span> to
+      this size. If either value is 0, <span class=
+      "arg">composite_image</span> is not scaled.</dd>
+
+      <dt>composite_image</dt>
+
+      <dd>Either an imagelist or a image. If an imagelist, uses the
+      current image.</dd>
+
+      <dt>op</dt>
+
+      <dd>A <a href=
+      "constants.html#CompositeOperator">CompositeOperator</a>
+      constant.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example 1</h4>
+
+    <p><a href="javascript:popup('drawcomp.rb.html')"><img src=
+    "ex/drawcomp1.gif" alt="composite example 1" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 2</h4>
+
+    <p><a href="javascript:popup('drawcomp.rb.html')"><img src=
+    "ex/drawcomp2.gif" alt="composite example 2" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="image.html#composite">composite</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="decorate">decorate</h3>
+
+    <p><span class="arg">draw</span>.decorate(<span class=
+    "arg">aDecorationType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify text decoration.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#DecorationType">DecorationType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+draw.decorate(Magick::LineThroughDecoration)
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="define_clip_path">define_clip_path</h3>
+
+    <p><span class="arg">draw</span>.define_clip_path(<span class=
+    "arg">aString</span>) { <span class="arg">block</span> } -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Define a clip-path. Within <span class="arg">block</span>,
+    call other drawing primitive methods (<code>rectangle</code>,
+    <code>polygon</code>, <code>text</code>, etc.) to define the
+    clip-path. The union of all the primitives (excluding the
+    effects of rendering methods such as <code>stroke_width</code>,
+    etc.) is the clip-path. After the clip-path is invoked by the
+    <a href="#clip_path">clip-path</a> method, anything drawn on
+    the image inside the clip-path will appear. Anything drawn
+    outside the clip-path will be hidden. (See <a href=
+    "#clip_rule">clip_rule</a> for a definition of how
+    &times;Magick decides what is "inside" and what is "outside" of
+    the clip-path.)</p>
+
+    <h4>Arguments</h4>
+
+    <p>The name of the clip-path. This is the name that is
+    specified in the <code>clip_path</code> method.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>See <a href="#clip_path">clip_path</a>.
+  </div>
+
+  <div class="sig">
+    <h3 id="ellipse">ellipse</h3>
+
+    <p>draw.ellipse(<span class="arg">origin_x</span>, <span class=
+    "arg">origin_y</span>, <span class="arg">width</span>,
+    <span class="arg">height</span>, <span class=
+    "arg">arc_start</span>, <span class="arg">arc_end</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw an ellipse.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>origin_x, origin_y</dt>
+
+      <dd>The center of the ellipse</dd>
+
+      <dt>width, height</dt>
+
+      <dd>The horizontal and vertical radii</dd>
+
+      <dt>arc_start</dt>
+
+      <dd>Where to start the ellipse, in degrees. 0 degrees is at 3
+      o'clock.</dd>
+
+      <dt>arc_end</dt>
+
+      <dd>Where to end the ellipse, in degrees</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>draw.ellipse(180,125, 150,75, 0, 270)</code></p>
+
+    <p><a href="javascript:popup('ellipse.rb.html')"><img src=
+    "ex/ellipse.gif" alt="ellipse example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="#arc">arc</a>, <a href=
+    "#circle">circle</a>, <a href="#path">path</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="encoding">encoding</h3>
+
+    <p><span class="arg">draw</span>.encoding(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the font encoding.</p>
+
+    <h4>Arguments</h4>
+
+    <p>See the &times;Magick documentation for the
+    <code>-encoding</code> option to the <code>mogrify</code>
+    command</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="fill">fill</h3>
+
+    <p><span class="arg">draw</span>.fill(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the color or pattern with which graphical elements
+    are filled.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="imusage.html#color_names">color name</a> or
+    <a href="#pattern">pattern</a> name.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+  draw.fill('red')
+</pre>
+
+    <h4>Aliases</h4>
+
+    <p><code>fill_color</code>, <code>fill_pattern</code></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="fill_opacity">fill_opacity</h3>
+
+    <p><span class="arg">draw</span>.fill_opacity(<span class=
+    "arg">aFloat</span> or <em>aString</em>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the fill opacity.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A number between 0 and 1, inclusive, or a percentage
+    represented as a string, i.e. '30%'. The argument 0.3 is the
+    same as '30%'.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>See the example for <a href="#opacity">opacity</a>.</p>
+
+    <h4>See also</h4><a href="#opacity">opacity</a>, <a href=
+    "#stroke_opacity">stroke_opacity</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="fill_rule">fill_rule</h3>
+
+    <p><span class=
+    "arg">draw</span>.fill_rule(<code>"evenodd"</code> or
+    <code>"nonzero"</code>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify how to determine if a point on the image is inside a
+    shape. See <a href=
+    "http://www.w3.org/TR/SVG/painting.html#FillRuleProperty"><code>
+    the <b>'fill-rule'</b> property</code></a> in the
+    <cite>Scalable Vector Graphics (SVG) 1.1 Specification</cite>
+    for a complete description and examples.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either "evenodd" or "nonzero".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font">font</h3>
+
+    <p><span class=
+    "arg"><em>draw</em>.font(<em>aString</em>)</span> -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the font to draw text with.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The font name or filename. <span class="imquote">You can tag
+    a font to specify whether it is a Postscript, Truetype, or
+    OPTION1 font. For example, Arial.ttf is a Truetype font,
+    ps:helvetica is Postscript, and x:fixed is OPTION1.</span></p>
+
+    <p>The font name can be a complete filename such as
+    <code>"/mnt/windows/windows/fonts/Arial.ttf"</code>. The font
+    name can also be a fully qualified X font name such as
+    <code>"-urw-times-medium-i-normal--0-0-0-0-p-0-iso8859-13"</code>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4><a href="#font_family">font_family</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_family">font_family</h3>
+
+    <p><span class="arg">draw</span>.font_family(<span class=
+    "arg">aString</span>) -&gt; draw</p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the font family.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A font family name such as "arial" or "helvetica".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>See the example for <a href="#text">text</a>.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_stretch">font_stretch</h3>
+
+    <p><span class="arg">draw</span>.font_stretch(<span class=
+    "arg">aStretchType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the spacing between text characters.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#StretchType">StretchType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_style">font_style</h3>
+
+    <p><span class="arg">draw</span>.font_style(<span class=
+    "arg">aStyleType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the font style, i.e. italic, oblique, or normal.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#StyleType">StyleType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_weight">font_weight</h3>
+
+    <p><span class="arg">draw</span>.font_weight(<span class=
+    "arg">aWeightType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the font weight. For example, "bold" or
+    "normal".</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#WeightType">WeightType</a>
+    constant, or one of the numbers 100, 200, 300, 400, 500, 600,
+    700, 800, or 900.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="gravity">gravity</h3>
+
+    <p><span class="arg">draw</span>.gravity(<span class=
+    "arg">aGravityType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify how the text is positioned. The default is
+    <code>Magick::NorthWestGravity</code>.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#GravityType">GravityType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript:popup('grav.rb.html')"><img src=
+    "ex/grav.gif" alt="gravity example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#text_align">text_align</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="line">line</h3>
+
+    <p><span class="arg">draw</span>.line(<span class=
+    "arg">here_x</span>, <span class="arg">here_y</span>,
+    <span class="arg">there_x</span>, <span class=
+    "arg">there_y</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a line from <em>here</em> to <em>there</em>.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>here_x, here_y</dt>
+
+      <dd>The starting point.</dd>
+
+      <dt>there_x, there_y</dt>
+
+      <dd>The ending point.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.line(50,50, 50,200)<br />
+    gc.line(50,200, 200,200)<br />
+    gc.line(200,200, 50,50)</code></p>
+
+    <p><a href="javascript:popup('line.rb.html')"><img src=
+    "ex/line.gif" alt="line example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="matte">matte</h3>
+
+    <p><span class="arg">draw</span>.matte(<span class=
+    "arg">x</span>,<span class="arg">y</span>, <span class=
+    "arg">aPaintMethod</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Make the image transparent according to the specified
+    PaintMethod constant.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x, y</dt>
+
+      <dd>Point in image to use, along with the PaintMethod
+      constant, to set transparent pixels in the image.</dd>
+
+      <dt>aPaintMethod</dt>
+
+      <dd>
+        One of the following <a href=
+        "constants.html#PaintMethod">PaintMethod</a> constants:
+
+        <dl>
+          <dt>PointMethod</dt>
+
+          <dd>Make the pixel at <em>(x,y)</em> transparent.</dd>
+
+          <dt>ReplaceMethod</dt>
+
+          <dd>Make all pixels that are the same color as the pixel
+          at <em>(x,y)</em> transparent.</dd>
+
+          <dt>FloodfillMethod</dt>
+
+          <dd>Make all the pixels surrounding the pixel at
+          <em>(x,y)</em> transparent, until encountering pixels
+          that fail to match color at <em>(x,y)</em>.</dd>
+
+          <dt>FillToBorderMethod</dt>
+
+          <dd>Make all the pixels surrounding the pixel at
+          <em>(x,y)</em> transparent, until encountering pixels
+          that match the border color.</dd>
+
+          <dt>ResetMethod</dt>
+
+          <dd>Make the entire image transparent.</dd>
+        </dl>
+      </dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4><a href=
+    "image2.html#matte_point">matte_point</a>, <a href=
+    "image2.html#matte_replace">matte_replace</a>, <a href=
+    "image2.html#matte_floodfill">matte_floodfill</a>, <a href=
+    "image2.html#matte_fill_to_border">matte_fill_to_border</a>,
+    <a href="image3.html#opaque">opaque</a>, <a href=
+    "image3.html#transparent">transparent</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="opacity">opacity</h3>
+
+    <p><span class="arg">draw</span>.opacity(<span class=
+    "arg">opacity</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the fill and stroke opacities.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either a number between 0 and 1, or a percentage represented
+    as a string, i.e. "25%". The string argument "25%" is the same
+    as the numeric argument 0.25. Both the fill and stroke
+    opacities are set to the specified value.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example demonstrates 4 levels of opacity.</p>
+
+    <p><a href="javascript:popup('opacity.rb.html')"><img src=
+    "ex/opacity.gif" alt="opacity example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#fill_opacity">fill_opacity</a>, <a href=
+    "#stroke_opacity">stroke_opacity</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="path">path</h3>
+
+    <p><span class="arg">draw</span>.path(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw using SVG-compatible path drawing commands. See
+    "<a href="http://www.w3.org/TR/SVG/paths.html">Paths</a>" in
+    the <cite>Scalable Vector Graphics (SVG) 1.1
+    Specification</cite>.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A string containing SVG <em>moveto</em>, <em>line</em>,
+    <em>curve</em>, <em>arc</em>, or <em>closepath</em>
+    instructions. The string is equivalent to the
+    <strong>d</strong> attribute in an SVG <strong>'path'</strong>
+    element.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>These examples are all taken from the <a href=
+    "http://www.w3.org/TR/SVG/paths.html">SVG path</a>
+    examples.</p>
+
+    <h4>Example 1 - Arcs</h4>
+
+    <p><code>gc.path('M110,100 h-75 a75,75 0 1,0 75,-75 z')<br />
+    gc.path('M97.5,87.5 v-75 a75,75 0 0,0 -75,75 z')</code></p>
+
+    <p><a href="javascript:popup('arcpath.rb.html')"><img src=
+    "ex/arcpath.gif" alt="path example 1" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 2 - Quadratic bezier</h4>
+
+    <p><code>gc.path("M20,150 Q120,25 220,150 T420,150")</code></p>
+
+    <p><a href="javascript:popup('qbezierpath.rb.html')"><img src=
+    "ex/qbezierpath.gif" alt="path example 2" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 3 - Cubic bezier</h4>
+
+    <p><code>gc.path("M20,120 C20,20 170,20 170,120 S320,220
+    320,120")</code></p>
+
+    <p><a href="javascript:popup('path.rb.html')"><img src=
+    "ex/path.gif" alt="path example 3" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="pattern">pattern</h3>
+
+    <p><span class="arg">draw</span>.pattern(<span class=
+    "arg">name</span>, <span class="arg">x</span>, <span class=
+    "arg">y</span>, <span class="arg">width</span>, <span class=
+    "arg">height</span>) { pattern primitives } -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Define a pattern that can be used as the <a href=
+    "#fill">fill</a> or <a href="#stroke">stroke</a> pattern.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>name</dt>
+
+      <dd>The name of the pattern. The pattern is used in a
+      <a href="#fill">fill</a> or <a href="#stroke">stroke</a>
+      method by specifying its name.</dd>
+
+      <dt>x, y, width, height</dt>
+
+      <dd>Define how the pattern is tiled. The pattern rectangles
+      start at (<span class="arg">x</span> +
+      <em>m</em>*<span class="arg">width</span>, <span class=
+      "arg">y</span>+<em>n</em>*<span class="arg">height</span>)
+      for the values of <em>n</em> and <em>m</em> as necessary to
+      fill the space.</dd>
+
+      <dt>pattern primitives</dt>
+
+      <dd>The method calls that draw the pattern.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example 1</h4>
+
+    <p><a href="javascript:popup('pattern1.rb.html')"><img src=
+    "ex/pattern1.gif" alt="pattern example 1" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>Example 2</h4>
+
+    <p><a href="javascript:popup('pattern2.rb.html')"><img src=
+    "ex/pattern2.gif" alt="pattern example 2" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#fill">fill</a>, <a href="#stroke">stroke</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="point">point</h3>
+
+    <p><span class="arg">draw</span>.point(<span class=
+    "arg">x</span>, <span class="arg">y</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Set the pixel at <span class="arg">x</span>,<span class=
+    "arg">y</span> to the <a href="#fill">fill</a> color.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x, y</dt>
+
+      <dd>The pixel location</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="pointsize">pointsize</h3>
+
+    <p><span class="arg">draw</span>.pointsize(<span class=
+    "arg">anInteger</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Set the font size in points. The default is 12.</p>
+
+    <h4>Arguments</h4>
+
+    <p>See the example for <a href="#text">text</a>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Alias</h4>
+
+    <p>font_size</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="polygon">polygon</h3>
+
+    <p><span class="arg">draw</span>.polygon(<span class=
+    "arg">x1</span>, <span class="arg">y1</span>,...,<span class=
+    "arg">xN</span>, <span class="arg">yN</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a polygon.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The arguments are a sequence of 2 or more points. If the
+    last point is not the same as the first, the polygon is closed
+    by drawing a line from the last point to the first.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example is taken from the <a href=
+    "http://www.w3.org/TR/SVG/shapes.html#PolygonElement">The
+    'polygon' element</a> in the <cite>Scalable Vector Graphics
+    (SVG) 1.1 Specification</cite></p><a href=
+    "javascript:popup('polygon.rb.html')"><img src="ex/polygon.gif"
+    alt="polygon example" title=
+    "Click to see the example script" /></a>
+
+    <h4>See also</h4><a href="#path">path</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="polyline">polyline</h3>
+
+    <p><span class="arg">draw</span>.polyline(<span class=
+    "arg">x1</span>, <span class="arg">y1</span>,...,<span class=
+    "arg">xN</span>, <span class="arg">yN</span>) -&gt; draw</p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a polyline. Unlike a polygon, a polyline is not
+    automatically closed.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A sequence of 2 or more points.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example is taken from the <a href=
+    "http://www.w3.org/TR/SVG/shapes.html#PolylineElement">The
+    'polyline' element</a> in the <cite>Scalable Vector Graphics
+    (SVG) 1.1 Specification</cite></p>
+
+    <p><a href="javascript:popup('polyline.rb.html')"><img src=
+    "ex/polyline.gif" alt="polyline example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="pop">pop</h3>
+
+    <p><span class="arg">draw</span>.pop -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Restore the graphics context to the state it was in when
+    <a href="#push">push</a> was called last.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4><a href="#push">push</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="push">push</h3>
+
+    <p><span class="arg">draw</span>.push -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Save the current state of the graphics context, including
+    the attribute settings and the current set of primitives. Use
+    the <a href="#pop">pop</a> primitive to restore the state.</p>
+
+    <p><em>Note:</em> The <code>push</code> and <code>pop</code>
+    methods are probably not as useful in RMagick as they are in C
+    language &times;Magick programs, since it is easy to create
+    separate draw objects, each with its own set of properties and
+    primitives.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4><a href="#pop">pop</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="rectangle">rectangle</h3>
+
+    <p><span class="arg">draw</span>.rectangle(<span class=
+    "arg">x1</span>, <span class="arg">y1</span>, <span class=
+    "arg">x2</span>, <span class="arg">y2</span>) -&gt; draw</p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a rectangle.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x1, y1</dt>
+
+      <dd>The upper left hand corner of the rectangle</dd>
+
+      <dt>x2, y2</dt>
+
+      <dd>The lower right hand corner of the rectangle</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.rectangle(20,20, 280,180)</code></p><a href=
+    "javascript:popup('rectangle.rb.html')"><img src=
+    "ex/rectangle.gif" alt="rectangle example" title=
+    "Click to see the example script" /></a>
+  </div>
+
+  <div class="sig">
+    <h3 id="rotate">rotate</h3>
+
+    <p><span class="arg">draw</span>.rotate(<span class=
+    "arg">degrees</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify a rotation transformation to the coordinate space.
+    The default is 0.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The amount of rotation, in degrees. The angle of rotation is
+    clockwise, so 90&deg; is South.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.rotate(45)</code></p>
+
+    <p><a href="javascript:popup('rotate.rb.html')"><img src=
+    "ex/rotate.gif" alt="rotate example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="#affine">affine</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="roundrectangle">roundrectangle</h3>
+
+    <p><span class="arg">draw</span>.roundrectangle(<span class=
+    "arg">x1</span>, <span class="arg">y1</span>, <span class=
+    "arg">x2</span>, <span class="arg">y2</span>, <span class=
+    "arg">cw</span>, <span class="arg">ch</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw a rectangle with rounded corners.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x1, y1</dt>
+
+      <dd>The upper left hand corner of the rectangle</dd>
+
+      <dt>x2, y2</dt>
+
+      <dd>The lower right hand corner of the rectangle</dd>
+
+      <dt>cw, ch</dt>
+
+      <dd>The corner width and height</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.roundrectangle(20,20, 280,180, 8, 8)</code></p>
+
+    <p><a href="javascript:popup('roundrect.rb.html')"><img src=
+    "ex/roundrect.gif" alt="roundrectangle example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="scale">scale</h3>
+
+    <p><span class="arg">draw</span>.scale(<span class=
+    "arg">sx</span>, <span class="arg">sy</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Define a scale transformation to the coordinate space. The
+    default scale is (1.0, 1.0).</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>sx, sy</dt>
+
+      <dd>The amount of scaling in the x and y dimensions.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4><a href="#affine">affine</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="skewx">skewx</h3>
+
+    <p><span class="arg">draw</span>.skewx(<span class=
+    "arg">aFloat</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Define a skew tranformation along the x-axis.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The amount of skew, in degrees.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.skewx(30)</code></p>
+
+    <p><a href="javascript:popup('skewx.rb.html')"><img src=
+    "ex/skewx.gif" alt="skewx example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="skewy">skewy</a>, <a href=
+    "#affine">affine</a>, <a href="#rotate">rotate</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="skewy">skewy</h3>
+
+    <p><span class="arg">draw</span>.skewy(<span class=
+    "arg">aFloat</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Define a skew tranformation along the y-axis.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The amount of skew, in degrees.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.skewy(30)</code></p>
+
+    <p><a href="javascript:popup('skewy.rb.html')"><img src=
+    "ex/skewy.gif" alt="skewy example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="#affine">affine</a>, <a href=
+    "#skewx">skewx</a>, <a href="#rotate">rotate</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke">stroke</h3>
+
+    <p><span class="arg">draw</span>.stroke(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the stroke color or pattern.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="imusage.html#color_names">color name</a> or
+    <a href="#pattern">pattern</a> name.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Aliases</h4><code>stroke_color</code>,
+    <code>stroke_pattern</code>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_antialias">stroke_antialias</h3>
+
+    <p><span class=
+    "arg">draw</span>.stroke_antialias(<code>true</code> or
+    <code>false</code>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify if the stroke should be antialiased. The default is
+    <code>true</code>.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_dasharray">stroke_dasharray</h3>
+
+    <p><span class="arg">draw</span>.stroke_dasharray(<span class=
+    "arg">x1</span>,...,<span class="arg">xn</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Describe a pattern of dashes to be used when stroking paths.
+    The arguments are a list of pixel widths of alternating dashes
+    and gaps.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The first argument is the width of the first dash. The
+    second is the width of the gap following the first dash. The
+    third argument is another dash width, followed by another gap
+    width, etc. If you specify an odd number of arguments, the
+    arguments are repeated to produce an even number. All arguments
+    must be &gt; 0.</p>
+
+    <p>To produce a solid stroke, specify no arguments, i.e.
+    <code>stroke_dasharray()</code></p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><a href=
+    "javascript:popup('stroke_dasharray.rb.html'"><img src=
+    "ex/stroke_dasharray.gif" alt="stroke_dasharray example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#stroke_dashoffset">stroke_dashoffset</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_dashoffset">stroke_dashoffset</h3>
+
+    <p><span class="arg">draw</span>.stroke_dashoffset(<span class=
+    "arg">anInteger</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the initial distance into the dash pattern.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The initial distance into the dash pattern. The units are
+    pixels.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>See <a href=
+    "#stroke_dasharray">stroke_dasharray</a>.
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_linecap">stroke_linecap</h3>
+
+    <p><span class="arg">draw</span>.stroke_linecap(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify how the line ends should be drawn.</p>
+
+    <h4>Arguments</h4>
+
+    <p>One of "butt", "round", or "square".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>The following example is from the <a href=
+    "http://www.w3.org/TR/SVG/painting.html#StrokeProperties">Stroke
+    Properties</a> section of the <cite>Scalable Vector Graphics
+    (SVG) 1.1 Specification</cite>.</p>
+
+    <p><a href=
+    "javascript:popup('stroke_linecap.rb.html')"><img src=
+    "ex/stroke_linecap.gif" alt="stroke_linecap example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_linejoin">stroke_linejoin</h3>
+
+    <p><span class="arg">draw</span>.stroke_linejoin(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify how corners are drawn.</p>
+
+    <h4>Arguments</h4>
+
+    <p>One of "miter", "round", or "bevel".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>The following example is from the <a href=
+    "http://www.w3.org/TR/SVG/painting.html#StrokeProperties">Stroke
+    Properties</a> section of the <cite>Scalable Vector Graphics
+    (SVG) 1.0 Specification</cite>.</p>
+
+    <p><a href=
+    "javascript:popup('stroke_linejoin.rb.html')"><img src=
+    "ex/stroke_linejoin.gif" alt="stroke_linejoin example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href=
+    "#stroke_miterlimit">stroke_miterlimit</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_miterlimit">stroke_miterlimit</h3>
+
+    <p><span class="arg">draw</span>.stroke_miterlimit(<span class=
+    "arg">aFloat</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify a constraint on the length of the "miter" formed by
+    two lines meeting at an angle. If the angle if very sharp, the
+    miter could be very long relative to the line thickness. The
+    miter limit is a limit on the ratio of the miter length to the
+    line width.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A number &gt;= 1. The limit on the ratio of the miter length
+    to the line width.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_opacity">stroke_opacity</h3>
+
+    <p><span class="arg">draw</span>.stroke_opacity(<span class=
+    "arg">aFloat</span> or <span class="arg">aString</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the stroke opacity.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A number between 0 and 1, inclusive, or a percentage
+    represented as a string, i.e. '30%'. The argument 0.3 is the
+    same as '30%'.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+draw.stroke_opacity(0.4)
+draw.stroke_opacity('40%')
+</pre>
+
+    <h4>See also</h4><a href="#fill_opacity">fill_opacity</a>,
+    <a href="#opacity">opacity</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_width">stroke_width</h3>
+
+    <p><span class="arg">draw</span>.stroke_width(<span class=
+    "arg">anInteger</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify the stroke width in pixels. The default is 1.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript:popup('stroke_width.rb.html')"><img src=
+    "ex/stroke_width.gif" alt="stroke_width example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="text">text</h3>
+
+    <p><span class="arg">draw</span>.text(<span class=
+    "arg">x</span>,<span class="arg">y</span>, <span class=
+    "arg">text</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Draw text at the location specified by (<span class=
+    "arg">x</span>,<span class="arg">y</span>). Use <a href=
+    "#gravity">gravity</a> to position <span class=
+    "arg">text</span> relative to (<span class="arg">x</span>,
+    <span class="arg">y</span>). Specify the font appearance with
+    the <a href="#font">font</a>, <a href=
+    "#font_family">font_family</a>, <a href=
+    "#font_stretch">font_stretch</a>, <a href=
+    "#font_style">font_style</a>, and <a href=
+    "#font_weight">font_weight</a> methods. Specify the text
+    attributes with the <a href="#text_align">text_align</a>,
+    <a href="#text_anchor">text_anchor</a>, <a href=
+    "text_antialias">text_antialias</a>, and <a href=
+    "text_undercolor">text_undercolor</a> methods.</p>
+
+    <p>You can embed information about the image by including
+    <a href="#spec_chars_table">special character sequences</a> in
+    the text string.</p>
+
+    <p>If the text string contains an embedded blank, quote, or
+    apostrophe, surround the entire text string using a character
+    that is not in the text. &times;Magick uses these characters to
+    delimit the string but will strip them off before drawing the
+    text. You can use quotes, apostrophes, or braces ("{}"). You
+    can also escape a blank, quote, or apostrophe by preceding it
+    with a backslash ("\"). To include a backslash in the text, use
+    two consecutive backslashes. To include a '%' in the text, use
+    '%%'. See the examples below.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>x, y</dt>
+
+      <dd>The text position, influenced by <a href=
+      "#gravity">gravity</a>.</dd>
+
+      <dt>text</dt>
+
+      <dd>The text.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Quoting examples</h4>
+
+    <p>The text to the right of &raquo; is the text that will be
+    drawn.</p>
+    <pre>
+gc.text(10,10, '"Hello there!"') &raquo; Hello there!
+gc.text(10,10, "'What\'s up?'") &raquo; What's up?
+gc.text(10,10, %q/"What's up?"/) &raquo; What's up?
+gc.text(10,10, %q/{"What's up?"}/) &raquo; "What's up?"
+</pre>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript:popup('text.rb.html')"><img src=
+    "ex/text.gif" alt="text example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="#annotate">annotate</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="text_align">text_align</h3>
+
+    <p><span class="arg">draw</span>.text_align(<span class=
+    "arg">anAlignType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Align text relative to the starting point.</p>
+
+    <h4>Arguments</h4>
+
+    <p>An <a href="constants.html#AlignType">AlignType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript:popup('text_align.rb.html')"><img src=
+    "ex/text_align.gif" alt="text_align example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="text_anchor">text_anchor</h3>
+
+    <p><span class="arg">draw</span>.text_anchor(<span class=
+    "arg">anAnchorType</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Align text relative to the starting point. This is the SVG
+    1.1 equivalent to <a href="#text_align">text_align</a>.</p>
+
+    <h4>Arguments</h4>
+
+    <p>One of the constants <code>AnchorStart</code>,
+    <code>AnchorMiddle</code>, or <code>AnchorEnd</code>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="text_antialias">text_antialias</h3>
+
+    <p><span class=
+    "arg">draw</span>.text_antialias(<code>true</code> or
+    <code>false</code>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify if the text is to be antialiased.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Either <code>true</code> or <code>false</code>. The default
+    is <code>true</code>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>The character on the left is not antialiased. The character
+    on the right is antialiased.</p><a href=
+    "javascript:popup('text_antialias.rb.html')"><img src=
+    "ex/text_antialias.gif" alt="text_antialias example" title=
+    "Click to see the example script" /></a>
+
+    <h4>See also</h4><a href=
+    "#stroke_antialias">stroke_antialias</a>
+  </div>
+
+  <div class="sig">
+    <h3 id="text_undercolor">text_undercolor</h3>
+
+    <p><span class="arg">draw</span>.undercolor(<span class=
+    "arg">aString</span>) -&gt; <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The color to draw underneath text. The default is
+    transparent.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A color name.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript('text_undercolor.rb.html')"><img src=
+    "ex/text_undercolor.gif" alt="text_undercolor example" title=
+    "Click to see the example script" /></a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="translate">translate</h3>
+
+    <p><span class="arg">draw</span>.translate(<span class=
+    "arg">tx</span>, <span class="arg">ty</span>) -&gt;
+    <em>draw</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specify a translation operation on the coordinate space.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>tx, ty</dt>
+
+      <dd>The amount of translation in the x and y directions.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p><code>gc.translate(125, 125)</code></p>
+
+    <p><a href="javascript:popup('translate.rb.html')"><img src=
+    "ex/translate.gif" alt="translate example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#affine">affine</a></p>
+  </div>
+
+  <h2 class="methods" id="attributes">annotate attributes</h2>
+
+  <div class="sig">
+    <h3 id="affine_eq">affine=</h3>
+
+    <p><span class="arg">draw.</span>.affine =
+    <em>anAffineMatrix</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The transformation matrix. The default is the null
+    transformation.</p>
+
+    <h4>Argument</h4>
+
+    <p>An <a href="struct.html#AffineMatrix">AffineMatrix</a>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="align_eq">align=</h3>
+
+    <p><span class="arg">draw.</span>.align =
+    <em>anAlignType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The text alignment. The default is
+    <code>LeftAlign</code>.</p>
+
+    <h4>Argument</h4>
+
+    <p>A <a href="constants.html#AlignType">AlignType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="decorate_eq">decorate=</h3>
+
+    <p><span class="arg">draw</span>.decorate =
+    <em>aDecorationType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The text decoration. The default is
+    <code>NoDecorationType</code>.</p>
+
+    <h4>Argument</h4>
+
+    <p>A <a href="constants.html#DecorationType">DecorationType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="density_eq">density=</h3>
+
+    <p><span class="arg">draw</span>.density = <em>aString</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The text density in the x and y directions. The default is
+    "72x72".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="encoding_eq">encoding=</h3>
+
+    <p><span class="arg">draw</span>.encoding =
+    <em>aString</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The text encoding.</p>
+
+    <h4>Argument</h4>
+
+    <p>See the &times;Magick documentation for the
+    <code>-encoding</code> option to the <code>mogrify</code>
+    command.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="fill_eq">fill=</h3>
+
+    <p><span class="arg">draw</span>.fill = <em>aString</em> or
+    <em>aPixel</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>The fill color. The default is "black".
+
+    <h4>Argument</h4>
+
+    <p>May be a <a href="imusage.html#color_names">color name</a>
+    or a <a href="struct.html#Pixel">Pixel</a> object.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_eq">font=</h3>
+
+    <p><span class="arg">draw</span>.font = <em>aString</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font name. The default is "Helvetica". See <a href=
+    "#font">font</a> for more information about font names.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_family_eq">font_family=</h3>
+
+    <p><span class="arg">draw</span>.font_family =
+    <em>aString</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font family name. For example, "arial" or
+    "helvetica".</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_stretch_eq">font_stretch=</h3>
+
+    <p><span class="arg">draw</span>.font_stretch =
+    <em>aStretchType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font stretch.</p>
+
+    <h4>Argument</h4>A <a href=
+    "constants.html#StretchType">StretchType</a> constant.
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_style_eq">font_style=</h3>
+
+    <p><span class="arg">draw</span>.font_style =
+    <em>aStyleType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font style.</p>
+
+    <h4>Argument</h4>
+
+    <p>A <a href="constants.html#StyleType">StyleType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="font_weight_eq">font_weight=</h3>
+
+    <p><span class="arg">draw</span>.font_weight =
+    <em>aWeightType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font weight.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#WeightType">WeightType</a>
+    constant or one of the numbers 100, 200, 300, 400, 500, 600,
+    700, 800, or 900.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="gravity_eq">gravity=</h3>
+
+    <p><span class="arg">draw</span>.gravity =
+    <em>aGravityType</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Specifies how to orient text with respect to the text's
+    origin.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <a href="constants.html#GravityType">GravityType</a>
+    constant.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="pointsize_eq">pointsize=</h3>
+
+    <p><span class="arg">draw</span>.pointsize =
+    <em>anNumeric</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The font size in points. The default is 12.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+  </div>
+
+  <div class="sig">
+    <h3 id="rotation_eq">rotation=</h3>
+
+    <p><span class="arg">draw</span>.rotation =
+    <em>aNumeric</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Apply rotation to text. The default is no rotation.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The amount of rotation in degrees.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_eq">stroke=</h3>
+
+    <p><span class="arg">draw</span>.stroke = <em>aString</em> or
+    <em>aPixel</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The stroke color. This is the color used to outline the
+    text. The default is "black".</p>
+
+    <h4>Arguments</h4>A <a href="imusage.html#color_names">color
+    name</a> or <a href="struct.html#Pixel">Pixel</a> object.
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="stroke_width_eq">stroke_width=</h3>
+
+    <p><span class="arg">draw</span>.stroke =
+    <em>anInteger</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>The stroke width in pixels. The default is 1.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="text_antialias_eq">text_antialias=</h3>
+
+    <p><span class="arg">draw</span>.text_antialias =
+    <em><code>true</code> or <code>false</code></em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Whether the text is antialiased or not. The default is
+    <code>true</code>.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="undercolor_eq">undercolor=</h3>
+
+    <p><span class="arg">draw</span>.undercolor = <em>aString</em>
+    or <em>aPixel</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>If set, causes the text to be drawn over a box of the
+    specified color.</p>
+
+    <h4>Arguments</h4>A <a href="imusage.html#color_names">color
+    name</a> or a <a href="struct.html#Pixel">Pixel</a> object.
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
+  <p class="spacer">&nbsp;</p>
+
+  <div class="nav">
+    &laquo;&nbsp;<a href="image3.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "struct.html">Next</a>&nbsp;&raquo;
+  </div>
+</body>
+</html>