RubyGems - rmagick - Versions diffs - 2.4.0 → 2.5.0 - Mend

rmagick 2.4.0 → 2.5.0

Potentially problematic release.

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

Files changed (38) hide show

data/ChangeLog CHANGED

@@ -1,3 +1,6 @@
+RMagick 2.5.0
+    o Added Image#add_compose_mask, #delete_compose_mask (feature #20531)
 RMagick 2.4.0
     o Added Image#image_type= (feature #20490)

data/README.html CHANGED

@@ -1,15 +1,15 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
   <head>
-    <title>RMagick 2.4.0 README</title>
+    <title>RMagick 2.5.0 README</title>
     <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
     <meta name="GENERATOR" content="RedCloth">
   </head>
   <body>
-<h1>RMagick 2.4.0 <span class="caps">README</span></h1>
+<h1>RMagick 2.5.0 <span class="caps">README</span></h1>
-	<h2>06/02/08</h2>
+	<h2>06/08/08</h2>
 	<h3>Table of Contents</h3>
@@ -75,12 +75,12 @@ depending on which tarball you have:</p>
 <pre>
-    tar xvzf RMagick-2.4.0-tar.gz              (gzipped tarball)
-    tar xvjf RMagick-2.4.0-tar.bz2             (bzipped tarball)
+    tar xvzf RMagick-2.5.0-tar.gz              (gzipped tarball)
+    tar xvjf RMagick-2.5.0-tar.bz2             (bzipped tarball)
     7z e RMagick-x.y.z.tar.lzma -so | tar xv    (7zipped tarball)
 </pre>
-	<p>Change to the RMagick-2.4.0 directory. If you are not using any
+	<p>Change to the RMagick-2.5.0 directory. If you are not using any
 configuration options (usually you don&#8217;t need to) enter the command</p>
@@ -191,7 +191,7 @@ systems, see the documentation for the dynamic loading facility.</p>
 <pre>
-    hook /home/me/src/RMagick-2.4.0/./post-setup.rb failed:
+    hook /home/me/src/RMagick-2.5.0/./post-setup.rb failed:
     No such file or directory - "/tmp/rmagick6872.6"
 </pre>

data/doc/comtasks.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: Common Tasks</title>
+  <title>RMagick 2.5.0: Common Tasks</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -31,7 +31,7 @@
 </head>
 <body>
-  <h6 id="header">RMagick 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="optequiv.html">Prev</a> | <a href=

data/doc/constants.html CHANGED

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

data/doc/draw.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: class Draw</title>
+  <title>RMagick 2.5.0: class Draw</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 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image3.html">Prev</a> | <a href=

data/doc/ex/compose_mask.rb ADDED

@@ -0,0 +1,23 @@
+require 'RMagick'
+background = Magick::Image.read('images/Flower_Hat.jpg').first
+source = Magick::Image.read('pattern:checkerboard') {self.size = "#{background.columns}x#{background.rows}"}.first
+mask = Magick::Image.new(background.columns, background.rows) {self.background_color = "black"}
+# Make a mask
+gc = Magick::Draw.new
+gc.annotate(mask, 0, 0, 0, 0, "Ruby") do
+  gc.gravity = Magick::CenterGravity
+  gc.pointsize = 100
+  gc.rotation = 90
+  gc.font_weight = Magick::BoldWeight
+  gc.fill = "white"
+  gc.stroke = "none"
+end
+background.add_compose_mask(mask)
+result = background.composite(source, Magick::CenterGravity, Magick::OverCompositeOp)
+result.write "compose_mask_example.jpg"
+source.write "compose_mask_source.gif"
+mask.write "compose_mask.gif"

data/doc/ilist.html CHANGED

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

data/doc/image1.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: class Image (class methods and instance
+  <title>RMagick 2.5.0: class Image (class methods and instance
   methods a-d)</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
@@ -48,7 +48,7 @@ float: left;
 </head>
 <body>
-  <h6 id="header">RMagick 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="imageattrs.html">Prev</a> | <a href=
@@ -121,13 +121,15 @@ float: left;
           <li><a href=
           "#adaptive_threshold">adaptive_threshold</a></li>
-          <li><a href="#add_noise">add_noise</a></li>
+          <li><a href="#add_compose_mask">add_compose_mask</a></li>
-          <li><a href="#add_profile">add_profile</a></li>
+          <li><a href="#add_noise">add_noise</a></li>
           <li><a href=
           "#add_noise_channel">add_noise_channel</a></li>
+          <li><a href="#add_profile">add_profile</a></li>
           <li><a href="#affine_transform">affine_transform</a></li>
           <li><a href="#alpha">alpha</a></li>
@@ -233,6 +235,9 @@ float: left;
           <li><a href="#decipher">decipher</a></li>
+          <li><a href=
+          "#delete_compose_mask">delete_compose_mask</a></li>
           <li><a href="#delete_profile">delete_profile</a></li>
           <li><a href="#despeckle">despeckle</a></li>
@@ -1142,6 +1147,96 @@ img = Image.read_inline(content)
     <p>AdaptiveThresholdImage</p>
   </div>
+  <div class="sig">
+    <h3 id="add_compose_mask">add_compose_mask</h3>
+    <p><span class="arg">img</span>.add_compose_mask(<span class=
+    "arg">mask</span>) -&gt; <em>self</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Associates a mask with an image that will be used as the
+    destination image in a <a href="#composite">composite</a>
+    operation. The areas of the destination image that are masked
+    by white pixels will be modified by the <a href=
+    "#composite">composite</a> method, while areas masked by black
+    pixels are unchanged.</p>
+    <p>See <a href=
+    "http://www.imagemagick.org/Usage/compose/#mask">Using a
+    Compose Mask to Limit the Composed Area</a> in Anthony
+    Thyssen's <a href="http://www.imagemagick.org/Usage/">Examples
+    of ImageMagick Usage</a>.</p>
+    <h4>Arguments</h4>
+    <p>The mask image must have the same dimensions as the
+    destination image.</p>
+    <h4>Returns</h4>
+    <p>self</p>
+    <h4>Example</h4>
+    <div>
+      <table summary="compose_mask example">
+        <tr>
+          <td><a href=
+          "javascript:add_popup('compose_mask.rb.html')"><img src=
+          "ex/images/Flower_Hat.jpg" width="100" height="125" alt=
+          "Source image for add_compose_mask example" title=
+          "Click to see the example script" /></a></td>
+          <td><a href=
+          "javascript:add_popup('compose_mask.rb.html')"><img src=
+          "ex/compose_mask_source.gif" width="100" height="125"
+          alt="Background image for add_compose_mask example"
+          title="Click to see the example script" /></a></td>
+          <td><a href=
+          "javascript:add_popup('compose_mask.rb.html')"><img src=
+          "ex/compose_mask.gif" width="100" height="125" alt=
+          "Mask image for compose_mask example" title=
+          "Click to see the example script" /></a></td>
+          <td><a href=
+          "javascript:add_popup('compose_mask.rb.html')"><img src=
+          "ex/compose_mask_example.jpg" width="93" height="125"
+          alt="Result image for compose_mask example" title=
+          "Click to see the example script" /></a></td>
+        </tr>
+        <tr>
+          <td align="center">Background</td>
+          <td align="center">Source</td>
+          <td align="center">Mask</td>
+          <td align="center">Result</td>
+        </tr>
+      </table>
+    </div>
+    <h4>See also</h4>
+    <p><a href="#composite">composite</a>, <a href=
+    "#delete_compose_mask">delete_compose_mask</a></p>
+    <h4>Notes</h4>
+    <p>This method uses a <em>copy</em> of the argument as the
+    mask. If you change the mask image you must call this method
+    again to update the mask.</p>
+    <h4>Magick API</h4>
+    <p>SetImageMask</p>
+  </div>
   <div class="sig">
     <h3 id="add_noise">add_noise</h3>
@@ -1723,8 +1818,9 @@ img = Image.read_inline(content)
       <dd>One or more <a href=
       "constants.html#ChannelType">ChannelType</a> values. If none
-      are specified, the red, green, and blue channels are blurred. This is the
-      equivalent of <a href="#blur_image">blur_image</a>.</dd>
+      are specified, the red, green, and blue channels are blurred.
+      This is the equivalent of <a href=
+      "#blur_image">blur_image</a>.</dd>
     </dl>
     <h4>Returns</h4>
@@ -1880,7 +1976,8 @@ img = Image.read_inline(content)
     <p>The image's <em>bounding box</em>. The bounding box is the
     rectangle that encloses all the pixels not in the border color.
-    Uses the current <a href="imageattrs.html#fuzz">fuzz</a> value.</p>
+    Uses the current <a href="imageattrs.html#fuzz">fuzz</a>
+    value.</p>
     <h4>Returns</h4>A <a href="struct.html#Rectangle">Rectangle</a>
     object.
@@ -3535,6 +3632,32 @@ deciphered_img = img.decipher("magic word")
     <p><a href="image2.html#encipher">encipher</a></p>
   </div>
+  <div class="sig">
+    <h3 id="delete_compose_mask">delete_compose_mask</h3>
+    <p><span class="arg">img</span>.delete_compose_mask() -&gt;
+    <em>self</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Deletes the mask added by <a href=
+    "#add_compose_mask">add_compose_mask</a>.</p>
+    <h4>Returns</h4>
+    <p>self</p>
+    <h4>See also</h4>
+    <p><a href="#add_compose_mask">add_compose_mask</a></p>
+    <h4>Magick API</h4>
+    <p>SetImageMask</p>
+  </div>
   <div class="sig">
     <h3 id="delete_profile">delete_profile</h3>

data/doc/image2.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: class Image (instance methods e-o)</title>
+  <title>RMagick 2.5.0: class Image (instance methods e-o)</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -47,7 +47,7 @@ td.ds {
 </head>
 <body>
-  <h6 id="header">RMagick 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image1.html">Prev</a> | <a href=

data/doc/image3.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: class Image (instance methods p-w)</title>
+  <title>RMagick 2.5.0: class Image (instance methods p-w)</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 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image2.html">Prev</a> | <a href=

data/doc/imageattrs.html CHANGED

@@ -6,7 +6,7 @@
   <meta name="generator" content=
   "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: class Image (attribute methods)</title>
+  <title>RMagick 2.5.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 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.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 1 September 2005), see www.w3.org" />
-  <title>RMagick 2.4.0: ImageMagick Conventions</title>
+  <title>RMagick 2.5.0: ImageMagick 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 2.4.0 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.5.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="usage.html">Prev</a> | <a href=
@@ -290,9 +290,8 @@
   <p><em>Hint:</em> You can specify the transparent color as
   "none", "transparent", or "#000000ff".</p>
-  <p><a href=
-  "http://www.imagemagick.org/script/command-line-options.php#fill">
-  This</a> is ImageMagick's page about color names.</p>
+  <p><a href="http://www.imagemagick.org/script/color.php">This</a>
+  is ImageMagick's page about color names.</p>
   <h2 id="geometry">The geometry string</h2>
@@ -308,7 +307,7 @@
 </pre>
   <p><a href=
-  "http://www.imagemagick.org/script/command-line-options.php#geometry">
+  "http://www.imagemagick.org/script/command-line-options.php#resize">
   This</a> is the ImageMagick description of the geometry
   string:</p>
@@ -340,12 +339,19 @@
     '640x480&gt;' and the image size is 256x256, the image size
     does not change. However, if the image is 512x512 or 1024x1024,
     it is resized to 480x480.</p>
+    <p>Use ^ to set a minimum image size limit. The geometry
+    640x480^, for example, means the image width will not be less
+    than 640 and the image height will not be less than 480 pixels
+    after the resize. One of those dimensions will match the
+    requested size, but the image will likely overflow the space
+    requested to preserve its aspect ratio.</p>
   </div>
-  <p>The x and y offsets, if present, can be preceded with either
-  a + or - sign. The + causes x and y to be measured from the left
-  or top edges, respectively. Conversely, - measures from the right
-  or bottom edges. Offsets are always measured in pixels.</p>
+  <p>The x and y offsets, if present, can be preceded with either a
+  + or - sign. The + causes x and y to be measured from the left or
+  top edges, respectively. Conversely, - measures from the right or
+  bottom edges. Offsets are always measured in pixels.</p>
   <p>Any method that accepts a geometry string will also accept a
   <a href="struct.html#Geometry"><code>Geometry</code></a>
@@ -472,8 +478,10 @@ i = Image.read("gradient:red-blue") { self.size = "100x200" }
     be referenced by specifying the pattern name. For example,
     <code>pattern:checkerboard</code>. For a list of acceptable
     patterns, see <a href=
-    "http://www.imagemagick.org/script/formats.php">this
-    page.</a></p>
+    "http://www.imagemagick.org/script/formats.php">this page.</a>
+    If you do not specify a size the pattern's default size is
+    used. If you specify a size the pattern will be repeated as
+    necessary to fill the image.</p>
     <h4>plasma<sup>*</sup></h4>