Core Image Gem
Simple image manipulation using Apple's Core Image technology.
Installation
gem install core_image
Usage
require 'core_image'
image = CoreImage.new(location) # more on this below
image.rotate(90)
image.scale_to_size(300)
image.save
Supports Chaining
image.rotate(90).scale(0.6).save(new_path)
Extra Bits
image.flip_horizontally
image.flip_vertically
image.save # oh no!
image.revert #=> reverts to the original image
One More Thing!
image.tint({:red => 0, :green => 0, :blue => 255, :alpha => 1.0})
image.crop(x, y, w, h) # starts from lower left
image.color_at(x, y) # => RGB Hash of specified pixel
image.overlay(another_image) # follows the same instantiation rules
Instantiating
You can instantiate a new Core Image object with the following:
- A path to a file
- A url to a file
- An Apple image object: NSImage, CIImage, CGImage
- Another Core Image object
File Types
Core Image can open and save the following formats: jpeg, png, tiff, gif, pct, and bmp. It can also open pdfs and save them as one of the previously listed image formats.
Requirements
Requires Mac OS X to run.
Tests
Core Image testing is done via the Riot gem and can be run by typing rake from the root directory of this repository (you must have Riot installed to do so).
Support
Serveral updates are in the works but feel free to report issues, make comments, voice concerns and I'll get to them when I can! Enjoy!