rmagick 1.9.3 → 1.10.0

data/doc/draw.html

@@ -11,7 +11,7 @@
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
   <meta name="Copyright" content=
-  "Copyright (C) 2005 by Timothy P. Hunter" />
+  "Copyright (C) 2006 by Timothy P. Hunter" />
   <link rel="stylesheet" type="text/css" href="css/doc.css" />
 <script type="text/javascript" src="scripts/doc.js">
 </script>
@@ -680,7 +680,7 @@ title.annotate(montage, 0,0,0,40, 'Named Colors') {
     <p>A Magick::TypeMetric struct. This structure has the
     following attributes. (The descriptions are taken from the
     <a href=
-    "http://www.imagemagick.org/www/Magick++/TypeMetric.html">Magick++</a>
+    "http://www.imagemagick.org/Magick++/TypeMetric.html">Magick++</a>
     documentation and source code.)</p>
 
     <table summary="type metric attributes" class="simple_table">

data/doc/ex/crop_resized.rb

@@ -0,0 +1,10 @@
+#!/usr/local/bin/ruby -w
+require 'RMagick'
+
+# Demonstrate the crop_resize method
+
+img = Magick::Image.read('images/Flower_Hat.jpg')[0]
+thumbnail = img.crop_resized(76, 76)
+thumbnail.write("crop_resized.jpg")
+
+

data/doc/ex/get_type_metrics.rb

@@ -27,10 +27,11 @@ end     # class Draw
 
 
 Origin_x = 110
-Origin_y = 220
+Origin_y = 230
 Glyph = 'g'
+Face = ARGV[0] ? ARGV[0] : "Times"
 
-canvas = Image.new(410,300,HatchFill.new('white', 'lightcyan2'))
+canvas = Image.new(410,320,HatchFill.new('white', 'lightcyan2'))
 
 # Draw a big lowercase 'g' on the canvas. Leave room on all sides for
 # the labels. Use 'undercolor' to set off the glyph.
@@ -39,7 +40,7 @@ glyph.annotate(canvas, 0, 0, Origin_x, Origin_y, Glyph) do |opts|
     opts.pointsize = 124
     opts.stroke = 'none'
     opts.fill = 'black'
-    opts.font_family = 'Times'
+    opts.font_family = Face
     opts.undercolor = '#ffff00c0'
 end
 
@@ -47,11 +48,12 @@ end
 metrics = glyph.get_type_metrics(canvas, Glyph)
 
 gc = Draw.new
+gc.translate(Origin_x, Origin_y)
 
 # Draw the origin as a big red dot.
 gc.stroke('red')
 gc.fill('red')
-gc.circle(Origin_x, Origin_y, Origin_x, Origin_y+2)
+gc.circle(0, 0, 0, 2)
 
 # All our lines will be medium-gray, dashed, and thin.
 gc.stroke('gray50')
@@ -60,26 +62,27 @@ gc.stroke_width(1)
 gc.fill('none')
 
 # baseline
-gc.line(Origin_x-10, Origin_y, Origin_x+metrics.width+20, Origin_y)
+gc.line(-10, 0, metrics.width+20, 0)
 
 # a vertical line through the origin
-gc.line(Origin_x, 30, Origin_x, 270)
+gc.line(0, -metrics.descent-metrics.height-10, 0, -metrics.descent+15)
 
 # descent
-gc.line(Origin_x-10, Origin_y-metrics.descent, Origin_x+metrics.width+20, Origin_y-metrics.descent)
+gc.line(-10, -metrics.descent, metrics.width+20, -metrics.descent)
 
 # ascent
-gc.line(Origin_x-10, Origin_y-metrics.ascent, Origin_x+metrics.width+20, Origin_y-metrics.ascent)
+gc.line(-10, -metrics.ascent, metrics.width+20, -metrics.ascent)
 
 # height
-gc.line(Origin_x-10, Origin_y-metrics.height, Origin_x+metrics.width+10, Origin_y-metrics.height)
+gc.line(-10, -metrics.descent-metrics.height,
+        metrics.width+10, -metrics.descent-metrics.height)
 
 # width
-gc.line(Origin_x+metrics.width, 30, Origin_x+metrics.width, 270)
+gc.line(metrics.width, -metrics.descent-metrics.height-10,
+        metrics.width, -metrics.descent+20)
 
 # max_advance
-gc.line(Origin_x+metrics.max_advance, Origin_y-metrics.descent-10,
-        Origin_x+metrics.max_advance, 270)
+gc.line(metrics.max_advance, -10, metrics.max_advance, -metrics.descent+20)
 
 gc.draw(canvas)
 
@@ -91,36 +94,37 @@ gc.pointsize(13)
 gc.fill('none')
 gc.stroke('black')
 gc.stroke_width(1)
+gc.translate(Origin_x, Origin_y)
 
 # between origin and descent
 gc.push
-gc.translate(Origin_x+metrics.width+23, Origin_y)
+gc.translate(metrics.width+23, 0)
 gc.brace(10, metrics.descent)
 gc.pop
 
 # between origin and ascent
 gc.push
-gc.translate(Origin_x+metrics.width+23, Origin_y)
+gc.translate(metrics.width+23, 0)
 gc.brace(10, metrics.ascent)
 gc.pop
 
 # between origin and height
 gc.push
-gc.translate(Origin_x-13, Origin_y-metrics.height)
+gc.translate(-13, -metrics.descent-metrics.height)
 gc.rotate(180)
 gc.brace(10, metrics.height)
 gc.pop
 
 # between origin and width
 gc.push
-gc.translate(Origin_x+metrics.width, 27.0)
+gc.translate(metrics.width, -metrics.descent-metrics.height-10-3)
 gc.rotate(-90)
 gc.brace(10, metrics.width)
 gc.pop
 
 # between origin and max_advance
 gc.push
-gc.translate(Origin_x, Origin_y-metrics.descent+14)
+gc.translate(0, -metrics.descent+15)
 gc.rotate(90)
 gc.brace(10, metrics.max_advance)
 gc.pop
@@ -128,11 +132,11 @@ gc.pop
 # Add labels
 gc.stroke('none')
 gc.fill('black')
-gc.text(Origin_x+metrics.width+40, Origin_y-(metrics.ascent/2)+4, 'ascent')
-gc.text(Origin_x+metrics.width+40, Origin_y-(metrics.descent/2)+4, 'descent')
-gc.text(Origin_x-60, Origin_y-metrics.height/2+4, 'height')
-gc.text(Origin_x+(metrics.width/2)-15, 15, 'width')
-gc.text(Origin_x+(metrics.max_advance)/2-38, 290, "max_advance")
+gc.text(metrics.width+40, -(metrics.ascent/2)+4, 'ascent')
+gc.text(metrics.width+40, -(metrics.descent/2)+4, 'descent')
+gc.text(-60, -metrics.descent-metrics.height/2+4, 'height')
+gc.text((metrics.width/2)-15, -metrics.descent-metrics.height-25, 'width')
+gc.text((metrics.max_advance)/2-38, -metrics.descent+35, "max_advance")
 
 gc.draw(canvas)
 canvas.border!(1,1,'blue')

data/doc/ex/vignette.rb

@@ -0,0 +1,19 @@
+#! /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
+
+begin
+    vignette = img.vignette
+rescue NotImplementedError
+    vignette = Magick::Image.read('images/notimplemented.gif').first
+    vignette.resize!(img.columns, img.rows)
+end
+
+vignette.write('vignette.jpg')
+
+exit

data/doc/ilist.html

@@ -895,11 +895,6 @@ scene=1
 
     <p><a href="image2.html#inspect">Image#inspect</a></p>
 
-    <h4>Magick API</h4>
-
-    <p>The description is essentially the same as that provided by
-    <a href=
-    "http://www.imagemagick.org/www/api/image.html#describeimage">DescribeImageList</a></p>
   </div>
 
   <div class="sig">

data/doc/image1.html

@@ -4,7 +4,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
   <meta name="generator" content=
-  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
+  "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
 
   <title>RMagick: class Image (class and instance methods, part
   1)</title>
@@ -12,7 +12,7 @@
   "text/html; charset=us-ascii" />
   <meta name="GENERATOR" content="Quanta Plus" />
   <meta name="Copyright" content=
-  "Copyright (C) 2005 by Timothy P. Hunter" />
+  "Copyright (C) 2006 by Timothy P. Hunter" />
   <link rel="stylesheet" type="text/css" href="css/doc.css" />
 <script type="text/javascript" src="scripts/doc.js">
 </script>
@@ -97,6 +97,9 @@ float: left;
 
           <li><a href="#add_noise">add_noise</a></li>
 
+          <li><a href=
+          "#add_noise_channel">add_noise_channel</a></li>
+
           <li><a href="#affine_transform">affine_transform</a></li>
 
           <li><a href="#annotate">annotate</a></li>
@@ -157,14 +160,14 @@ float: left;
           <li><a href="#composite_bang">composite!</a></li>
 
           <li><a href="#composite_affine">composite_affine</a></li>
+
+          <li><a href=
+          "#compress_colormap_bang">compress_colormap!</a></li>
         </ul>
       </div>
 
       <div class="toccol">
         <ul>
-          <li><a href=
-          "#compress_colormap_bang">compress_colormap!</a></li>
-
           <li><a href="#contrast">contrast</a></li>
 
           <li><a href="#convolve">convolve</a></li>
@@ -177,6 +180,10 @@ float: left;
 
           <li><a href="#crop_bang">crop!</a></li>
 
+          <li><a href="#crop_resized">crop_resized</a></li>
+
+          <li><a href="#crop_resized_bang">crop_resized!</a></li>
+
           <li><a href="#cycle_colormap">cycle_colormap</a></li>
 
           <li><a href="#despeckle">despeckle</a></li>
@@ -187,7 +194,8 @@ float: left;
 
           <li><a href="#display">display</a></li>
 
-          <li><a href="#distortion_channel">distortion_channel</a></li>
+          <li><a href=
+          "#distortion_channel">distortion_channel</a></li>
 
           <li><a href="#dup">dup</a></li>
 
@@ -766,7 +774,7 @@ img = Magick::Image.read_inline(content)
     <h3 id="add_noise">add_noise</h3>
 
     <p><span class="arg">image</span>.add_noise(<span class=
-    "arg">aNoiseType</span>) -&gt; <em>anImage</em></p>
+    "arg">noise_type</span>) -&gt; <em>anImage</em></p>
   </div>
 
   <div class="desc">
@@ -779,7 +787,7 @@ img = Magick::Image.read_inline(content)
     <h4>Arguments</h4>
 
     <p>A <a href="constants.html#NoiseType">NoiseType</a>
-    constant.</p>
+    value.</p>
 
     <h4>Returns</h4>
 
@@ -790,8 +798,8 @@ img = Magick::Image.read_inline(content)
     <div class="noise_example_wrapper">
       <a href="javascript:popup('add_noise.rb.html')"><img src=
       "ex/images/Flower_Hat.jpg" alt="add_noise example" id=
-      "add_noise_example" title=
-      "Click to see the example script" /></a>
+      "add_noise_example" title="Click to see the example script"
+       /></a>
 
       <p>Click the NoiseType to see the effect.</p>
 
@@ -823,6 +831,54 @@ img = Magick::Image.read_inline(content)
     <h4>Magick API</h4>
 
     <p>AddNoiseImage</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#add_noise_channel">add_noise_channel</a></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="add_noise_channel">add_noise_channel</h3>
+
+    <p>image.add_noise_channel(<span class="arg">noise_type</span>
+    [,<span class="arg">channel</span>...]) -&gt;
+    <em>anImage</em></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Adds random noise to the specified channel or channels in
+    the image.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>noise_type</dt>
+
+      <dd>A <a href="constants.html#NoiseType">NoiseType</a>
+      value.</dd>
+
+      <dt>channel...</dt>
+
+      <dd>0 or more <a href=
+      "constants.html#ChannelType">ChannelType</a> arguments. If no
+      channels are specified, adds noise to all the channels.
+      Specifying no channel arguments has the same effect as the
+      <code>add_noise</code> method, above.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>A new image</p>
+
+    <h4>Magick API</h4>
+
+    <p>AddNoiseImageChannel (available in ImageMagick 6.2.5)</p>
+
+    <h4>See also</h4>
+
+    <p><a href="#add_noise">add_noise</a></p>
   </div>
 
   <div class="sig">
@@ -905,7 +961,8 @@ img = Magick::Image.read_inline(content)
     <h3 id="bilevel_channel">bilevel_channel</h3>
 
     <p><span class="arg">image</span>.bilevel_channel(<span class=
-    "arg">threshold</span> [,<span class="arg">channel...</span>]) = <em>aNewImage</em></p>
+    "arg">threshold</span> [,<span class="arg">channel...</span>])
+    = <em>aNewImage</em></p>
   </div>
 
   <div class="desc">
@@ -964,7 +1021,8 @@ img = Magick::Image.read_inline(content)
 
     <p><span class="arg">image</span>.blur_channel(<span class=
     "arg">radius=0.0</span>, <span class=
-    "arg">sigma=1.0</span><span class="arg">[, channel...]]</span>) -&gt; <em>anImage</em></p>
+    "arg">sigma=1.0</span><span class="arg">[, channel...]]</span>)
+    -&gt; <em>anImage</em></p>
   </div>
 
   <div class="desc">
@@ -1144,12 +1202,13 @@ img = Magick::Image.read_inline(content)
     "padding: 10px; display: none;" id="borderless" onmouseout=
     "this.style.display='none'; bordered.style.display='';" src=
     "ex/images/Flower_Hat.jpg" alt="border example" title=
-    "Click to see the example script" /> <img id="bordered"
-    onmouseover=
+    "Click to see the example script"  /> <img id=
+    "bordered" onmouseover=
     "this.style.display='none'; borderless.style.display='';" src=
-    "ex/border.jpg" alt="border example" /></a><img src=
-    "ex/images/spin.gif" alt="" class="spin" style="left: 224px;"
-    title="Mouse over the example to see the original image" /></p>
+    "ex/border.jpg" alt="border example"
+     /></a><img src="ex/images/spin.gif" alt="" class=
+    "spin" style="left: 224px;" title=
+    "Mouse over the example to see the original image" /></p>
 
     <h4>See also</h4>
 
@@ -1265,7 +1324,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h4>Arguments</h4>
 
     <p>A <a href="constants.html#ChannelType">ChannelType</a>
-    constant.</p>
+    value.</p>
 
     <h4>Returns</h4>
 
@@ -1294,8 +1353,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h3 id="channel_depth">channel_depth</h3>
 
     <p><span class="arg">image</span>.channel_depth([<span class=
-    "arg">channel</span>...])
-    -&gt; <em>aNumeric</em></p>
+    "arg">channel</span>...]) -&gt; <em>aNumeric</em></p>
   </div>
 
   <div class="desc">
@@ -1310,7 +1368,7 @@ mona.change_geometry!('320x240') { |cols, rows, img|
       <dt>channel...</dt>
 
       <dd>Zero or more <a href=
-      "constants.html#ChannelType">ChannelType</a> constants. If no
+      "constants.html#ChannelType">ChannelType</a> values. If no
       arguments are specified, the default is all channels.</dd>
     </dl>
 
@@ -1332,8 +1390,8 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h3 id="channel_extrema">channel_extrema</h3>
 
     <p><span class="arg">image</span>.channel_extrema([<span class=
-    "arg">channel</span>...])
-    -&gt; <em>[aNumeric, aNumeric]</em></p>
+    "arg">channel</span>...]) -&gt; <em>[aNumeric,
+    aNumeric]</em></p>
   </div>
 
   <div class="desc">
@@ -1375,8 +1433,8 @@ mona.change_geometry!('320x240') { |cols, rows, img|
     <h3 id="channel_mean">channel_mean</h3>
 
     <p><span class="arg">image</span>.channel_mean([<span class=
-    "arg">channel</span>...])
-    -&gt; <em>[aNumeric, aNumeric]</em></p>
+    "arg">channel</span>...]) -&gt; <em>[aNumeric,
+    aNumeric]</em></p>
   </div>
 
   <div class="desc">
@@ -1913,9 +1971,8 @@ f.color_reset!(red)
 
       <dt>metric</dt>
 
-      <dd>
-        The desired distortion metric. A <a href="constants.html#MetricType">MetricType</a> value.
-      </dd>
+      <dd>The desired distortion metric. A <a href=
+      "constants.html#MetricType">MetricType</a> value.</dd>
 
       <dt>channel...</dt>
 
@@ -1935,8 +1992,8 @@ f.color_reset!(red)
     <h4>See also</h4>
 
     <p><a href="#difference">difference</a>, <a href=
-    "#spaceship">&lt;=&gt;</a>,
-    <a href="#distortion_channel">distortion_channel</a></p>
+    "#spaceship">&lt;=&gt;</a>, <a href=
+    "#distortion_channel">distortion_channel</a></p>
 
     <h4>Magick API</h4>
 
@@ -1996,7 +2053,7 @@ f.color_reset!(red)
 
           <dd>A <a href=
           "constants.html#CompositeOperator">CompositeOperator</a>
-          constant.</dd>
+          value.</dd>
         </dl>
       </dd>
 
@@ -2014,7 +2071,7 @@ f.color_reset!(red)
 
           <dd>
             A <a href="constants.html#GravityType">GravityType</a>
-            constant that specifies the location of <em>img</em> on
+            value that specifies the location of <em>img</em> on
             <em>image</em>:
 
             <dl>
@@ -2069,7 +2126,7 @@ f.color_reset!(red)
 
           <dd>A <a href=
           "constants.html#CompositeOperator">CompositeOperator</a>
-          constant.</dd>
+          value.</dd>
         </dl>
       </dd>
 
@@ -2086,7 +2143,7 @@ f.color_reset!(red)
           <dt>gravity</dt>
 
           <dd>A <a href=
-          "constants.html#GravityType">GravityType</a> constant. If
+          "constants.html#GravityType">GravityType</a> value. If
           the argument is NorthEastGravity, EastGravity, or
           SouthEastGravity, the x-offset is measured from the right
           side of the image. If the argument is SouthEastGravity,
@@ -2104,7 +2161,7 @@ f.color_reset!(red)
 
           <dd>A <a href=
           "constants.html#CompositeOperator">CompositeOperator</a>
-          constant.</dd>
+          value.</dd>
         </dl>
       </dd>
     </dl>
@@ -2330,7 +2387,8 @@ f.colors &raquo; 108
 
     <p><span class="arg">image</span>.convolve_channel(<span class=
     "arg">order</span>, <span class="arg">kernel</span> [,
-    <span class="arg">channel</span>...]) -&gt; <em>anImage</em></p>
+    <span class="arg">channel</span>...]) -&gt;
+    <em>anImage</em></p>
   </div>
 
   <div class="desc">
@@ -2451,7 +2509,7 @@ f2 = f.copy
 
           <dd>
             A <a href="constants.html#GravityType">GravityType</a>
-            constant specifying the position of the rectangle.
+            value specifying the position of the rectangle.
 
             <dl>
               <dt>NorthWestGravity</dt>
@@ -2515,7 +2573,7 @@ f2 = f.copy
           <dt>gravity</dt>
 
           <dd>A <a href=
-          "constants.html#GravityType">GravityType</a> constant. If
+          "constants.html#GravityType">GravityType</a> value. If
           the argument is NorthEastGravity, EastGravity, or
           SouthEastGravity, the <em>x-</em>offset is measured from
           the right side of the image. If the argument is
@@ -2608,6 +2666,102 @@ cropped = img.crop(x, y, width, height, true)
     <p>self</p>
   </div>
 
+  <div class="sig">
+    <h3 id="crop_resized">crop_resized</h3>
+
+    <p><span class="arg">image</span>.crop_resized(<span class=
+    "arg">width</span>, <span class="arg">height</span>,
+    <span class=
+    "arg">gravity</span>=<code>Magick::CenterGravity</code>) -&gt;
+    <span class="arg">anImage</span></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>
+
+    <p>Creates an image with the size specified by <span class=
+    "arg">width</span> and <span class="arg">height</span> having
+    the same aspect ratio as the target image. Use
+    <code>crop_resized</code> to produce a thumbnail image with an
+    exact size.</p>
+
+    <p>If necessary, <code>crop_resized</code> resizes the image
+    such that its smaller dimension exactly fits the rectangle
+    specified by <span class="arg">width</span> and <span class=
+    "arg">height</span>. If the resulting image exceeds the
+    rectangle's size in the image's larger dimension,
+    <code>crop_resized</code> crops the image to fit the rectangle
+    exactly. Use <span class="arg">gravity</span> to specify which
+    portion of the image to crop.</p>
+
+    <h4>Arguments</h4>
+
+    <dl>
+      <dt>width</dt>
+
+      <dd>The width of the resulting image in pixels</dd>
+
+      <dt>height</dt>
+
+      <dd>The height of the resulting image in pixels</dd>
+
+      <dt>gravity</dt>
+
+      <dd>Use this argument to specify which portion of the image
+      to retain when cropping. The value can be any <a href=
+      "constants.html#GravityType">GravityType</a> value. The
+      effect is the same as the <span class="arg">gravity</span>
+      argument to the <a href="#crop"><code>crop</code></a> method.
+      The default is <code>CenterGravity</code>.</dd>
+    </dl>
+
+    <h4>Returns</h4>
+
+    <p>A new image</p>
+
+    <h4>Example</h4>
+
+    <p>In this example, some rows have been cropped from the top
+    and bottom to produce a square thumbnail from a rectangular
+    image without distorting the image.</p>
+
+    <p class="rollover"><a href=
+    "javascript:popup('crop_resized.rb.html')">
+    <!-- This img tag displays the original image when the mouse is over -->
+     <img id="cropless" style="display: none" onmouseout=
+    "this.style.display='none';cropped.style.display='';" src=
+    "ex/images/Flower_Hat.jpg" alt="crop_resize example" title=
+    "Click to see the example script"  />
+    <!--  This img tag displays the framed image when the mouse is not over-->
+     <img style=
+    "padding-left:62px; padding-right: 62px; padding-top: 87px;padding-bottom:87px;"
+    id="cropped" onmouseover=
+    "this.style.display='none';cropless.style.display='';" src=
+    "ex/crop_resized.jpg" alt="frame example"  /></a>
+    <img src="ex/images/spin.gif" alt="" style=
+    "margin-bottom: 230px" title=
+    "Mouse over the example to see the original image" /></p>
+  </div>
+
+  <div class="sig">
+    <h3 id="crop_resize_bang">crop_resized!</h3>
+
+    <p><span class="arg">image</span>.crop_resized!(<span class=
+    "arg">width</span>, <span class="arg">height</span>,
+    <span class=
+    "arg">gravity</span>=<code>Magick::CenterGravity</code>) -&gt;
+    <span class="arg">image</span></p>
+  </div>
+
+  <div class="desc">
+    <h4>Description</h4>The in-place form of <a href=
+    "#crop_resized">crop_resized</a>.
+
+    <h4>Returns</h4>
+
+    <p>self</p>
+  </div>
+
   <div class="sig">
     <h3 id="cycle_colormap">cycle_colormap</h3>
 
@@ -2860,24 +3014,34 @@ exit
   </div>
 
   <div class="sig">
-      <h3 id="distortion_channel">distortion_channel</h3>
-    <p><span class="arg">image</span>.distortion_channel(<span class="arg">reconstructed_image</span>, <span class="arg">metric</span>[, <span class="arg">channel</span>...]) -&gt; <em>aFloat</em></p>
+    <h3 id="distortion_channel">distortion_channel</h3>
+
+    <p><span class=
+    "arg">image</span>.distortion_channel(<span class=
+    "arg">reconstructed_image</span>, <span class=
+    "arg">metric</span>[, <span class="arg">channel</span>...])
+    -&gt; <em>aFloat</em></p>
   </div>
 
   <div class="desc">
-      <h4>Description</h4>
-    <p class="imquote">(C)ompares one or more image channels of an image to a reconstructed image and returns the specified distortion metric.</p>
+    <h4>Description</h4>
+
+    <p class="imquote">(C)ompares one or more image channels of an
+    image to a reconstructed image and returns the specified
+    distortion metric.</p>
+
     <h4>Arguments</h4>
+
     <dl>
-    <dt>reconstructed_image</dt>
+      <dt>reconstructed_image</dt>
+
       <dd>Either an imagelist or an image. If an imagelist, uses
       the current image.</dd>
 
       <dt>metric</dt>
 
-      <dd>
-        The desired distortion metric. A <a href="constants.html#MetricType">MetricType</a> value.
-      </dd>
+      <dd>The desired distortion metric. A <a href=
+      "constants.html#MetricType">MetricType</a> value.</dd>
 
       <dt>channel...</dt>
 
@@ -2887,12 +3051,18 @@ exit
       distortion value. If no channels are specified, compares all
       channels.</dd>
     </dl>
+
     <h4>Returns</h4>
+
     <h4>Magick API</h4>
-    <p>GetImageChannelDistortion (available in ImageMagick 6.2.0)</p>
+
+    <p>GetImageChannelDistortion (available in ImageMagick
+    6.2.0)</p>
+
     <h4>See also</h4>
-    <p><a href="#compare_channel">compare_channel</a>,
-    <a href="#difference">difference</a></p>
+
+    <p><a href="#compare_channel">compare_channel</a>, <a href=
+    "#difference">difference</a></p>
   </div>
 
   <div class="sig">