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

rmagick 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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>