This version is intended to work with openjdk11+, @sampottinger is currently working on vanilla processing which will enable JRubyArt to catch up.

A slim layer to communicate with Processing from JRuby, features maven build. We have created a configuration free version of ruby processing, for processing-4.0+, where we include a modified processing core (public runPropane() to replace protected runSketch(). These jars are small enough to include in a gem distribution, and hence we do not require configuration. This has created a scriptable version, ie files get run direct from jruby. Currently JavaFX is unsupported again @sampottinger is currently working on vanilla processing to use OpenJFX. It would be nice make use of java modules, but I think we should let jruby project do that first (unless processing.org beat them to it).

adjust above for your OS/distro setup.

Previously there has been linker issue with P2D or P3D sketches with stock openjdk with some linux distros, but that seems to have gone away. Adopt open jdk binaries have always worked.

• jdk-11.0.7+
• jruby-9.2.17.0

rake rake gem rake javadoc

jgem install propane # from rubygems jgem install propane-3.10.0-java.gem # local install # Alternative jruby -S gem install propane # from rubygems jruby -S gem install propane-3.10.0-java.gem # local install

To check version and confirm gem bin files are on your path (also checks JDK version)

propane --version

A propane sketch:-

require 'propane' class FlashingLightsSketch < Propane::App def settings size(800, 600) end def setup sketch_title 'Flashing Light Sketch' end def draw background(rand(255), rand(255), rand(255)) end end FlashingLightsSketch.new

Create template sketches with the sketch creator tool

propane -c my_sketch 200 200 # for default renderer propane -c my_sketch 200 200 p2d # for opengl 2D renderer propane -c my_sketch 200 200 p3d # for opengl 3D renderer

To run sketches

jruby my_sketch.rb # or use script to run sketches from atom

To install the sound and video libraries ~/.propane/libraries. Depends on wget.

propane --install sound propane --install video

Other java libraries can be manually installed to the same folder (no need for processing ide)

See gh-pages for more detailed instructions and much more.

Worked Examples more to follow, feel free to add your own, especially ruby-2.5

• syntax now we can. To install the samples. The samples get copied to ~/propane_samples. Depends on wget.

propane --install samples

please move existing propane_samples if you wish to keep them. The current release features some noise sketches that exploit the new choice of noise implementation.