A Ruby library for making trippy visuals and sounds. Need to pick locations and colors to draw in? Let one of Ruby On Acid’s “factories” do it for you. Then swap out one factory for another without changing your code. Need to pick a note from a scale or a tempo? Ruby On Acid factories can do that too. And if none of the bundled factories does what you need, it’s easy to write your own.
sudo gem install rubyonacid
The factory is the core concept of Ruby On Acid. You create a factory of a particular type, and then anywhere in your code that you need a value within a certain range, you get it from the factory. For example, if you need x and y coordinates for drawing on a 800 × 600 window, you would tell a factory that you need a value for :x from 0 to 800, and a value for :y from 0 to 600. If you later wanted to change drawing patterns, you could simply swap out factories.
def draw(factory)
window.draw_circle(
factory.get(:x, :max => 800),
factory.get(:y, :max => 600),
factory.get(:radius, :max => 100)
)
end
current_factory = RubyOnAcid::RandomFactory.new
10.times {draw(current_factory)}
current_factory = RubyOnAcid::LoopFactory.new
10.times {draw(current_factory)}
See the examples directory for usage of the various factories.
Making new factories is easy – simply make a subclass of RubyOnAcid::Factory. Then write a get_unit() method that takes a key and returns a value between 0 and 1.
For example, here’s the entire code for the (original) bundled RandomFactory class:
class RandomFactory < RubyOnAcid::Factory
def get_unit(key)
return rand
end
end
Of course, when the values you’re generating are random, you don’t need to know what they’ll be used for. For situations where you do care, you can use the “key” parameter, which is an indication from the factory user of the kind of value they need. This class tracks the previously returned value for a key and increments the next one:
class CumulativeFactory < RubyOnAcid::Factory
def initialize
super #Be sure to call Factory's constructor if you override it!
@counters = Hash.new {|h, k| h[k] = 0.0}
end
def get_unit(key)
@counters[key] = (@counters[key] + 0.1) % 1.0
return @counters[key]
end
end
factory = CumulativeFactory.new
puts factory.get(:x) # => 0.1
puts factory.get(:y) # => 0.1
puts factory.get(:x) # => 0.2
puts factory.get(:z) # => 0.1
Start by looking at the code for the bundled factories in the lib/rubyonacid/factories directory; it should give you some ideas of what’s possible.
API documentation is hosted on RDoc.info.
The project page on GitHub lets you browse the latest code, or clone or fork the source repo for yourself.
The discussion list is the place for questions, problems, bug reports, feature requests, etc. And since working with Ruby On Acid is usually a creative endeavor, be sure to share your ideas and learn from others, too!
Copyright © 2009-2011 Jay McGavren. Released under the MIT license. See the LICENSE file for details.