____ _ ____ _
| _ \ _ _| |__ _ _ | _ \ _ __ ___ ___ ___ ___ ___(_)_ __ __ _
| |_) | | | | '_ \| | | |_____| |_) | '__/ _ \ / __/ _ \/ __/ __| | '_ \ / _` |
| _ <| |_| | |_) | |_| |_____| __/| | | (_) | (_| __/\__ \__ \ | | | | (_| |
|_| \_\\__,_|_.__/ \__, | |_| |_| \___/ \___\___||___/___/_|_| |_|\__, |
|___/ |___/
This is a Ruby wrapper that lets you harness Processing’s awesome power.
It makes Processing act in a slightly more Shoes-like way, and replaces
the ol’ crusty faux-Java-1.4-syntax sandals that Processing usually
wears with some new Ruby slippers. So, here’s what you’ll need to make
it work:
Download the most recent JRuby, and make sure that the jruby command is
reachable in your path.
From inside this folder, you can run the samples like so:
jruby samples/jwishy.rb
Because it’s Ruby, you can also load the samples via jirb, and then alter
them on the fly. Live coding, anyone?
Changelog:
Revision 0.8
* Ruby-Processing can now export Mac applications! Running
script/application my_sketch.rb will create MySketch.app,
complete with all of its data and libraries. If you have
a .icns file inside of your data folder, it will become
the app's icon.
* Added a mathematical Fern sample. It's a port of Luis
Correia's java original, with algorithms from Wikipedia.
* Sketches now have a library_loaded? method, so that you can
check if a library has been started successfully, and
conditionally enable things. (Good for OpenGL.)
* The Boids library is now about 40% faster. It also comes with
an example in library/boids/samples.
* Specs have been started both for exporting and for Ruby-
Processing itself.
Revision 0.7
* Thanks to MenTaLguY, once again, for work on the JRubyApplet, OpenGL
is now a first-class citizen. If you're using OpenGL in your sketch,
the applet exporter should just work. It has also been moved and
renamed, so now you can use it like:
script/applet my_sketch.rb
* An app generator has been added for getting started. It'll give you
a template for an empty Ruby-Processing sketch, with setup and draw
methods and all that. Usage:
script/generate my_sketch 800 600
Will create a file called my_sketch.rb, with a title of "My Sketch",
800 pixels wide and 600 pixels tall. Width and height are optional.
* Ruby-Processing now includes its first pure-Ruby library, a port
of Tom de Smedt's "Boids", for algorithmic flocking.
Revision 0.6
* Now we're baking up some applet pie. The applet_tree script will
take your Ruby-Processing sketch, export it as an applet, and
generate an HTML page for you to post. It's way easier now than it
would have been before. (thanks to MenTaLguY.) Use it like so:
./applet_tree my_sketch.rb
But there are caveats: Applets don't work with native libraries, so
no OpenGL. If you're requiring other files that aren't part of the
standard Ruby distro, you'll need to include them as libraries, which
means: Drop them in a folder inside of "library". Use
load_ruby_library("folder_name") or load_java_library() to load 'em.
These methods replace the previous load_library(). Ruby libs will
load the .rb with the same name as the folder. Java libs will just
load up all of the .jars in the folder.
Demos — all of the standard samples are available as applets:
http://fiercefrontiers.com/applets/jwishy/
http://fiercefrontiers.com/applets/tree/
http://fiercefrontiers.com/applets/circle_collision/
http://fiercefrontiers.com/applets/reflection/
Revision 0.5
* Ruby-Processing gets easy native library support. Now you can take
Processing libraries, drop them in the library folder, and load them
up like so (inside your sketch):
load_library "opengl"
It works by loading up all of the .jars in that folder, and setting
the java.library.path to that folder, so that the native extensions
can be found.
* Full Screen OpenGL demo added, but you'll need to copy over the
OpenGL library to use it.
Revision 0.4
* Ruby-Processing goes fullscreen. Just pass :full_screen => true
into the options when you’re starting up your app. Like so:
MyApp.new(:title => "MyApp", :full_screen => true)
* Because Processing has just so many methods, you can now search
through them: find_method "method_name"
Revision 0.3
* Processing::App.current will give you a handle on the app. (Useful
in jirb).
* samples/jwishy.rb has some new hooks for live coding.
* circle_collision and tree samples added (Joe Holt)
) is private.
