doc/ilist.html in rmagick-1.15.17 vs doc/ilist.html in rmagick-2.0.0
- old
+ new
@@ -2,13 +2,13 @@
"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 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" />
<meta name="Copyright" content=
"Copyright (C) 2005 by Timothy P. Hunter" />
@@ -18,21 +18,20 @@
<script type="text/javascript" src="scripts/doc.js">
</script>
</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">
« <a href="magick.html">Prev</a> | <a href=
"index.html">Contents</a> | <a href=
"imageattrs.html">Next</a> »
</div>
- <h1>class ImageList <span class="superclass"><
- 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>
<h3>class methods</h3>
@@ -71,10 +70,12 @@
<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>
@@ -96,17 +97,17 @@
<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="#morph">morph</a></li>
-
<li><a href="#mosaic">mosaic</a></li>
<li><a href="#new_image">new_image</a></li>
<li><a href="#optimize_layers">optimize_layers</a></li>
@@ -115,10 +116,12 @@
<li><a href="#quantize">quantize</a></li>
<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>
</ul>
</div>
@@ -210,14 +213,13 @@
<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/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>
<p>The number of iterations.</p>
@@ -285,14 +287,10 @@
<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>
- <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
</pre>
</div>
@@ -306,20 +304,20 @@
</div>
<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
updates the scene number to the new index. If the method
deletes the current image, the scene number is set to the last
@@ -373,11 +371,16 @@
</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.</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>,
and <code>rassoc</code> methods are not defined in the
ImageList class.</p>
@@ -533,21 +536,19 @@
"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"
- /><!--
+ "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>
<p>AverageImages</p>
</div>
@@ -561,11 +562,11 @@
<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>
+ original is propogated to the copy.</p>
<h4>Returns</h4>
<p>A new imagelist</p>
@@ -609,21 +610,90 @@
"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: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>) ->
+ <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>
<p><span class="arg">imagelist.</span>copy ->
<em>anImageList</em></p>
</div>
@@ -642,12 +712,14 @@
<h4>Example</h4>
<pre>
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">
<h3 id="cur_image">cur_image</h3>
@@ -687,11 +759,11 @@
<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
+ <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
and second image and stores just the changed rectangle of the
second image, along with the offset of the rectangle relative
@@ -796,15 +868,16 @@
"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></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">
<h3 id="from_blob">from_blob</h3>
@@ -1180,12 +1253,12 @@
<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 ×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>
<p>The default is no texture.</p>
@@ -1312,15 +1385,16 @@
"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>
+ "#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">
<h3 id="new_image">new_image</h3>
@@ -1378,99 +1452,199 @@
<p>Optimizes or compares the images in the list. Equivalent to
the <code>-layers</code> option in ImageMagick's
<code>mogrify</code> command.</p>
- <p>With the CompareAnyLayer, CompareClearLayer, and
- CompareOverlayLayer arguments, <code>optimize_layers</code>
- <span class="imquote">compares each image with the next in a
- sequence and returns the minimum bounding region of all the
- pixel differences (of the <code>LayerMethod</code> specified)
- it discovers.</span></p>
+ <p>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>
- <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>
+ <h4>Arguments</h4>
- <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>One of the following ImageLayerMethod enum values:</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>
+ <dl>
+ <dt>CoalesceLayer</dt>
- <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>
+ <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>
- <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>
+ <dt>CompareAnyLayer</dt>
- <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>
+ <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>
- <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>
+ <dt>CompareClearLayer</dt>
- <h4>Arguments</h4>
+ <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>
- <p>One of the following <code>MagickLayerMethod</code>
- values:</p>
+ <dt>CompareOverlayLayer</dt>
- <ul>
- <li>CoalesceLayer</li>
+ <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>
- <li>CompareAnyLayer</li>
+ <dt>DisposeLayer</dt>
- <li>CompareClearLayer</li>
+ <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>
- <li>CompareOverlayLayer</li>
+ <dt>FlattenLayer</dt>
- <li>DisposeLayer</li>
+ <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>
- <li>OptimizeLayer</li>
+ <dt>MosaicLayer</dt>
- <li>OptimizePlusLayer</li>
- </ul>
+ <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>
+
+ <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 (available in
- ImageMagick 6.2.6)</p>
+ <p>OptimizeImageLayers, CompareImageLayers</p>
</div>
<div class="sig">
<h3 id="ping">ping</h3>
@@ -1538,11 +1712,11 @@
<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">MaxRGB</a>.</dd>
+ "constants.html#Miscellaneous_constants">QuantumRange</a>.</dd>
<dt>colorspace</dt>
<dd class="imquote">The <a href=
"constants.html#ColorspaceType">colorspace</a> to quantize
@@ -1668,11 +1842,11 @@
<p>ReadImage</p>
<h4>Notes</h4>
- <p>You can create images using ×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>
<div class="sig">
@@ -1715,10 +1889,27 @@
<p>ImageListToBlob</p>
</div>
<div class="sig">
+ <h3 id="to_a">to_a</h3>
+
+ <p><span class="arg">imagelist</span>.to_a ->
+ <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>
<p><span class="arg">imagelist.</span>write(<span class=
"arg">filename</span>) <span class="arg">[ { optional
arguments } ]</span> -> <em>self</em><br />
@@ -1773,10 +1964,10 @@
i = Magick::ImageList.new "animated.gif"
p i.length » 3 # contains 3 images
i.write "test.png" » test.png.0
» test.png.1
» test.png.2
-# ×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" » animated.miff
</pre>
<h4>See also</h4>