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

data/doc/magick.html CHANGED

@@ -10,7 +10,7 @@
   <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" />
+  <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>

data/doc/rvg.html ADDED

@@ -0,0 +1,890 @@
+<!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 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="rvgtut.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "rvggroup.html">Next</a>&nbsp;&raquo;
+  </div>
+  <h1>class RVG <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>
+    <div class="toccol">
+      <ul>
+        <li><a href=
+        "#RVG_background_fill">background_fill=</a></li>
+        <li><a href=
+        "#RVG_background_fill_opacity">background_fill_opacity=</a></li>
+        <li><a href=
+        "#RVG_background_image">background_image=</a></li>
+        <li><a href=
+        "#RVG_background_pattern">background_pattern=</a></li>
+        <li><a href=
+        "#RVG_background_position">background_position=</a></li>
+      </ul>
+    </div>
+    <div class="toccol">
+      <ul>
+        <li><a href="#RVG_canvas">canvas</a></li>
+        <li><a href="#RVG_desc">desc, desc=</a></li>
+        <li><a href="#RVG_height">height</a></li>
+        <li><a href="#RVG_metadata">metadata, metadata=</a></li>
+      </ul>
+    </div>
+    <div class="toccol">
+      <ul>
+        <li><a href="#RVG_title">title, title=</a></li>
+        <li><a href="#RVG_width">width</a></li>
+        <li><a href="#RVG_x">x</a></li>
+        <li><a href="#RVG_y">y</a></li>
+      </ul>
+    </div>
+    <h3>instance methods</h3>
+    <div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#RVG_draw">draw</a></li>
+          <li><a href="#RVG_g">g</a></li>
+          <li><a href="#RVG_image">image</a></li>
+        </ul>
+      </div>
+      <div class="toccol">
+        <ul>
+          <li><a href=
+          "#RVG_preserve_aspect_ratio">preserve_aspect_ratio</a></li>
+          <li><a href="#RVG_rvg">rvg</a></li>
+          <li><a href="#RVG_text">text</a></li>
+        </ul>
+      </div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#RVG_use">use</a></li>
+          <li><a href="#RVG_viewbox">viewbox</a></li>
+        </ul>
+      </div>
+    </div>
+    <h3>shared methods</h3>
+    <p>In addition to the methods listed above, <code>class
+    RVG</code> 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>
+  </div>
+  <h2 class="methods">class methods</h2>
+  <div class="sig">
+    <h3 id="RVG_new">new</h3>
+    <p>RVG.new(<span class="arg">width</span>=nil, <span class=
+    "arg">height</span>=nil) [ <span class="arg">{ |canvas| drawing
+    method calls }</span> ] -&gt; anRVG</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Creates a container that can have its own coordinate system.
+    Within the block, call drawing methods on <em>canvas</em> to
+    render shapes, text, and raster images in the container.</p>
+    <p>An RVG object is always the outermost container for a
+    drawing. Call the <a href="#draw">draw</a> method on the
+    returned RVG object to produce the final image.</p>
+    <h4>Arguments</h4>
+    <p>If the RVG object is the outermost container, <span class=
+    "arg">width</span> and <span class="arg">height</span> are
+    required and specify the width and height of the final drawing
+    in pixels. You can call <a href="#units">conversion methods</a>
+    to use units such as inches and millimeters instead of
+    pixels.</p>
+    <p>Otherwise, wid<span class="arg">th</span> and <span class=
+    "arg">height</span> specify the area of the viewbox. If the RVG
+    object will be used as an argument to the <a href=
+    "#Use_use">use</a> method, then <span class="arg">width</span>
+    and <span class="arg">height</span> may be omitted here, then
+    specified as arguments to <code>use</code>.</p>
+    <h4>Returns</h4>
+    <p>An RVG object</p>
+    <h4>Example</h4>
+    <p>See the <a href="rvgtut.html">tutorial</a> for a simple
+    example. The image below demonstrates an advanced use of
+    <code>RVG.new</code>. This example creates an RVG object that
+    draws an orange-and-green target. The <span class=
+    "arg">width</span> and <span class="arg">height</span>
+    arguments are omitted in the <code>RVG.new</code> call.
+    Instead, the viewport width and height are specified as
+    arguments to 4 invocations of <a href="#Use_use">use</a>. Each
+    <code>use</code> specifies a different viewport size, so the
+    same RVG object draws 4 different-sized targets.</p>
+    <p>Click the image to see the example script.</p>
+    <p><a href="javascript:popup('nested_rvg.rb.html')"><img src=
+    "ex/nested_rvg.gif" title="Click to see the example script"
+    alt="nested RVG example" /></a></p>
+    <h4>See also</h4>
+    <p><a href="#Group_class">Group</a></p>
+  </div>
+  <h2 class="methods">attributes</h2>
+  <div class="sig">
+    <h3 id='RVG_background_fill'>background_fill=</h3>
+    <p><span class="arg">canvas</span>.background_fill =
+    <span class="arg">value</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify a background fill color. The attribute value may be
+    either a <a href="struct.html#Pixel">pixel</a> or a <a href=
+    "imusage.html#color_names">color name.</a> The default fill
+    color is "#000000ff". This color is usually called "none". This
+    attribute has no effect on nested RVG objects.</p>
+    <h4>Example</h4>
+    <pre>
+canvas.background_fill = 'white'
+</pre>
+    <h4>Returns</h4><span class="arg">value</span>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_background_fill_opacity'>
+    background_fill_opacity=</h3>
+    <p><span class="arg">canvas</span>.background_fill_opacity =
+    <span class="arg">value</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify the opacity of the background fill color when the
+    <a href="#RVG_background_fill">background fill</a> is not the
+    default. The value is a number between 0.0 (fully transparent)
+    and 1.0 (fully opaque). The default is 1.0. The attribute is
+    ignored unless <code>background_fill</code> is specified. This
+    attribute has no effect on nested RVG objects.</p>
+    <h4>Example</h4>
+    <pre>
+canvas.background_fill = 'white'
+canvas.background_fill_opacity = 0.50
+</pre>
+    <h4>Returns</h4><span class="arg">value</span>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_background_image'>background_image=</h3>
+    <p><span class="arg">canvas</span>.background_image =
+    <span class="arg">anImage</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify an image to be used as the canvas background. The
+    value is an <a href="image1.html#new">Image</a> object. This
+    attribute has no effect on nested RVG objects.</p>
+    <h4>Example</h4>
+    <pre>
+canvas.background_image = Magick::Image.read('myBackground.gif').first
+</pre>
+    <h4>Returns</h4><span class="arg">anImage</span>
+    <h4>See also</h4>
+    <p><a href=
+    "#RVG_background_position">background_position=</a></p>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_background_pattern'>background_pattern=</h3>
+    <p><span class="arg">canvas</span>.background_pattern =
+    <span class="arg">aFill</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify an <a href="struct.html#fill">Fill object</a> to
+    fill the canvas background. This attribute has no effect on
+    nested RVG objects.</p>
+    <h4>Example</h4>
+    <pre>
+canvas.background_pattern = Magick::GradientFill.new(0, 0, 0, 100, "#900", "#000")
+</pre>
+    <h4>Returns</h4><span class="arg">aFill</span>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_background_position'>background_position=</h3>
+    <p><span class="arg">canvas</span>.background_position =
+    <span class="arg">pos</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>If the dimensions of the image specified by <a href=
+    "#RVG_background_image">background_image</a> do not exactly
+    match the canvas dimensions, this attribute specifies how to
+    position the image on the background. This attribute has no
+    effect on nested RVG objects.</p>
+    <h4>Argument</h4>The value of <span class="arg">pos</span> can
+    be any one of the following symbols :
+    <dl>
+      <dt>:scaled</dt>
+      <dd>The image is scaled to fit. The image proportions are not
+      retained.</dd>
+      <dt>:tiled</dt>
+      <dd>The image is tiled across the background.</dd>
+      <dt>:fit</dt>
+      <dd>The image is scaled to fit. The image proportions are
+      retained. Any part of the background that is not covered by
+      the image is colored with the <a href=
+      "#RVG_background_color">background color</a>.</dd>
+    </dl>
+    <h4>Example</h4>
+    <pre>
+canvas.background_image = Magick::Image.read('myBackground.gif').first
+canvas.background_position = :scaled
+</pre>
+    <h4>Returns</h4><span class="arg">pos</span>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_canvas'>canvas</h3>
+    <p><span class="arg">rvg</span>.canvas -&gt; anImage</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>After the <a href="#RVG_draw">draw</a> method has been used,
+    returns the rendered image. This is the same image that
+    <a href="#RVG_draw">draw</a> returns.</p>
+    <h4>Returns</h4>
+    <p>An image</p>
+  </div>
+  <div class="sig">
+    <h3 id="RVG_desc">desc, desc=</h3>
+    <p><span class="arg">rvg</span>.desc -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">rvg</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 drawing. The description will
+    be assigned to the "desc" property of the resulting image. This
+    attribute has no effect on nested RVG objects.
+  </div>
+  <div class="sig">
+    <h3 id='RVG_height'>height</h3>
+    <p><span class="arg">rvg</span>.height -&gt; <span class=
+    "arg">height</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>The height of the RVG object in user coordinates.</p>
+    <h4>See also</h4>
+    <p><a href="#RVG_width">width</a></p>
+  </div>
+  <div class="sig">
+    <h3 id="RVG_metadata">metadata, metadata=</h3>
+    <p><span class="arg">rvg</span>.metadata -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">rvg</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 drawing. The metadata string
+    will be assigned to the "metadata" property of the resulting
+    image. This attribute has no effect on nested RVG objects.
+  </div>
+  <div class="sig">
+    <h3 id="RVG_title">title, title=</h3>
+    <p><span class="arg">rvg</span>.title -&gt; <span class=
+    "arg">aString</span><br />
+    <span class="arg">rvg</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 drawing. The title will be assigned to
+    the "title" property of the resulting image. This attribute has
+    no effect on nested RVG objects.
+  </div>
+  <div class="sig">
+    <h3 id='RVG_width'>width</h3>
+    <p><span class="arg">rvg</span>.width -&gt; <span class=
+    "arg">width</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>The width of the RVG object in user coordinates.</p>
+    <h4>See also</h4>
+    <p><a href="#RVG_height">height</a></p>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_x'>x</h3>
+    <p><span class="arg">rvg</span>.x -&gt; <span class=
+    "arg">x-offset</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>If this RVG object is nested within another RVG object,
+    returns the x-offset in user coordinates from the upper-left
+    corner of the enclosing RVG object.</p>
+    <h4>See also</h4>
+    <p><a href="#RVG_y">y</a></p>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_y'>y</h3>
+    <p><span class="arg">rvg</span>.y -&gt; <span class=
+    "arg">y-offset</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>If this RVG object is nested within another RVG object,
+    returns the y-offset in user coordinates from the upper-left
+    corner of the enclosing RVG object.</p>
+    <h4>See also</h4>
+    <p><a href="#RVG_x">x</a></p>
+  </div>
+  <h2 class="methods">instance methods</h2>
+  <div class="sig">
+    <h3 id='RVG_draw'>draw</h3>
+    <p><span class="arg">rvg</span>.draw -&gt; anImage</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Causes all the drawing objects that have been added to the
+    canvas to be rendered.</p>
+    <p>Regardless of the order in which methods were called,
+    <code>draw</code> executes the methods in this order:</p>
+    <ol>
+      <li>transforms, in the order they were called.</li>
+      <li><code>viewbox</code> and
+      <code>preserve_aspect_ratio</code></li>
+      <li>styles</li>
+      <li>nested groups, RVG objects, shapes, text, and images, in
+      the order they were added to the containing object</li>
+    </ol>
+    <p>Nested groups and RVG objects also follow this sequence.</p>
+    <h4>Returns</h4>
+    <p>An image</p>
+    <h4>Example</h4>
+    <pre>
+      img = rvg.draw
+      img.write('myDrawing.jpg')
+</pre>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_g'>g</h3>
+    <p><span class="arg">rvg.</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 enclosing RVG object.
+    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='RVG_image'>image</h3>
+    <p><span class="arg">rvg.</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 enclosing RVG object.</p>
+    <h4>Returns</h4>
+    <p>Returns the new image, so <code>RVG::Image</code> methods
+    can be chained to this method.</p>
+    <h4>Notes</h4>
+    <p>An <code>RVG::Image</code> object is <em>not</em> the same
+    as a <a href="image1.html">Magick::Image</a> object!</p>
+  </div>
+  <div class="sig">
+    <h3 id='RVG_preserve_aspect_ratio'>preserve_aspect_ratio</h3>
+    <p><span class=
+    "arg">rvg</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="#RVG_viewbox">viewbox</a> method and
+    the user coordinate system does not scale uniformly to the
+    default coordinate system (for example, the width and height of
+    the RVG object is 4x3 and the user coordinate system is 16x9),
+    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><a href=
+    "javascript:popup('PreserveAspectRatio.rb.html')"><img src=
+    "ex/PreserveAspectRatio.gif" title=
+    "Click to see the example script" alt=
+    "preserve_aspect_ratio example" /></a></p>
+    <h4>Returns</h4>
+    <p><span class="arg">Self</span>, so other <code>RVG</code>
+    methods can be chained to this method.</p>
+    <h4>See Also</h4>
+    <p><a href="#RVG_viewbox">viewbox</a></p>
+  </div>
+  <div class="sig">
+    <h3 id="RVG_rvg">rvg</h3>
+    <p><span class="arg">rvg</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">anRVG</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>This method constructs a new RVG object and adds it to the
+    enclosing RVG object. Each nested RVG object can use the
+    <a href="#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>.</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">rvg.</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 enclosing RVG
+    object. 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">rvg</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 RVG
+    object.</p>
+    <p>When the referenced argument is another 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="RVG_viewbox">viewbox</h3>
+    <p><span class="arg">rvg</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 RVG object is called the <em>viewport</em>.
+    By default the origin of the coordinate system for an RVG
+    object 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.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>In the following examples, because the <code>viewbox</code>
+    method specifies the dimensions of the coordinate system, the
+    dimensions specified for the graphic objects can remain the
+    same while the size of the canvas changes.</p>
+    <p><strong>Rendered into a 300x200 viewport</strong><a href=
+    "javascript:popup('ViewBox.rb.html')"><img src=
+    "ex/ViewBox_300x200.gif" title=
+    "Click to see the example script" alt=
+    "viewbox 300x200 example" /></a></p>
+    <p><strong>Rendered into a 150x200 viewport</strong><a href=
+    "javascript:popup('ViewBox.rb.html')"><img src=
+    "ex/ViewBox_150x200.gif" title=
+    "Click to see the example script" alt=
+    "viewbox 150x200 example" /></a></p>
+    <h4>Returns</h4>
+    <p><span class="arg">Self</span>, so other <code>RVG</code>
+    methods may be chained to <code>viewbox</code>.</p>
+    <h4>See Also</h4>
+    <p><a href=
+    "#RVG_preserve_aspect_ratio">preserve_aspect_ratio</a></p>
+  </div>
+  <p class="spacer">&nbsp;</p>
+  <div class="nav">
+    &laquo; <a href="rvgtut.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href="rvggroup.html">Next</a>
+    &raquo;
+  </div>
+</body>
+</html>