Propane
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.
Requirements
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.16.0
Building and testing
rake
rake gem
rake javadoc
Installation
jgem install propane # from rubygems
jgem install propane-3.8.0-java.gem # local install
# Alternative
jruby -S gem install propane # from rubygems
jruby -S gem install propane-3.8.0-java.gem # local install
Check Install
To check version and confirm gem bin files are on your path (also checks JDK version)
propane --version
Usage
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.
Examples
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.bash propane --install samples
please move existingpropane_samples
if you wish to keep them. The current release features some noise sketches that exploit the new choice of noise implementation.