Skip to content

A simpler ruby-processing for linux/Windows/MacOS?

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE.md
Unknown
license.txt

ruby-processing/propane

Repository files navigation

Propane

Gem Version Travis CI

A slim layer to communicate with Processing from JRuby, features a polyglot maven build. We have created a configuration free version of ruby processing, for processing-3.3.6, where we include processing core (from a local maven repository and opengl etc from maven central). 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, but you could use jruby-complete if you used the propane script (avoids need to give the absolute data path for the data folder, but would also be needed for a watch mode). See guide to building ruby-processing projects.

NB: The main reason for build failing is when the core.jar is not available from maven central, to install a local jar (example for linux mint):-

mvn install:install-file /home/tux/processing-3.3.6/core/library/core.jar -DgroupId=org.processing -DartifactId=core -Dversion=3.3.6

adjust above for your OS/distro setup.

Requirements

  • jdk8+
  • jruby-9.1.16.0
  • mvn-3.5.0+
  • core.jar processing-3.3.6 (build only)

Building and testing

rake rake gem rake javadoc

Installation

jgem install propane # from rubygems jgem install propane-2.6.0-java.gem # for local install

Usage

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

There is a handy 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.2+ 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 several PixelFlow glsl library examples, including a few shadertoy demos as sketches.