rmagick 1.10.1 → 1.11.0

data/configure.ac

@@ -1,7 +1,7 @@
 
 # RMagick configure.ac
 
-AC_INIT(RMagick, 1.10.1, rmagick@rubyforge.org, RMagick-1.10.1.tar.gz)
+AC_INIT(RMagick, 1.11.0, rmagick@rubyforge.org, RMagick-1.11.0.tar.gz)
 echo "Configuring ${PACKAGE_STRING}"
 
 AC_CONFIG_HEADER([ext/RMagick/rmagick_config.h])
@@ -19,7 +19,7 @@ fi
 
 # See if user prefers GraphicsMagick over ImageMagick
 AC_ARG_WITH(graphics-magick,
-    AC_HELP_STRING([--with-graphics-magick], [configure RMagick with GraphicsMagick]),
+    AS_HELP_STRING([--with-graphics-magick], [configure RMagick with GraphicsMagick]),
     [with_graphics_magick=$withval],
     [with_graphics_magick='no'])
 
@@ -99,9 +99,9 @@ if test "$rm_have_acquirestringinfo" = yes; then
 fi
 
 AC_CHECK_FUNCS([AdaptiveThresholdImage AddDefinitions AddNoiseImageChannel BilevelImageChannel])
-AC_CHECK_FUNCS([BlackThresholdImage BlurImageChannel CompareImageChannels ConvolveImageChannel])
-AC_CHECK_FUNCS([EvaluateImageChannel ExportImagePixels FuzzyColorCompare])
-AC_CHECK_FUNCS([GammaImageChannel GaussianBlurImageChannel])
+AC_CHECK_FUNCS([BlackThresholdImage BlurImageChannel ClearMagickException CompareImageChannels])
+AC_CHECK_FUNCS([CompareImageLayers ContrastStretchImageChannel ConvolveImageChannel EvaluateImageChannel])
+AC_CHECK_FUNCS([ExportImagePixels FuzzyColorCompare GammaImageChannel GaussianBlurImageChannel])
 AC_CHECK_FUNCS([GetColorHistogram GetColorInfoArray])
 
 # We need to be able to query these symbols later in the configure script, so set a shell
@@ -144,12 +144,12 @@ if test "$rm_have_gettypeinfolist" = yes; then
    AC_DEFINE(HAVE_GETTYPEINFOLIST)
 fi
 
-AC_CHECK_FUNCS([GrayscalePseudoClassImage ImagesToBlob ImportImagePixels InterpretImageAttributes])
-AC_CHECK_FUNCS([IsColorSimilar NegateImageChannel NormalizeImageChannel])
-AC_CHECK_FUNCS([ParseSizeGeometry PosterizeImage PreviewImage QuantumOperatorRegionImage])
-AC_CHECK_FUNCS([RadialBlurImage RandomChannelThresholdImage RandomThresholdImageChannel])
-AC_CHECK_FUNCS([SeparateImageChannel SepiaToneImage SetImageBackgroundColor])
-AC_CHECK_FUNCS([SetImageChannelDepth SetImageColorspace SetImageOption])
+AC_CHECK_FUNCS([GetMagickResourceLimit GrayscalePseudoClassImage ImagesToBlob ImportImagePixels])
+AC_CHECK_FUNCS([InheritException InterpretImageAttributes IsColorSimilar NegateImageChannel])
+AC_CHECK_FUNCS([NormalizeImageChannel ParseSizeGeometry PosterizeImage PreviewImage])
+AC_CHECK_FUNCS([QuantumOperatorRegionImage RadialBlurImage RandomChannelThresholdImage])
+AC_CHECK_FUNCS([RandomThresholdImageChannel SeparateImageChannel SepiaToneImage])
+AC_CHECK_FUNCS([SetImageBackgroundColor SetImageChannelDepth SetImageColorspace SetImageOption])
 AC_CHECK_FUNCS([SetImageProgressMonitor ShadowImage SharpenImageChannel])
 AC_CHECK_FUNCS([SigmoidalContrastImageChannel SpliceImage StripImage])
 AC_CHECK_FUNCS([ThresholdImageChannel TintImage])
@@ -235,34 +235,34 @@ if test "$rm_cv_member_Image_extract_info" = yes; then
   AC_DEFINE(HAVE_IMAGE_EXTRACT_INFO)
 fi
 
-AC_CACHE_CHECK(for HSBColorspace enum value, rm_cv_enum_hsbcolorspace,
+AC_CACHE_CHECK(for CineonLogRGBColorspace enum value, rm_cv_enum_cineonlogrgbcolorspace,
   [AC_TRY_COMPILE(
 [#include <stdio.h>
 #if HAVE_SYS_TYPES_H
 #include <sys/types.h>
 #endif
 #include "magick/api.h"],
-     [ColorspaceType x; x = HSBColorspace],
-     rm_cv_enum_hsbcolorspace='yes',
-     rm_cv_enum_hsbcolorspace='no')])
+     [ColorspaceType x; x = CineonLogRGBColorspace],
+     rm_cv_enum_cineonlogrgbcolorspace='yes',
+     rm_cv_enum_cineonlogrgbcolorspace='no')])
 
-if test "$rm_cv_enum_hsbcolorspace" = yes; then
-  AC_DEFINE(HAVE_HSBCOLORSPACE)
+if test "$rm_cv_enum_cineonlogrgbcolorspace" = yes; then
+  AC_DEFINE(HAVE_CINEONLOGRGBCOLORSPACE)
 fi
 
-AC_CACHE_CHECK(for CineonLogRGBColorspace enum value, rm_cv_enum_cineonlogrgbcolorspace,
+AC_CACHE_CHECK(for HSBColorspace enum value, rm_cv_enum_hsbcolorspace,
   [AC_TRY_COMPILE(
 [#include <stdio.h>
 #if HAVE_SYS_TYPES_H
 #include <sys/types.h>
 #endif
 #include "magick/api.h"],
-     [ColorspaceType x; x = CineonLogRGBColorspace],
-     rm_cv_enum_cineonlogrgbcolorspace='yes',
-     rm_cv_enum_cineonlogrgbcolorspace='no')])
+     [ColorspaceType x; x = HSBColorspace],
+     rm_cv_enum_hsbcolorspace='yes',
+     rm_cv_enum_hsbcolorspace='no')])
 
-if test "$rm_cv_enum_cineonlogrgbcolorspace" = yes; then
-  AC_DEFINE(HAVE_CINEONLOGRGBCOLORSPACE)
+if test "$rm_cv_enum_hsbcolorspace" = yes; then
+  AC_DEFINE(HAVE_HSBCOLORSPACE)
 fi
 
 AC_CACHE_CHECK(for LABColorspace enum value, rm_cv_enum_labcolorspace,
@@ -355,7 +355,6 @@ if test "$rm_cv_enum_logcolorspace" = yes; then
   AC_DEFINE(HAVE_LOGCOLORSPACE)
 fi
 
-
 AC_CACHE_CHECK(for CopyCyanCompositeOp enum value, rm_cv_enum_copycyancompositeop,
   [AC_TRY_COMPILE(
 [#include <stdio.h>
@@ -521,6 +520,20 @@ if test "$rm_cv_enum_transparentvirtualpixelmethod" = yes; then
   AC_DEFINE(HAVE_TRANSPARENTVIRTUALPIXELMETHOD)
 fi
 
+AC_CACHE_CHECK(for CoalesceLayer enum value, rm_cv_enum_coalescelayer,
+  [AC_TRY_COMPILE(
+[#include <stdio.h>
+#if HAVE_SYS_TYPES_H
+#include <sys/types.h>
+#endif
+#include "magick/api.h"],
+     [MagickLayerMethod x; x = CoalesceLayer],
+     rm_cv_enum_coalescelayer='yes',
+     rm_cv_enum_coalescelayer='no')])
+
+if test "$rm_cv_enum_coalescelayer" = yes; then
+  AC_DEFINE(HAVE_COALESCELAYER)
+fi
 
 if test "$rm_have_getimagequantumdepth" = yes; then
    # IM 6.0.5 changed the number of arguments to GetImageQuantumDepth.
@@ -632,59 +645,65 @@ if test `eval echo $datadir` != ${prefix}/share; then
   RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --data-dir=`eval echo $datadir`"
 fi
 
+AC_ARG_WITH(ruby-prog,
+    AS_HELP_STRING([--with-ruby-prog=NAME], [the ruby program used for installation [[PREFIX/bin/ruby]]]),
+    [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --ruby-prog=$withval"
+     RUBY=$withval], )
+
+AC_ARG_WITH(rbconfig,
+    AS_HELP_STRING([--with-rbconfig=PATH], [your rbconfig to load [[ruby's]]]),
+    [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --rbconfig=$withval"], )
+
 AC_ARG_WITH(doc-dir,
-    AC_HELP_STRING([--with-doc-dir=DIR], [RMagick documentation directory [[PREFIX/share/RMagick]]]),
+    AS_HELP_STRING([--with-doc-dir=DIR], [RMagick documentation directory [[PREFIX/share/RMagick]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --doc-dir=$withval"], )
 
 AC_ARG_WITH(std-ruby,
-    AC_HELP_STRING([--with-std-ruby=DIR], [the directory for standard ruby libraries [[PREFIX/lib/ruby/1.x]]]),
+    AS_HELP_STRING([--with-std-ruby=DIR], [the directory for standard ruby libraries [[PREFIX/lib/ruby/1.x]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --std-ruby=$withval"], )
 
 AC_ARG_WITH(site-ruby,
-    AC_HELP_STRING([--with-site-ruby=DIR], [the directory for non-standard ruby libraries [[PREFIX/lib/ruby/site_ruby/1.x]]]),
+    AS_HELP_STRING([--with-site-ruby=DIR], [the directory for non-standard ruby libraries [[PREFIX/lib/ruby/site_ruby/1.x]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --site-ruby=$withval"], )
 
 AC_ARG_WITH(site-ruby-common,
-    AC_HELP_STRING([--with-site-ruby-common=DIR], [the directory for version-independent non-standard ruby libraries [[PREFIX/lib/ruby/site_ruby]]]),
+    AS_HELP_STRING([--with-site-ruby-common=DIR], [the directory for version-independent non-standard ruby libraries [[PREFIX/lib/ruby/site_ruby]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --site-ruby-common=$withval"], )
 
 AC_ARG_WITH(rb-dir,
-    AC_HELP_STRING([--with-rb-dir=DIR], [the directory for ruby scripts [[PREFIX/lib/ruby/site_ruby/1.x]]]),
+    AS_HELP_STRING([--with-rb-dir=DIR], [the directory for ruby scripts [[PREFIX/lib/ruby/site_ruby/1.x]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --rb-dir=$withval"], )
 
 AC_ARG_WITH(so-dir,
-    AC_HELP_STRING([--with-so-dir=DIR], [the directory for ruby extensions]),
+    AS_HELP_STRING([--with-so-dir=DIR], [the directory for ruby extensions]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --so-dir=$withval"], )
 
 AC_ARG_WITH(ruby-path,
-    AC_HELP_STRING([--with-ruby-path=DIR], [path to set to #! line [PREFIX/bin/ruby]]),
+    AS_HELP_STRING([--with-ruby-path=DIR], [path to set to #! line [PREFIX/bin/ruby]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --ruby-path=$withval"], )
 
-AC_ARG_WITH(ruby-prog,
-    AC_HELP_STRING([--with-ruby-prog=NAME], [the ruby program used for installation [[PREFIX/bin/ruby]]]),
-    [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --ruby-prog=$withval"
-     RUBY=$withval], )
-
 AC_ARG_WITH(make-prog,
-    AC_HELP_STRING([--with-make-prog=NAME], [the make program to compile ruby extensions [[make]]]),
+    AS_HELP_STRING([--with-make-prog=NAME], [the make program to compile ruby extensions [[make]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --make-prog=$withval"], )
 
-AC_ARG_WITH(rbconfig,
-    AC_HELP_STRING([--with-rbconfig=PATH], [your rbconfig to load [[ruby's]]]),
-    [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --rbconfig=$withval"], )
-
 AC_ARG_ENABLE(without-ext,
-    AC_HELP_STRING([--enable-without-ext], [does not compile/install ruby extensions [[--disable-without-ext]]]),
+    AS_HELP_STRING([--enable-without-ext], [does not compile/install ruby extensions [[--disable-without-ext]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --without-ext"], )
 
 AC_ARG_ENABLE(no-harm,
-    AC_HELP_STRING([--enable-no-harm], [only display what to do if given [[--disable-no-harm]]]),
+    AS_HELP_STRING([--enable-no-harm], [only display what to do if given [[--disable-no-harm]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --no-harm"], )
 
 AC_ARG_ENABLE(allow-example-errors,
-    AC_HELP_STRING([--enable-allow-example-errors], [allow installation to proceed even if a lot of examples fail [--disable-allow-example-errors]]),
+    AS_HELP_STRING([--enable-allow-example-errors], [allow installation to proceed even if a lot of examples fail [[--disable-allow-example-errors]]]),
     [RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --allow-example-errors"], )
 
+AC_ARG_ENABLE(htmldoc,
+    AS_HELP_STRING([--disable-htmldoc], [skip creating the HTML documentation and examples [[--enable-htmldoc]]]),
+    [if test "$enable_htmldoc" = no; then
+        RUBY_CONFIG_OPTS="$RUBY_CONFIG_OPTS --disable-htmldoc"
+     fi], )
+
 
 RUBY_VERSION_STRING=`$RUBY --version`
 AC_DEFINE_UNQUOTED(RUBY_VERSION_STRING, "$RUBY_VERSION_STRING")

data/doc/ex/level.rb

@@ -5,8 +5,7 @@ require 'RMagick'
 
 before = Magick::Image.read('images/Flower_Hat.jpg').first
 
-# Allow the white-point argument to default.
 # Brighten up the mid-tones a bit.
-after = before.level(0,1.50)
+after = before.level(0, Magick::MaxRGB, 1.50)
 after.write('level.jpg')
 exit

data/doc/ex/path.rb

@@ -50,7 +50,7 @@ gc.text 330,125, "'320,120'"
 # Add control point labels
 gc.text  30, 25, "'20,20'"
 gc.text 180, 25, "'170,20'"
-gc.text 330,225, "'320,320'"
+gc.text 330,225, "'320,220'"
 
 # Add auto control point label
 gc.text 180,225, "'auto ctl point'"

data/doc/ilist.html

@@ -4,7 +4,7 @@
 <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: class ImageList</title>
   <meta http-equiv="Content-Type" content=
@@ -15,23 +15,8 @@
   <link rel="stylesheet" type="text/css" href="css/doc.css" />
 <script type="text/javascript" src="scripts/doc.js">
 </script>
-<script type="text/javascript">
-  //<![CDATA[
-    <!-- Pre-load these images -->
-    img = new Image();
-    img.src = "ex/average_before.gif";
-    img.src = "ex/coalesce_anim.gif";
-    img.src = "ex/map_before.jpg";
-    img.src = "ex/morph.gif";
-    img.src = "ex/quantize-m_before.jpg";
-  //]]>
+<script type="text/javascript" src="scripts/doc.js">
 </script>
-<style type="text/css">
-  /*<![CDATA[*/
-
-  /* Styles local to this page. */
-  /*]]>*/
-</style>
 </head>
 
 <body>
@@ -111,17 +96,19 @@
         <li><a href="#map">map</a></li>
 
         <li><a href="#montage">montage</a></li>
+
+        <li><a href="#morph">morph</a></li>
       </ul>
     </div>
 
     <div class="toccol">
       <ul>
-        <li><a href="#morph">morph</a></li>
-
         <li><a href="#mosaic">mosaic</a></li>
 
         <li><a href="#new_image">new_image</a></li>
 
+        <li><a href="#optimize_layers">optimize_layers</a></li>
+
         <li><a href="#ping">ping</a></li>
 
         <li><a href="#quantize">quantize</a></li>
@@ -189,8 +176,8 @@ i = Magick::ImageList.new("Button_A.gif", "Cheetah.jpg")
     time between each image in an animation. The
     <code>delay=</code> attribute assigns the same delay to all the
     images in the imagelist. Use <a href=
-    "imageattrs.html#Image.delay">Image#delay=</a> to set different
-    delay values on individual images.</p>
+    "imageattrs.html#delay">Image#delay=</a> to set different delay
+    values on individual images.</p>
 
     <h4>Arguments</h4>
 
@@ -208,7 +195,7 @@ imagelist.delay = 20 # delay 1/5 of a second between images.
 
     <h4>See also</h4>
 
-    <p><a href="imageattrs.html#Image.delay">Image#delay=</a></p>
+    <p><a href="imageattrs.html#delay">Image#delay=</a></p>
   </div>
 
   <div class="sig">
@@ -546,15 +533,16 @@ imagelist.animate { self.server_name = "other:0.0" }
      <img style="display:none" id="notaveraged" onmouseout=
     "this.style.display='none'; averaged.style.display=''; averagedspin.style.display='';"
     title="Click to see the example script" src=
-    "ex/average_before.gif" alt="average example" /><!--
+    "ex/average_before.gif" alt="average example"  /><!--
                                   This img tag displays the averaged image when the mouse is not over
                                   --><img style="display:" id=
 "averaged" onmouseover=
 "this.style.display='none'; notaveraged.style.display=''; averagedspin.style.display='none';"
-    src="ex/average_after.gif" alt="average example" /></a>
-    <img src="ex/images/spin.gif" alt="" class="spin" style=
-    "left:131px; display:" id="averagedspin" title=
-    "Mouse over the example to see the 3 original images" /></p>
+    src="ex/average_after.gif" alt="average example"
+    /></a> <img src="ex/images/spin.gif" alt="" class=
+    "spin" style="left:131px; display:" id="averagedspin" title=
+    "Mouse over the example to see the 3 original images"
+    /></p>
 
     <h4>Magick API</h4>
 
@@ -598,11 +586,11 @@ imagelist.animate { self.server_name = "other:0.0" }
     previous images.</p>
 
     <p>The length of time between images in the new image is
-    specified by the <a href=
-    "imageattrs.html#Image.delay">delay</a> attribute of the input
-    image. The position of the image on the merged images is
-    specified by the <a href="imageattrs.html#Image.page">page</a>
-    attribute of the input image.</p>
+    specified by the <a href="imageattrs.html#delay">delay</a>
+    attribute of the input image. The position of the image on the
+    merged images is specified by the <a href=
+    "imageattrs.html#page">page</a> attribute of the input
+    image.</p>
 
     <h4>Returns</h4>
 
@@ -713,6 +701,10 @@ imagelist2 = imagelist1.copy
     <h4>Magick API</h4>
 
     <p>DeconstructImages</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#optimize_layers">optimize_layers</a></p>
   </div>
 
   <div class="sig">
@@ -760,6 +752,11 @@ imagelist2 = imagelist1.copy
     <p><a href="#animate">animate</a>, <a href=
     "image1.html#display">Image#display</a></p>
 
+    <h4>Note</h4>
+
+    <p>The display method is not supported on native MS
+    Windows.</p>
+
     <h4>Magick API</h4>
 
     <p>DisplayImages</p>
@@ -894,13 +891,12 @@ scene=1
     <h4>See also</h4>
 
     <p><a href="image2.html#inspect">Image#inspect</a></p>
-
   </div>
 
   <div class="sig">
     <h3 id="map">map</h3>
 
-    <p><span class="arg">imagelist.map</span>(<span class=
+    <p><span class="arg">imagelist</span>.map(<span class=
     "arg">reference</span>, <span class="arg">dither</span>) -&gt;
     <em>anImageList</em></p>
   </div>
@@ -1007,7 +1003,7 @@ scene=1
 
       <dd><em>Hint:</em> You can use a different composite operator
       for each tile by setting each image's <a href=
-      "imageattrs.html#Image.compose">compose=</a> attribute to the
+      "imageattrs.html#compose">compose=</a> attribute to the
       desired operator. In the optional arguments block, set
       <code>compose</code> to UndefinedCompositeOp.</dd>
 
@@ -1160,6 +1156,9 @@ img[2]['Label'] = "Mom's Birthday"
     <h4>Example</h4><a href=
     "javascript:popup('demo.rb.html')">demo.rb</a>
 
+    <h4>Example</h4><a href=
+    "javascript:popup('demo.rb.html')">demo.rb</a>
+
     <h4>Magick API</h4>
 
     <p>MontageImages</p>
@@ -1223,7 +1222,7 @@ img[2]['Label'] = "Mom's Birthday"
 
     <p>Composites all the images into a single new image. The
     location of each image is determined by the value of its
-    <a href="imageattrs.html#Image.page">page</a> attribute.</p>
+    <a href="imageattrs.html#page">page</a> attribute.</p>
 
     <h4>Returns</h4>
 
@@ -1248,9 +1247,9 @@ img[2]['Label'] = "Mom's Birthday"
     <h3 id="new_image">new_image</h3>
 
     <p><span class="arg">imagelist.</span>new_image(<span class=
-    "arg">columns</span>, <span class="arg">rows</span><span class=
-    "arg">[, fill]</span>) <span class="arg">[&nbsp;{ optional
-    arguments }&nbsp;]</span> -&gt; <em>self</em></p>
+    "arg">columns</span>, <span class="arg">rows[, fill]</span>)
+    <span class="arg">[&nbsp;{ optional arguments }&nbsp;]</span>
+    -&gt; <em>self</em></p>
   </div>
 
   <div class="desc">
@@ -1288,6 +1287,112 @@ imagelist.new_image(100, 100) { self.background_color = "red" }
 </pre>
   </div>
 
+  <div class="sig">
+    <h3 id="optimize_layers">optimize_layers</h3>
+
+    <p><span class=
+    "arg">imagelist</span>.optimize_layers(<span class=
+    "arg">layer_method</span>) -&gt; <em>anImageList</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Optimizes or compares the images in the list. Equivalent to
+    the <code>-layers</code> option in ImageMagick's
+    <code>mogrify</code> command.</p>
+
+    <p>With the CompareAnyLayer, CompareClearLayer, and
+    CompareOverlayLayer arguments, <code>optimize_layers</code>
+    <span class="imquote">compares each image with the next in a
+    sequence and returns the minimum bounding region of all the
+    pixel differences (of the <code>LayerMethod</code> specified)
+    it discovers.</span></p>
+
+    <p class="imquote">The images in the list <span class=
+    "imquote">do NOT have to be the same size, though it is best
+    that all the images are fully 'coalesced' (images are all the
+    same size, on a flattened canvas, and represent how an specific
+    frame should look is animatated)</span></p>
+
+    <p class="imquote">If images are not the same size as the page
+    canvas size of first image, then it is alpha composed using
+    'Copy' onto the previous frame compared. That is the
+    differences only within the overlay area are looked at.</p>
+
+    <p class="imquote">No dispose methods are applied, though this
+    does not matter for animations which are a fully coalesced
+    sequence of images.</p>
+
+    <p>With OptimizeLayer, <code>optimize_layers</code>
+    <span class="imquote">compares each image the GIF disposed
+    forms of the previous image in the sequence. From this it
+    attempts to select the smallest cropped image to replace each
+    frame, while preserving the results of the
+    animation.</span></p>
+
+    <p>OptimizePlusLayer is the same as OptimizeLayers,
+    <span class="imquote">but may also add or even remove extra
+    frames in the animation, if it improves the total number of
+    pixels in the resulting GIF animation.</span></p>
+
+    <p>With DisposeLayer, <code>optimize_layers</code> <span class=
+    "imquote">returns the coalesced frames of a GIF animation as it
+    would appear after the GIF dispose method of that frame has
+    been applied. That is it returns the appearance of each frame
+    before the next is overlaid.</span></p>
+
+    <p>The <code>optimize_layers</code> method corresponds to the
+    <code>-layers</code> option on ImageMagick's
+    <code>convert</code> and <code>mogrify</code> commands. Anthony
+    Thyssen's excellent <a href=
+    "http://www.cit.gu.edu.au/~anthony/graphics/imagick6">Examples
+    of ImageMagick Usage</a> site has very detailed <a href=
+    "http://www.cit.gu.edu.au/~anthony/graphics/imagick6/anim_basics/#optimize">
+    information and examples</a> of the <code>-layers</code> option
+    and and the optimization methods .</p>
+
+    <h4>Arguments</h4>
+
+    <p>One of the following <code>MagickLayerMethod</code>
+    values:</p>
+
+    <ul>
+      <li>CoalesceLayer</li>
+
+      <li>CompareAnyLayer</li>
+
+      <li>CompareClearLayer</li>
+
+      <li>CompareOverlayLayer</li>
+
+      <li>DisposeLayer</li>
+
+      <li>OptimizeLayer</li>
+
+      <li>OptimizePlusLayer</li>
+    </ul>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#deconstruct">deconstruct</a> is an alias for
+    <code>optimize_layers</code> with the
+    <code>CompareAnyLayer</code> argument.</p>
+
+    <p><a href="#coalesce">coalesce</a> is an alias for
+    <code>optimize_layers</code> with the
+    <code>CoalesceLayer</code> argument.</p>
+
+    <h4>Magick API</h4>
+
+    <p>OptimizeImageLayers, CompareImageLayers (available in
+    ImageMagick 6.2.6)</p>
+  </div>
+
   <div class="sig">
     <h3 id="ping">ping</h3>
 
@@ -1392,14 +1497,13 @@ puts "The image has #{i.columns} columns and #{i.rows} rows." &raquo;
       <dd><span class="imquote">Calculate quantization errors when
       quantizing the image.</span> Stores the results for each
       image in the imagelist <a href=
-      "imageattrs.html#Image.mean_error_per_pixel">mean_error_per_pixel</a>,
+      "imageattrs.html#mean_error_per_pixel">mean_error_per_pixel</a>,
       <a href=
-      "imageattrs.html#Image.normalized_maximum_error">normalized_maximum_error</a>,
+      "imageattrs.html#normalized_maximum_error">normalized_maximum_error</a>,
       and <a href=
-      "imageattrs.html#Image.normalized_mean_error">normalized_mean_error</a>
+      "imageattrs.html#normalized_mean_error">normalized_mean_error</a>
       attributes. Stores the number of colors used for the image in
-      the <a href=
-      "imageattrs.html#Image.total_colors">total_colors</a>
+      the <a href="imageattrs.html#total_colors">total_colors</a>
       attribute.</dd>
     </dl>