RubyGems - rmagick - Versions diffs - 1.14.1 → 1.15.0 - Mend

rmagick 1.14.1 → 1.15.0

Potentially problematic release.

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

Files changed (66) hide show

data/ChangeLog +22 -0
data/README.html +11 -63
data/README.txt +8 -56
data/configure +214 -787
data/configure.ac +22 -24
data/doc/comtasks.html +2 -2
data/doc/constants.html +5 -6
data/doc/draw.html +33 -14
data/doc/ex/clip_path.rb +3 -0
data/doc/ex/path.rb +1 -1
data/doc/ex/polaroid.rb +23 -0
data/doc/ex/tspan01.rb +2 -2
data/doc/ex/tspan02.rb +2 -2
data/doc/ex/tspan03.rb +3 -3
data/doc/ex/wet_floor.rb +54 -0
data/doc/ilist.html +83 -4
data/doc/image1.html +4 -5
data/doc/image2.html +395 -266
data/doc/image3.html +104 -8
data/doc/imageattrs.html +2 -2
data/doc/imusage.html +2 -2
data/doc/index.html +22 -18
data/doc/info.html +28 -6
data/doc/magick.html +125 -4
data/doc/optequiv.html +196 -21
data/doc/rvg.html +2 -2
data/doc/rvgclip.html +2 -2
data/doc/rvggroup.html +2 -2
data/doc/rvgimage.html +2 -2
data/doc/rvgpattern.html +2 -2
data/doc/rvgshape.html +2 -2
data/doc/rvgstyle.html +2 -2
data/doc/rvgtext.html +2 -2
data/doc/rvgtspan.html +2 -2
data/doc/rvgtut.html +3 -3
data/doc/rvguse.html +2 -2
data/doc/rvgxform.html +2 -2
data/doc/struct.html +2 -2
data/doc/usage.html +26 -5
data/ext/RMagick/MANIFEST +3 -1
data/ext/RMagick/rmagick.h +46 -12
data/ext/RMagick/rmagick_config.h.in +12 -2
data/ext/RMagick/rmdraw.c +202 -62
data/ext/RMagick/rmfill.c +36 -36
data/ext/RMagick/rmilist.c +75 -31
data/ext/RMagick/rmimage.c +640 -323
data/ext/RMagick/rminfo.c +76 -15
data/ext/RMagick/rmmain.c +107 -30
data/ext/RMagick/rmutil.c +97 -68
data/lib/RMagick.rb +11 -11
data/lib/rvg/clippath.rb +38 -36
data/lib/rvg/container.rb +120 -118
data/lib/rvg/deep_equal.rb +44 -42
data/lib/rvg/describable.rb +49 -47
data/lib/rvg/embellishable.rb +399 -397
data/lib/rvg/misc.rb +613 -603
data/lib/rvg/paint.rb +38 -36
data/lib/rvg/pathdata.rb +124 -122
data/lib/rvg/rvg.rb +202 -198
data/lib/rvg/stretchable.rb +132 -130
data/lib/rvg/stylable.rb +101 -99
data/lib/rvg/text.rb +173 -171
data/lib/rvg/transformable.rb +120 -118
data/lib/rvg/units.rb +60 -58
data/rmagick.gemspec +1 -1
metadata +5 -3

data/doc/image3.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick: class Image (instance methods, part 3)</title>
+  <title>RMagick 1.15.0: class Image (instance methods, part 3)</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -51,7 +51,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <h6 id="header">RMagick 1.15.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image2.html">Prev</a> | <a href=
@@ -91,6 +91,8 @@
           <li><a href=
           "#random_threshold_channel">random_threshold_channel</a></li>
+          <li><a href="#recolor">recolor</a></li>
           <li><a href="#reduce_noise">reduce_noise</a></li>
           <li><a href="#resample">resample</a></li>
@@ -166,14 +168,14 @@
           <li><a href="#strip_bang">strip!</a></li>
           <li><a href="#swirl">swirl</a></li>
+          <li><a href=
+          "#texture_fill_to_border">texture_fill_to_border</a></li>
         </ul>
       </div>
       <div class="toccol">
         <ul>
-          <li><a href=
-          "#texture_fill_to_border">texture_fill_to_border</a></li>
           <li><a href=
           "#texture_floodfill">texture_floodfill</a></li>
@@ -216,6 +218,8 @@
           <li><a href="#wave">wave</a></li>
+          <li><a href="#wet_floor">wet_floor</a></li>
           <li><a href="#white_threshold">white_threshold</a></li>
           <li><a href="#write">write</a></li>
@@ -808,6 +812,32 @@ random_threshold_channel(geom, RedChannel)
     <p>RandomThresholdImageChannel</p>
   </div>
+  <div class="sig">
+    <h3 id="recolor">recolor</h3>
+    <p><span class="arg">image</span>.recolor(<span class=
+    "arg">color_matrix</span>) -&gt; <em>anImage</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Use this method to <span class="imquote">translate, scale,
+    shear, or rotate image colors. Although you can use variable
+    sized matrices, typically you use a 5&times;5 for an RGBA image
+    and a 6&times;6 for CMYKA. Populate the last row with
+    normalized values to translate.</span></p>
+    <h4>Arguments</h4>
+    <p>An array of Float values representing the recolor
+    matrix.</p>
+    <h4>Magick API</h4>
+    <p>RecolorImage (introduced in ImageMagick 6.3.1)</p>
+  </div>
   <div class="sig">
     <h3 id="reduce_noise">reduce_noise</h3>
@@ -1609,7 +1639,7 @@ random_threshold_channel(geom, RedChannel)
     id="shadowed" onmouseover=
     "this.style.display='none';shadowless.style.display='';" src=
     "ex/shadow_after.gif" alt="shadow example"
-     /></a> <img src="ex/images/spin.gif" alt="" style=
+    /></a> <img src="ex/images/spin.gif" alt="" style=
     "margin-bottom: 120px" title=
     "Mouse over the example to see the original image" /></p>
@@ -1827,7 +1857,7 @@ random_threshold_channel(geom, RedChannel)
      <img id="sheared" onmouseover=
     "this.style.display='none'; noshear.style.display='';" src=
     "ex/shear.jpg" alt="shear example"
-     /></a><img src="ex/images/spin.gif" alt="" class=
+    /></a><img src="ex/images/spin.gif" alt="" class=
     "spin" style="left: 253px; top: 34px" title=
     "Mouse over the example to see the original image" /></p>
@@ -3550,7 +3580,7 @@ end
                                                               --><img class="hide"
     id="waved" onmouseover=
     "this.style.display='none'; nowave.style.display='';" src=
-    "ex/wave.jpg" alt="wave example"  /></a> <img src=
+    "ex/wave.jpg" alt="wave example" /></a> <img src=
     "ex/images/spin.gif" alt="" class="spin" title=
     "Mouse over the example to see the original image" /></p>
@@ -3564,6 +3594,72 @@ end
     "imageattrs.html#virtual_pixel_method">virtual_pixel_method</a></p>
   </div>
+  <div class="sig">
+    <h3 id="wet_floor">wet_floor</h3>
+    <p><span class="arg">image</span>.wet_floor(<span class=
+    "arg">intial=0.5</span>, <span class="arg">rate=1.0</span>)
+    -&gt; <em>anImage</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Creates a <a href=
+    "http://en.wikipedia.org/wiki/Wet_floor_effect">"wet floor"</a>
+    reflection. The reflection is an inverted copy of the image
+    that changes from partially transparent to entirely
+    transparent. By default only the bottom third of the image
+    appears in the reflection.</p>
+    <p>Note that the output image is just the reflection. This
+    makes it easy to apply further transformations to the
+    reflection before combining it with the original image.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>initial</dt>
+      <dd>A value between 0.0 and 1.0 that specifies the initial
+      percentage of transparency. Higher values cause the top of
+      the reflection to be more transparent, lower values less
+      transparent. The default is 0.5, which means that the top of
+      the reflection is 50% transparent.</dd>
+      <dt>rate</dt>
+      <dd>A non-negative value that specifies how rapidly the
+      reflection transitions from the initial level of transparency
+      to entirely transparent. The default value is 1.0, which
+      means that the transition occurs in 1/3 the image height.
+      Values greater than 1.0 speed up the transition (the
+      reflection will have fewer rows), values lower than 1.0 slow
+      down the transition (the reflection will have more rows). A
+      value of 0.0 means that the level of transparency will not
+      change.</dd>
+    </dl>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>Example</h4>
+    <p>Here are four examples of <code>wet_floor</code>. The top
+    image shows the result of appending the default reflection to
+    the original image. The second image shows the result of
+    decreasing the initial transparency to 0.25 and using 0.5 as
+    the <span class="arg">rate</span> argument. The third image
+    uses the same reflection as the second image but has a slant
+    added. The bottom image is the same as the third image but with
+    a ripple effect.</p>
+    <p><a href="javascript:popup('wet_floor.rb.html')"><img src=
+    "ex/wet_floor.gif" title="Click to see the example script" alt=
+    "wet floor example" /></a></p>
+  </div>
   <div class="sig">
     <h3 id="white_threshold">white_threshold</h3>

data/doc/imageattrs.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick: class Image (attribute methods)</title>
+  <title>RMagick 1.15.0: class Image (attribute methods)</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -25,7 +25,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <h6 id="header">RMagick 1.15.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="ilist.html">Prev</a> | <a href=

data/doc/imusage.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick: ImageMagick/GraphicsMagick Conventions</title>
+  <title>RMagick 1.15.0: ImageMagick/GraphicsMagick Conventions</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -69,7 +69,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <h6 id="header">RMagick 1.15.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="usage.html">Prev</a> | <a href=

data/doc/index.html CHANGED

@@ -4,9 +4,10 @@
 <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" />
+  "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick User's Guide and Reference</title>
+  <title>RMagick 1.15.0 User's Guide and
+  Reference</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -105,7 +106,8 @@
   </div>
   <p id="magick">Ruby+ImageMagick<span class="tm">TM</span><br />
-  Ruby+GraphicsMagick</p>
+  Ruby+GraphicsMagick<br />
+  Version 1.15.0</p>
   <h1>User's Guide and Reference</h1>
@@ -124,7 +126,8 @@
           <li><a href="imusage.html">ImageMagick and GraphicsMagick
           Conventions</a></li>
-        <li><a href="optequiv.html">Magick Command Options and Their Equivalent Methods</a></li>
+          <li><a href="optequiv.html">Magick Command Options and
+          Their Equivalent Methods</a></li>
           <li><a href="comtasks.html">Common Tasks</a></li>
         </ul>
@@ -234,7 +237,7 @@
     </ul>
   </div>
-  <h2 id="#introduction">Introduction</h2>
+  <h2 id="introduction">Introduction</h2>
   <h3>What is RMagick?</h3>
@@ -313,16 +316,17 @@
   <h3>About this document</h3>
-  <p>This document is divided into 4 parts. The first is this page.
-  The second part is a user's guide covering both RMagick and
+  <p>This document describes Version 1.15.0 of RMagick.
+  It is divided into 4 parts. The first is this page. The second
+  part is a user's guide covering both RMagick and
   ImageMagick/GraphicsMagick usage and conventions. The third part
   is a reference guide to the ImageList, Image, and Draw classes.
   This guide includes many examples.</p>
-  <p>The fourth part covers the newest addition to RMagick, Ruby
-  Vector Graphics (RVG). RVG is a facade for Draw that provides a
-  high-level API for scalable vector graphics. The RVG section
-  includes a tutorial and complete reference documentation.</p>
+  <p>The fourth part covers Ruby Vector Graphics (RVG). RVG is a
+  facade for Draw that provides a high-level API for scalable
+  vector graphics. The RVG section includes a tutorial and complete
+  reference documentation.</p>
   <p>Accompanying the HTML documentation is a set of over 175
   example RMagick programs. Each is a complete, stand-alone program
@@ -398,10 +402,11 @@
   Ruby version numbers, along with a thorough description of the
   problem. RMagick will tell you both its version number and
   &times;Magick's version number. Simply bring up irb and run this
-  command: <code>ruby -r RMagick -e "puts Magick::Long_version"</code></p>
+  command: <code>ruby -r RMagick -e "puts
+  Magick::Long_version"</code></p>
   <pre class="example" id="version">
-This is RMagick 1.13.0 ($Date: 2006/09/05 23:11:25 $) Copyright (C) 2006 by Timothy P. Hunter
-Built with ImageMagick 6.2.9 08/21/06 Q8 http://www.imagemagick.org
+This is RMagick 1.15.0 ($Date: 2007/01/14 19:01:40 $) Copyright (C) 2007 by Timothy P. Hunter
+Built with ImageMagick 6.3.1 01/13/07 Q16 http://www.imagemagick.org
 Built for ruby 1.8.5 (2006-08-25) [i686-linux]
 Web page: http://rmagick.rubyforge.org
 Email: rmagick@rubyforge.org
@@ -439,12 +444,11 @@ Email: rmagick@rubyforge.org
   Notices</a></h3>
   <ul>
-    <li>RMagick is copyrighted by Timothy P. Hunter.</li>
+    <li>RMagick &copy; 2002-2007 Timothy P. Hunter.</li>
-    <li>ImageMagick is copyrighted by ImageMagick
-    Studio.</li>
+    <li>ImageMagick &copy; 1999-2007 ImageMagick Studio.</li>
-    <li>GraphicsMagick is copyrighted by the GraphicsMagick
+    <li>GraphicsMagick &copy; 2002, 2003, 2004, 2005 GraphicsMagick
     Group.</li>
     <li>Ruby is copyrighted free software by Yukihiro

data/doc/info.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick: class Image::Info - Optional method
+  <title>RMagick 1.15.0: class Image::Info - Optional method
   arguments</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
@@ -44,7 +44,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <h6 id="header">RMagick 1.15.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="struct.html">Prev</a> | <a href=
@@ -96,13 +96,13 @@
         <li><a href="#depth">depth</a></li>
         <li><a href="#dispose">dispose</a></li>
+        <li><a href="#dither">dither</a></li>
       </ul>
     </div>
     <div class="toccol">
       <ul>
-        <li><a href="#dither">dither</a></li>
         <li><a href="#extract">extract</a></li>
         <li><a href="#filename">filename</a></li>
@@ -124,17 +124,19 @@
         <li><a href="#label">label</a></li>
         <li><a href="#matte_color">matte_color</a></li>
+        <li><a href="#monitor">monitor</a></li>
       </ul>
     </div>
     <div class="toccol">
       <ul>
-        <li><a href="#monitor">monitor</a></li>
         <li><a href="#monochrome">monochrome</a></li>
         <li><a href="#orientation">orientation</a></li>
+        <li><a href="#origin">origin</a></li>
         <li><a href="#page">page</a></li>
         <li><a href="#pointsize">pointsize</a></li>
@@ -1078,6 +1080,26 @@ self.undefine("tiff", "bits-per-sample")
     "constants.html#OrientationType">OrientationType</a> value.</p>
   </div>
+  <div class="sig">
+    <h3 id="origin">origin</h3>
+    <p><span class="arg">self</span>.origin=<span class=
+    "arg">aString</span> or <span class="arg">aGeometry</span></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Set the image origin.</p>
+    <h4>Argument</h4>
+    <p>A <a href="imusage.html#geometry">geometry string</a> of the
+    form <code>+x+y</code> (a "-" may be used instead of "+" to
+    indicate a negative offset) or a <a href=
+    "struct.html#Geometry">Geometry</a> object.</p>
+  </div>
   <div class="sig">
     <h3 id="page">page</h3>

data/doc/magick.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
-  <title>RMagick: module Magick</title>
+  <title>RMagick 1.15.0: module Magick</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -24,7 +24,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick User's Guide and Reference</h6>
+  <h6 id="header">RMagick 1.15.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="comtasks.html">Prev</a> | <a href=
@@ -51,6 +51,10 @@
       <li><a href=
       "#set_cache_threshold">set_cache_threshold</a></li>
+      <li><a href="#set_log_event_mask">set_log_event_mask</a></li>
+      <li><a href="#set_log_format">set_log_format</a></li>
       <li><a href="#set_monitor">set_monitor</a></li>
     </ul>
   </div>
@@ -362,8 +366,8 @@ p Magick.formats &raquo;
       <code>:file</code>, the limit is the number of open files. If
       <code>:memory</code> or <code>:map</code>, the limit is
       measured megabytes. If <code>:disk</code>, the limit is
-      measured in gigabytes. If this argument is omitted the limit is not
-      changed.</dd>
+      measured in gigabytes. If this argument is omitted the limit
+      is not changed.</dd>
     </dl>
     <h4>Returns</h4>
@@ -416,6 +420,123 @@ Magick.set_cache_threshold(n)
 </pre>
   </div>
+  <div class="sig">
+    <h3 id="set_log_event_mask">set_log_event_mask</h3>
+    <p>Magick.set_log_event_mask(<span class=
+    "arg">event_list</span>)</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify which events to log.</p>
+    <h4>Argument</h4>
+    <p>A string composed of one or more of the following event
+    types. If more than one event type is specified, separate the
+    event types with commas.</p>
+    <p><code>All, Annotate, Blob, Cache, Coder, Configure,
+    Deprecate, Draw, Exception, Locale, Module, None, Resource,
+    Trace, Transform, User, Wand, X11</code></p>
+    <h4>Example</h4>
+    <pre>
+Magick.set_log_event_mask("Module,Coder")
+</pre>
+    <h4>Magick API</h4>
+    <p>SetLogEventMask</p>
+    <h4>See also</h4>
+    <p><a href="#set_log_format">set_log_format</a></p>
+    <h4>Log configuration</h4>
+    <p>Magick logging is configured with the log.xml file in
+    Magick's config directory. See <a href=
+    "http://redux.imagemagick.org/script/resources.php">Resources</a>
+    in the ImageMagick documenation for more information.</p>
+    <p>Use this command to find out about the current log
+    configuration.</p>
+    <pre>
+convert -list log
+</pre>
+  </div>
+  <div class="sig">
+    <h3 id="set_log_format">set_log_format</h3>
+    <p>Magick.set_log_format(<span class="arg">format</span>)</p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Specify the event log format.</p>
+    <h4>Argument</h4>
+    <p>A fprintf-like format string composed of optional "normal"
+    text (to which no meaning is assigned) and the following format
+    characters:</p>
+    <dl>
+      <dt>%d</dt>
+      <dd>domain</dd>
+      <dt>%e</dt>
+      <dd>event</dd>
+      <dt>%f</dt>
+      <dd>function</dd>
+      <dt>%l</dt>
+      <dd>line</dd>
+      <dt>%m</dt>
+      <dd>module</dd>
+      <dt>%p</dt>
+      <dd>process ID</dd>
+      <dt>%r</dt>
+      <dd>read CPU time</dd>
+      <dt>%t</dt>
+      <dd>wall clock time</dd>
+      <dt>%u</dt>
+      <dd>user CPU time</dd>
+      <dt>%%</dt>
+      <dd>percent sign</dd>
+      <dt>\n</dt>
+      <dd>newline</dd>
+      <dt>\r</dt>
+      <dd>carriage return</dd>
+    </dl>
+  </div>
   <div class="sig">
     <h3 id="set_monitor">set_monitor</h3>