rdp-rmagick 0.0.0

data/README-Mac-OSX.txt

@@ -0,0 +1 @@
+For installation instructions see http://rmagick.rubyforge.org/install-osx.html

data/README.md

@@ -0,0 +1,231 @@
+h1. RMagick 0.0.0$ README
+
+h2. YY/MM/DD
+
+h3. Table of Contents
+
+* "Introduction":#intro
+* "Prerequisites":#prereq
+* "Installing RMagick":#install
+* "Configuration Options":#config
+* "Things that can go wrong":#wrong
+* "Upgrading":#upgrade
+* "Uninstalling":#uninstall
+* "More samples":#samples
+* "Reporting Bugs":#bugs
+* "Contact Information":#contact
+* "Credits":#credits
+* "License":#license
+
+h2(#intro). Introduction
+
+RMagick is an interface between the Ruby programming language and the
+ImageMagick image processing library.
+
+h2(#prereq). Prerequisites
+
+*O/S* Linux, *BSD, OS X, Windows 2000, XP, Vista, other *nix-like systems.
+
+*Ruby* Version 1.8.2 or later. You can get Ruby from "www.ruby-lang.org":http://www.ruby-lang.org.
+The use of versions of Ruby older than 1.8.4 with RMagick is deprecated. Support will be
+removed in a future release.
+
+*ImageMagick* Version 6.3.0 or later. You can get ImageMagick from "www.imagemagick.org":http://www.imagemagick.org.
+
+h2(#install). Installing RMagick
+
+First install ImageMagick. Complete and up-to-date instructions for installing
+ImageMagick on Linux, *BSD, and other *nix-type O/S's are available
+"here":http://rmagick.rubyforge.org/install-linux.html. Use steps 0, 1, and 2.
+Similarly, instructions for installing ImageMagick using MacPorts on OS X
+are available "here":http://rmagick.rubyforge.org/install-osx.html. Use steps
+1 and 2.
+
+This release of RMagick uses Minero Aoki's setup.rb script for installation.
+See the next section for configuration options. Usually you do not need to
+specify any of these options. You can get more information about setup.rb from
+his "web site":<http://i.loveruby.net.
+
+I assume you've already decompressed the tarball, or you wouldn't be reading
+this. If you have not decompressed the tarball, do so with one of these commands,
+depending on which tarball you have:
+
+<pre>
+    tar xvzf RMagick-0.0.0$-tar.gz              (gzipped tarball)
+    tar xvjf RMagick-0.0.0$-tar.bz2             (bzipped tarball)
+    7z e RMagick-x.y.z.tar.lzma -so | tar xv    (7zipped tarball)
+</pre>
+
+Change to the RMagick-0.0.0 directory. If you are not using any
+configuration options (usually you don't need to) enter the command
+
+<pre>
+   ruby setup.rb
+</pre>
+
+Note that setup.rb executes all the example programs, so this can take
+some time.  This process both builds the example images used in the
+documentation and validates your RMagick installation.
+
+After this command completes, make sure you have root privileges (that
+is, login as root or use su or sudo) and enter the command
+
+<pre>
+    ruby setup.rb install
+</pre>
+
+h2(#config). Configuration options
+
+Type @ruby setup.rb --help@ to see a list of configuration options.  In
+addition to the regular options, there are a few RMagick-specific options:
+
+h4. --doc-dir=directory
+
+Specify the directory to install the RMagick documentation.
+By default this is $prefix/share/RMagick, where $prefix is the
+prefix specified by --prefix. For example, to install the
+documentation in /Users/me/RMagick, specify:
+
+<pre>
+    ruby setup.rb --doc-dir=/Users/me/RMagick
+</pre>
+
+h4. --allow-example-errors
+
+Normally the documentation installation terminates if 5 examples fail.
+If you use this option, the installation does not check for failing
+examples and will always complete. This option is useful if you're
+having trouble installing RMagick and you want to see all the failing examples.
+
+h4. -- disable-htmldoc
+
+By default the install process runs all the RMagick example programs and
+generates HTML versions of all the examples.  This option causes the
+install process to skip this step.  No install verification will take
+place and no documentation will be installed.
+
+h2(#wrong). Things that can go wrong
+
+The "RMagick installation FAQ":http://rmagick.rubyforge.org/install-faq.html
+has answers to the most commonly reported problems.
+
+h4. Can't install RMagick. Can't find libMagick or one of the dependent libraries. Check the mkmf.log file for more detailed information.
+
+Typically this message means that one or more of the libraries that ImageMagick
+depends on hasn't been installed. Examine the mkmf.log file in the ext/RMagick
+subdirectory of the installation directory for any error messages. These messages
+typically contain enough additional information for you to be able to diagnose
+the problem. Also see "this FAQ":http://rmagick.rubyforge.org/install-faq.html#libmagick.
+
+h4. Cannot open shared object file
+
+If you get a message like this:
+
+<pre>
+    $DIR/RMagick.rb:11:in `require': libMagick.so.0:
+      cannot open shared object file: No such file or directory -
+      $DIR/RMagick2.so (LoadError)
+</pre>
+
+you probably do not have the directory in which the ImageMagick library
+is installed in your load path.  An easy way to fix this is to define
+the directory in the LD_LIBRARY_PATH environment variable.  For
+example, suppose you installed the ImageMagick library libMagick.so in
+/usr/local/lib.  (By default this is where it is installed.) Create the
+LD_LIBRARY_PATH variable like this:
+
+<pre>
+        export LD_LIBRARY_PATH=/usr/local/lib
+</pre>
+
+On Linux, see @ld(1)@ and @ld.so(8)@ for more information. On other operating
+systems, see the documentation for the dynamic loading facility.
+
+h4. No such file or directory - "/tmp/rmagick6872.6"
+
+When setup.rb is running the examples, if you get a message like this:
+
+<pre>
+    hook /home/me/src/RMagick-0.0.0/./post-setup.rb failed:
+    No such file or directory - "/tmp/rmagick6872.6"
+</pre>
+
+you probably do not have a temporary directory environment variable set. Set
+the TMPDIR environment variable to your temporary directory. For example:
+
+<pre>
+    export TMPDIR=/home/me/tmp
+</pre>
+
+
+h2(#upgrade). Upgrading
+
+If you upgrade to a newer release of ImageMagick, make sure you're using a
+release of RMagick that supports that release. It's safe to install a new
+release of RMagick over an earlier release.
+
+h2(#uninstall). Uninstalling
+
+The uninstall.rb script will uninstall RMagick completely. Make sure you
+have administrator priviledges. Then run this command:
+
+<pre>
+    ruby uninstall.rb
+</pre>
+
+h2(#samples). More samples
+
+You can find more sample RMagick programs in the /example directory.
+These programs are not installed in the RMagick documentation tree.
+
+h2(#bugs). Reporting bugs
+
+Please report bugs in RMagick, its documentation, or its installation
+programs to me via the bug tracker on the "RMagick project page":http://rubyforge.org/projects/rmagick.
+However, I can't help with Ruby installation and configuration or ImageMagick
+installation and configuration. Information about reporting problems and
+getting help for ImageMagick is available at the "ImageMagick web site":http://www.imagemagick.org
+or the "ImageMagick Forum":http://www.imagemagick.org/discourse-server.
+
+h2(#contact). Contact Information
+
+*Author:* Tim Hunter, Omer Bar-or, Benjamin Thomas
+
+*Email:* "rmagick@rubyforge.org":mailto:rmagick@rubyforge.org
+
+*Web site:* "http://rmagick.rubyforge.org":http://rmagick.rubyforge.org
+
+h2(#credits). Credits
+
+Thanks to "ImageMagick Studio LLC":http://www.imagemagick.org for ImageMagick
+and for hosting the RMagick documentation.
+
+h2(#license). License
+
+<pre>
+Copyright &copy; 2002-2009 by Timothy P. Hunter
+
+Changes since Nov. 2009 copyright &copy; by Benjamin Thomas and Omer Bar-or
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+</pre>
+
+<hr>
+This file is marked up using "Textile":http://hobix.com/textile/ and converted
+to HTML with "RedCloth":http://whytheluckystiff.net/ruby/redcloth/.

data/build_tarball.rake

@@ -0,0 +1,215 @@
+
+# Build the tar.gz, tar.bz2, and .gem files for an RMagick Release
+# Expects the CVS tag for release RMagick x.y.z to be in the form RMagick_x-y-z.
+# To use: cd to $HOME
+# run:    rake -f path/to/build_tarball.rake clean
+#         rake -f path/to/build_tarball.rake release=tag beta=whatever
+#
+# Specify the release as release=RMagick_x-y-z or nothing if release=HEAD
+# Specify a beta Release as beta=beta1
+
+require 'rubygems'
+require 'redcloth'
+require 'find'
+require 'fileutils'
+include FileUtils
+
+
+CVSSERVER = ":ext:rmagick@rubyforge.org/var/cvs/rmagick"
+
+
+# CVS_Tag is the CVS tag for this release. Dist_Directory is CVS_Tag,
+# modified for use as a directory name.
+if ENV.include?("release")
+  CVS_Tag = ENV["release"]
+  Dist_Directory = CVS_Tag.tr('_-','-.')
+else
+  CVS_Tag = "HEAD"
+  Dist_Directory = "RMagick-0.0.0"
+end
+
+
+# RMagick_Version is just X.Y.Z
+RMagick_Version = Dist_Directory.sub(/RMagick-/, "")
+
+# RMagick_Version2 is X.Y.Z + "-beta1" if beta=beta1
+RMagick_Version2 = RMagick_Version + (ENV.include?("beta") ? "-" + ENV["beta"] : "")
+
+# Release is RMagick-X.Y.Z, plus "-beta1" if beta=beta1
+Release = Dist_Directory + (ENV.include?("beta") ? "-" + ENV["beta"] : "")
+
+README = "README.html"
+MANIFEST = "ext/RMagick/MANIFEST"
+
+
+
+
+# Change the version number placeholders in a file.
+# Returns an array of lines from the file.
+def reversion(name)
+  now = Time.new
+  now = now.strftime("%m/%d/%y")
+
+  lines = File.readlines name
+  lines.each do |line|
+    line.gsub!(%r{0\.0\.0\$}, RMagick_Version2)
+    line.gsub!(%r{0\.0\.0}, RMagick_Version)
+    line.gsub!(%r{YY/MM/DD}, now)
+  end
+  lines
+end
+
+
+
+
+# Rewrite a file containing embedded version number placeholders.
+def reversion_file(name)
+  lines = reversion(name)
+  tmp_name = name + "_tmp"
+  mv name, tmp_name
+  begin
+    File.open(name, "w") { |f| lines.each { |line| f.write line } }
+  rescue
+    mv tmp_name, name
+  ensure
+    rm tmp_name
+  end
+end
+
+
+
+
+task :extconf do
+  Dir.chdir(Dist_Directory) { reversion_file "ext/RMagick/extconf.rb" }
+end
+
+
+
+
+task :gemspec do
+  Dir.chdir(Dist_Directory) { reversion_file "rmagick.gemspec" }
+end
+
+
+
+
+task "README.txt" do
+  Dir.chdir Dist_Directory do
+    reversion_file "README.rc"
+    body = File.readlines "README.rc"
+    body = RedCloth.new(body.join).to_html + "\n"
+    File.open("README.txt", "w") { |f| f.write body }
+  end
+end
+
+
+
+
+task README => "README.txt" do
+  puts "writing #{README}"
+  Dir.chdir Dist_Directory do
+    File.open(README, "w") do |html|
+      html.write <<END_HTML_HEAD
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <title>RMagick #{RMagick_Version2} README</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+    <meta name="GENERATOR" content="RedCloth">
+  </head>
+  <body>
+END_HTML_HEAD
+      html.write File.readlines("README.txt")
+      html.write <<END_HTML_TAIL
+  </body>
+</html>
+END_HTML_TAIL
+    end
+  end
+end
+
+
+
+
+task :doc do
+  Dir.chdir(File.join(Dist_Directory, "doc")) do
+      FileList["*.html"].each { |d| reversion_file(d) }
+  end
+end
+
+
+
+
+# Remove files we don't want in the tarball.
+# Ensure files are not executable. (ref: bug #10080)
+task :fix_files do
+    Dir.chdir Dist_Directory do
+        rm_rf "test", :verbose => true
+        rm "lib/rvg/to_c.rb", :verbose => true
+        rm "README.rc", :verbose => true
+        rm "README.txt", :verbose => true
+        chmod 0644, FileList["doc/*.html", "doc/ex/*.rb", "doc/ex/images/*", "examples/*.rb"]
+    end
+end
+
+
+
+
+task :manifest do
+  now = Time.new
+  now = now.strftime("%H:%M:%S %m/%d/%y")
+  puts "generating #{MANIFEST}"
+
+  Dir.chdir Dist_Directory do
+    File.open(MANIFEST, "w") do |f|
+      f.puts "MANIFEST for #{Release} - #{now}\n\n"
+      Find.find('.') do |name|
+        next if File.directory? name
+        f.puts name[2..-1]    # remove leading "./"
+      end
+    end
+  end
+end
+
+
+
+
+task :export do
+  sh "cvs -d#{CVSSERVER}  export -r #{CVS_Tag} -d #{Dist_Directory} RMagick"
+end
+
+
+
+
+task :collateral => [README, :gemspec, :extconf, :doc]
+
+GEM = Dist_Directory.downcase + ".gem"
+
+task :default => [:export, :collateral, :fix_files, :manifest] do
+  sh "tar czf #{Release}.tar.gz #{Dist_Directory}"
+  sh "tar cjf #{Release}.tar.bz2 #{Dist_Directory}"
+  sh "tar c #{Release} | 7z a -t7z -m0=lzma -mx=9 -mfb=64 -ms=on -si#{Release}.tar #{Release}.tar.lzma"
+
+  # Extract with
+  #   7z e RMagick-x.y.z.tar.lzma -so | tar xv
+  #sh "tar cf  #{Release}.tar #{Dist_Directory}"
+  #sh "7z a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on #{Release}.tar.lzma #{Release}.tar"
+  #rm_rf Release+".tar", :verbose => true
+
+  Dir.chdir(Dist_Directory) do
+    sh "gem build rmagick.gemspec"
+    mv GEM, "../", :verbose => true
+  end
+end
+
+
+
+
+task :clean do
+  rm_rf Dist_Directory, :verbose => true
+  rm_rf Release+".tar.gz", :verbose => true
+  rm_rf Release+".tar.bz2", :verbose => true
+  rm_rf Release+".tar.lzma", :verbose => true
+  rm_rf GEM, :verbose => true
+end
+

data/doc/comtasks.html

@@ -0,0 +1,287 @@
+<!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 1 September 2005), see www.w3.org" />
+
+  <title>RMagick 0.0.0: Common Tasks</title>
+  <meta http-equiv="Content-Type" content=
+  "text/html; charset=us-ascii" />
+  <meta name="GENERATOR" content="Quanta Plus" />
+  <meta name="Copyright" content=
+  "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>
+<style type="text/css">
+  /*<![CDATA[*/
+
+  /* Styles local to this page. */
+  #drop_shadow {
+    margin-left: auto;
+    margin-right: auto;
+    width: 250px;
+  }
+
+
+  /*]]>*/
+</style>
+</head>
+
+<body>
+  <h6 id="header">RMagick 0.0.0 User's Guide and Reference</h6>
+
+  <div class="nav">
+    &laquo;&nbsp;<a href="optequiv.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href=
+    "magick.html">Next</a>&nbsp;&raquo;
+  </div>
+
+  <h1>Common Tasks</h1>
+
+  <div id="toc">
+    <h2>Table of Contents</h2>
+
+    <ul style="margin-left: 15px; padding-top: 1em;">
+      <li><a href="#info">Getting information about an
+      image</a></li>
+
+      <li><a href="#convert">Converting an image to another
+      format</a></li>
+
+      <li><a href="#thumb">Making thumbnails</a></li>
+
+      <li><a href="#resizing">Resizing to a maximum (or minimum)
+      size</a></li>
+
+      <li><a href="#blob">Writing to or reading from a string
+      instead of a file</a></li>
+
+      <li><a href="#gray">Converting a color image to
+      grayscale</a></li>
+
+      <li><a href="#compressing">Compressing image files</a></li>
+
+      <li><a href="#shadow">Making a drop shadow</a></li>
+    </ul>
+  </div>
+
+  <h2 id="info">Getting information about an image</h2>
+
+  <p>One of the most fundamental operations on an image is simply
+  getting basic information about the image. RMagick assigns dozens
+  of <a href="imageattrs.html">attributes</a> to an image. All you
+  have to do is read the image and then call the attribute methods.
+  Here's a Ruby program that takes image filenames from the command
+  line and then prints a variety of information about each image to
+  the terminal.</p>
+  <pre class="example">
+require 'RMagick'
+ARGV.each { |file|
+    puts file
+    img = Magick::Image::read(file).first
+    puts "   Format: #{img.format}"
+    puts "   Geometry: #{img.columns}x#{img.rows}"
+    puts "   Class: " + case img.class_type
+                            when Magick::DirectClass
+                                "DirectClass"
+                            when Magick::PseudoClass
+                                "PseudoClass"
+                        end
+    puts "   Depth: #{img.depth} bits-per-pixel"
+    puts "   Colors: #{img.number_colors}"
+    puts "   Filesize: #{img.filesize}"
+    puts "   Resolution: #{img.x_resolution.to_i}x#{img.y_resolution.to_i} "+
+        "pixels/#{img.units == Magick::PixelsPerInchResolution ?
+        "inch" : "centimeter"}"
+    if img.properties.length &gt; 0
+        puts "   Properties:"
+        img.properties { |name,value|
+            puts %Q|      #{name} = "#{value}"|
+        }
+    end
+    }
+</pre>
+
+  <h2 id="convert">Converting an image to another format</h2>
+
+  <p>Converting an image to another format is as simple as writing
+  the image to a file. ImageMagick uses the output filename
+  suffix (".jpg" for JPEG, ".gif" for GIF, for example) or prefix
+  ("ps:" for PostScript, for example) to determine the format of
+  the output image.</p>
+
+  <h2 id="thumb">Making thumbnails</h2>
+
+  <p>RMagick gives you four different methods for resizing an
+  image: <a href="image3.html#resize"><code>resize</code></a>,
+  <a href="image3.html#sample"><code>sample</code></a>, <a href=
+  "image3.html#scale"><code>scale</code></a>, and <a href=
+  "image3.html#thumbnail"><code>thumbnail</code></a>. All four are
+  equally easy to use. Specify the number of columns and rows you
+  want the thumbnail to have, like this:</p>
+  <pre class="example">
+img = Image.new "bigimage.gif"
+thumb = img.scale(125, 125)
+thumb.write "thumb.gif"
+</pre>
+
+  <p>Alternatively, just pass a single <code>Float</code> argument
+  that represents the change in size. For example, to
+  proportionally reduce the size of an image to 25% of its original
+  size, do this:</p>
+  <pre class="example">
+img = Image.new "bigimage.gif"
+thumb = img.scale(0.25)
+thumb.write "thumb.gif"
+</pre>
+
+  <p>The <code>resize</code> method gives you more control by
+  allowing you to specify a <a href=
+  "constants.html#FilterType">filter</a> to use when scaling the
+  image. Some filters produce a better-looking thumbnail at the
+  expense of extra processing time. You can also use a
+  <code>blur</code> argument, which specifies how much blurriness
+  or sharpness the resize method should introduce.</p>
+
+  <p>The <code>sample</code> method, unlike the other two, does not
+  do any color interpolation when resizing.</p>
+
+  <p>The <code>thumbnail</code> method is faster than
+  <code>resize</code> if the thumbnail is less than 10% of the size
+  of the original image.</p>
+
+  <h3>flickr-style thumbnails</h3>
+
+  <p><a href="http://www.flickr.com">flickr</a> thumbnails are 75
+  pixels wide and 75 pixels tall. If the original image isn't
+  square, the thumbnail is cropped in its larger dimension so that
+  the image isn't distorted. You can get make this kind of
+  thumbnail with the <a href=
+  "image3.html#resize_to_fill">resize_to_fill</a> method.</p>
+  <pre class="example">
+thumb = img.resize_to_fill(75, 75)
+</pre>
+
+  <h2 id="resizing">Resizing to a maximum (or minimum) size</h2>
+
+  <p>Say you need to make all your thumbnails no bigger than 64x64
+  but with the same aspect ratio as the original. Or, you don't
+  want to resize the image if it's already smaller than 64x64. The
+  <a href=
+  "image1.html#change_geometry"><code>change_geometry</code></a>
+  method can help.</p>
+
+  <p>The <code>change_geometry</code> method accepts an
+  ImageMagick <a href="imusage.html#geometry">geometry string</a>
+  argument and a block. The geometry string specifies how to change
+  the image's size: one or two numbers to specify the new size and
+  optional flags to describe any constraints. The
+  <code>change_geometry</code> method parses the geometry string
+  and computes new width and height values. Then it calls the
+  block, passing the values it computed.</p>
+
+  <p>Within the block you can do whatever you want with the new
+  values. Typically you'll call one of the resize methods mentioned
+  in the previous section and make the resized image the return
+  value from the block. The <code>change_geometry</code> method
+  then returns that value to its caller.</p>
+
+  <h3>Simple thumbnails</h3>
+
+  <p>If you just want to make sure your thumbnail is no bigger than
+  a certain width and height, use the <a href=
+  "image3.html#resize_to_fit">resize_to_fit</a> method.</p>
+  <pre class="example">
+thumb = img.resize_to_fit(75, 75)
+</pre>
+
+  <h2><a id="blob" name="blob">Writing to or reading from a string
+  instead of a file</a></h2>
+
+  <p>Use the <a href="image1.html#from_blob">Image.from_blob</a>
+  method to construct an Image object from a string. Use the
+  <a href="image3.html#to_blob">Image#to_blob</a> method to convert
+  an image to a string. A blob is simply an in-memory version of an
+  image file. That is, you could use <code>File.read</code> to read
+  an JPEG file into a string, then create an image by using that
+  string as an argument to <code>from_blob</code>. Similarly, if
+  you create a string version of an image with
+  <code>to_blob</code>, then write the string to a file, any image
+  viewer will be able to display it just as if you had written the
+  image directly to a file. Blobs are very useful in web
+  applications when you want to modify an image and then stream it
+  back to the client.</p>
+
+  <p>Use <a href=
+  "image2.html#import_pixels">Image#import_pixels</a> to load pixel
+  data from a string buffer into an image. The pixel data must be
+  in scanline order, right-to-left and top-to-bottom. The data can
+  be packed as 8-bit bytes, 16-bit halfwords, 32-bit fullwords, or
+  as C floats or doubles. The reciprocal method is <a href=
+  "image3.html#export_pixels_to_str">Image#export_pixels_to_str</a>.</p>
+
+  <h2 id="gray">Converting a color image to grayscale</h2>
+
+  <p>Use the <a href=
+  "image3.html#quantize"><code>quantize</code></a> method with the
+  <a href=
+  "constants.html#ColorspaceType">Magick::GRAYColorspace</a>
+  argument. If you want real "grayscale," quantize the image to 256
+  colors. If you want to convert a color image to black-and-white,
+  use 2 colors. (See the <code>demo.rb</code> example.)</p>
+
+  <h2 id="compressing">Compressing image files</h2>
+
+  <p>Many image formats, including JPEG, PDF, and BMP, support
+  compressed image files. The type of compression used depends on
+  the format. Specify the compression type by assigning a <a href=
+  "constants.html#CompressionType">CompressionType</a> value to the
+  <a href="info.html#compression">compression</a> optional argument
+  to the <a href="image3.html#write">write</a> method.</p>
+
+  <p>The JPEGCompression and ZipCompression types support multiple
+  levels of compression. Use the <a href=
+  "info.html#quality">quality</a> optional argument to the
+  <code>write</code> method. The quality attribute is a number
+  between 0 and 100, with 100 representing the least compression.
+  When you compress an image using JPEGCompression, more
+  compression usually results in a lower-quality image. When you
+  compress an image using ZipCompression, more compression usually
+  takes longer.</p>
+
+  <p>For more information, see the ImageMagick documentation for
+  the <code>-quality</code> option to the utility commands.</p>
+  <pre class="example">
+img.write("myimage.jpg") { self.quality = 50 }
+</pre>
+
+  <h2 id="shadow">Making a drop shadow</h2>
+
+  <p>Here's one way to make a drop shadow behind text. Make the
+  shadow first by drawing the text in a light gray color. Position
+  the text slightly to the right and down from where the real text
+  will be. Then use the <a href=
+  "image1.html#blur_image"><code>blur_image</code></a> method to
+  make the shadow by blurring the text. Finally, draw the text
+  again in whatever color you want. <em>(Click the image to see the
+  Ruby program that created it.)</em></p>
+
+  <div id="drop_shadow">
+    <a href="javascript:popup('drop_shadow.rb.html')"><img src=
+    "ex/drop_shadow.gif" title="Click to see the example script"
+    alt="drop shadow example" /></a>
+  </div>
+  <hr />
+
+  <p class="spacer"></p>
+
+  <div class="nav">
+    &laquo; <a href="optequiv.html">Prev</a> | <a href=
+    "index.html">Contents</a> | <a href="magick.html">Next</a>
+    &raquo;
+  </div>
+</body>
+</html>