RubyGems - rmagick - Versions diffs - 1.7.4 → 1.8.0 - Mend

rmagick 1.7.4 → 1.8.0

Potentially problematic release.

This version of rmagick might be problematic. Click here for more details.

Files changed (130) hide show

data/ChangeLog +10 -2
data/README.html +284 -290
data/README.txt +298 -307
data/configure +180 -11
data/configure.ac +18 -2
data/doc/comtasks.html +1 -1
data/doc/constants.html +15 -10
data/doc/css/ref.css +67 -0
data/doc/draw.html +1 -1
data/doc/ex/InitialCoords.rb +24 -0
data/doc/ex/NewCoordSys.rb +33 -0
data/doc/ex/OrigCoordSys.rb +19 -0
data/doc/ex/PreserveAspectRatio.rb +206 -0
data/doc/ex/RotateScale.rb +38 -0
data/doc/ex/Skew.rb +39 -0
data/doc/ex/Use01.rb +17 -0
data/doc/ex/Use02.rb +22 -0
data/doc/ex/Use03.rb +17 -0
data/doc/ex/ViewBox.rb +34 -0
data/doc/ex/arcs01.rb +29 -0
data/doc/ex/arcs02.rb +62 -0
data/doc/ex/baseline_shift01.rb +19 -0
data/doc/ex/bounding_box.rb +31 -37
data/doc/ex/circle01.rb +18 -0
data/doc/ex/cubic01.rb +46 -0
data/doc/ex/cubic02.rb +95 -0
data/doc/ex/drop_shadow.rb +1 -1
data/doc/ex/ellipse01.rb +23 -0
data/doc/ex/evenodd.rb +44 -0
data/doc/ex/font_styles.rb +29 -0
data/doc/ex/group.rb +27 -0
data/doc/ex/image.rb +47 -0
data/doc/ex/images/big-duck.gif +0 -0
data/doc/ex/images/duck.gif +0 -0
data/doc/ex/images/duck0.gif +0 -0
data/doc/ex/images/duck1.gif +0 -0
data/doc/ex/images/duck10.gif +0 -0
data/doc/ex/images/duck11.gif +0 -0
data/doc/ex/images/duck12.gif +0 -0
data/doc/ex/images/duck13.gif +0 -0
data/doc/ex/images/duck14.gif +0 -0
data/doc/ex/images/duck15.gif +0 -0
data/doc/ex/images/duck2.gif +0 -0
data/doc/ex/images/duck3.gif +0 -0
data/doc/ex/images/duck4.gif +0 -0
data/doc/ex/images/duck5.gif +0 -0
data/doc/ex/images/duck6.gif +0 -0
data/doc/ex/images/duck7.gif +0 -0
data/doc/ex/images/duck8.gif +0 -0
data/doc/ex/images/duck9.gif +0 -0
data/doc/ex/line01.rb +24 -0
data/doc/ex/nested_rvg.rb +22 -0
data/doc/ex/nonzero.rb +44 -0
data/doc/ex/polygon01.rb +24 -0
data/doc/ex/polyline01.rb +24 -0
data/doc/ex/quad01.rb +37 -0
data/doc/ex/rect01.rb +16 -0
data/doc/ex/rect02.rb +23 -0
data/doc/ex/rvg_clippath.rb +15 -0
data/doc/ex/rvg_linecap.rb +44 -0
data/doc/ex/rvg_linejoin.rb +42 -0
data/doc/ex/rvg_opacity.rb +20 -0
data/doc/ex/rvg_pattern.rb +27 -0
data/doc/ex/rvg_stroke_dasharray.rb +13 -0
data/doc/ex/sepiatone.rb +15 -0
data/doc/ex/shadow.rb +37 -0
data/doc/ex/smile.rb +9 -9
data/doc/ex/stroke_fill.rb +12 -0
data/doc/ex/text01.rb +18 -0
data/doc/ex/text_styles.rb +22 -0
data/doc/ex/texture_fill_to_border.rb +3 -3
data/doc/ex/texture_floodfill.rb +3 -2
data/doc/ex/tref01.rb +26 -0
data/doc/ex/triangle01.rb +17 -0
data/doc/ex/tspan01.rb +19 -0
data/doc/ex/tspan02.rb +20 -0
data/doc/ex/tspan03.rb +22 -0
data/doc/ex/writing_mode01.rb +28 -0
data/doc/ex/writing_mode02.rb +27 -0
data/doc/ilist.html +1 -1
data/doc/image1.html +66 -30
data/doc/image2.html +1 -1
data/doc/image3.html +274 -49
data/doc/imageattrs.html +87 -10
data/doc/imusage.html +1 -1
data/doc/index.html +80 -39
data/doc/info.html +149 -13
data/doc/magick.html +1 -1
data/doc/rvg.html +890 -0
data/doc/rvgclip.html +249 -0
data/doc/rvggroup.html +305 -0
data/doc/rvgimage.html +288 -0
data/doc/rvgpattern.html +456 -0
data/doc/rvgshape.html +376 -0
data/doc/rvgstyle.html +269 -0
data/doc/rvgtext.html +464 -0
data/doc/rvgtspan.html +237 -0
data/doc/rvgtut.html +512 -0
data/doc/rvguse.html +145 -0
data/doc/rvgxform.html +294 -0
data/doc/struct.html +9 -71
data/doc/usage.html +22 -7
data/ext/RMagick/MANIFEST +94 -2
data/ext/RMagick/rmagick.h +10 -4
data/ext/RMagick/rmagick_config.h.in +8 -2
data/ext/RMagick/rmdraw.c +2 -2
data/ext/RMagick/rmfill.c +2 -2
data/ext/RMagick/rmilist.c +3 -3
data/ext/RMagick/rmimage.c +152 -5
data/ext/RMagick/rminfo.c +208 -2
data/ext/RMagick/rmmain.c +14 -5
data/ext/RMagick/rmutil.c +83 -22
data/lib/RMagick.rb +2 -2
data/lib/rvg/clippath.rb +46 -0
data/lib/rvg/container.rb +129 -0
data/lib/rvg/deep_equal.rb +54 -0
data/lib/rvg/describable.rb +51 -0
data/lib/rvg/embellishable.rb +395 -0
data/lib/rvg/misc.rb +729 -0
data/lib/rvg/paint.rb +48 -0
data/lib/rvg/pathdata.rb +129 -0
data/lib/rvg/rvg.rb +279 -0
data/lib/rvg/stretchable.rb +150 -0
data/lib/rvg/stylable.rb +116 -0
data/lib/rvg/text.rb +185 -0
data/lib/rvg/transformable.rb +131 -0
data/lib/rvg/units.rb +64 -0
data/rmagick.gemspec +1 -1
data/uninstall.rb +3 -2
metadata +96 -3

@@ -0,0 +1,288 @@
+<!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 March 2005), see www.w3.org" />
+  <title>RMagick: RVG Reference: RVG::Image Class</title>
+  <meta http-equiv="Content-Type" content=
+  "text/html; charset=us-ascii" />
+  <meta name="GENERATOR" content="Quanta Plus" />
+  <meta name="Copyright" content=
+  "Copyright (C) 2005 by Timothy P. Hunter" />
+  <link rel="stylesheet" type="text/css" href="css/doc.css" />
+<script type="text/javascript" src="scripts/doc.js">
+</script>
+<script type="text/javascript">
+  //<![CDATA[
+  //]]>
+</script>
+<style type="text/css">
+  /*<![CDATA[*/
+    }
+  /*]]>*/
+</style>
+</head>
+<body>
+  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <div class="nav">
+    &laquo;&nbsp;<a href="rvggroup.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "rvgpattern.html">Next</a>&nbsp;&raquo;
+  </div>
+  <h1>class RVG::Image <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>attributes</h3>
+    <ul>
+      <li><a href="#desc">desc, desc=</a></li>
+      <li><a href="#metadata">metadata, metadata=</a></li>
+      <li><a href="#title">title, title=</a></li>
+    </ul>
+    <h3>instance methods</h3>
+    <ul>
+      <li><a href=
+      "#preserve_aspect_ratio">preserve_aspect_ratio</a></li>
+    </ul>
+    <h3>shared methods</h3>
+    <p>In addition to the methods listed above, <code>class
+    RVG::Image</code> also implements the <a href=
+    "rvgstyle.html">styles</a> method and the <a href=
+    "rvgxform.html">transform methods</a>.</p>
+  </div>
+  <h2 class="methods">class methods</h2>
+  <div class="sig">
+    <h3 id="new">new</h3>
+    <p><span class="arg">RVG::Image</span>.new(<span class=
+    "arg">raster_image</span>, <span class="arg">width</span>=nil,
+    <span class="arg">height</span>=nil, <span class=
+    "arg">x</span>=0, <span class="arg">y</span>=0) -&gt;
+    <span class="arg">anImage</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Constructs a raster image object. The viewbox is defined by
+    the image bounds. This method is usually called indirectly via
+    the <code>image</code> method in the <a href=
+    "rvg.html#RVG_image">RVG</a>, <a href=
+    "rvggroup.html#image">RVG::Group</a>, or <a href=
+    "rvgpattern.html">RVG::Pattern</a> classes.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>raster_image</dt>
+      <dd>A <a href="image1.html#new">Magick::Image</a>
+      object.</dd>
+      <dt>width, height</dt>
+      <dd>The width and height of the rectangle in which the image
+      is placed.</dd>
+      <dt>x, y</dt>
+      <dd>The <em>x-</em> and <em>y</em>-axis location of the
+      rectangle in which the image is placed.</dd>
+    </dl>
+    <h4>Example</h4>
+    <p>See <a href=
+    "#preserve_aspect_ratio">preserve_aspect_ratio</a></p>
+  </div>
+  <h2 class="methods">attributes</h2>
+  <div class="sig">
+    <h3 id="desc">desc, desc=</h3>
+    <p><span class="arg">image</span>.desc -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">image</span>.desc = <span class=
+    "arg">aString</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>Use the <code>desc</code> attribute to
+    assign a text description to the image.
+  </div>
+  <div class="sig">
+    <h3 id="metadata">metadata, metadata=</h3>
+    <p><span class="arg">image</span>.metadata -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">image</span>.metadata = <span class=
+    "arg">aString</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>Use the <code>metadata</code> attribute to
+    assign additional metadata to the image.
+  </div>
+  <div class="sig">
+    <h3 id="RVG_title">title, title=</h3>
+    <p><span class="arg">image</span>.title -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">image</span>.title = <span class=
+    "arg">aString</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>Use the <code>title</code> attribute to
+    assign a title to the image.
+  </div>
+  <h2 class="methods">instance methods</h2>
+  <div class="sig">
+    <p><span class=
+    "arg">image</span>.preserve_aspect_ratio(<span class=
+    "arg">align</span>, <span class=
+    "arg">meet_or_slice</span>='meet') -&gt; <span class=
+    "arg">self</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Use <code>preserve_aspect_ratio</code> to specify whether or
+    not the image is stretched to fit the rectangle in which it is
+    placed. If not, you can specify how to fit the image into the
+    space.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>align</dt>
+      <dd>
+        When the value of the <code>meet_or_slice</code> argument
+        is 'meet' or 'slice', this argument controls the placement
+        of the image within the viewport. The <code>align</code>
+        argument is the concatenation of an <em>x</em>-aligment and
+        a <em>y</em>-alignment. The values are shown in these
+        lists:
+        <h6><em>x</em>-alignment</h6>
+        <dl>
+          <dt>xMin</dt>
+          <dd>align the minimum <em>x</em> value of the image with
+          the left corner of the viewport.</dd>
+          <dt>xMid</dt>
+          <dd>vertically center the image within the viewport.</dd>
+          <dt>xMax</dt>
+          <dd>align the maximum <em>x</em> value of the image with
+          the right corner of the viewport.</dd>
+        </dl>
+        <h6><em>y</em>-alignment</h6>
+        <dl>
+          <dt>YMin</dt>
+          <dd>align the minimum <em>y</em> value of the image with
+          the top of the viewport.</dd>
+          <dt>YMid</dt>
+          <dd>horizontally center the image within the
+          viewport.</dd>
+          <dt>YMax</dt>
+          <dd>align the maximum <em>y</em> value of the image with
+          the bottom of the viewport</dd>
+        </dl>
+      </dd>
+      <dt>meet_or_slice</dt>
+      <dd>
+        This argument can have one of these three values:
+        <dl>
+          <dt>'none'</dt>
+          <dd>The image is scaled as necessary so that it fits
+          exactly within the viewport. The aspect ratio is
+          <em>not</em> maintained.</dd>
+          <dt>'meet'</dt>
+          <dd>The image is scaled as necessary so that the larger
+          dimension exactly fits the viewport. There may be some
+          unused space in the viewport. The aspect ratio is
+          maintained.</dd>
+          <dt>'slice'</dt>
+          <dd>The image is scaled as necessary so that the smaller
+          dimension exactly fits the viewport. Some of the image in
+          the larger dimension may be cut off. The aspect ratio is
+          maintained.</dd>
+        </dl>
+      </dd>
+    </dl>
+    <h4>Example</h4>
+    <p><a href="javascript:popup('image.rb.html')"><img src=
+    "ex/image.gif" title="Click to see the example script" alt=
+    "preserve_aspect_ratio example" /></a></p>
+    <h4>Returns</h4>
+    <p><span class="arg">self</span></p>
+    <h4>See Also</h4>
+    <p><a href=
+    "#RVG_preserve_aspect_ratio">RVG#preserve_aspect_ratio</a></p>
+  </div>
+  <p class="spacer">&nbsp;</p>
+  <div class="nav">
+    &laquo;&nbsp;<a href="rvggroup.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "rvgpattern.html">Next</a>&nbsp;&raquo;
+  </div>
+</body>
+</html>

data/doc/rvgpattern.html ADDED

@@ -0,0 +1,456 @@
+<!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 March 2005), see www.w3.org" />
+  <title>RMagick: RVG Reference: RVG::Pattern Class</title>
+  <meta http-equiv="Content-Type" content=
+  "text/html; charset=us-ascii" />
+  <meta name="GENERATOR" content="Quanta Plus" />
+  <meta name="Copyright" content=
+  "Copyright (C) 2005 by Timothy P. Hunter" />
+  <link rel="stylesheet" type="text/css" href="css/doc.css" />
+<script type="text/javascript" src="scripts/doc.js">
+</script>
+<script type="text/javascript">
+  //<![CDATA[
+  //]]>
+</script>
+<style type="text/css">
+  /*<![CDATA[*/
+    }
+  /*]]>*/
+</style>
+</head>
+<body>
+  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <div class="nav">
+    &laquo;&nbsp;<a href="rvgimage.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "rvgclip.html">Next</a>&nbsp;&raquo;
+  </div>
+  <h1>class RVG::Pattern <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>
+        <div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#g">g</a></li>
+          <li><a href="#image">image</a></li>
+          <li><a href=
+          "#preserve_aspect_ratio">preserve_aspect_ratio</a></li>
+        </ul>
+      </div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#rvg">rvg</a></li>
+          <li><a href="#text">text</a></li>
+        </ul>
+      </div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#use">use</a></li>
+          <li><a href="#viewbox">viewbox</a></li>
+        </ul>
+      </div>
+    </div>
+    <h3>shared methods</h3>
+    <p>    <p>In addition to the methods listed above, this class
+     also implements the <a href=
+    "rvgstyle.html">styles</a> method, the <a href=
+    "rvgshape.html">shape methods</a> and the <a href=
+    "rvgxform.html">transform methods</a>.</p></p>
+  </div>
+  <h2 class="methods">class methods</h2>
+  <div class="sig">
+    <h3 id="new">new</h3>
+    <p>RVG::Pattern.new(<span class="arg">width</span>=0, <span class="arg">height</span>=0, <span class="arg">x</span>=0, <span class="arg">y</span>=0) [ <span class="arg">{ |pattern| drawing
+    method calls }</span> ] -&gt; aPattern</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Creates a pattern that can be used with the <code>:fill</code> and <code>:stroke</code> styles.</p>
+    <p>Define the pattern in the associated block. The pattern can be composed of <a href="rvgshape.html">shapes</a>,
+    <a href="rvgtext.html#new">text</a>, <a href="rvgimage.html#new">raster images</a>, <a href="rvggroup.html#new">groups</a>, and <a href="rvg.html#RVG_new">RVG objects</a>.
+    You can use the <a href="rvguse.html#new">use</a> method to include graphic objects in the pattern.</p>
+    <h4>Arguments</h4>
+    <dl>
+    <dt>width, height</dt>
+    <dd>These arguments define the pattern viewport.</dd>
+    <dt>x, y</dt>
+    <dd>Specify the starting offset of the pattern. The pattern will be repeated at <span class="arg">x</span><code>+m*width</code> and <span class="arg">y</span><code>+n*height</code> offsets.</dd>
+    </dl>
+    <h4>Example</h4>
+    <p><a href=
+    "javascript:popup('rvg_pattern.rb.html')"><img src="ex/rvg_pattern.gif"
+    title="Click to see the example script" alt=
+    "pattern example" /></a></p>
+  </div>
+  <h2 class="methods">instance methods</h2>
+  <div class="sig">
+    <h3 id='g'>g</h3>
+    <p><span class="arg">pattern.</span>g [{|<span class=
+    "arg">grp</span>| ...}] -&gt; <span class=
+    "arg">aGroup</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Calls <a href="rvggroup.html#new">RVG::Group.new</a> to
+    construct a group and adds it to the pattern.
+    Yields to a block if one is present, passing the new group as
+    an argument.</p>
+    <h4>Returns</h4>
+    <p>Returns the new group, so <code>RVG::Group</code> methods
+    can be chained to this method.</p>
+  </div>
+  <div class="sig">
+    <h3 id='image'>image</h3>
+    <p><span class="arg">pattern.</span>image(<span class=
+    "arg">raster_image</span>, <span class="arg">width</span>=nil,
+    <span class="arg">height</span>=nil, <span class=
+    "arg">x</span>=0, <span class="arg">y</span>=0) -&gt;
+    <span class="arg">anImage</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Calls <a href="rvgimage.html#new">RVG::Image.new</a> to
+    construct an image and adds it to the pattern.</p>
+    <h4>Returns</h4>
+    <p>Returns the new image, so <code>RVG::Image</code> methods
+    can be chained to this method.</p>
+  </div>
+  <div class="sig">
+    <h3 id='preserve_aspect_ratio'>preserve_aspect_ratio</h3>
+    <p><span class=
+    "arg">pattern</span>.preserve_aspect_ratio(<span class=
+    "arg">align</span>, <span class=
+    "arg">meet_or_slice</span>='meet') [{|<span class=
+    "arg">self</span>| ...}] -&gt; <span class=
+    "arg">self</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>If you use the <a href="#viewbox">viewbox</a> method and
+    the user coordinate system does not scale uniformly to the
+    default coordinate system,
+    use the <code>preserve_aspect_ratio</code> method to specify
+    whether or not the content is stretched to fit. If not, you can
+    specify how to fit the content into the space.</p>
+    <p><code>Preserve_aspect_ratio</code> yields to a block if one
+    is present, passing <span class="arg">self</span> as an
+    argument.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>align</dt>
+      <dd>
+        When the value of the <code>meet_or_slice</code> argument
+        is 'meet' or 'slice', this argument controls the placement
+        of the content within the viewport. The <code>align</code>
+        argument is the concatenation of an <em>x</em>-aligment and
+        a <em>y</em>-alignment. The values are shown in these
+        lists:
+        <h6><em>x</em>-alignment</h6>
+        <dl>
+          <dt>xMin</dt>
+          <dd>align the minimum <em>x</em> value of the content
+          with the left corner of the viewport.</dd>
+          <dt>xMid</dt>
+          <dd>vertically center the content within the
+          viewport.</dd>
+          <dt>xMax</dt>
+          <dd>align the maximum <em>x</em> value of the content
+          with the right corner of the viewport.</dd>
+        </dl>
+        <h6><em>y</em>-alignment</h6>
+        <dl>
+          <dt>YMin</dt>
+          <dd>align the minimum <em>y</em> value of the content
+          with the top of the viewport.</dd>
+          <dt>YMid</dt>
+          <dd>horizontally center the content within the
+          viewport.</dd>
+          <dt>YMax</dt>
+          <dd>align the maximum <em>y</em> value of the content
+          with the bottom of the viewport</dd>
+        </dl>
+      </dd>
+      <dt>meet_or_slice</dt>
+      <dd>
+        This argument can have one of these three values:
+        <dl>
+          <dt>'none'</dt>
+          <dd>The content is scaled as necessary so that it fits
+          exactly within the viewport. The aspect ratio is
+          <em>not</em> maintained.</dd>
+          <dt>'meet'</dt>
+          <dd>The content is scaled as necessary so that the larger
+          dimension exactly fits the viewport. There may be some
+          unused space in the viewport. The aspect ratio is
+          maintained.</dd>
+          <dt>'slice'</dt>
+          <dd>The content is scaled as necessary so that the
+          smaller dimension exactly fits the viewport. Some of the
+          content in the larger dimension may be cut off. The
+          aspect ratio is maintained.</dd>
+        </dl>
+      </dd>
+    </dl>
+    <h4>Example</h4>
+    <p>See the RVG class <a href="rvg.html#RVG_preserve_aspect_ratio">example</a>.</p>
+    <h4>Returns</h4>
+    <p><span class="arg">Self</span>, so other <code>RVG::Pattern</code>
+    methods can be chained to this method.</p>
+    <h4>See Also</h4>
+    <p><a href="#viewbox">viewbox</a></p>
+  </div>
+  <div class="sig">
+    <h3 id="rvg">rvg</h3>
+    <p><span class="arg">pattern</span>.rvg(<span class=
+    "arg">width</span>, <span class="arg">height</span>,
+    <span class="arg">x</span>=0, <span class="arg">y</span>=0)
+    [{|<span class="arg">new_rvg</span>| ...}] -&gt; <span class=
+    "arg">aPattern</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>This method constructs a new RVG object and adds it to the
+    pattern. Each nested RVG object can use the
+    <a href="rvg.html#RVG_viewbox">viewbox</a> method to define its own
+    coordinate system. The <code>rvg</code> method yields to a
+    block, passing the nested RVG object as an argument. Within the
+    block, any drawing objects added to the nested RVG object are
+    rendered within the nested RVG object's viewport.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>width, height</dt>
+      <dd>Specifies the viewport width and height. The units are in
+      the user coordinate system of the parent container.</dd>
+      <dt>x, y</dt>
+      <dd>The x- and y-axis offsets of the viewport upper-left
+      corner. The units are in the user coordinate system of the
+      parent container.</dd>
+    </dl>
+    <h4>Example</h4>
+    <p>See the example for <a href=
+    "#RVG_preserve_aspect_ratio">preserve_aspect_ratio</a>
+    in <code>class RVG</code>.</p>
+    <h4>Returns</h4>
+    <p>The <code>RVG</code> object, so other <code>RVG</code>
+    methods can be chained to this method.</p>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_text'>text</h3>
+    <p><span class="arg">pattern.</span>text(<span class=
+    "arg">x</span>=0, <span class="arg">y</span>=0, <span class=
+    "arg">text</span>=nil) [{|<span class="arg">aText</span>| ...}]
+    -&gt; <span class="arg">aText</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Calls <a href="rvgtext.html#new">RVG::Text.new</a> to
+    construct a text object and adds it to the pattern. Yields to a block if one is present, passing the new
+    text object as an argument.</p>
+    <h4>Returns</h4>
+    <p>The <code>RVG::Text</code> object, so other
+    <code>RVG::Text</code> methods can be chained to this
+    method.</p>
+  </div>
+  <div class="sig">
+    <h3 id="RVG_use">use</h3>
+    <p><span class="arg">pattern</span>.use(<span class=
+    "arg">obj</span>, <span class="arg">x</span>=0, <span class=
+    "arg">y</span>=0, <span class="arg">width</span>=nil,
+    <span class="arg">height</span>=nil) -&gt; <span class=
+    "arg">aUse</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Calls <a href="rvguse.html#new">RVG::Use.new</a> to
+    constructs a <code>use</code> object and adds it to the pattern.</p>
+    <p>When the referenced argument is an RVG object,
+    <span class="arg">width</span> and <span class=
+    "arg">height</span> can be used to specify the width and height
+    of the viewport. If present and non-nil, these arguments
+    override any width and height specified when the RVG object was
+    created. You must specify the viewport size either when
+    creating the RVG object or when referencing it with
+    <code>use</code>.</p>
+    <h4>Examples</h4>
+    <p>See <a href="rvguse.html#new">RVG::Use.new</a></p>
+    <h4>Returns</h4>
+    <p>The <code>RVG::Use</code> object, so other
+    <code>RVG::Use</code> methods can be chained to this
+    method.</p>
+  </div>
+  <div class="sig">
+    <h3 id="viewbox">viewbox</h3>
+    <p><span class="arg">pattern</span>.viewbox(<span class="arg">min_x</span>, <span class=
+    "arg">min_y</span>, <span class="arg">width</span>,
+    <span class="arg">height</span>) [{|<span class=
+    "arg">self</span>| ...}] -&gt; <span class="arg">rvg</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>The area of the pattern is called the <em>viewport</em>.
+    By default the origin of the coordinate system for an pattern is (0,0). The user coordinates are pixels and the width
+    and height are established by the <span class=
+    "arg">width</span> and <span class="arg">height</span>
+    arguments to <code>RVG::Pattern.new</code>.</p>
+    <p>Use the <code>viewbox</code> method to superimpose a user
+    coordinate system on the viewport. The <code>viewbox</code>
+    method lets you set up a coordinate system using the units of
+    your choice.</p>
+    <p>The <code>viewbox</code> method yields to a block if one is
+    present, passing <code>self</code> as an argument.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>min_x, min_y</dt>
+      <dd>The minimum <em>x</em>-coordinate and
+      <em>y</em>-coordinate of the user coordinate system.</dd>
+      <dt>width, height</dt>
+      <dd>The width and height of the user coordinate system.</dd>
+    </dl>
+    <h4>Example</h4>
+    <p>See the <a href="rvg.html#RVG_viewbox">example</a> for the <code>RVG </code>class.</p>
+    <h4>Returns</h4>
+    <p><span class="arg">Self</span>, so other <code>RVG::Pattern</code>
+    methods may be chained to <code>viewbox</code>.</p>
+    <h4>See Also</h4>
+    <p><a href=
+    "#preserve_aspect_ratio">preserve_aspect_ratio</a></p>
+  </div>
+    <p class="spacer">&nbsp;</p>
+  <div class="nav">
+    &laquo;&nbsp;<a href="rvgimage.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "rvgclip.html">Next</a>&nbsp;&raquo;
+  </div>
+ </body>
+</html>