|Graphics Processing for Ruby and Ruby on Rails|
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.
RMagick is an interface between the Ruby programming language and the ImageMagick® and GraphicsMagick image processing libraries.
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.
|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|
|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|
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.
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.
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.
More Information About Using RMagick
These fine books include information about using RMagick. Find them at your favorite bookstore.
|The Ruby Way, Second Edition (Addison-Wesley) Hal Fulton's classic book includes an overview of RMagick.||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 (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.|
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
at rubyforge dot org.
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.
OSI Certified Open Source Software