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

@@ -6,14 +6,7 @@ require 'RMagick'
 # Compare this example with the vignette.rb script in the examples directory.
 img = Magick::Image.read('images/Flower_Hat.jpg').first
-begin
-    vignette = img.vignette
-rescue NotImplementedError
-    vignette = Magick::Image.read('images/notimplemented.gif').first
-    vignette.resize!(img.columns, img.rows)
-end
+vignette = img.vignette
 vignette.write('vignette.jpg')
 exit

data/doc/ex/watermark.rb CHANGED

@@ -7,6 +7,7 @@ img = Magick::Image.read("images/Flower_Hat.jpg").first
 # Make a watermark from the word "RMagick"
 mark = Magick::Image.new(140, 40) {self.background_color = "none"}
 gc = Magick::Draw.new
 gc.annotate(mark, 0, 0, 0, -5, "RMagick") do
     gc.gravity = Magick::CenterGravity
     gc.pointsize = 32

data/doc/ex/wet_floor.rb CHANGED

@@ -2,31 +2,25 @@
 require 'RMagick'
-if Magick::Magick_version =~ /ImageMagick/
-  y = -15
-else
-  y = 1
-end
 results = Magick::ImageList.new
 img = Magick::Image.new(270, 60)
-img.matte = true
 gc = Magick::Draw.new
-gc.annotate(img, 0, 0, 0, y, "RUBY!") do
+gc.annotate(img, 0, 0, 0, -15, "RUBY!") do
     gc.fill = '#c00'
     gc.stroke = 'black'
     gc.stroke_width = 2
     gc.font_weight = Magick::BoldWeight
     gc.gravity = Magick::SouthGravity
-  if RUBY_PLATFORM =~ /mswin32/
-    gc.font_family = "Georgia"
-      gc.pointsize = 76
-  else
-      gc.font_family = "times"
-    gc.pointsize = 80
-  end
+	if RUBY_PLATFORM =~ /mswin32/
+		gc.font_family = "Georgia"
+	    gc.pointsize = 76
+	else
+	    gc.font_family = "times"
+		gc.pointsize = 80
+	end
 end
 # Add a little bit of shading

data/doc/ilist.html CHANGED

@@ -4,9 +4,9 @@
 <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 ImageList</title>
+  <title>RMagick 2.0.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 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="magick.html">Prev</a> | <a href=
@@ -28,9 +28,8 @@
     "imageattrs.html">Next</a>&nbsp;&raquo;
   </div>
-  <h1>class ImageList <span class="superclass">&lt;
-  Array</span><br />
-  <span class="mixin">mixes in Comparable</span></h1>
+  <h1>class ImageList<br />
+  <span class="mixin">mixes in Comparable, Enumerable</span></h1>
   <div id="toc">
     <h2>Table of Contents</h2>
@@ -73,6 +72,8 @@
         <li><a href="#coalesce">coalesce</a></li>
+        <li><a href="#composite_layers">composite_layers</a></li>
         <li><a href="#copy">copy</a></li>
         <li><a href="#cur_image">cur_image</a></li>
@@ -98,13 +99,13 @@
         <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>
@@ -117,6 +118,8 @@
         <li><a href="#read">read</a></li>
+        <li><a href="#to_a">to_a</a></li>
         <li><a href="#to_blob">to_blob</a></li>
         <li><a href="#write">write</a></li>
@@ -212,10 +215,9 @@ imagelist.delay = 20 # delay 1/5 of a second between images.
     <p>Sets the number of times an animated image should loop.</p>
     <p>The <a href="#animate">animate</a> method and the
-    ImageMagick animate/GraphicsMagick gm utilities do not respect
-    this number. Both will repeat the animation until you stop
-    them. Mozilla (and presumably Netscape) do respect the
-    value..</p>
+    ImageMagick animate command does not respect this number. Both
+    will repeat the animation until you stop them. Mozilla (and
+    presumably Netscape) do respect the value..</p>
     <h4>Arguments</h4>
@@ -287,10 +289,6 @@ imagelist.scene &raquo; 10
     establish the elapsed time between frames in an animation. By
     default the number of ticks per second is 100.</p>
-    <p>This attribute is available only in ImageMagick 6.2.4 and
-    later. Prior to this release the number of ticks per second is
-    fixed at 100.</p>
     <h4>Example</h4>
     <pre>
 imagelist.ticks_per_second = 1000
@@ -308,16 +306,16 @@ imagelist.ticks_per_second = 1000
   <div class="desc">
     <h4>Description</h4>
-    <p><code>ImageList</code> is a subclass of <code>Array</code>,
-    so you can manipulate the images in an imagelist using almost
-    all of the methods defined in <code>Array</code>. Typically
-    these methods also update the scene number. The scene number
-    will never exceed the number of images in the list, and if the
-    imagelist contains no images the scene number will be
-    <code>nil</code>.</p>
+    <p><code>ImageList</code> delegates many methods to
+    <code>Array</code>, so you can manipulate the images in an
+    imagelist using almost all of the methods defined in
+    <code>Array</code>. Typically these methods also update the
+    scene number. The scene number will never exceed the number of
+    images in the list, and if the imagelist contains no images the
+    scene number will be <code>nil</code>.</p>
-    <p>Array methods defined in the ImageList class that would
-    normally return an array return an ImageList.</p>
+    <p>Array methods that would normally return an array return an
+    ImageList.</p>
     <p>Most array methods keep the current image current. If the
     method moves the current image to a new position, the method
@@ -375,7 +373,12 @@ imagelist.ticks_per_second = 1000
     <p>Adding anything other than a image to an imagelist has
     undefined results. Most of the time RMagick will raise an
-    ArgumentError exception.</p>
+    ArgumentError exception. For example, if you call
+    <code>collect!</code> on an imagelist you should make sure that
+    the members of theimagelist remain images. If you need to
+    replace images in an imagelist with non-image objects, convert
+    the imagelist to an array with the <code>to_a</code> method,
+    then modify the array.</p>
     <p>The <code>assoc</code>, <code>flatten</code>,
     <code>flatten!</code>, <code>join</code>, <code>pack</code>,
@@ -535,17 +538,15 @@ 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>
@@ -563,7 +564,7 @@ imagelist.animate { self.server_name = "other:0.0" }
     <h4>Description</h4>
     <p>Same as <a href="#dup">dup</a>, but the frozen state of the
-    original is propagated to the copy.</p>
+    original is propogated to the copy.</p>
     <h4>Returns</h4>
@@ -611,16 +612,85 @@ imagelist.animate { self.server_name = "other:0.0" }
     "this.src='ex/coalesce.gif'" src="ex/coalesce.gif" alt=
     "coalesce example" title=
     "Click the image to see the example script" /></a><img src=
-    "ex/images/spin.gif" alt="" class="spin" style="left:159px"
+    "ex/images/spin.gif" alt="" class="spin" style="left:165px"
     title="Mouse over the example to see the animation" /></p>
-    <h4>See also</h4><a href="#flatten_images">flatten_images</a>
+    <h4>See also</h4>
+    <p><a href="#flatten_images">flatten_images</a>, <a href=
+    "#optimize_layers">optimize_layers</a></p>
     <h4>Magick API</h4>
     <p>CoalesceImages</p>
   </div>
+  <div class="sig">
+    <h3 id="composite_layers">composite_layers</h3>
+    <p><span class=
+    "arg">destination_list</span>.composite_layers(<span class=
+    "arg">source_list</span>, <span class=
+    "arg">operator</span>=<code>OverCompositeOp</code>) -&gt;
+    <em>anImageList</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>An image from <span class="arg">source_list</span> is
+    composited over an image from <span class=
+    "arg">destination_list</span> until one list is finished. Use
+    the <a href="imageattrs.html#geometry">geometry</a> and
+    <a href="imageattrs.html#gravity">gravity</a> attributes of the
+    first image in <span class="arg">destination_list</span> to
+    position the source images over the destination images.
+    <span class="imquote">Unlike a normal composite operation, the
+    canvas offset is also included to the composite positioning. If
+    one of the image lists only contains one image, that image is
+    applied to all the images in the other image list, regardless
+    of which list it is. In this case it is the image meta-data of
+    the list which preserved.</span></p>
+    <h4>Arguments</h4>
+    <p>The optional <span class="arg">operator</span> argument
+    specifies a <a href=
+    "constants.html#CompositeOperator">CompositeOperator</a> to use
+    for the compositing operations.</p>
+    <h4>Returns</h4>
+    <p>An imagelist</p>
+    <h4>Example</h4>
+    <p>This example is an animated GIF. Mouse over the image to
+    start the animation.</p>
+    <p class="rollover"><a href=
+    "javascript:popup('composite_layers.rb.html')"><img onmouseover="this.src='ex/composite_layers.gif'"
+    onmouseout="this.src='ex/composite_layers1.gif'" src=
+    "ex/composite_layers1.gif" alt="composite_layers example"
+    title="Click the image to see the example script" /></a><img src="ex/images/spin.gif"
+    alt="" class="spin" style="left:105px" title=
+    "Mouse over the example to see the animation" /></p>
+    <h4>Notes</h4>
+    <p>This method is equivalent to the <code>-layers
+    Composite</code> option of ImageMagick's <code>convert</code>
+    command. See the <a href=
+    "http://www.imagemagick.org/Usage/anim_mods/#composite">Layers
+    Composition</a> section in <a href=
+    "http://www.imagemagick.org/Usage/">Examples of ImageMagick
+    Usage</a> for more information.</p>
+    <h4>See also</h4>
+    <p><a href="#optimize_layers">optimize_layers</a></p>
+  </div>
   <div class="sig">
     <h3 id="copy">copy</h3>
@@ -644,8 +714,10 @@ imagelist.animate { self.server_name = "other:0.0" }
 imagelist2 = imagelist1.copy
 </pre>
-    <h4>See also</h4><a href="image1.html#copy">Image#copy</a>,
-    <a href="#clone">clone</a>, <a href="#dup">dup</a>
+    <h4>See also</h4>
+    <p><a href="image1.html#copy">Image#copy</a>, <a href=
+    "#clone">clone</a>, <a href="#dup">dup</a></p>
   </div>
   <div class="sig">
@@ -689,7 +761,7 @@ imagelist2 = imagelist1.copy
     successor. The resulting imagelist usually produces a much
     smaller file.</p>
-    <p>The <code>deconstruct</code> method starts by copying the
+    <p>The <code>desconstruct</code> method starts by copying the
     first image in the list to the output imagelist. Then, for each
     pair of images, <code>deconstruct</code> computes the smallest
     rectangle that encompasses all the changes between the first
@@ -798,11 +870,12 @@ imagelist2 = imagelist1.copy
     <h4>See also</h4>
-    <p><a href="#coalesce">coalesce</a></p>
+    <p><a href="#coalesce">coalesce</a>, <a href=
+    "#optimize_layers">optimize_layers</a></p>
     <h4>Magick API</h4>
-    <p>FlattenImageList</p>
+    <p>MergeImageLaters with the FlattenLayer method.</p>
   </div>
   <div class="sig">
@@ -1182,8 +1255,8 @@ geometry is "120x120+4+3&gt;".
       <dd>
         A image to be tiled on the background of the composite
         image. If present, this attribute overrides the background
-        color. For example, to use &times;Magick's built-in
-        "granite" texture as the background, use:
+        color. For example, to use ImageMagick's built-in "granite"
+        texture as the background, use:
         <pre>
 self.texture = Magick::Image.read("granite:").first
 </pre>
@@ -1314,11 +1387,12 @@ img[2]['Label'] = "Mom's Birthday"
     <h4>See also</h4><a href="#coalesce">coalesce</a>, <a href=
     "#flatten_images">flatten_images</a>, <a href=
-    "#montage">montage</a>
+    "#montage">montage</a>, <a href=
+    "#optimize_images">optimize_images</a>
     <h4>Magick API</h4>
-    <p>MosaicImages</p>
+    <p>MergeImageLayers with the MosaicLayer method.</p>
   </div>
   <div class="sig">
@@ -1380,76 +1454,175 @@ imagelist.new_image(100, 100) { self.background_color = "red" }
     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 animated)</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>
+    "http://www.imagemagick.org/Usage/">Examples of ImageMagick
+    Usage</a> site has very detailed <a href=
+    "http://www.imagemagick.org/Usage/anim_opt/">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>
+    <p>One of the following ImageLayerMethod enum values:</p>
-    <ul>
-      <li>CoalesceLayer</li>
-      <li>CompareAnyLayer</li>
-      <li>CompareClearLayer</li>
-      <li>CompareOverlayLayer</li>
-      <li>DisposeLayer</li>
+    <dl>
+      <dt>CoalesceLayer</dt>
+      <dd class="imquote">Equivalent to [<a href=
+      "#coalesce">coalesce</a>]. Apply the GIF disposal methods set
+      in the current image sequence to form a fully defined
+      animation sequence without, as it should be displayed.
+      Effectively converting a GIF animation into a 'film strip'
+      like animation.</dd>
+      <dt>CompareAnyLayer</dt>
+      <dd class="imquote">Crop the second and later frames to the
+      smallest rectangle that contains all the differences between
+      the two images. No GIF disposal methods are taken into
+      account. This is exactly the same as [<a href=
+      "#deconstruct">deconstruct</a>], and does not preserve a
+      animation's normal working, especially when a animation used
+      GIF disposal methods such as 'Previous' or 'Background'.</dd>
+      <dt>CompareClearLayer</dt>
+      <dd class="imquote">As [CompareAnyLayer] but crop to the
+      bounds of any opaque pixels which become transparent in the
+      second frame. That is the smallest image needed to mask or
+      erase pixels for the next frame.</dd>
+      <dt>CompareOverlayLayer</dt>
+      <dd class="imquote">As [CompareAnyLayer] but crop to pixels
+      that add extra color to the next image, as a result of
+      overlaying color pixels. That is the smallest single overlaid
+      image to add or change colors. This can, be used with the
+      -compose alpha composition method 'change-mask', to reduce
+      the image to just the pixels that need to be overlaid.</dd>
+      <dt>DisposeLayer</dt>
+      <dd class="imquote">This is like [CoalesceLayer] but shows
+      the look of the animation after the GIF disposal method has
+      been applied, before the next sub-frame image is overlaid.
+      That is the 'dispose' image that results from the application
+      of the GIF disposal method. This allows you to check what is
+      going wrong with a particular animation you may be
+      developing.</dd>
+      <dt>FlattenLayer</dt>
+      <dd><span class="imquote">Create a canvas the size of the
+      first images virtual canvas using the current background
+      color, and compose each image in turn onto that canvas.
+      Images falling outside that canvas will be clipped. Final
+      image will have a zero virtual canvas offset. This is usally
+      used as one of the final 'image layering' operations
+      overlaying all the prepared image layers into a final image.
+      For a single image this method can also be used to fillout a
+      virtual canvas with real pixels, or to underlay a opaque
+      color to remove transparency from an image.</span> This
+      method corresponds to <a href=
+      "#flatten_images">flatten_images</a>, above.</dd>
+      <dt>MosaicLayer</dt>
+      <dd><span class="imquote">As FlattenLayer method but
+      expanding the initial canvas size of the first image so as to
+      hold all the image layers. However as a virtual canvas is
+      'locked' to the origin, by definition, image layers with a
+      negative offsets will still be clipped by the top and left
+      edges. This method is commonly used to layout individual
+      image using various offset but without knowning the final
+      canvas size. The resulting image will, like FlattenLayer not
+      have any virtual offset, so can be saved to any image file
+      format.</span> This method corresponds to <a href=
+      "#mosaic">mosaic</a>, above.</dd>
+      <dt>OptimizeImageLayer</dt>
+      <dd class="imquote">Optimize a coalesced animation into GIF
+      animation by reducing the number of pixels per frame as much
+      as possible by attempting to pick the best GIF disposal
+      method to use, while ensuring the result will continue to
+      animate properly. There is no guarantee that the best
+      optimization will be found. But then no reasonably fast GIF
+      optimization algorithm can do this. However this does seem to
+      do better than most other GIF frame optimizers seen.</dd>
+      <dt>OptimizeLayer</dt>
+      <dd class="imquote">Optimize a coalesced animation into GIF
+      animation using a number of general techniques. This is
+      currently a short cut to apply both the [OptimizeImageLayer]
+      and [OptimizeTransLayer] methods but will expand to include
+      other methods.</dd>
+      <dt>OptimizePlusLayer</dt>
+      <dd class="imquote">As [OptimizeImageLayer] but attempt to
+      improve the overall optimization by adding extra frames to
+      the animation, without changing the final look or timing of
+      the animation. The frames are added to attempt to separate
+      the clearing of pixels from the overlaying of new additional
+      pixels from one animation frame to the next. If this does not
+      improve the optimization (for the next frame only), it will
+      fall back to the results of the previous normal
+      [OptimizeImageLayer] technique. There is the possibility that
+      the change in the disposal style will result in a worsening
+      in the optimization of later frames, though this is unlikely.
+      In other words there no guarantee that it is better than the
+      normal 'optimize-frame' technique.</dd>
+      <dt>OptimizeTransLayer</dt>
+      <dd class="imquote">Given a GIF animation, replace any pixel
+      in the sub-frame overlay images with transparency, if it does
+      not change the resulting animation by more than the current
+      fuzz factor. This should allow a existing frame optimized GIF
+      animation to compress into a smaller file size due to larger
+      areas of one (transparent) color rather than a pattern of
+      multiple colors repeating the current disposed image of the
+      last frame.</dd>
+      <dt>RemoveDupsLayer</dt>
+      <dd class="imquote">Remove (and merge time delays) of
+      duplicate consecutive images, so as to simplify layer
+      overlays of coalesced animations. Usally this is a result of
+      using a constant time delay across the whole animation, or
+      after a larger animation was split into smaller
+      sub-animations. The duplicate frames could also have been
+      used as part of some frame optimization methods.</dd>
+      <dt>RemoveZeroLayer</dt>
+      <dd class="imquote">Remove any image with a zero time delay,
+      unless ALL the images have a zero time delay (and is not a
+      proper timed animation, a warning is then issued). In a GIF
+      animation, such images are usually frames which provide
+      partial intermediary updates between the frames that are
+      actually displayed to users. These frames are usally added
+      for improved frame optimization in GIF animations.</dd>
+    </dl>
-      <li>OptimizeLayer</li>
+    <p>Some of these values are not supported by older versions of
+    ImageMagick. To see what values are available, enter the
+    following code in irb:</p>
+    <pre>
+Magick::ImageLayerMethod.values {|v| puts v}
+</pre>
-      <li>OptimizePlusLayer</li>
-    </ul>
+    <p>In releases of ImageMagick before 6.3.6, this type was
+    called MagickLayerMethod, so you may need to use this
+    instead:</p>
+    <pre>
+Magick::MagickLayerMethod.values {|v| puts v}
+</pre>
     <h4>Returns</h4>
@@ -1457,6 +1630,8 @@ imagelist.new_image(100, 100) { self.background_color = "red" }
     <h4>See also</h4>
+    <p><a href="#composite_layers">composite_layers</a></p>
     <p><a href="#deconstruct">deconstruct</a> is an alias for
     <code>optimize_layers</code> with the
     <code>CompareAnyLayer</code> argument.</p>
@@ -1467,8 +1642,7 @@ imagelist.new_image(100, 100) { self.background_color = "red" }
     <h4>Magick API</h4>
-    <p>OptimizeImageLayers, CompareImageLayers (available in
-    ImageMagick 6.2.6)</p>
+    <p>OptimizeImageLayers, CompareImageLayers</p>
   </div>
   <div class="sig">
@@ -1540,7 +1714,7 @@ puts "The image has #{i.columns} columns and #{i.rows} rows." &raquo;
       <dd>The maximum number of colors to use in the output images.
       Must be less than or equal to <a href=
-      "constants.html#Miscellaneous_constants">MaxRGB</a>.</dd>
+      "constants.html#Miscellaneous_constants">QuantumRange</a>.</dd>
       <dt>colorspace</dt>
@@ -1670,7 +1844,7 @@ number = '0'
     <h4>Notes</h4>
-    <p>You can create images using &times;Magick's built-in formats
+    <p>You can create images using ImageMagick's built-in formats
     with the <code>read</code> method. See <a href=
     "imusage.html#builtin_formats">Built-in image formats</a>.</p>
   </div>
@@ -1716,6 +1890,23 @@ s = i.to_blob &raquo; a string representing the image.
     <p>ImageListToBlob</p>
   </div>
+  <div class="sig">
+    <h3 id="to_a">to_a</h3>
+    <p><span class="arg">imagelist</span>.to_a -&gt;
+    <em>anArray</em></p>
+  </div>
+  <div class="desc">
+    <h4>Description</h4>
+    <p>Returns an array containing all the images in the list.</p>
+    <h4>Returns</h4>
+    <p>An array</p>
+  </div>
   <div class="sig">
     <h3 id="write">write</h3>
@@ -1775,7 +1966,7 @@ p i.length &raquo; 3 # contains 3 images
 i.write "test.png" &raquo; test.png.0
                    &raquo; test.png.1
                    &raquo; test.png.2
-# &times;Magick's MIFF format does support multi-frame
+# ImageMagick's MIFF format does support multi-frame
 # files, so all 3 images are written to one file.
 i.write "animated.miff" &raquo; animated.miff
 </pre>