RubyGems - rmagick - Versions diffs - 2.5.2 → 2.6.0 - Mend

rmagick 2.5.2 → 2.6.0

Potentially problematic release.

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

Files changed (52) hide show

data/ChangeLog +29 -0
data/README.html +7 -7
data/doc/comtasks.html +2 -2
data/doc/constants.html +22 -5
data/doc/draw.html +2 -2
data/doc/ex/affinity.rb +12 -0
data/doc/ex/affinity_images.rb +21 -0
data/doc/ex/composite_tiled.rb +23 -0
data/doc/ex/images/Apple.miff +0 -0
data/doc/ex/images/Leaf.miff +0 -0
data/doc/ex/images/Rocks_On_Beach.miff +0 -0
data/doc/ex/images/Yellow_Rose.miff +0 -0
data/doc/ex/level_colors.rb +11 -0
data/doc/ilist.html +72 -30
data/doc/image1.html +305 -34
data/doc/image2.html +144 -18
data/doc/image3.html +111 -8
data/doc/imageattrs.html +10 -2
data/doc/imusage.html +5 -5
data/doc/index.html +3 -3
data/doc/info.html +2 -2
data/doc/magick.html +2 -2
data/doc/optequiv.html +54 -9
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 +2 -2
data/doc/rvguse.html +2 -2
data/doc/rvgxform.html +2 -2
data/doc/struct.html +2 -2
data/doc/usage.html +27 -8
data/ext/RMagick/MANIFEST +9 -3
data/ext/RMagick/extconf.rb +19 -3
data/ext/RMagick/rmagick.h +23 -7
data/ext/RMagick/rmdraw.c +74 -22
data/ext/RMagick/rmfill.c +2 -2
data/ext/RMagick/rmilist.c +79 -29
data/ext/RMagick/rmimage.c +904 -393
data/ext/RMagick/rminfo.c +9 -9
data/ext/RMagick/rmmain.c +64 -9
data/ext/RMagick/rmutil.c +158 -44
data/lib/RMagick.rb +32 -1
data/rmagick.gemspec +1 -1
metadata +10 -4
data/doc/ex/map.rb +0 -28
data/doc/ex/map_f.rb +0 -15

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.5.2: class Image (instance methods e-o)</title>
+  <title>RMagick 2.6.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.5.2 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.6.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image1.html">Prev</a> | <a href=
@@ -111,13 +111,13 @@ td.ds {
           <li><a href="#flop_bang">flop!</a></li>
           <li><a href="#frame">frame</a></li>
+          <li><a href="#freeze">freeze</a></li>
         </ul>
       </div>
       <div class="toccol">
         <ul>
-          <li><a href="#freeze">freeze</a></li>
           <li><a href="#gamma_channel">gamma_channel</a></li>
           <li><a href="#gamma_correct">gamma_correct</a></li>
@@ -153,6 +153,10 @@ td.ds {
           <li><a href="#level_channel">level_channel</a></li>
+          <li><a href="#level_colors">level_colors</a></li>
+          <li><a href="#levelize_channel">levelize_channel</a></li>
           <li><a href="#linear_stretch">linear_stretch</a></li>
           <li><a href="#liquid_rescale">liquid_rescale</a></li>
@@ -1035,7 +1039,7 @@ scanline = img.export_pixels(0, r, img.columns, 1, "RGB");
      <img style="padding:25px; display:none" id="frameless"
     onmouseout="this.style.display='none';framed.style.display='';"
     src="ex/images/Flower_Hat.jpg" alt="frame example" title=
-    "Click to see the example script" />
+    "Click to see the example script" />
     <!-- This img tag displays the framed image when the mouse is not over -->
      <img onmouseover=
     "this.style.display='none';frameless.style.display='';" src=
@@ -2361,7 +2365,7 @@ img.level(white_point, gamma, black_point) -&gt; image # wrong!
       "constants.html#Miscellaneous_constants">QuantumRange</a>.
       The default is 0.0.</dd>
-      <dt>mid_point</dt>
+      <dt>white_point</dt>
       <dd>A white point level in the range 0..QuantumRange. The
       default is <a href=
@@ -2380,13 +2384,142 @@ img.level(white_point, gamma, black_point) -&gt; image # wrong!
     <h4>See also</h4>
-    <p><a href="#level">level</a></p>
+    <p><a href="#level">level</a>, <a href=
+    "#levelize_channel">levelize_channel</a></p>
     <h4>Magick API</h4>
     <p>LevelImageChannel</p>
   </div>
+  <div class="sig">
+    <h3 id="level_colors">level_colors</h3>
+    <p><span class="arg">img</span>.level_colors(<span class=
+    "arg">black_color</span>="black", <span class=
+    "arg">white_color</span>="white", <span class=
+    "arg">invert</span>=<code>true</code>) -&gt; <em>image</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>When <span class="arg">invert</span> is true, black and
+    white will be mapped to the <span class=
+    "arg">black_color</span> and <span class=
+    "arg">white_color</span> colors, compressing all other colors
+    linearly. When <span class="arg">invert</span> is false, black
+    and white will be mapped to the <span class=
+    "arg">black_color</span> and <span class=
+    "arg">white_color</span> colors, stretching all other colors
+    linearly. The default is <code>true</code>.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>black_color</dt>
+      <dd>The color to be mapped to black. The default is
+      "black".</dd>
+      <dt>white_color</dt>
+      <dd>The color to be mapped to white. The default is
+      "white".</dd>
+      <dt>invert</dt>
+      <dd>See the description above.</dd>
+    </dl>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>Example</h4>
+    <p class="rollover"><a href=
+    "javascript:popup('level_colors.rb.html')"><img onmouseover=
+    "this.src='ex/images/Flower_Hat.jpg'" onmouseout=
+    "this.src='ex/level_colors.jpg'" src="ex/level_colors.jpg"
+    title="Click to see the example script" alt=
+    "level_colors example" /></a> <img src="ex/images/spin.gif"
+    alt="" class="spin" title=
+    "Mouse over the image to see the original image" /></p>
+    <h4>See also</h4>
+    <p>This method corresponds to the +level-colors option. See
+    <a href=
+    "http://www.imagemagick.org/Usage/color/#level-colors">Examples
+    of ImageMagick Usage</a> for more information.</p>
+    <h4>Magick API</h4>
+    <p>LevelImageColors</p>
+  </div>
+  <div class="sig">
+    <h3 id="levelize_channel">levelize_channel</h3>
+    <p><span class="arg">img</span>.levelize_channel(<span class=
+    "arg">black_point</span>, <span class="arg">white_point</span>,
+    <span class="arg">gamma</span>=1.0 [, <span class=
+    "arg">channel</span>...]) -&gt; <em>image</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Maps black and white to the specified points. The reverse of
+    <a href="#level_channel">level_channel</a>.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>black_point</dt>
+      <dd>A black point level in the range 0..<a href=
+      "constants.html#Miscellaneous_constants">QuantumRange</a>.
+      This argument is required.</dd>
+      <dt>white_point</dt>
+      <dd>A white point level in the range 0..QuantumRange. The
+      default is QuantumRange - <span class=
+      "arg">black_point</span>.</dd>
+      <dt>gamma</dt>
+      <dd>A gamma correction in the range 0.0-10.0 The default is
+      1.0.</dd>
+      <dt>channel...</dt>
+      <dd>0 or more <a href=
+      "constants.html#ChannelType">ChannelType</a> arguments. If no
+      channels are specified, the default channels are the red,
+      green, and blue channels.</dd>
+    </dl>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>See also</h4>
+    <p><a href="#level">level</a>, <a href=
+    "#level_channel">level_channel</a></p>
+    <p>This method corresponds to the +level option. See <a href=
+    "http://www.imagemagick.org/Usage/color/#level_plus">Examples
+    of ImageMagick Usage</a> for more information.</p>
+    <h4>Magick API</h4>
+    <p>LevelizeImageChannel</p>
+  </div>
   <div class="sig">
     <h3 id="linear_stretch">linear_stretch</h3>
@@ -2552,18 +2685,11 @@ img.level(white_point, gamma, black_point) -&gt; image # wrong!
     <p>A new image</p>
-    <h4>Example</h4>
-    <p>This image has been mapped to the Netscape 216-color
-    cube.</p>
+    <h4>Notes</h4>
-    <p class="rollover"><a href=
-    "javascript:popup('map_f.rb.html')"><img onmouseover=
-    "this.src='ex/images/Flower_Hat.jpg'" onmouseout=
-    "this.src='ex/map_f.jpg'" src="ex/map_f.jpg" alt=
-    "map_f example" title="Click to see the example script" /></a>
-    <img src="ex/images/spin.gif" alt="" class="spin" title=
-    "Mouse over the image to see the original image" /></p>
+    <p>This method is deprecated when using ImageMagick 6.4.3-6 and
+    later. Use <a href="image1.html#affinity">affinity</a>
+    instead.</p>
     <h4>See also</h4>

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.5.2: class Image (instance methods p-w)</title>
+  <title>RMagick 2.6.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.5.2 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.6.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="image2.html">Prev</a> | <a href=
@@ -171,6 +171,8 @@
           <li><a href="#solarize">solarize</a></li>
+          <!-- <li><a href="#sparse_color">sparse_color</a></li> -->
           <li><a href="#splice">splice</a></li>
           <li><a href="#spread">spread</a></li>
@@ -182,13 +184,13 @@
           <li><a href="#store_pixels">store_pixels</a></li>
           <li><a href="#strip_bang">strip!</a></li>
-          <li><a href="#swirl">swirl</a></li>
         </ul>
       </div>
       <div class="toccol">
         <ul>
+          <li><a href="#swirl">swirl</a></li>
           <li><a href="#sync_profiles">sync_profiles</a></li>
           <li><a href=
@@ -714,8 +716,8 @@ end
     <p><span class="arg">img</span>.quantize(<span class=
     "arg">number_colors</span>=256, <span class=
     "arg">colorspace</span>=RGBColorspace, <span class=
-    "arg">dither</span>=<code>true</code>, <span class=
-    "arg">tree_depth</span>=0, <span class=
+    "arg">dither</span>=<code>RiemersmaDitherMethod</code>,
+    <span class="arg">tree_depth</span>=0, <span class=
     "arg">measure_error</span>=<code>false</code>) -&gt;
     <em>image</em></p>
   </div>
@@ -752,8 +754,9 @@ end
       <dt>dither</dt>
-      <dd>Set to <code>false</code> to disable dithering. See the
-      documentation for the <a href=
+      <dd>A <a href="constants.html#DitherMethod">DitherMethod</a>
+      value. Set to <code>NoDitherMethod</code> to disable
+      dithering. See the documentation for the <a href=
       "http://redux.imagemagick.org/script/command-line-options.php#dither">
       ImageMagick -dither option</a> for more information.</dd>
@@ -2527,6 +2530,88 @@ img.properties &raquo;
     <p>SolarizeImage</p>
   </div>
+  <!--
+  <div class="sig">
+    <h3 id="sparse_color">sparse_color</h3>
+    <p><span class="arg">img</span>.sparse_color(<span class=
+    "arg">method</span>, <span class="arg">points</span>[,
+    <span class="arg">channel</span>...]) -&gt; <em>image</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p class="imquote">Given a set of coordinates interpolates the
+    colors found at those coordinates, across the whole image,
+    using various methods.</p>
+    <p>For more information about this method see the ImageMagick
+    documentation for the -sparse-color option. Also see <a href=
+    "http://www.imagemagick.org/Usage/canvas/#sparse-color">Sparse
+    Points of Color</a> at <a href=
+    "http://www.imagemagick.org/Usage/">Examples of ImageMagick
+    Usage</a>.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>method</dt>
+      <dd>
+        One of the following interpolation methods:
+        <dl>
+          <dt>BarycentricColorInterpolate</dt>
+          <dd class="imquote">Three point triangle of color given 3
+          points. Giving only 2 points will form a linear gradient
+          between those points. Gradient is however not restricted
+          to just the triangle or line.</dd>
+          <dt>BilinearColorInterpolate</dt>
+          <dd class="imquote">Like barycentric but for 4 points.
+          Less than 4 points fall back to barycentric.</dd>
+          <dt>ShepardsColorInterpolate</dt>
+          <dd class="imquote">Colors points basied on the ratio of
+          inverse distance squared. Generating spots of color in a
+          sea of the average of colors.</dd>
+          <dt>VoronoiColorInterpolate</dt>
+          <dd class="imquote">Simply map each pixel to the to
+          nearest color point given. The result are polygonal
+          'cells' of solid color.</dd>
+          <dt>PolynomialColorInterpolate</dt>
+          <dd class="imquote">&nbsp;</dd>
+        </dl>
+      </dd>
+      <dt>points</dt>
+      <dd>An array of coordinates. The number of coordinates varies
+      according to the method.</dd>
+      <dt>channel...</dt>
+      <dd>0 or more <a href=
+      "constants.html#ChannelType">ChannelType</a> arguments.</dd>
+    </dl>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>Magick API</h4>
+    <p>SparseColorInterpolate (available in 6.4.2)</p>
+  </div>
+-->
   <div class="sig">
     <h3 id="splice">splice</h3>
@@ -4170,6 +4255,24 @@ end
     <p>Almost all of the examples call <code>write</code>.</p>
+    <h4>Notes</h4>
+    <p>When the argument is a filename, specify the output format
+    via the filename extension (for example ".jpg" or ".gif") or by
+    prefixing the filename with the desired format (for example,
+    "jpeg:myfile"), not via <code>format=</code>.</p>
+    <p><em>Do not</em> use a StringIO object or a Tempfile object
+    as the argument. Neither of these work. Use
+    <code>to_blob</code> to write to a String. Instead of a
+    tempfile, get the path of the tempfile from the
+    <code>path</code> method. Prefix the path with the desired
+    image format. For example,</p>
+    <pre>
+temp = Tempfile.new("image")
+img.write("jpeg:"+ temp.path)
+</pre>
     <h4>See also</h4>
     <p><a href="ilist.html#write">ImageList#write</a></p>

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.5.2: class Image (attribute methods)</title>
+  <title>RMagick 2.6.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.5.2 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.6.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="ilist.html">Prev</a> | <a href=
@@ -1556,6 +1556,14 @@ blur_image is 100% complete.
       <dd class="imquote">use a dithered pattern to choose a pixel
       in a 32x32 neighborhood.</dd>
+      <dt>HorizontalTileVirtualPixelMethod</dt>
+      <dd class="imquote">Horizontally tile the image</dd>
+      <dt>VerticalTileVirtualPixelMethod</dt>
+      <dd class="imquote">Vertically tile the image</dd>
     </dl>
     <p>Some of these values are not supported by older versions of

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.5.2: ImageMagick Conventions</title>
+  <title>RMagick 2.6.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.5.2 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.6.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="usage.html">Prev</a> | <a href=
@@ -164,9 +164,9 @@
   color names. A color name can be</p>
   <ol>
-    <li>an X color name such as "red", "chocolate", or
-    "lightslategray". (On Linux and FreeBSD, the master list is
-    usually <code>/usr/X11R6/lib/X11/rgb.txt</code>.)</li>
+    <li>an <a href=
+    "http://en.wikipedia.org/wiki/X11_color_names">X11 color
+    name</a> such as "red", "chocolate", or "lightslategray".</li>
     <li>an <a href=
     "http://www.w3.org/TR/SVG/types.html#ColorKeywords">SVG color