Compass Magick

Dynamic image generation for Compass using ChunkyPNG/PhantomJS (no dependency on RMagick).

Example

body {
  background: transparent magick-canvas(100px, 100px,
    magick-fill(magick-linear-gradient(red, green, blue))
  ) repeat-x;
}

A CSS3 Sassy Button recreated in Compass Magick:
StanAngeloff.github.com/compass-magick/ (showcases all features)

Installation is simple via RubyGems. Compass and ChunkyPNG are required.

gem install compass-magick

If you wish to use PhantomJS, please follow the build instructions.

To start a new Compass project with Magick included:

compass create -r magick my_project

To use Compass Magick within your existing projects, require the plugin from your Compass configuration:

require 'magick'

There is a short tutorial available which should guide you through creating a simple themeable button.

Compass Magick is very much a work in progress. Documentation is sparse, speed is a major issue and there are probably a lot of bugs.

You can help by looking at any of the following areas (ordered by priority):

Optimizing the code as floating point math may not always be needed and too many object copies sucks
Writing tests to make sure nothing breaks in new versions
Performing code reviews since this is my very first Ruby project and I don't have any experience with the language so there are probably many st*OO*pid things in code
Improving RDoc because you can never have too much documentation
Adding new plugins. Compass Magick looks for Ruby files and imports those on startup
Submitting more examples to show off what Compass Magick can do
Opening issues for features you find missing or broken
Porting over some of CamanJS' goodness, we all love visual effects

Willem van Bergen for his great work on ChunkyPNG which has been a major source of knowledge while working on the project
Chris Eppstein for Compass itself
The Ruby community for being awesome and welcoming a stranger

Copyright (c) 2011 Stan Angeloff. See LICENSE.md for details.