RMagick logo

Ruby+ImageMagick ®
Ruby+GraphicsMagick

Graphics Processing for Ruby and Ruby on Rails

News

RMagick has found a new developer. Please welcome: Moncef Maiza!

RMagick is looking for new developers. Interested in helping out on a cool open source project?

RMagick is moving to GitHub! See the new repository.

RMagick 2.13.0 has been released.

About RMagick

RMagick is an interface between the Ruby programming language and the ImageMagick® and GraphicsMagick image processing libraries.

What Does RMagick Do?

Thumbnails are just the start! Check out the RMagick portfolio. The first page shows some basic transformations. Page 2 demonstrates special effects. Page 3 illustrates the drawing API.

Which version of RMagick is right for me?

There are two versions of RMagick, RMagick 1 and RMagick 2. Most people will want to install RMagick 2. This version works with Ruby 1.8.5 and later (including Ruby 1.9) and ImageMagick 6.3.5 and later. All new enhancements to RMagick will be in RMagick 2. RMagick 2 does not work with GraphicsMagick.

RMagick 1 works with Ruby 1.6.7 and later*, all versions of GraphicsMagick and ImageMagick 6.0.0 and later. RMagick 1 does not support any features added to ImageMagick 6.3.0 and later and does not work with Ruby 1.9. RMagick 1 is fully supported. As of this writing there have been 14 bug fix releases. I plan to continue to supply bug fixes as necessary.

This table summarizes the differences between RMagick 1 and 2.

RMagick Version Feature Table
Feature RMagick 1 RMagick 2
Works with Ruby < 1.8.5* Yes No
Works with ImageMagick 6.0.0-6.2.9 Yes No
Works with GraphicsMagick Yes No
Fully supported Yes Yes
Works with ImageMagick 6.3.5 and later Yes Yes
Available as a Windows RubyGem? No Yes
Gets new features No Yes
Works with Ruby 1.9 No Yes
Supports new ImageMagick features No Yes

*except RVG

Documentation

RMagick comes with comprehensive documentation in HTML format. The documentation for your version of RMagick is installed on your system along with the RMagick software. If you are using RMagick on another system such as a web hosting service you can read the documentation online at one of these locations.

The documentation at these locations may not be for the same version of RMagick that you are using. Thanks to the good folks at Simple Systems and ImageMagick Studio LLC for providing the web space.

Prerequisites

You can use RMagick on Linux, FreeBSD, OS X and other *nix-like systems such as Solaris and Cygwin. You can also use RMagick on Windows XP and Vista. RMagick works with Ruby 1.8. If you do not have Ruby, you can get it from www.ruby-lang.org. You must have ImageMagick 6.0.0 or later, or GraphicsMagick 1.0 or later. (I recommend ImageMagick 6.3.0 or later, or GraphicsMagick 1.1.) You only need one of ImageMagick or GraphicsMagick. RMagick works equally well with either. See below for links to the ImageMagick and GraphicsMagick download sites.

Installation FAQ

Frequently asked questions about installing RMagick.

Articles About Using RMagick

Look here for short, in-depth articles about RMagick. New ones will be added from time-to-time.

Alpha compositing - Part I (Feb 18, 2006)
This article shows how use Image#composite to blend two images into one.
Alpha compositing - Part 2 (Web 2.0 Graphics) (June 18, 2006)
This article continues the discussion of Image#composite by showing how to produce "Web 2.0" design effects with RMagick.
The Polaroid® Effect (Sep 22, 2006) (updated Jan 31, 2007)
Make your image look like an old Polaroid print. ("Polaroid" and the other names of products of Polaroid Corporation are trademarks of Polaroid Corporation.)
Watermarking Images With the shade Method (Nov 13, 2006)
A simple technique for adding a digital watermark to an image.

More Information About Using RMagick

These fine books include information about using RMagick. Find them at your favorite bookstore.

The Ruby Way The Ruby Way, Second Edition (Addison-Wesley) Hal Fulton's classic book includes an overview of RMagick. Ruby Cookbook Ruby Cookbook (O'Reilly) Check out Antonio Cangiano's excellent RMagick recipes.
Rails Cookbook (O'Reilly) Rob Orsini's guide includes a "Graphics" chapter that shows how to use RMagick in Rails applications. The Definitive Guide to ImageMagick The Definitive Guide to ImageMagick (Apress) Michael Still devotes an entire chapter to RMagick.
Practical Ruby Gems (Apress) David Berube shows how to create thumbnails with RMagick, one one of 29 "practical" Ruby Gems explained in his book. Beginning Google Maps Applications with Rails and Ajax: From Novice to Professional (Apress) Andre Lewis shows how to use RMagick to create custom overlays to use with the Google Maps API.

Contact Info

My name is Tim Hunter. Please use the RMagick project at RubyForge to ask questions, report bugs, or just to let me know you're using RMagick! You can also email me at rmagick at rubyforge dot org.

Download RMagick

Download GraphicsMagick
GraphicsMagick logo
Download ImageMagick
ImageMagick logo

License and Copyright Information

Copyright © 2002-2008 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.

Other Copyrights
  • ImageMagick is Copyright © 1999-2008 ImageMagick Studio.
  • GraphicsMagick is Copyright © 2002, 2003, 2004, 2005, 2007 GraphicsMagick Group.
  • The ImageMagick logo is copyright Pineapple USA Inc.
  • Ruby is copyrighted free software by Yukihiro Matsumoto.
OSI Certified Open Source Software

OSI Certified Open Source Software