Propane Gem Version Travis CI

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 existing propane_samples if you wish to keep them. The current release features some noise sketches that exploit the new choice of noise implementation.