RubyGems - rmagick - Versions diffs - 1.15.17 → 2.0.0 - Mend

rmagick 1.15.17 → 2.0.0

Potentially problematic release.

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

Files changed (108) hide show

data/ChangeLog +78 -25
data/README.html +117 -188
data/README.txt +116 -181
data/build_tarball.rake +205 -0
data/doc/comtasks.html +2 -2
data/doc/constants.html +118 -44
data/doc/draw.html +57 -99
data/doc/ex/adaptive_threshold.rb +1 -10
data/doc/ex/add_noise.rb +4 -5
data/doc/ex/axes.rb +1 -1
data/doc/ex/bilevel_channel.rb +2 -13
data/doc/ex/bounding_box.rb +3 -4
data/doc/ex/channel.rb +6 -7
data/doc/ex/clip_path.rb +11 -5
data/doc/ex/color_histogram.rb +8 -20
data/doc/ex/composite_layers.rb +53 -0
data/doc/ex/fill_pattern.rb +26 -0
data/doc/ex/get_multiline_type_metrics.rb +26 -37
data/doc/ex/get_type_metrics.rb +25 -25
data/doc/ex/images/notimplemented.gif +0 -0
data/doc/ex/level.rb +1 -1
data/doc/ex/matte_floodfill.rb +5 -6
data/doc/ex/matte_replace.rb +5 -6
data/doc/ex/negate_channel.rb +0 -10
data/doc/ex/opacity.rb +3 -5
data/doc/ex/polaroid.rb +4 -1
data/doc/ex/posterize.rb +1 -12
data/doc/ex/preview.rb +1 -8
data/doc/ex/radial_blur.rb +1 -11
data/doc/ex/raise.rb +1 -4
data/doc/ex/random_threshold_channel.rb +4 -9
data/doc/ex/sepiatone.rb +2 -9
data/doc/ex/shadow.rb +12 -18
data/doc/ex/sketch.rb +2 -9
data/doc/ex/smile.rb +7 -7
data/doc/ex/splice.rb +3 -10
data/doc/ex/stegano.rb +5 -0
data/doc/ex/threshold.rb +2 -2
data/doc/ex/transpose.rb +1 -8
data/doc/ex/transverse.rb +1 -8
data/doc/ex/trim.rb +1 -2
data/doc/ex/viewex.rb +4 -5
data/doc/ex/vignette.rb +1 -8
data/doc/ex/watermark.rb +1 -0
data/doc/ex/wet_floor.rb +8 -14
data/doc/ilist.html +301 -110
data/doc/image1.html +362 -258
data/doc/image2.html +429 -286
data/doc/image3.html +418 -192
data/doc/imageattrs.html +100 -39
data/doc/imusage.html +26 -21
data/doc/index.html +52 -93
data/doc/info.html +160 -64
data/doc/magick.html +37 -71
data/doc/optequiv.html +155 -61
data/doc/rvg.html +3 -3
data/doc/rvgclip.html +2 -2
data/doc/rvggroup.html +2 -2
data/doc/rvgimage.html +3 -3
data/doc/rvgpattern.html +3 -3
data/doc/rvgshape.html +2 -2
data/doc/rvgstyle.html +2 -2
data/doc/rvgtext.html +2 -2
data/doc/rvgtspan.html +4 -4
data/doc/rvgtut.html +4 -4
data/doc/rvguse.html +3 -3
data/doc/rvgxform.html +2 -2
data/doc/struct.html +26 -29
data/doc/usage.html +99 -48
data/examples/crop_with_gravity.rb +46 -0
data/examples/demo.rb +2 -2
data/examples/histogram.rb +11 -11
data/examples/identify.rb +45 -45
data/examples/spinner.rb +3 -2
data/ext/RMagick/MANIFEST +7 -8
data/ext/RMagick/extconf.rb +242 -0
data/ext/RMagick/rmagick.h +136 -222
data/ext/RMagick/rmdraw.c +226 -229
data/ext/RMagick/rmfill.c +69 -118
data/ext/RMagick/rmilist.c +234 -94
data/ext/RMagick/rmimage.c +1719 -2564
data/ext/RMagick/rminfo.c +433 -619
data/ext/RMagick/rmmain.c +249 -487
data/ext/RMagick/rmutil.c +344 -563
data/lib/RMagick.rb +414 -358
data/lib/rvg/clippath.rb +2 -2
data/lib/rvg/container.rb +2 -2
data/lib/rvg/describable.rb +2 -2
data/lib/rvg/embellishable.rb +2 -2
data/lib/rvg/misc.rb +3 -3
data/lib/rvg/paint.rb +2 -7
data/lib/rvg/pathdata.rb +2 -2
data/lib/rvg/rvg.rb +2 -2
data/lib/rvg/stretchable.rb +2 -14
data/lib/rvg/stylable.rb +2 -2
data/lib/rvg/text.rb +2 -2
data/lib/rvg/transformable.rb +2 -2
data/lib/rvg/units.rb +2 -2
data/{metaconfig.in → metaconfig} +0 -1
data/post-setup.rb +1 -1
data/rmagick.gemspec +6 -9
metadata +41 -49
data/Makefile.in +0 -42
data/configure +0 -12358
data/configure.ac +0 -791
data/ext/RMagick/extconf.rb.in +0 -25
data/ext/RMagick/rmagick_config.h.in +0 -285
data/gem_extconf.rb +0 -42

data/doc/image1.html CHANGED

@@ -4,10 +4,10 @@
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
   <meta name="generator" content=
-  "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
+  "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
-  <title>RMagick 1.15.17: class Image (class and instance methods,
-  part 1)</title>
+  <title>RMagick 2.0.0: class Image (class methods and instance
+  methods a-d)</title>
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
@@ -48,7 +48,7 @@ float: left;
 </head>
 <body>
-  <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
+  <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
   <div class="nav">
     &laquo;&nbsp;<a href="imageattrs.html">Prev</a> | <a href=
@@ -57,7 +57,7 @@ float: left;
   </div>
   <h1>class Image <span class="superclass">&lt; Object</span>
-  (class and instance methods, part 1)<br />
+  (class methods and instance methods a-d)<br />
   <span class="mixin">mixes in Comparable</span></h1>
   <div id="toc">
@@ -65,21 +65,35 @@ float: left;
     <h3>class methods</h3>
-    <ul>
-      <li><a href="#capture">capture</a></li>
+    <div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#capture">capture</a></li>
-      <li><a href="#constitute">constitute</a></li>
+          <li><a href="#combine">combine</a></li>
-      <li><a href="#from_blob">from_blob</a></li>
+          <li><a href="#constitute">constitute</a></li>
+        </ul>
+      </div>
+      <div class="toccol">
+        <ul>
+          <li><a href="#from_blob">from_blob</a></li>
-      <li><a href="#new">new</a></li>
+          <li><a href="#new">new</a></li>
-      <li><a href="#ping">ping</a></li>
+          <li><a href="#ping">ping</a></li>
+        </ul>
+      </div>
-      <li><a href="#read">read</a></li>
+      <div class="toccol">
+        <ul>
+          <li><a href="#read">read</a></li>
-      <li><a href="#read_inline">read_inline</a></li>
-    </ul>
+          <li><a href="#read_inline">read_inline</a></li>
+        </ul>
+      </div>
+    </div>
     <h3>instance methods</h3>
@@ -133,13 +147,13 @@ float: left;
           <li><a href="#blur_image">blur_image</a></li>
           <li><a href="#border">border</a></li>
+          <li><a href="#border_bang">border!</a></li>
         </ul>
       </div>
       <div class="toccol">
         <ul>
-          <li><a href="#border_bang">border!</a></li>
           <li><a href="#change_geometry">change_geometry</a></li>
           <li><a href="#changed_q">changed?</a></li>
@@ -154,10 +168,14 @@ float: left;
           <li><a href="#charcoal">charcoal</a></li>
+          <li><a href="#check_destroyed">check_destroyed</a></li>
           <li><a href="#chop">chop</a></li>
           <li><a href="#clone">clone</a></li>
+          <li><a href="#clut_channel">clut_channel</a></li>
           <li><a href=
           "#color_fill_to_border">color_fill_to_border</a></li>
@@ -213,6 +231,10 @@ float: left;
           <li><a href="#despeckle">despeckle</a></li>
+          <li><a href="#destroy_bang">destroy!</a></li>
+          <li><a href="#destroyed_q">destroyed?</a></li>
           <li><a href="#difference">difference</a></li>
           <li><a href="#dispatch">dispatch</a></li>
@@ -223,19 +245,12 @@ float: left;
           <li><a href="#dissolve">dissolve</a></li>
+          <li><a href="#distort">distort</a></li>
           <li><a href=
           "#distortion_channel">distortion_channel</a></li>
           <li><a href="#dup">dup</a></li>
-          <li><a href=
-          "#each_iptc_dataset">each_iptc_dataset</a></li>
-          <li><a href="#each_profile">each_profile</a></li>
-          <li><a href="#edge">edge</a></li>
-          <li><a href="#emboss">emboss</a></li>
         </ul>
       </div>
     </div>
@@ -328,6 +343,52 @@ img = Magick::Image.capture {
 </pre>
   </div>
+  <div class="sig">
+    <h3 id="combine">combine</h3>
+    <p>Image.combine(<span class="arg">red_ch</span>=nil[,
+    <span class="arg">green_ch</span>=nil[, <span class=
+    "arg">blue_ch</span>=nil[<span class="arg">,
+    opacity_ch</span>=nil]]]) -&gt;<em>anImage</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Combines the grayscale value of the pixels in each image to
+    form a new image.</p>
+    <h4>Arguments</h4>
+    <p>The red channel of the image specified in the first argument
+    is used as the red channel in the new image. The green channel
+    of the image specified in the second argument is used as the
+    green channel in the new image. The blue channel of the image
+    specified in the third argument is used as the blue channel in
+    the new image. The opacity channel of the image specified in
+    the fourth argument is used as the opacity channel in the new
+    image.</p>
+    <p>Any of the arguments may be nil. Trailing nil arguments may
+    be omitted. You must specify at least one image argument.</p>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>See also</h4>
+    <p>The same results can be obtained using the <a href=
+    "#composite">composite</a> method and the
+    CopyRed/Green/Blue/OpacityCompositeOp <a href=
+    "constants.html#CompositeOperator">CompositeOperator</a> enum
+    values.</p>
+    <h4>Magick API</h4>
+    <p>CombineImages</p>
+  </div>
   <div class="sig">
     <h3 id="constitute">constitute</h3>
@@ -368,7 +429,7 @@ img = Magick::Image.capture {
       The elements in the array must be either all
       <code>Integers</code> or all <code>Floats</code>. If the
       elements are <code>Integers</code>, the <code>Integers</code>
-      must be in the range [0..MaxRGB]. If the elements are
+      must be in the range [0..QuantumRange]. If the elements are
       <code>Floats</code>, they must be in the range [0..1].</dd>
     </dl>
@@ -547,7 +608,13 @@ p cheetah[0].columns &raquo; 1024
   <div class="desc">
     <h4>Description</h4>
-    <p>Creates one or more images from the image file.</p>
+    <p>Reads all the images from the specified file.</p>
+    <p><span style="font-style:italic">Note:</span> Because an
+    image file can contain multiple images or multiple image
+    layers, <code>read</code> always returns an array containing 0
+    or more elements, one element for each image or image layer in
+    the file.</p>
     <h4>Arguments</h4>
@@ -574,6 +641,12 @@ animated.gif[2] GIF 127x120+0+0 PseudoClass 256c 8-bit 54395b]
     <p><a href="#ping"><code>ping</code></a></p>
+    <h4>Note</h4>
+    <p>The read method does not accept a StringIO object. If you
+    want to create an image from a string buffer, use <a href=
+    "image1.html#from_blob">from_blob</a>.</p>
     <h4>Magick API</h4>
     <p>ReadImage</p>
@@ -599,7 +672,7 @@ animated.gif[2] GIF 127x120+0+0 PseudoClass 256c 8-bit 54395b]
     required. If the image format cannot be deduced from the image
     data, you can use the <a href="info.html#format">format</a>
     attribute. If you want to extract a subset of an image
-    sequence, read <a href="imusage.html#frames">this</a> section.</p>
+    sequence, see <a href="imusage.html#frames">here</a>.</p>
     <h4>Returns</h4>
@@ -634,7 +707,7 @@ img = Magick::Image.read_inline(content)
     <p>Returns the value of the image property identified by
     <span class="arg">key</span>. An image may have any number of
     properties. Each property is identified by a string (or symbol)
-    key. The property value is a string. &times;Magick predefines
+    key. The property value is a string. ImageMagick predefines
     some properties, including <code>Label</code>,
     <code>Comment</code>, <code>Signature</code>, and in some cases
     <code>EXIF</code>.</p>
@@ -662,7 +735,7 @@ img = Magick::Image.read_inline(content)
     <h4>Note</h4>
-    <p>&times;Magick calls properties "attributes." I use the word
+    <p>ImageMagick calls properties "attributes." I use the word
     "properties" to reduce the confusion with image object
     attributes such as <code>rows</code> and
     <code>columns</code>.</p>
@@ -753,7 +826,7 @@ img = Magick::Image.read_inline(content)
   <div class="desc">
     <h4>Description</h4>
-    <p><span class="imquote">Adaptively blurs the image by blurring
+    <p><span class="imquote">Adaptively blurs the image by bluring
     more intensely near image edges and less intensely far from
     edges.</span> The adaptive_blur method blurs <span class=
     "imquote">the image with a Gaussian operator of the
@@ -793,7 +866,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AdaptiveBlurImage (available in ImageMagick 6.2.8)</p>
+    <p>AdaptiveBlurImage</p>
   </div>
   <div class="sig">
@@ -844,8 +917,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AdaptiveBlurImageChannel (available in ImageMagick
-    6.2.8)</p>
+    <p>AdaptiveBlurImageChannel</p>
   </div>
   <div class="sig">
@@ -899,7 +971,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AdaptiveResizeImage (available in ImageMagick 6.2.9)</p>
+    <p>AdaptiveResizeImage</p>
   </div>
   <div class="sig">
@@ -953,7 +1025,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AdaptiveSharpenImage (available in ImageMagick 6.2.7)</p>
+    <p>AdaptiveSharpenImage</p>
   </div>
   <div class="sig">
@@ -1004,8 +1076,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AdaptiveSharpenImageChannel (available in ImageMagick
-    6.2.7)</p>
+    <p>AdaptiveSharpenImageChannel</p>
   </div>
   <div class="sig">
@@ -1094,8 +1165,8 @@ img = Magick::Image.read_inline(content)
     <div class="noise_example_wrapper">
       <a href="javascript:popup('add_noise.rb.html')"><img src=
       "ex/images/Flower_Hat.jpg" alt="add_noise example" id=
-      "add_noise_example" title="Click to see the example script"
-      /></a>
+      "add_noise_example" title=
+      "Click to see the example script" /></a>
       <p>Click the NoiseType to see the effect.</p>
@@ -1124,6 +1195,10 @@ img = Magick::Image.read_inline(content)
     <div style="clear: both;"></div>
+    <h4>Notes</h4>
+    <p>The RandomNoise type was added in ImageMagick 6.3.5.</p>
     <h4>Magick API</h4>
     <p>AddNoiseImage</p>
@@ -1170,7 +1245,7 @@ img = Magick::Image.read_inline(content)
     method can also be used to add a profile. The type of profile
     must be specified and the profile data must be in the form of a
     string. Also see <a href="#delete_profile">delete_profile</a>
-    and <a href="#each_profile">each_profile</a>.</p>
+    and <a href="image2.html#each_profile">each_profile</a>.</p>
     <h4>Magick API</h4>
@@ -1215,7 +1290,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>AddNoiseImageChannel (available in ImageMagick 6.2.5)</p>
+    <p>AddNoiseImageChannel</p>
     <h4>See also</h4>
@@ -1324,9 +1399,8 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>FlipImage, FlopImage, RotateImage, TransposeImage (available
-    in ImageMagick 6.2.8), TransverseImage (available in
-    ImageMagick 6.2.8)</p>
+    <p>FlipImage, FlopImage, RotateImage, TransposeImage,
+    TransverseImage</p>
   </div>
   <div class="sig">
@@ -1377,7 +1451,7 @@ img = Magick::Image.read_inline(content)
       <dt>threshold</dt>
       <dd>The threshold value, a number between 0 and
-      <code>MaxRGB</code>.</dd>
+      QuantumRange.</dd>
       <dt>channel...</dt>
@@ -1393,7 +1467,8 @@ img = Magick::Image.read_inline(content)
     <h4>Example</h4>
-    <p><code>bilevel_channel(2*MaxRGB/3, RedChannel)</code></p>
+    <p><code>bilevel_channel(2*QuantumRange/3,
+    RedChannel)</code></p>
     <p class="rollover"><a href=
     "javascript:popup('bilevel_channel.rb.html')"><img onmouseover=
@@ -1434,9 +1509,9 @@ img = Magick::Image.read_inline(content)
     <h4>Arguments</h4>
-    <p>Each channel argument is a number between 0 and MaxRGB. All
-    arguments except the first may be omitted. If the <span class=
-    "arg">green_channel</span> or <span class=
+    <p>Each channel argument is a number between 0 and
+    QuantumRange. All arguments except the first may be omitted. If
+    the <span class="arg">green_channel</span> or <span class=
     "arg">blue_channel</span> argument is omitted, the default
     value is the <span class="arg">red_channel</span> value. If the
     <span class="arg">opacity_channel</span> argument is omitted,
@@ -1480,7 +1555,7 @@ img = Magick::Image.read_inline(content)
     and <span class="arg">dst_percent</span>.</p>
     <p>This method corresponds to the -blend option of
-    &times;Magick's <code>composite</code> command.</p>
+    ImageMagick's <code>composite</code> command.</p>
     <h4>Arguments</h4>
@@ -1584,7 +1659,7 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
-    <p>BlurImageChannel (available in ImageMagick 6.0.1)</p>
+    <p>BlurImageChannel</p>
   </div>
   <div class="sig">
@@ -1678,13 +1753,12 @@ img = Magick::Image.read_inline(content)
     "padding: 10px; display: none;" id="borderless" onmouseout=
     "this.style.display='none'; bordered.style.display='';" src=
     "ex/images/Flower_Hat.jpg" alt="border example" title=
-    "Click to see the example script"  /> <img id=
-    "bordered" onmouseover=
+    "Click to see the example script" /> <img id="bordered"
+    onmouseover=
     "this.style.display='none'; borderless.style.display='';" src=
-    "ex/border.jpg" alt="border example"
-    /></a><img src="ex/images/spin.gif" alt="" class=
-    "spin" style="left: 224px;" title=
-    "Mouse over the example to see the original image" /></p>
+    "ex/border.jpg" alt="border example" /></a><img src=
+    "ex/images/spin.gif" alt="" class="spin" style="left: 224px;"
+    title="Mouse over the example to see the original image" /></p>
     <h4>See also</h4>
@@ -1883,10 +1957,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
       <dd>Zero or more <a href=
       "constants.html#ChannelType">ChannelType</a> values. If no
-      arguments are specified, the default is all channels.
-      <em>GraphicsMagick users note:</em> Specify exactly one
-      channel. The <code>AllChannels</code> value is not
-      supported.</dd>
+      arguments are specified, the default is all channels.</dd>
     </dl>
     <h4>Returns</h4>
@@ -1894,15 +1965,9 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <p>An array. The first element in the array is the minimum
     value. The second element is the maximum value.</p>
-    <h4>See also</h4>
-    <p>GraphicsMagick users see <a href=
-    "image3.html#statistics">statistics</a></p>
     <h4>Magick API</h4>
-    <p>GetImageChannelExtrema (available in ImageMagick),
-    GetImageStatistics (available in GraphicsMagick 1.1)</p>
+    <p>GetImageChannelExtrema</p>
   </div>
   <div class="sig">
@@ -1926,10 +1991,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
       <dd>Zero or more <a href=
       "constants.html#ChannelType">ChannelType</a> values. If no
-      arguments are specified, the default is all channels.
-      <em>GraphicsMagick users note:</em> Specify exactly one
-      channel. The <code>AllChannels</code> value is not
-      supported.</dd>
+      arguments are specified, the default is all channels.</dd>
     </dl>
     <h4>Returns</h4>
@@ -1937,15 +1999,9 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <p>An array. The first element in the array is the mean value.
     The second element is the standard deviation.</p>
-    <h4>See also</h4>
-    <p>GraphicsMagick users see <a href=
-    "image3.html#statistics">statistics</a></p>
     <h4>Magick API</h4>
-    <p>GetImageChannelMean (available in ImageMagick),
-    GetImageStatistics (available in GraphicsMagick 1.1)</p>
+    <p>GetImageChannelMean</p>
   </div>
   <div class="sig">
@@ -1998,6 +2054,25 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <p>CharcoalImage</p>
   </div>
+  <div class="sig">
+    <h3 id="check_destroyed">check_destroyed</h3>
+    <p><span class="arg">image</span>.check_destroyed -&gt;
+    <code>nil</code></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Raises Magick::DestroyedImageError if the image has been
+    destroyed. Returns nil otherwise.</p>
+    <h4>See also</h4>
+    <p><a href="#destroy_bang">destroy!</a>, <a href=
+    "#destroyed_q">destroyed?</a></p>
+  </div>
   <div class="sig">
     <h3 id="chop">chop</h3>
@@ -2073,7 +2148,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h4>Description</h4>
     <p>Same as <a href="#dup">dup</a> except the frozen state of
-    the original is propagated to the new copy.</p>
+    the original is propogated to the new copy.</p>
     <h4>Returns</h4>
@@ -2084,6 +2159,69 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <p><a href="#dup">dup</a></p>
   </div>
+  <div class="sig">
+    <h3 id="clut_channel">clut_channel</h3>
+    <p><span class="arg">image</span>.clut(<span class=
+    "arg">clut_image</span> [, <span class=
+    "arg">channel...</span>]) -&gt; <em>self</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Replace the channel values in the target image with a lookup
+    of its replacement value in an LUT gradient image.</p>
+    <p class="imquote">The LUT image should be either a single row
+    or column image of replacement colors. The lookup is controled
+    by the -interpolate setting, especially for an LUT which is not
+    the full length needed by the IM installed Quality (Q) level.
+    Good setings for this is the default 'bilinear' or 'bicubic'
+    interpolation setting for a smooth color gradient, or 'integer'
+    for a direct unsmoothed lookup of color values.</p>
+    <p class="imquote">This method is especially suited to
+    replacing a grayscale image with specific color gradient from
+    the CLUT image.</p>
+    <p class="imquote">Note that color replacements involving
+    transparency (alpha/matte channel) will lookup the replacement
+    alpha/matte value using the alpha/matte value of the original
+    image. As such correct alpha channel lookup for a pure
+    gray-scale original image will require a copy of that grayscale
+    to be transfered into its alpha channel before applying the
+    -clut operator.</p>
+    <h4>Arguments</h4>
+    <dl>
+      <dt>clut_image</dt>
+      <dd>The LUT gradient image. Specify which interpolation
+      method to use by setting this image's <a href=
+      "imageattrs.html#pixel_interpolation_method">pixel_interpolation_method</a>
+      attribute to a <a href=
+      "constants.html#InterpolatePixelMethod">Magick::InterpolatePixelMethod</a>
+      value.</dd>
+      <dt>channel...</dt>
+      <dd>Limit which channels are modified by specifying one or
+      more <a href="constants.html#ChannelType">ChannelType</a>
+      values. Only these channels will be changed. If no channels
+      are specified, all channels will be changed.</dd>
+    </dl>
+    <h4>Returns</h4>
+    <p>self</p>
+    <h4>See also</h4>
+    <p>ImageMagick's -clut option.</p>
+  </div>
   <div class="sig">
     <h3 id="color_fill_to_border">color_fill_to_border</h3>
@@ -2235,9 +2373,9 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     "ex/color_histogram.gif" alt="color_histogram example" title=
     "Click the image to see the example script" /></a></p>
-    <h4>Magick API</h4>GetColorHistogram (available in
-    GraphicsMagick 1.1), GetImageHistogram (available in
-    ImageMagick)
+    <h4>Magick API</h4>
+    <p>GetImageHistogram</p>
   </div>
   <div class="sig">
@@ -2263,7 +2401,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
       <dt>red_pct, green_pct, blue_pct, matte_pct</dt>
       <dd>The percentage of the fill color red, green, blue and
-      matte (transparency) components to blend with the image pixel.
+      matte (tranparency) components to blend with the image pixel.
       For example, <code>.25</code> is 25%. The matte_pct argument
       is optional.</dd>
@@ -2279,8 +2417,8 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h4>Example</h4>
-    <p>This example converts a color image to sepia-tone using the
-    <a href="image3.html#quantize">quantize</a> and
+    <p>This example converts a color image to a "sepia-tone-ish"
+    image using the <a href="image3.html#quantize">quantize</a> and
     <code>colorize</code> methods.</p>
     <p class="rollover"><a href=
@@ -2358,7 +2496,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     "arg">x</span>,<span class="arg">y</span> to the fill color.
     This method creates a new image object. If you want to set a
     single pixel in the image without creating a new image, use
-    <a href="image2.html#pixel_color">pixel_color</a> or the
+    <a href="image3.html#pixel_color">pixel_color</a> or the
     <a href="draw.html#point">Draw#point</a> method.
     <h4>Arguments</h4>
@@ -2385,7 +2523,7 @@ f.color_point(50,50, 'red')
     <h4>See also</h4>
-    <p><a href="image2.html#pixel_color">pixel_color</a>, <a href=
+    <p><a href="image3.html#pixel_color">pixel_color</a>, <a href=
     "draw.html#point">Draw#point</a></p>
     <h4>Magick API</h4>
@@ -2624,7 +2762,7 @@ f.color_reset!(red)
           <dt>x, y</dt>
           <dd>The x- and y-offset of the composited image, measured
-          as specified by the <em>gravity</em> argument.</dd>
+          relative to the <em>gravity</em> argument.</dd>
           <dt>composite_op</dt>
@@ -2858,7 +2996,7 @@ f.colors &raquo; 108
     <h4>Magick API</h4>
-    <p>ContrastStretchImage (available in ImageMagick 6.2.6)</p>
+    <p>ContrastStretchImage</p>
   </div>
   <div class="sig">
@@ -2895,7 +3033,7 @@ f.colors &raquo; 108
     <h4>See also</h4>
     <p><a href="#convolve_channel">convolve_channel</a>. The
-    <a href="#edge">edge</a>, <a href=
+    <a href="image2.html#edge">edge</a>, <a href=
     "image2.html#emboss">emboss</a>, <a href=
     "image2.html#gaussian_blur">gaussian_blur</a>, <a href=
     "image2.html#motion_blur">motion_blur</a> and <a href=
@@ -2972,7 +3110,7 @@ f.colors &raquo; 108
   <div class="desc">
     <h4>Description</h4>Returns a copy of the image. The tainted
-    state of the original is propagated to the copy.
+    state of the original is propogated to the copy.
     <h4>Example</h4>
     <pre>
@@ -3106,13 +3244,21 @@ f2 = f.copy
           <dt>gravity</dt>
           <dd>A <a href=
-          "constants.html#GravityType">GravityType</a> value.</dd>
+          "constants.html#GravityType">GravityType</a> value. If
+          the argument is NorthEastGravity, EastGravity, or
+          SouthEastGravity, the <em>x-</em>offset is measured from
+          the right side of the image. If the argument is
+          SouthEastGravity, SouthGravity, or SouthWestGravity, the
+          <em>y-</em>offset is measured from the bottom of the
+          image. All other values are ignored and the <em>x-</em>
+          and <em>y-</em>offsets are measured from the upper-left
+          corner of the image.</dd>
           <dt>x, y</dt>
-          <dd><span class="arg">x-</span> and <span class=
-          "arg">y-offset</span> relative to the <span class=
-          "arg">gravity</span> value</dd>
+          <dd>The <em>x-</em> and <em>y-</em>offset of the
+          rectangle from the sides specified by the
+          <em>gravity</em> argument.</dd>
           <dt>width, height</dt>
@@ -3159,7 +3305,8 @@ cropped = img.crop(x, y, width, height, true)
     <h4>See also</h4>
-    <p><a href="#crop_bang">crop!</a>, <a href="#chop">chop</a></p>
+    <p><a href="#crop_bang">crop!</a>, <a href="#chop">chop</a>,
+    <a href="image2.html#excerpt">excerpt</a></p>
     <h4>Magick API</h4>
@@ -3256,15 +3403,14 @@ cropped = img.crop(x, y, width, height, true)
      <img id="cropless" style="display: none" onmouseout=
     "this.style.display='none';cropped.style.display='';" src=
     "ex/images/Flower_Hat.jpg" alt="crop_resize 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 style=
     "padding-left:62px; padding-right: 62px; padding-top: 87px;padding-bottom:87px;"
     id="cropped" onmouseover=
     "this.style.display='none';cropless.style.display='';" src=
-    "ex/crop_resized.jpg" alt="frame example" /></a>
-    <img src="ex/images/spin.gif" alt="" style=
-    "margin-bottom: 230px" title=
+    "ex/crop_resized.jpg" alt="frame example" /></a> <img src=
+    "ex/images/spin.gif" alt="" style="margin-bottom: 230px" title=
     "Mouse over the example to see the original image" /></p>
   </div>
@@ -3388,6 +3534,53 @@ cropped = img.crop(x, y, width, height, true)
     <p>DespeckleImage</p>
   </div>
+  <div class="sig">
+    <h3 id="destroy_bang">destroy!</h3>
+    <p><span class="arg">image</span>.destroy! -&gt;
+    <em>self</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Returns all the memory associated with the image to the
+    system. After an image has been destroyed, all Image methods
+    (except <a href="image1.html#destroyed_q">destroyed?</a> and
+    <a href="image2.html#inspect">inspect</a>) called on the image
+    will raise a Magick::DestroyedImageError.</p>
+    <p>It is not possible to recover a destroyed image.</p>
+    <h4>Returns</h4>
+    <p>self</p>
+    <h4>See also</h4>
+    <p><a href="#check_destroyed">check_destroyed</a>, <a href=
+    "#destroyed_q">destroyed?</a></p>
+  </div>
+  <div class="sig">
+    <h3 id="destroyed_q">destroyed?</h3>
+    <p><span class="arg">image</span>.destroyed? -&gt;
+    <code>true</code> or <code>false</code></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Returns true if the image has been destroyed, false
+    otherwise.</p>
+    <h4>See also</h4>
+    <p><a href="#check_destroyed">check_destroyed</a>, <a href=
+    "#destroy_bang">destroy!</a></p>
+  </div>
   <div class="sig">
     <h3 id="difference">difference</h3>
@@ -3402,7 +3595,7 @@ cropped = img.crop(x, y, width, height, true)
     about their difference.</p>
     <p class="imquote">A small normalized mean square
-    error...suggests the images are very similar in spatial layout
+    error...suggests the images are very similiar in spatial layout
     and color.</p>
     <h4>Returns</h4>
@@ -3491,7 +3684,8 @@ cropped = img.crop(x, y, width, height, true)
       <dd>If <code>true</code>, the returned array elements will be
       <code>Float</code> values in the range 0..1. If
       <code>false</code>, the returned array elements will be
-      <code>Integer</code> values in the range 0..MaxRGB.</dd>
+      <code>Integer</code> values in the range
+      0..QuantumRange.</dd>
     </dl>
     <h4>Returns</h4>An array
@@ -3527,8 +3721,7 @@ exit
     <h4>Magick API</h4>
-    <p>DispatchImage (GraphicsMagick), or ExportImagePixels
-    (ImageMagick)</p>
+    <p>ExportImagePixels</p>
     <h4>Note</h4>
@@ -3559,7 +3752,7 @@ exit
     from <span class="arg">image</span> to the output image.</p>
     <p>This method corresponds to the -displace option of
-    &times;Magick's <code>composite</code> command.</p>
+    ImageMagick's <code>composite</code> command.</p>
     <h4>Arguments</h4>
@@ -3669,7 +3862,7 @@ exit
     <span class="arg">src_percentage</span>.</p>
     <p>This method corresponds to the -dissolve option of
-    &times;Magick's <code>composite</code> command.</p>
+    ImageMagick's <code>composite</code> command.</p>
     <h4>Arguments</h4>
@@ -3687,7 +3880,7 @@ exit
       interpreted as a percentage. Both 0.25 and "25%" mean 25%.
       This argument is required.</dd>
-      <dt>dst_percentage (with ImageMagick)</dt>
+      <dt>dst_percentage</dt>
       <dd>Either a non-negative number a string in the form "NN%".
       If <span class="arg">src_percentage</span> is a number it is
@@ -3695,12 +3888,6 @@ exit
       This argument may omitted if no other arguments follow it. In
       this case <span class="arg">image</span>'s opacity is
       unchanged.</dd>
-      <dt>dst_percentage (with GraphicsMagick)</dt>
-      <dd>With GraphicsMagick, <code>dissolve</code> ignores the
-      value and uses <code>1.0-<span class=
-      "arg">src_percentage</span></code> instead.</dd>
     </dl>
     <p>The <code>dissolve</code> method can be called with or
@@ -3740,6 +3927,65 @@ exit
     "#composite">composite</a></p>
   </div>
+  <div class="sig">
+    <h3 id="distort">distort</h3>
+    <p><span class="arg">image</span>.distort(<span class=
+    "arg">type</span>, <span class="arg">points</span>,
+    <span class="arg">bestfit</span>=<code>false</code>) -&gt;
+    <em>anImage</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Distort an image using the specified distortion type and its
+    required arguments. This method is the equivalent of
+    ImageMagick's -distort option.</p>
+    <h4>Arguments</h4>
+    <p>Specify one of the following values for the distortion
+    <span class="arg">type</span>:</p>
+    <ul>
+      <li>AffineDistortion</li>
+      <li>AffineProjectionDistortion</li>
+      <li>ArcDistortion</li>
+      <li>BilinearDistortion</li>
+      <li>PerspectiveDistortion</li>
+      <li>ScaleRotateTranslateDistortion</li>
+    </ul>
+    <p>The <span class="arg">points</span> argument is an array of
+    numbers. The size of the array depends on the distortion
+    type.</p>
+    <p class="imquote">If <span class="arg">bestfit</span> is
+    enabled, and the distortion allows it, the destination image is
+    adjusted to ensure the whole source image will just fit within
+    the final destination image, which will be sized and offset
+    accordingly. Also in many cases the virtual offset of the
+    source image will be taken into account in the mapping.</p>
+    <h4>Returns</h4>
+    <p>A new image</p>
+    <h4>Note</h4>
+    <p>See <a href=
+    "http://www.imagemagick.org/Usage/distorts/#distort">Distortion
+    Operator</a> in Anthony Thyssen's excellent <a href=
+    "http://www.imagemagick.org/Usage/">Examples of ImageMagick
+    Usage</a> for more information about distortion operations.</p>
+  </div>
   <div class="sig">
     <h3 id="distortion_channel">distortion_channel</h3>
@@ -3786,8 +4032,7 @@ exit
     <h4>Magick API</h4>
-    <p>GetImageChannelDistortion (available in ImageMagick
-    6.2.0)</p>
+    <p>GetImageChannelDistortion</p>
     <h4>See also</h4>
@@ -3816,147 +4061,6 @@ exit
     <p><a href="#clone">clone</a></p>
   </div>
-  <div class="sig">
-    <h3 id="each_iptc_dataset">each_iptc_dataset</h3>
-    <p>image.each_iptc_dataset { |<span class="arg">dataset</span>,
-    <span class="arg">data_field</span>| <span class=
-    "arg">block</span>} -&gt; <code>nil</code></p>
-  </div>
-  <div class="desc">
-    <h4>Description</h4>
-    <p>Iterates over the IPTC DataSet constants in Magick::IPTC. If
-    the image's IPTC profile has the DataSet and the data field has
-    non-0 length, yields to the block. The IPTC DataSet constants
-    are listed <a href="image2.html#get_iptc_dataset">here</a>.</p>
-    <h4>Arguments</h4>
-    <p>The block arguments are:</p>
-    <dl>
-      <dt>dataset</dt>
-      <dd>The DataSet name</dd>
-      <dt>data_field</dt>
-      <dd>The data field</dd>
-    </dl>
-    <h4>See also</h4>
-    <p><a href=
-    "image2.html#get_iptc_dataset">get_iptc_dataset</a></p>
-  </div>
-  <div class="sig">
-    <h3 id="each_profile">each_profile</h3>
-    <p><span class="arg">image</span>.each_profile {|<span class=
-    "arg">name</span>, <span class="arg">value</span>| <span class=
-    "arg">block</span>} -&gt; <em>???</em> (see Returns)</p>
-  </div>
-  <div class="desc">
-    <h4>Description</h4>Calls <span class="arg">block</span> once
-    for each profile in the image, passing the profile name and
-    value as parameters.
-    <h4>Returns</h4>
-    <p>the last value returned by the block</p>
-    <h4>See also</h4>
-    <p>The <a href=
-    "imageattrs.html#color_profile">color_profile</a> and <a href=
-    "imageattrs.html#iptc_profile">iptc_profile</a> attributes
-    return the ICC and IPTC profiles, respectively.</p>
-    <h4>Magick API</h4>
-    <p>GetNextImageProfile</p>
-  </div>
-  <div class="sig">
-    <h3 id="edge">edge</h3>
-    <p><span class="arg">image</span>.edge(<span class=
-    "arg">radius</span>=0.0) -&gt; <em>anImage</em></p>
-  </div>
-  <div class="desc">
-    <h4>Description</h4>Finds edges in the image.
-    <h4>Arguments</h4>The radius of the convolution filter. If the
-    radius is 0, <code>edge</code> selects a suitable default.
-    <h4>Returns</h4>
-    <p>A new image</p>
-    <h4>Example</h4>
-    <p class="rollover"><a href=
-    "javascript:popup('edge.rb.html')"><img onmouseover=
-    "this.src='ex/images/Flower_Hat.jpg'" onmouseout=
-    "this.src='ex/edge.jpg'" src="ex/edge.jpg" alt="edge example"
-    title="Click the image to see the example script" /></a>
-    <img src="ex/images/spin.gif" alt="" class="spin" title=
-    "Mouse over the example to see the original image" /></p>
-    <h4>Magick API</h4>
-    <p>EdgeImage</p>
-  </div>
-  <div class="sig">
-    <h3 id="emboss">emboss</h3>
-    <p><span class="arg">image</span>.emboss(<span class=
-    "arg">radius</span>=0.0, <span class="arg">sigma</span>=1.0)
-    -&gt; <em>anImage</em></p>
-  </div>
-  <div class="desc">
-    <h4>Description</h4>Adds a 3-dimensional effect.
-    <h4>Arguments</h4>
-    <dl>
-      <dt>radius</dt>
-      <dd>The radius of the Gaussian operator.</dd>
-      <dt>sigma</dt>
-      <dd>The sigma (standard deviation) of the Gaussian operator.
-      This value cannot be 0.0.</dd>
-    </dl>
-    <h4>Returns</h4>
-    <p>A new image</p>
-    <h4>Example</h4>
-    <p class="rollover"><a href=
-    "javascript:popup('emboss.rb.html')"><img onmouseover=
-    "this.src='ex/images/Flower_Hat.jpg'" onmouseout=
-    "this.src='ex/emboss.jpg'" src="ex/emboss.jpg" alt=
-    "emboss example" title=
-    "Click the image to see the example script" /></a><img src=
-    "ex/images/spin.gif" alt="" class="spin" title=
-    "Mouse over the example to see the original image" /></p>
-    <h4>Magick API</h4>
-    <p>EmbossImage</p>
-  </div>
   <p class="spacer">&nbsp;</p>
   <div class="nav">