RMagick 2.12.0 (ImageMagick 6.5.6-8) Win32 Installation

In this file you find:

Prerequisites

Installation instructions

Gem Install

In order to be reading this file, you've already downloaded the zip file and unzipped it into a temporary directory. Double-click the ImageMagick installer (ImageMagick-6.5.6-8-Q8-windows-dll.exe) found in the temporary directory. The only option that you need to choose from the installation options is "Update executable search path." The other options are up to you. Do not use any other version of ImageMagick. RMagick will not run if you install any other version of ImageMagick.

Make sure RubyGems is up-to-date. If you are using an older version, update it now. Enter the command

Installing the gem is very simple. Start a Command Prompt window. Use the chdir command to make the temporary directory that contains the unzipped files the current directory. Enter this command:

You should see:

If instead you get the message

then you didn't update RubyGems. Do so now and re-run the gem install command.

Post Installation

It may be necessary to restart any services, Command Prompt windows, or even reboot for current applications (Ruby on Rails based apps, in particular) after installing RMagick.

Documentation

Documentation has been installed into the directory of the gem, which can be found using the command:

The line(s) you should note is/are:
    - GEM PATH:
       - c:/ruby/lib/ruby/gems/1.8
Using this example, the documentation can be found in:
    c:\ruby\lib\ruby\gems\1.8\gems\rmagick-2.12.0-x86-mswin32\doc\index.html
And additional examples are in:
    c:\ruby\lib\ruby\gems\1.8\gems\rmagick-2.12.0-x86-mswin32\examples

General Remarks

Most problems can be resolved by simply closing all existing Command Prompt windows and starting a new Command Prompt window after installing ImageMagick and RMagick.

If Ruby complains that it can't find RMagick, be sure that you have set up the RubyGems environment. The simplest way to do this is to require "rubygems" first:

        require 'rubygems'
        require 'RMagick'
There are other ways to set up the RubyGems environment. See the RubyGems documentation for more information.

Use require 'RMagick’, spelled as shown. Ruby is case-sensitive, even if Windows isn't.

Don't use require_gem to require RMagick. This is obsolete.

If you need help using RMagick, use the Help Forum on RubyForge.

Please report bugs in RMagick, its documentation, or its installation programs to us via the bug tracker on the RMagick project page at RubyForge. When reporting bugs, please specify that you are using the rmagick-win32 gem. Don’t forget to mention the RMagick, Ruby, and Windows version.

Contact Information

Comments for either the distribution or the library itself are welcome. Write to us.

Thanks to

Licensing information

The RMagick library is released under the MIT license, below. ImageMagick uses a GPL compatible license (see the ImageMagick website).

License

Copyright © 2009 by Timothy P. Hunter

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.

http://www.opensource.org/docs/definition.php

This software is OSI Certified Open Source Software.

OSI Certified is a certification mark of the Open Source Initiative.