rdp-rmagick 0.0.0

data/doc/ex/vignette.rb

@@ -0,0 +1,12 @@
+#! /usr/local/bin/ruby -w
+
+require 'RMagick'
+
+# Demonstrate the Image#vignette method.
+# Compare this example with the vignette.rb script in the examples directory.
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+vignette = img.vignette
+vignette.write('vignette.jpg')
+
+exit

data/doc/ex/watermark.rb

@@ -0,0 +1,28 @@
+#! /usr/local/bin/ruby -w
+
+require "RMagick"
+
+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
+    if RUBY_PLATFORM =~ /mswin32/
+        gc.font_family = "Georgia"
+    else
+        gc.font_family = "Times"
+    end
+    gc.fill = "white"
+    gc.stroke = "none"
+end
+
+mark = mark.wave(2.5, 70).rotate(-90)
+
+# Composite the watermark in the lower right (southeast) corner.
+img2 = img.watermark(mark, 0.25, 0, Magick::SouthEastGravity)
+img2.write("watermark.jpg")
+

data/doc/ex/wave.rb

@@ -0,0 +1,9 @@
+#! /usr/local/bin/ruby -w
+require 'RMagick'
+
+img = Magick::Image.read('images/Flower_Hat.jpg').first
+
+img = img.wave
+
+img.write('wave.jpg')
+exit

data/doc/ex/wet_floor.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+
+require 'RMagick'
+
+
+results = Magick::ImageList.new
+
+img = Magick::Image.new(270, 60) {self.background_color = "black" }
+
+gc = Magick::Draw.new
+gc.annotate(img, 0, 0, 0, -15, "RUBY!") do
+    gc.fill = '#a00'
+    gc.stroke = '#f00'
+    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
+end
+
+# Add a little bit of shading
+if Magick.const_defined? "HardLightCompositeOp"
+    shade = img.shade(true, 310, 30)
+    img.composite!(shade, Magick::CenterGravity, Magick::HardLightCompositeOp)
+end
+
+# Create the default reflection
+reflection = img.wet_floor
+
+ilist = Magick::ImageList.new
+ilist << img << reflection
+results << ilist.append(true)
+
+# Change the initial level of transparency and the rate of transition
+ilist[1] = img.wet_floor(0.25, 0.5)
+results << ilist.append(true)
+
+# Add a slant
+xform = Magick::AffineMatrix.new(1.0, 0.0, Math::PI/4.0, 1.0, 0.0, 0.0)
+ilist[1] = ilist[1].affine_transform(xform)
+results << ilist.append(true)
+
+# Add a ripple
+ilist[1] = ilist[1].rotate(90).wave(2, 10).rotate(-90)
+results << ilist.append(true)
+
+# Montage into a single demo image. Use a white background so
+# there won't be any problems with transparency in the browser.
+result = results.montage do
+    self.geometry = '270x120'
+    self.tile = '1x4'
+    self.background_color = 'black'
+end
+result.write('wet_floor.gif')

data/doc/ex/writing_mode01.rb

@@ -0,0 +1,27 @@
+require 'rvg/rvg'
+
+Magick::RVG.dpi = 90
+
+TEXT_STYLES = {:writing_mode=>'tb',
+               :glyph_orientation_vertical=>0,
+               :fill=>'red4',
+               :font_weight=>'bold',
+               :font_size=>16}
+
+TEXT_STYLES2 = {:writing_mode=>'tb',
+               :glyph_orientation_vertical=>90,
+               :fill=>'green',
+               :font_weight=>'bold',
+               :font_size=>16}
+
+rvg = Magick::RVG.new(1.25.in, 7.in).viewbox(0,0,125,700) do |canvas|
+    canvas.background_fill = 'white'
+
+    canvas.text(40, 15, ":glyph_orientation_vertical=0").styles(TEXT_STYLES)
+    canvas.text(80, 25, ":glyph_orientation_vertical=90").styles(TEXT_STYLES2)
+
+    canvas.rect(124, 698).styles(:fill=>'none',:stroke=>'blue')
+end
+
+rvg.draw.write('writing_mode01.gif')
+

data/doc/ex/writing_mode02.rb

@@ -0,0 +1,26 @@
+require 'rvg/rvg'
+
+Magick::RVG.dpi = 90
+
+TEXT_STYLES = {:writing_mode=>'lr',
+               :glyph_orientation_horizontal=>0,
+               :fill=>'red4',
+               :font_weight=>'bold',
+               :font_size=>16}
+
+TEXT_STYLES2 = {:writing_mode=>'lr',
+               :glyph_orientation_horizontal=>180,
+               :fill=>'green',
+               :font_weight=>'bold',
+               :font_size=>16}
+
+rvg = Magick::RVG.new(3.in, 1.in).viewbox(0,0,300,100) do |canvas|
+    canvas.background_fill = 'white'
+
+    canvas.text(15, 40, ":glyph_orientation_horizontal=0").styles(TEXT_STYLES)
+    canvas.text(15, 80, ":glyph_orientation_horizontal=180").styles(TEXT_STYLES2)
+
+    canvas.rect(299, 99).styles(:fill=>'none',:stroke=>'blue')
+end
+
+rvg.draw.write('writing_mode02.gif')

data/doc/ilist.html

@@ -0,0 +1,2056 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta name="generator" content=
+  "HTML Tidy for Linux/x86 (vers 6 November 2007), see www.w3.org" />
+
+  <title>RMagick 0.0.0: class ImageList</title>
+  <meta http-equiv="Content-Type" content=
+  "text/html; charset=us-ascii" />
+  <meta name="GENERATOR" content="Quanta Plus" />
+  <meta name="Copyright" content=
+  "Copyright (C) 2005 by Timothy P. Hunter" />
+  <link rel="stylesheet" type="text/css" href="css/doc.css" />
+  <script type="text/javascript" src="scripts/doc.js">
+</script>
+  <script type="text/javascript" src="scripts/doc.js">
+</script>
+</head>
+
+<body>
+  <h6 id="header">RMagick 0.0.0 User's Guide and Reference</h6>
+
+  <div class="nav">
+    &laquo;&nbsp;<a href="magick.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "imageattrs.html">Next</a>&nbsp;&raquo;
+  </div>
+
+  <h1>class ImageList<br />
+  <span class="mixin">mixes in Comparable, Enumerable</span></h1>
+
+  <div id="toc">
+    <h2>Table of Contents</h2>
+
+    <h3>class methods</h3>
+
+    <ul>
+      <li><a href="#new">new</a></li>
+    </ul>
+
+    <h3>attributes</h3>
+
+    <ul>
+      <li><a href="#delay_eq">delay=</a></li>
+
+      <li><a href="#iterations_eq">iterations=</a></li>
+
+      <li><a href="#length">length</a></li>
+
+      <li><a href="#scene">scene, scene=</a></li>
+
+      <li><a href="#ticks_per_second_eq">ticks_per_second=</a></li>
+    </ul>
+
+    <h3>instance methods</h3>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#array_methods">Array methods</a></li>
+
+        <li><a href="#spaceship">&lt;=&gt;</a></li>
+
+        <li><a href="#animate">animate</a></li>
+
+        <li><a href="#append">append</a></li>
+
+        <li><a href="#average">average</a></li>
+
+        <li><a href="#clone">clone</a></li>
+
+        <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>
+      </ul>
+    </div>
+
+    <div class="toccol">
+      <ul>
+        <li><a href="#deconstruct">deconstruct</a></li>
+
+        <li><a href="#dup">dup</a></li>
+
+        <li><a href="#display">display</a></li>
+
+        <li><a href="#flatten_images">flatten_images</a></li>
+
+        <li><a href="#from_blob">from_blob</a></li>
+
+        <li><a href="#fx">fx</a></li>
+
+        <li><a href="#inspect">inspect</a></li>
+
+        <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="#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>
+
+        <li><a href="#read">read</a></li>
+
+        <li><a href="#remap">remap</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>
+      </ul>
+    </div>
+  </div>
+
+  <h2 class="methods">class methods</h2>
+
+  <div class="sig">
+    <h3 id="new">new</h3>
+
+    <p>Magick::ImageList.new <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>imagelist</em><br />
+    Magick::ImageList.new(<span class="arg">filename[,
+    filename...]]</span>) <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates a new imagelist. If one or more image filenames are
+    specified, opens and reads the files, adding a new image for
+    each image in the image file(s). Sets the scene number to the
+    index of the last image, or <code>nil</code> if no filenames
+    are specified.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Zero or more image file names. You can also specify optional
+    arguments to be used when reading the file(s) by setting
+    <a href="info.html">Image::Info</a> attributes in the optional
+    block.</p>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist. The imagelist contains an Image object for
+    each image in the specified files. A file can contain more than
+    one image. For example, new will create an image for each frame
+    in an animated GIF or each layer in a multi-layer Photoshop
+    file.</p>
+
+    <h4>Example</h4>
+    <pre>
+i = Magick::ImageList.new
+i = Magick::ImageList.new("Button_A.gif", "Cheetah.jpg")
+</pre>
+  </div>
+
+  <h2 class="methods">attributes</h2>
+
+  <div class="sig">
+    <h3 id="delay_eq">delay=</h3>
+
+    <p><span class="arg">ilist.</span>delay=<em>n</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>In conjunction with <a href=
+    "#ticks_per_second_eq">ticks_per_second</a> sets the length of
+    time between each image in an animation. The
+    <code>delay=</code> attribute assigns the same delay to all the
+    images in the ilist. Use <a href=
+    "imageattrs.html#delay">Image#delay=</a> to set different delay
+    values on individual images.</p>
+
+    <h4>Arguments</h4>
+
+    <p>An integer value representing the number of ticks that must
+    elapse between each image in an animation.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist.delay = 20 # delay 1/5 of a second between images.
+</pre>
+
+    <h4>See also</h4>
+
+    <p><a href="imageattrs.html#delay">Image#delay=</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="iterations_eq">iterations=</h3>
+
+    <p><span class="arg">ilist.</span>iterations=<em>n</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Sets the number of times an animated image should loop.</p>
+
+    <p>The <a href="#animate">animate</a> method and the
+    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>
+
+    <p>The number of iterations.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist.iterations = 10
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="length">length</h3>
+
+    <p><span class="arg">ilist.</span>length -&gt;
+    <em>integer</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Returns the number of images in the imagelist.</p>
+
+    <h4>Example</h4>
+    <pre>
+i = Magick::ImageList.new("images/Button_A.gif", "images/Button_B.gif")
+i.length &raquo; 2
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="scene">scene, scene=</h3>
+
+    <p><span class="arg">ilist</span>.scene -&gt;
+    <em>integer</em><br />
+    <span class="arg">ilist</span>.scene = <em>integer</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Get/set the current <em>scene number</em>. The scene number
+    indicates the image to which <a href="image1.html">Image</a>
+    methods are sent.</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist.scene = 10
+ilist.scene &raquo; 10
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="ticks_per_second_eq">ticks_per_second=</h3>
+
+    <p><span class="arg">ilist</span>.ticks_per_second =
+    <em>integer</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Used in conjunction with <a href="#delay_eq">delay</a> to
+    establish the elapsed time between frames in an animation. By
+    default the number of ticks per second is 100.</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist.ticks_per_second = 1000
+</pre>
+  </div>
+
+  <h2 class="methods">instance methods</h2>
+
+  <div class="sig">
+    <h3 id="array_methods">Array methods</h3>
+
+    <p>&nbsp;</p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <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 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
+    updates the scene number to the new index. If the method
+    deletes the current image, the scene number is set to the last
+    image in the list. The following table lists the methods that
+    do not follow these rules.</p>
+
+    <table summary="array method affect on scene number" class=
+    "simple_table">
+      <caption>
+        Array method behavior
+      </caption>
+
+      <thead>
+        <tr>
+          <th>Array method</th>
+
+          <th>scene number will be...</th>
+        </tr>
+      </thead>
+
+      <tbody>
+        <tr>
+          <td>&lt;&lt;</td>
+
+          <td>set to index the last image in the list</td>
+        </tr>
+
+        <tr>
+          <td>clear</td>
+
+          <td>set to <code>nil</code></td>
+        </tr>
+
+        <tr>
+          <td>concat</td>
+
+          <td>set to index the last image in the list</td>
+        </tr>
+
+        <tr>
+          <td>push</td>
+
+          <td>set to index the last image in the list</td>
+        </tr>
+
+        <tr>
+          <td>unshift</td>
+
+          <td>set to 0</td>
+        </tr>
+      </tbody>
+    </table>
+
+    <p>Adding anything other than a image to an imagelist has
+    undefined results. Most of the time RMagick will raise an
+    ArgumentError exception. For example, if you call
+    <code>collect!</code> on an imagelist you should make sure that
+    the members of the imagelist 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>,
+    and <code>rassoc</code> methods are not defined in the
+    ImageList class.</p>
+
+    <h4>Example</h4>
+
+    <p>Add noise to a model image. Append the resulting image to
+    the imagelist in "example". (See the <code>demo.rb</code>
+    example.)</p>
+    <pre>
+example = Magick::ImageList.new
+model = Magick::ImageList.new "model.miff"
+example &lt;&lt; model.add_noise Magick::LaplacisanNoise
+</pre>
+
+    <h4>See also</h4>
+
+    <p><a href="#scene">scene</a>, <a href="#scene">scene=</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="spaceship">&lt;=&gt;</h3>
+
+    <p><span class="arg">ilist</span> &lt;=&gt; <span class=
+    "arg">other_imagelist</span> -&gt; -1, 0, 1</p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Compares two imagelists and returns -1, 0, or 1 if the
+    receiver is less than, equal to, or greater than the other
+    imagelist. The comparison between the receiver (a) and the
+    other (b) is performed this way:</p>
+
+    <ol>
+      <li>For all images <code>n</code>, if the result of
+      <code>a[n]&nbsp;&lt;=&gt;&nbsp;b[n]</code> is not 0 then that
+      is the result of a&nbsp;&lt;=&gt;&nbsp;b. Individual images
+      are compared by comparing their <a href=
+      "image3.html#signature">signatures</a>.</li>
+
+      <li>If <code>a.scene&nbsp;&lt;=&gt;&nbsp;b.scene</code> is
+      not 0, returns the result</li>
+
+      <li>Returns
+      <code>a.length&nbsp;&lt;=&gt;&nbsp;b.length</code></li>
+    </ol>
+
+    <p><code>ImageList</code> mixes in the <code>Comparable</code>
+    module.</p>
+
+    <h4>See also</h4>
+
+    <p><a href="image1.html#spaceship">Image#&lt;=&gt;</a>,
+    <a href="image3.html#signature">signature</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="animate">animate</h3>
+
+    <p><span class="arg">ilist.</span>animate(<span class=
+    "arg">[delay]</span>) <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Animate the images to an X Window screen. By default
+    displays to the local screen. You can specify a different
+    screen by assigning the name to the <code>server_name</code>
+    attribute in the optional arguments block.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist.animate
+ilist.animate { self.server_name = "other:0.0" }
+</pre>
+
+    <h4>See also</h4>
+
+    <p><a href="#display">display</a></p>
+
+    <h4>Note</h4>
+
+    <p>The animate method is not supported on native MS
+    Windows.</p>
+
+    <h4>Magick API</h4>
+
+    <p>AnimateImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="append">append</h3>
+
+    <p><span class="arg">ilist.</span>append(<code>true</code> or
+    <code>false</code>) -&gt; <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Append all the images in the imagelist, either vertically or
+    horizontally. If the images are not of the same width, any
+    narrow images will be expanded to fit using the background
+    color.</p>
+
+    <h4>Arguments</h4>
+
+    <p>If <code>true</code>, rectangular images are stacked
+    top-to-bottom, otherwise left-to-right.</p>
+
+    <h4>Returns</h4>
+
+    <p>A image composed of all the images in the imagelist.</p>
+
+    <h4>Magick API</h4>
+
+    <p>AppendImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="average">average</h3>
+
+    <p><span class="arg">ilist.</span>average -&gt;
+    <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Averages all the images together. Each image in the image
+    must have the same width and height.</p>
+
+    <h4>Returns</h4>
+
+    <p>A single image representing the average of all the images in
+    the imagelist.</p>
+
+    <h4>Example</h4>
+
+    <p class="rollover"><a href=
+    "javascript:popup('average.rb.html')">
+    <!-- This img tag displays the original image when the mouse is over -->
+     <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" /><!--
+                                  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>
+
+    <h4>Magick API</h4>
+
+    <p>AverageImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="clone">clone</h3>
+
+    <p><span class="arg">ilist</span>.clone -&gt;
+    <em>other_imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Same as <a href="#dup">dup</a>, but the frozen state of the
+    original is propagated to the copy.</p>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#copy">copy</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="coalesce">coalesce</h3>
+
+    <p><span class="arg">ilist.</span>coalesce -&gt;
+    <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Merges all the images in the imagelist into a new imagelist.
+    Each image in the new imagelist is formed by flattening all the
+    previous images.</p>
+
+    <p>The length of time between images in the new image is
+    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>
+
+    <p>A new imagelist</p>
+
+    <h4>Example</h4>
+
+    <p>This example is an animated GIF created by coalescing 25
+    small images in a grid. Mouse over the image to start the
+    animation.</p>
+
+    <p class="rollover"><a href=
+    "javascript:popup('coalesce.rb.html')"><img onmouseover=
+    "this.src='ex/coalesce_anim.gif'" onmouseout=
+    "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:165px"
+    title="Mouse over the example to see the animation" /></p>
+
+    <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>imagelist</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>
+
+    <p><span class="arg">ilist.</span>copy -&gt;
+    <em>other_imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates a deep copy of the imagelist. The new imagelist
+    contains a copy of all the images in the original
+    imagelist.</p>
+
+    <h4>Returns</h4>
+
+    <p>An imagelist</p>
+
+    <h4>Example</h4>
+    <pre>
+imagelist2 = imagelist1.copy
+</pre>
+
+    <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">
+    <h3 id="cur_image">cur_image</h3>
+
+    <p><span class="arg">ilist.</span>cur_image -&gt;
+    <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Retrieves the image indexed by <a href="#scene">scene</a>.
+    Raises <code>IndexError</code> if there are no images in the
+    list.</p>
+
+    <p>Both the ImageList class and the Image class support the
+    <code>cur_image</code> method. Of course, in the Image class,
+    <code>cur_image</code> simply returns <code>self</code>. When a
+    method accepts either an image or a imagelist as an argument,
+    it sends the <code>cur_image</code> method to the argument to
+    get the current image.</p>
+
+    <h4>Returns</h4>
+
+    <p>An image</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="deconstruct">deconstruct</h3>
+
+    <p><span class="arg">ilist.</span>deconstruct -&gt;
+    <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>This method constructs a new imagelist containing images
+    that include only the changed pixels between each image and its
+    successor. The resulting imagelist usually produces a much
+    smaller file.</p>
+
+    <p>The <code>deconstruct</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
+    and second image and stores just the changed rectangle of the
+    second image, along with the offset of the rectangle relative
+    to the boundary of the first image.</p>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist</p>
+
+    <h4>Magick API</h4>
+
+    <p>DeconstructImages</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#optimize_layers">optimize_layers</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="dup">dup</h3>
+
+    <p><span class="arg">ilist</span>.dup -&gt;
+    <em>other_imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Makes a <em>shallow</em> copy of the receiver. The image
+    elements in the new imagelist are references to the image
+    elements in the original imagelist, not copies.</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#copy">copy</a>, <a href="#clone">clone</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="display">display</h3>
+
+    <p><span class="arg">ilist.</span>display <span class=
+    "arg">[&nbsp;{ optional arguments }&nbsp;]</span> -&gt;
+    <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Displays the images in the imagelist to any X Window screen.
+    By default displays to the local screen. You can specify a
+    different screen by assigning the name to the
+    <code>server_name</code> attribute in the optional arguments
+    block.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>See also</h4>
+
+    <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>
+  </div>
+
+  <div class="sig">
+    <h3 id="flatten_images">flatten_images</h3>
+
+    <p><span class="arg">ilist.</span>flatten_images -&gt;
+    <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Combines all the images in the imagelist into a single image
+    by overlaying each successive image onto the preceding images.
+    If a image has transparent areas, the underlying image will
+    show through. Use the <a href="imageattrs.html#page">page</a>
+    attribute to specify the position of each image with respect to
+    the preceding images.</p>
+
+    <p class="imquote">This is useful for combining Photoshop
+    layers into a single image.</p>
+
+    <h4>Returns</h4>
+
+    <p>An image</p>
+
+    <h4>Example</h4>
+
+    <p><a href=
+    "javascript:popup('flatten_images.rb.html')"><img alt=
+    "flatten_images example" src="ex/flatten_images.gif" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="#coalesce">coalesce</a>, <a href=
+    "#optimize_layers">optimize_layers</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>MergeImageLayers with the FlattenLayer method.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="from_blob">from_blob</h3>
+
+    <p><span class="arg">ilist.</span>from_blob(blob<span class=
+    "arg">[, blob...]</span>) <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates images from the blob (<em>B</em>inary <em>L</em>arge
+    <em>O</em>bjects) arguments and appends the images to the
+    imagelist.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A <em>blob</em> can be a string containing an image file
+    such as a JPEG or GIF. The string can contain a multi-image
+    file such as an animated GIF or a Photoshop image with multiple
+    layers. A blob can also be one of the strings produced by
+    <a href="#to_blob">to_blob</a>. Control how the image(s) are
+    created by setting additional <a href=
+    "info.html">Image::Info</a> attributes in the optional block
+    argument. Useful attributes include <a href=
+    "info.html#scene">scene</a>, <a href=
+    "info.html#number_scenes">number_scenes</a>, and <a href=
+    "info.html#extract">extract</a>.</p>
+
+    <h4>Returns</h4>
+
+    <p>An image created from the blob argument(s). The
+    <code>scene</code> attribute is set to the last image in the
+    imagelist.</p>
+
+    <h4>Example</h4>
+    <pre>
+require 'RMagick'
+
+f = File.open('Cheetah.jpg')
+blob = f.read
+
+ilist = Magick::ImageList.new
+ilist.from_blob(blob)
+ilist.display
+</pre>
+
+    <h4>See also</h4><a href="#to_blob">to_blob</a>, <a href=
+    "image3.html#to_blob">Image#to_blob</a>, <a href=
+    "image1.html#from_blob">Image.from_blob</a>
+
+    <h4>Magick API</h4>
+
+    <p>BlobToImageList</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="fx">fx</h3>
+
+    <p><span class="arg">ilist</span> .fx(<span class=
+    "arg">expression</span> [, <span class=
+    "arg">channel</span>...]) -&gt; <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Applies the specified mathematical expression to the input
+    images. This method corresponds to ImageMagick's <a href=
+    "http://redux.imagemagick.org/script/fx.php">-fx</a>
+    operator.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>expression</dt>
+
+      <dd>A mathematical expression of the form accepted by the -fx
+      operator..</dd>
+
+      <dt>channel...</dt>
+
+      <dd>0 or more <a href=
+      "constants.html#ChannelType">ChannelType</a> arguments.
+      Specify the output channels. If no channels are specified the
+      result is set over all channels except the opacity
+      channel.</dd>
+    </dl>
+
+    <h4>Notes</h4>
+
+    <ul>
+      <li>Fx expressions are interpreted. Therefore this method can
+      be quite slow depending on the complexity of the expression.
+      Generally you will get better performance by accessing the
+      image pixels as <a href="struct.html#Pixel">Pixel</a> objects
+      (see <a href="image2.html#get_pixels">get_pixels</a> and
+      <a href="image3.html#view">view</a>) and using Ruby code to
+      perform the mathematics.</li>
+
+      <li>The <code>u</code> and <code>v</code> symbols refer to
+      the 0th and 1st image in the list. The image reference index
+      (<code>u[2]</code> for example) works as expected. The
+      current <a href="#scene">scene number</a> has no meaning in
+      the context of the <code>fx</code> method.</li>
+
+      <li>To specify a non-default pixel interpolation method, set
+      the <a href=
+      "imageattrs.html#pixel_interpolation_method">pixel_interpolation_method</a>
+      attribute of the last image in the list.</li>
+    </ul>
+
+    <h4>Returns</h4>
+
+    <p>The image created by the expression.</p>
+
+    <h4>Example</h4>
+    <pre>
+# Produce a navy blue image from a black image
+imgl = Magick::ImageList.new
+imgl &lt;&lt; Magick::Image.new(64, 64) {self.background_color = 'black'}
+
+res = imgl.fx('1/2', Magick::BlueChannel)
+</pre>
+
+    <h4>ImageMagick API</h4>
+
+    <p>FxImageChannel</p>
+
+    <h4>See also</h4>
+
+    <p><a href="image2.html#get_pixels">get_pixels</a>, <a href=
+    "image3.html#view">view</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="inspect">inspect</h3>
+
+    <p><span class="arg">ilist.</span>inspect -&gt;
+    <em>string</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Produces a string that describes the images in the
+    imagelist.</p>
+
+    <h4>Arguments</h4>
+
+    <h4>Returns</h4>
+
+    <p>The returned string is a concatenation of the strings
+    returned by <a href="image2.html#inspect">Image#inspect</a> for
+    all the images in the imagelist.</p>
+
+    <h4>Example</h4>
+    <pre>
+i = Magick::ImageList.new("images/Button_A.gif", "images/Button_B.gif")
+&raquo; [images/Button_A.gif GIF 127x120+0+0 PseudoClass 256c 8-bit 18136b
+images/Button_B.gif GIF 127x120+0+0 PseudoClass 256c 8-bit 5157b]
+scene=1
+</pre>
+
+    <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">ilist</span>.map(<span class=
+    "arg">reference</span>, <span class="arg">dither</span>) -&gt;
+    <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Reduces the colors in the imagelist images to the set of
+    colors in the <span class="arg">reference</span> image.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>reference</dt>
+
+      <dd>An image or a imagelist. If an imagelist,
+      <code>map</code> uses the current image as the reference
+      image.</dd>
+
+      <dt>dither</dt>
+
+      <dd>if <code>true</code>, dither the mapped images.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist the same length as the receiver.</p>
+
+    <h4>Notes</h4>
+
+    <p>This method is deprecated when using ImageMagick 6.4.3-6 and
+    later. Use <a href="#remap">remap</a> instead.</p>
+
+    <h4>See also</h4>
+
+    <p><a href="image2.html#map">Image#map</a>, <a href=
+    "#quantize">quantize</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>MapImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="montage">montage</h3>
+
+    <p><span class="arg">ilist.</span>montage <span class=
+    "arg">[&nbsp;{ optional arguments }&nbsp;]</span> -&gt;
+    <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates a composite image by reducing the size of the input
+    images and arranging them in a grid on the background color or
+    texture of your choice. There are many configuration options.
+    For example, you can specify the number of columns and rows,
+    the distance between images, and include a label with each
+    small image (called a <em>tile</em>).</p>
+
+    <p>All of <code>montage</code>'s configuration options are
+    specified by assigning values to attributes in a block
+    associated with the method call.</p>
+
+    <p>As you can see in the examples below, when you assign a
+    value to a montage attribute you must specify <code>self</code>
+    as the receiver so that Ruby can distinguish the method call
+    from an assignment to a local variable.</p>
+
+    <p>You may assign a <a href="struct.html#Pixel">Pixel</a>
+    object to any attribute that accepts a color name.</p>
+
+    <h4>Montage attributes</h4>
+
+    <dl>
+      <dt>background_color=</dt>
+
+      <dd>The composite image background color.</dd>
+
+      <dt>border_color=</dt>
+
+      <dd>The tile border color.</dd>
+
+      <dt>border_width=</dt>
+
+      <dd>The tile border width in pixels.</dd>
+
+      <dt>compose=</dt>
+
+      <dd>The <a href="constants.html#CompositeOperator">composite
+      operator</a> to use when compositing the tile images onto the
+      background. The default composition operator is
+      <code>OverCompositeOp</code>.</dd>
+
+      <dd><em>Hint:</em> You can use a different composite operator
+      for each tile by setting each image's <a href=
+      "imageattrs.html#compose">compose=</a> attribute to the
+      desired operator. In the optional arguments block, set
+      <code>compose</code> to UndefinedCompositeOp.</dd>
+
+      <dt>fill=</dt>
+
+      <dd>If the tiles have labels, the label fill color. The
+      default fill color is black.</dd>
+
+      <dt>font=</dt>
+
+      <dd>If the tiles have labels, the label font. The default
+      font is Helvetica.</dd>
+
+      <dt>frame=</dt>
+
+      <dd>
+        The size of an ornamental frame surrounding each tile. The
+        frame specification may be either a string or a <a href=
+        "struct.html#Geometry">Geometry</a> object. If the argument
+        is a string, it must have the form
+        <code>&lt;width&gt;x&lt;height&gt;+&lt;outer bevel
+        width&gt;+&lt;inner bevel width&gt;</code>. If the argument
+        is a Geometry object, specify the width and height of the
+        frame with the <code>width</code> and <code>height</code>
+        attributes, and specify the outer bevel width and the inner
+        bevel width with the <code>x</code> and <code>y</code>
+        attributes. The values are in pixels. For example, to
+        surround each tile with a frame 20 pixels wide by 20 pixels
+        high and a 4-pixel inner and outer bevel, use:
+        <pre>
+self.frame = "20x20+4+4"
+</pre>or
+        <pre>
+self.frame = Magick::Geometry.new(20,20,4,4)
+</pre>
+      </dd>
+
+      <dd>If the tile has a label, the label is included in the
+      frame. The default is to have no frame.</dd>
+
+      <dd>See <a href="image2.html#frame">Image#frame</a>.</dd>
+
+      <dt>geometry=</dt>
+
+      <dd>
+        The size of the tiles and the distance between tiles. The
+        value can be either a <a href=
+        "imusage.html#geometry">geometry string</a> or a <a href=
+        "struct.html#Geometry">Geometry</a> object. The geometry
+        string has the form:
+        <code>&lt;tile-width&gt;x&lt;tile-height&gt;+&lt;distance-between-columns&gt;+&lt;distance-between-rows&gt;</code>.
+        If you use a Geometry object, specify the tile width and
+        height with the <code>width</code> and <code>height</code>
+        attributes, and the distance between rows and distance
+        between columns by the <code>x</code> and <code>y</code>
+        attributes. To create tiles that are 130 pixels wide and
+        194 pixels tall, with 10 pixels between each column of
+        tiles and 5 between each row, use:
+        <pre>
+self.geometry = "130x194+10+5"
+</pre>or
+        <pre>
+self.geometry = Magick::Geometry.new(130, 194, 10, 5)
+</pre>Both the geometry string and the <code>Geometry</code> object
+support flags that specify additional constraints. The default
+geometry is "120x120+4+3&gt;".
+      </dd>
+
+      <dt>gravity=</dt>
+
+      <dd>The <a href="constants.html#GravityType">direction</a>
+      used when adding the tile labels. (See <a href=
+      "draw.html#Draw.annotate">annotate</a>.)</dd>
+
+      <dt>matte_color=</dt>
+
+      <dd>The matte color. The default is #bdbdbd.</dd>
+
+      <dt>pointsize=</dt>
+
+      <dd>If the tiles have labels, the size of the label font in
+      points. The default is 12 points.</dd>
+
+      <dt>shadow=</dt>
+
+      <dd>If set to <code>true</code>, adds a drop shadow to each
+      tile. The default is <code>false</code>.</dd>
+
+      <dt>stroke=</dt>
+
+      <dd>If the tiles have labels, sets the stroke (outline) color
+      of the label text. The default is "transparent".</dd>
+
+      <dt>texture=</dt>
+
+      <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 ImageMagick's built-in "granite"
+        texture as the background, use:
+        <pre>
+self.texture = Magick::Image.read("granite:").first
+</pre>
+
+        <p>The default is no texture.</p>
+      </dd>
+
+      <dt>tile=</dt>
+
+      <dd>
+        The number of columns and rows to use when arranging the
+        tiles on the composite image. The value can be either a
+        string or a <a href="struct.html#Geometry">Geometry</a>
+        object. If the value is a string, it should have the form
+        <code>"&lt;columns&gt;x&lt;rows&gt;"</code>. If the value
+        is a Geometry object, specify the number of columns as the
+        <code>width</code> attribute and the number of rows as the
+        <code>height</code> attribute. <code>montage</code> always
+        generates all the rows, leaving empty cells if necessary.
+        To arrange the tiles 4 across and 10 down, use:
+        <pre>
+self.tile = "4x10"
+</pre>or
+        <pre>
+self.tile = Magick::Geometry.new(4,10)
+</pre>
+
+        <p>The default is "6x4". If there are too many tiles to fit
+        on one composite image, <code>montage</code> creates
+        multiple composite images.</p>
+      </dd>
+
+      <dt>title=</dt>
+
+      <dd>Adds a title over the whole montage.</dd>
+    </dl>
+
+    <h4>Tile labels</h4>
+
+    <p>To add labels to the tiles, assign a "Label" property to
+    each image. The <code>montage</code> method will use the value
+    of the property as the label. For example,</p>
+    <pre>
+img[2]['Label'] = "Mom's Birthday"
+</pre>
+
+    <p>See <a href="image1.html#aset">[]=</a>.</p>
+
+    <h4>Returns</h4>
+
+    <p>An imagelist that contains as many images as are required to
+    display all the tiles.</p>
+
+    <h4>Magick API</h4>
+
+    <p>MontageImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="morph">morph</h3>
+
+    <p><span class="arg">ilist.</span>morph(<span class=
+    "arg">n</span>) -&gt; <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Transforms a image into another image by inserting
+    <code>n</code> in-between images. Requires at least two images.
+    If more images are present, the 2nd image is transformed into
+    the 3rd, the 3rd to the 4th, etc.</p>
+
+    <h4>Arguments</h4>
+
+    <p>The number of in-between images to insert between each pair
+    of images.</p>
+
+    <h4>Returns</h4>
+
+    <p>An imagelist containing copies of the original images plus
+    the in-between images.</p>
+
+    <h4>Example</h4>
+
+    <p>This animated GIF was created by reading the "0", "1", "2"
+    and "3" images, then using <code>morph</code> to create 8
+    images between each original image. Mouse over the image to
+    start the animation.</p>
+
+    <p class="rollover"><a href=
+    "javascript:popup('morph.rb.html')"><img onmouseover=
+    "this.src='ex/morph.gif'" onmouseout=
+    "this.src='ex/images/Button_0.gif'" src=
+    "ex/images/Button_0.gif" alt="morph example" title=
+    "Click the image to see the example script" /></a><img src=
+    "ex/images/spin.gif" alt="" class="spin" style="left:131px"
+    title="Mouse over the example to see the animation" /></p>
+
+    <h4>Magick API</h4>
+
+    <p>MorphImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="mosaic">mosaic</h3>
+
+    <p><span class="arg">ilist.</span>mosaic -&gt;
+    <em>image</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <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#page">page</a> attribute.</p>
+
+    <h4>Returns</h4>
+
+    <p>An image</p>
+
+    <h4>Example</h4>
+
+    <p><a href="javascript:popup('mosaic.rb.html')"><img src=
+    "ex/mosaic.gif" alt="mosaic example" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4><a href="#coalesce">coalesce</a>, <a href=
+    "#flatten_images">flatten_images</a>, <a href=
+    "#montage">montage</a>, <a href=
+    "#optimize_images">optimize_images</a>
+
+    <h4>Magick API</h4>
+
+    <p>MergeImageLayers with the MosaicLayer method.</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="new_image">new_image</h3>
+
+    <p><span class="arg">ilist.</span>new_image(<span class=
+    "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">
+    <h4>Description</h4>
+
+    <p>Adds a new image to the imagelist. The image can have an
+    optional <a href="struct.html#fill">fill</a> applied to it.</p>
+
+    <h4>Arguments</h4>
+
+    <p>Creates a new image with the specified number of rows and
+    columns. If the optional <code>fill</code> argument is used,
+    calls the <code>fill</code> method to fill the image.
+    Otherwise, the image is filled with the background color.</p>
+
+    <p>You can set any <a href="info.html">Image::Info</a>
+    attributes in an associated block. These attributes supply
+    options to be used when creating the image. For example, you
+    can specify the <a href=
+    "imageattrs.html#background_color">background color</a> to fill
+    the image with (see the example), the <a href=
+    "imageattrs.html#depth">depth</a>, <a href=
+    "imageattrs.html#border_color">border color</a>, etc.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>Create a square red image.</p>
+    <pre>
+ilist = Magick::ImageList.new
+ilist.new_image(100, 100) { self.background_color = "red" }
+</pre>
+  </div>
+
+  <div class="sig">
+    <h3 id="optimize_layers">optimize_layers</h3>
+
+    <p><span class="arg">ilist</span>.optimize_layers(<span class=
+    "arg">layer_method</span>) -&gt; <em>imagelist</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>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.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 ImageLayerMethod enum values:</p>
+
+    <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 usually
+      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>MergeLayers</dt>
+
+      <dd class="imquote">As [FlattenLayer] but merging all the
+      given image layers into a new layer image just large enough
+      to hold all the image without clipping or extra space. The
+      new image's virtual offset will prevere the position of the
+      new layer, even if this offset is negative. the virtual
+      canvas size of the first image is preserved. Caution is
+      advised when handling image layers with negative offsets as
+      few image file formats handle them correctly.</dd>
+
+      <dt>MosaicLayer</dt>
+
+      <dd><span class="imquote">As [FlattenLayer] 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 knowing 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. Usually 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 usually added
+      for improved frame optimization in GIF animations.</dd>
+
+      <dt>TrimBoundsLayer</dt>
+
+      <dd class="imquote">Find the minimal bounds of all the images
+      in the current image sequence, then adjust the offsets so all
+      images are contained on a minimal positive canvas. None of
+      the image data is modified, only the virtual canvas size and
+      offset. Then all the images will have the same canvas size,
+      and all will have a positive offset, at least one image will
+      touch every edge of that canvas with actual pixel data,
+      though that data may be transparent.</dd>
+    </dl>
+
+    <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>
+
+    <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>
+
+    <p>A new imagelist</p>
+
+    <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>
+
+    <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</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="ping">ping</h3>
+
+    <p><span class="arg">ilist.</span>ping(<span class=
+    "arg">filename</span>[, <span class="arg">filename</span>...])
+    -&gt; <em>self</em><br />
+    <span class="arg">ilist.</span>ping(<span class=
+    "arg">file</span>[, <span class="arg">file</span>...]) -&gt;
+    <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Reads the image files and creates one or more images that
+    contain all the image attributes but without the pixel data. If
+    all you need is the image attributes, the <code>ping</code>
+    method is much faster and consumes less memory than <a href=
+    "#read"><code>read</code></a>.</p>
+
+    <h4>Arguments</h4>
+
+    <p>One or more image file names or open file objects.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+ilist = Magick::ImageList.new
+ilist.ping "Button_A.gif"
+puts "The image has #{i.columns} columns and #{i.rows} rows." &raquo;
+      The image has 127 columns and 120 rows.
+</pre>
+
+    <h4>See also</h4><a href="#read">read</a>
+
+    <h4>Magick API</h4>
+
+    <p>PingImage</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="quantize">quantize</h3>
+
+    <p><span class="arg">ilist.</span>quantize(nc=256,
+    colorspace=<code>RGBColorspace</code>,
+    dither=<code>RiemersmaDitherMethod</code>, tree_depth=0,
+    measure_error=<code>false</code>) -&gt; <em>imagelist</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p class="imquote">Analyzes the colors within a set of
+    reference images and chooses a fixed number of colors to
+    represent the set. The goal of the algorithm is to minimize the
+    difference between the input and output images while minimizing
+    the processing time.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>nc</dt>
+
+      <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">QuantumRange</a>.</dd>
+
+      <dt>colorspace</dt>
+
+      <dd class="imquote">The <a href=
+      "constants.html#ColorspaceType">colorspace</a> to quantize
+      in. Color reduction, by default, takes place in the RGB color
+      space. Empirical evidence suggests that distances in color
+      spaces such as YUV or YIQ correspond to perceptual color
+      differences more closely than do distances in RGB space. The
+      Transparent color space behaves uniquely in that it preserves
+      the matte channel of the image if it exists.</dd>
+
+      <dt>dither</dt>
+
+      <dd>A <a href="constants.html#DitherMethod">DitherMethod</a>
+      value. 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>
+
+      <dt>tree_depth</dt>
+
+      <dd class="imquote">Specify the tree depth to use while
+      quantizing. The values 0 and 1 support automatic tree depth
+      determination. The tree depth may be forced via values
+      ranging from two to eight. The ideal tree depth depends on
+      the characteristics of the input image, and may be determined
+      through experimentation.</dd>
+
+      <dt>measure_error</dt>
+
+      <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#mean_error_per_pixel">mean_error_per_pixel</a>,
+      <a href=
+      "imageattrs.html#normalized_maximum_error">normalized_maximum_error</a>,
+      and <a href=
+      "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#total_colors">total_colors</a>
+      attribute.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>A new imagelist containing quantized copies of the images in
+    the original image.</p>
+
+    <h4>Example</h4>
+
+    <p>This example shows the effect of quantizing 3 images to a
+    set of 16 colors in the RGB colorspace. Mouse over the image to
+    see the images before quantizing.</p>
+
+    <p class="rollover"><a href=
+    "javascript:popup('quantize-m.rb.html')"><img src=
+    "ex/quantize-m_after.jpg" alt="quantize example" title=
+    "Click to see the example script" onmouseover=
+    "this.src='ex/quantize-m_before.jpg'" onmouseout=
+    "this.src='ex/quantize-m_after.jpg'" /></a> <img src=
+    "ex/images/spin.gif" alt="" class="spin" style="left: 505px;"
+    title="Mouse over the example to see the original image" /></p>
+
+    <h4>See also</h4>
+
+    <p><a href="image3.html#quantize">Image#quantize</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>QuantizeImages</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="read">read</h3>
+
+    <p><span class="arg">ilist.</span>read(<span class=
+    "arg">filename[, filename...]</span>) <span class=
+    "arg">[&nbsp;{ optional arguments }&nbsp;]</span> -&gt;
+    <em>self</em><br />
+    <span class="arg">ilist.</span>read(<span class="arg">file[,
+    file...]</span>) <span class="arg">[&nbsp;{ optional arguments
+    }&nbsp;]</span> -&gt; <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Reads one or more image files and adds the images to the
+    imagelist. After reading all the files, sets the <a href=
+    "#scene">scene</a> number to the last image in the list.</p>
+
+    <p>The image files may be multi-frame (animated or layered)
+    files. In this case <code>read</code> adds multiple images per
+    file to the imagelist.</p>
+
+    <h4>Arguments</h4>
+
+    <p>One or more filenames or open file objects. You can also
+    specify optional arguments to be used when reading the file(s)
+    by setting <a href="info.html">Image::Info</a> attributes in
+    the optional block.</p>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+    <pre>
+i = Magick::ImageList.new
+number = '0'
+4.times do
+        i.read "images/Button_" + number + ".gif"
+        number.succ!
+        end
+</pre>
+
+    <p>Also see the morph.rb example and the demo.rb example.</p>
+
+    <h4>See also</h4>
+
+    <p><a href="image1.html#read">Image.read</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>ReadImage</p>
+
+    <h4>Notes</h4>
+
+    <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>
+
+  <div class="sig">
+    <h3 id="remap">remap</h3>
+
+    <p><span class="arg">ilist</span>.remap(<span class=
+    "arg">remap_image</span>=nil, <span class=
+    "arg">dither</span>=RiemersmaDitherMethod) -&gt;
+    <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Reduce the colors used in the imagelist to the set of colors
+    in <span id="arg">remap_image</span>.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>remap_image</dt>
+
+      <dd>The reference image</dd>
+
+      <dt>dither</dt>
+
+      <dd>A <a href="constants.html#DitherMethod">DitherMethod</a>
+      value. RiemersmaDitherMethod is the default. To disable
+      dithering specify NoDitherMethod.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+
+    <h4>Example</h4>
+
+    <p>This example shows the effect of reducing the colors used in
+    the apple, beach scene, and leaf images to the set of colors
+    used in the yellow rose image.</p>
+
+    <p><a href="javascript:popup('remap_images.rb.html')"><img alt=
+    "remap_images example" src="ex/remap_images.jpg" title=
+    "Click to see the example script" /></a></p>
+
+    <h4>See also</h4>
+
+    <p><a href="image3.html#remap">Image#remap</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>RemapImages (available in ImageMagick 6.4.3-6)</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="to_blob">to_blob</h3>
+
+    <p><span class="arg">ilist.</span>to_blob <span class=
+    "arg">[&nbsp;{ optional arguments }&nbsp;]</span> -&gt;
+    <em>string</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Converts the images in the imagelist to a <em>blob</em>.
+    <span class="imquote">A blob contains data that directly
+    represent a particular image format in memory instead of on
+    disk.</span></p>
+
+    <p>Control the format of the blob by setting <a href=
+    "info.html">Image::Info</a> attributes in an associated
+    block.</p>
+
+    <h4>Returns</h4>
+
+    <p>The blob in the form of a string</p>
+
+    <h4>Example</h4>
+    <pre>
+i = Magick::ImageList.new "birthday.png"
+s = i.to_blob &raquo; a string representing the image.
+</pre>
+
+    <h4>See also</h4>
+
+    <p><a href="#from_blob">from_blob</a>, <a href=
+    "image3.html#to_blob">Image#to_blob</a>, <a href=
+    "image1.html#from_blob">Image.from_blob</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>ImageListToBlob</p>
+  </div>
+
+  <div class="sig">
+    <h3 id="to_a">to_a</h3>
+
+    <p><span class="arg">ilist</span>.to_a -&gt; <em>array</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>
+
+    <p><span class="arg">ilist.</span>write(<span class=
+    "arg">filename</span>) <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>self</em><br />
+    <span class="arg">ilist.</span>write(<span class=
+    "arg">file</span>) <span class="arg">[&nbsp;{ optional
+    arguments }&nbsp;]</span> -&gt; <em>self</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>If the image format <a href="imusage.html#formats">indicated
+    by the filename</a> supports multiple images per file (animated
+    images), <code>write</code> writes all the images in the
+    imagelist to a single file. Otherwise, <code>write</code>
+    writes each image to a separate file.</p>
+
+    <p>Regardless of the original format, <code>write</code>
+    converts the images to the format specified by the
+    filename.</p>
+
+    <p>If the imagelist contains more than one image and the output
+    format does not support multi-frame images, each image is
+    written to a file that has the filename you specify followed by
+    a period (.) and the scene number. You can change this behavior
+    by embedding a %d, %0Nd, %o, %0No, %x, or %0Nx printf format
+    specification in the file name.</p>
+
+    <h4>Arguments</h4>
+
+    <p>A filename or open file object. Indicate the desired image
+    <a href="imusage.html#formats">format</a> either by the suffix
+    (i.e. <code>.jpg</code>, <code>.png</code>) or the prefix
+    (<code>ps:</code>) to the filename. If the argument is an open
+    file object, you can specify a format for each image in the
+    list by setting its <a href="imageattrs.html#format">format</a>
+    attribute. (See the Notes section for <a href=
+    "image3.html#write">Image#write</a>.)</p>
+
+    <p>You can also specify optional arguments by setting <a href=
+    "info.html">Image::Info</a> attributes in an associated
+    block.</p>
+
+    <h4>Returns</h4>
+
+    <p>self, or <code>nil</code> if the format cannot be
+    determined.</p>
+
+    <h4>Example</h4>
+    <pre>
+# The PNG format does not support multi-frame files,
+# so each image is written to a separate file.
+i = Magick::ImageList.new "animated.gif"
+p i.length &raquo; 3 # contains 3 images
+i.write "test.png" &raquo; test.png.0
+                   &raquo; test.png.1
+                   &raquo; test.png.2
+# 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>
+
+    <h4>See also</h4>
+
+    <p><a href="image3.html#write">Image#write</a></p>
+
+    <h4>Magick API</h4>
+
+    <p>WriteImages</p>
+  </div>
+
+  <p class="spacer">&nbsp;</p>
+
+  <div class="nav">
+    &laquo;&nbsp;<a href="magick.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "imageattrs.html">Next</a>&nbsp;&raquo;
+  </div>
+</body>
+</html>