PiCrate gem

Getting Started Manjaro

Mon, 11 May 2020 07:34:13 +0000

If Manjaro does not come with a pre-installed java, then the first step is to install a jdk the distro version (jdk16) should work.

sudo pacman -S jre-openjdk # current distro version jdk17

You can also use pacman to install jruby

sudo pacman -S jruby # current version jruby-9.3.0.0

It is probably a good idea to create a local gem store (rather needing to use sudo to install gems)

sudo pacman -S vim # all you need if your happy with vim

Vim is not installed by default

sudo pacman -S geany # if you prefer a GUI

Geany is not installed by default

mkdir -p ~/.gem/ruby/2.6.0 # current MRI version supported by jruby

Now set your GEM_HOME, GEM_PATH and amend your PATH as follows:-

echo "export GEM_HOME=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.bashrc
echo "export GEM_PATH=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.bashrc
echo "export PATH=\"\${PATH}:\${GEM_PATH}/bin\"" >> ~/.bashrc
source ~/.bashrc # to update environment without re-logging in

Now should be ready to install picrate and other gems. But speed up install time you should set --no-document option in ~/.gemrc

touch ~/.gemrc
echo "gem: --no-document" > ~/.gemrc

To install latest picrate and its dependencies:-

jgem install picrate

Geany is a good editor/ide for PiCrate on the RaspberryPI (install via pacman), but some may prefer vim. For geany you should edit/preferences/Terminal to Execute programs in the VTE.

For a first install:-

picrate --install # no args, install samples and geany config
# or
picrate -i Samples # to omit geany config

This installs example sketches in ~/projects/examples and ties them into a geany project examples.geany. It should also be possible to run sketches from the geany ide. The geany config creates picrate.rb template sketch so you can create a new sketch with template.

To create a template sketch from the command line:-

picrate -c my_sketch 600 400

creates file my_sketch.rb

#!/usr/bin/env jruby
# frozen_string_literal: false
require 'picrate'

class MySketch < Processing::App
  def settings
    size 200, 200
  end

  def setup
    sketch_title 'My Sketch'
  end

  def draw

  end
end
MySketch.new

Edit in vim (at command line) or geany (gui), you may need to install vim

vim my_sketch.rb
:!jruby % # from vim runs the sketch

To run sketches from command line:-

jruby --dev my_sketch.rb

Or even chmod +x my_sketch.rb to make an executable script.

See editors geany, for how to run sketches from a gui.

JWishy Sketch Running on RaspberryPI

Automated PiCrate Install

Mon, 09 Mar 2020 07:34:13 +0000

For a semi-automated setup and install, download and extract this gist. To keep your system clean put the file in a folder say ~/install_picrate

cd ~/picrate_install
bash picrate2_install.sh # to run default task

What the script does

Downloads JRuby
Installs JRuby to /opt
Uses update-alternatives to configure jruby, jgem and jirb
The script checks for GEM_HOME, if undefined it modifies ~/.profile to define GEM_HOME and puts gem binaries on your path, at logon.
Installs jdk11 if required sets JAVA_HOME, needed to support jruby
Creates ~/.gemrc with gem: no-document
Installs picrate gem To install picrate_samples also configures geanyIDE for use with picrate run picrate --install in a bash console

Note

GEM_HOME, JAVA_HOME and path to gem binaries are not available until next logon, to use immediately you could:-

source ~/.profile

NB: this only works in current shell, so if you want to use geanyIDE you should logout and logon again.

Getting Started Buster

Mon, 09 Mar 2020 07:34:13 +0000

Raspbian Buster installs OpenJDK11 (hard float) and that is just fine, if you have more that one version of java installed you could use update-alternatives tool to manage their use. NB: Will not work with OpenJDK-8.

Then install JRuby see jruby.

jgem install picrate

For a first install:-

picrate --install # no args, install samples and geany config
# or
picrate -i Samples # to omit geany config

This installs example sketches in ~/sample_sketches and ties them into a geany project picrate.geany. It should also be possible to run sketches from the geany ide.

Install processing libraries

picrate -i Sound
picrate -i video # install beta verion of vanilla video for now

To create a template sketch from the command line:-

picrate -c my_sketch 600 400

creates file my_sketch.rb

#!/usr/bin/env jruby
# frozen_string_literal: false
require 'picrate'

class MySketch < Processing::App
  def settings
    size 200, 200
  end

  def setup
    sketch_title 'My Sketch'
  end

  def draw

  end
end
MySketch.new

Edit in vim (at command line) or geany (gui), you may need to install vim

vim my_sketch.rb
:!jruby % # from vim runs the sketch

To run sketches from command line:-

jruby my_sketch.rb

Or even chmod +x my_sketch.rb to make an executable script.

See editors geany, for how to run sketches from a gui.

Circle Collision Sketch Running on RaspberryPI

Getting Started RaspbianOS

Mon, 11 Nov 2019 07:34:13 +0000

RaspberryPI OS usually comes with a pre-installed jdk11. Before installing JRuby it might be worth setting the JAVA_HOME environmental variable (to supress reflection warnings).

Otherwise follow these instructions in order as needed:-

sudo apt-get update # sync your local database with current release
sudo update # update to latest release
sudo apt install openjdk-11-jdk # installs latest jdk11
java -version # check installed version

If you have already installed a version java the java version may not match you can control the active java version on Debian using update-alternatives as follows:-

sudo update-alternatives --config java
sudo update-alternatives --config javac
sudo update-alternatives --config jar

See java install for more explanations.

Then install JRuby see jruby.

We strongly recommend that you create a local storage for gems on your system, as follows:-

mkdir -p ~/.gem/jruby/2.5.0

Now set your GEM_HOME, GEM_PATH and amend your PATH as follows:-

echo "export GEM_HOME=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.profile
echo "export GEM_PATH=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.profile
echo "export PATH=\"\${PATH}:\${GEM_PATH}/bin\"" >> ~/.profile
source ~/.profile # to update environment without re-logging in

Now should be ready to install picrate and other gems. Install a local version of rake:-

jgem install rake

To install latest picrate and its dependencies:-

jgem install picrate

For a first install:-

picrate --install # no args, install samples and geany config
# or
picrate -i Samples # to omit geany config

This installs example sketches in ~/projects/examples and ties them into a geany project examples.geany. It should also be possible to run sketches from the geany ide.

To create a template sketch from the command line:-

picrate -c my_sketch 600 400

creates file my_sketch.rb

#!/usr/bin/env jruby
# frozen_string_literal: false
require 'picrate'

class MySketch < Processing::App
  def settings
    size 200, 200
  end

  def setup
    sketch_title 'My Sketch'
  end

  def draw

  end
end
MySketch.new

Edit in vim (at command line) or geany (gui), you may need to install vim

vim my_sketch.rb
:!jruby % # from vim runs the sketch

To run sketches from command line:-

jruby my_sketch.rb

Or even chmod +x my_sketch.rb to make an executable script.

See editors geany, for how to run sketches from a gui.

JWishy Sketch Running on RaspberryPI

Getting Started with Geany

Tue, 27 Nov 2018 07:34:13 +0000

The current version of raspbian installs jdk-11 (hard float) and that is just fine, if you have more that one version of java installed you could use update-alternatives tool to manage their use.

Then install JRuby see jruby.

jgem install picrate

Install samples, and configure geany ide (for PiCrate)

picrate -i
# or
picrate --install

or for no geany configuration

picrate -i Samples
# or
picrate --install Samples

Install processing libraries

# picrate -i Sound not currently working
picrate -i video # preferred over vanilla video for now

Creating Sketches from the GeanyIDE

See editors geany, for how to run sketches from a gui.

Running PiCrate sketch on RaspberryPI from geany editor

Building PiCrate gem on Linux

Sun, 18 Nov 2018 07:34:13 +0000

Requirements:-

Latest jogl-2.4.0-rc jars (place in ~/jogl-2.4-rc2021011 folder see jogl-jars).
jdk-11+ and maven

Simply clone this distribution, then rake to build and test gem

git clone --depth 1 https://github.com/ruby-processing/PiCrate.git
cd PiCrate
rake # to build gem

Installing JRuby on Archlinux arm

Thu, 24 May 2018 07:34:13 +0000

Might work, please let us know!!! Manjaro works OK.

Processing API

Thu, 24 May 2018 07:34:13 +0000

You can use most processing methods in picrate, but where possible you should prefer these ruby alternatives (you should also prefer Vec2D and Vec3D to PVector). Here is a list of ruby alternatives to some ‘processing’ convenience methods; which with the exception of color, map1d, p5map, degrees and radians are just regular ruby methods.

function	processing	picrate
camera	`camera(args)`	`kamera(hash_args)`
color string	`color(#cc6600)`	`color('#cc6600')`
date/time		`t = Time.now`
	`day`	`t.day`
	`hour`	`t.hour`
	`minute`	`t.minute`
	`second`	`t.second`
	`year`	`t.year`
custom math	`map(x, b0, eo, b1, e1)`	`map1d(x, (b0..e0), (b1..e1))`
	`map(x, b0, eo, b1, e1)`	`p5map(x, b0, e0, b1, e1)`
	`max(array)`	`array.max`
	`min(array)`	`array.min`
conversion	`degrees(theta)`	`theta.degrees`
conversion	`radians(theta)`	`theta.radians`
conversion	`hex(string)`	`string.hex`
conversion	`unhex(string)`	`string.to_i(base=16)`
conversion	`binary(c)`	`c.to_s(2)`
conversion	`unbinary(string)`	`string.to_i(base=2)`
math	`abs(x)`	`x.abs`
math	`round(x)`	`x.round`
math	`ceil(x)`	`x.ceil`
math	`random(x)`	`rand(x)`
math	`random(a, b)`	`rand(a..b)`
math power	`pow(a, b)`	`a**b`
square	`sq(x)`	`x * x`
print	`println(x)`	`puts x`
format	`trim(string)`	`string.strip`
format	`nf(float_value, 0, 2)`	`format('%.2f', float_value)`
format	`nf(num, digit)`	`num.to_s.rjust(digit, '0')`
format	`nf(nf(num, left, right)`	`see below`

num.to_s.rjust(left, '0').ljust(left + right, '0')

For examples of using time in sketches see learning JRubyArt blog, timestamp and this clock sketch.

For example of kamera usage see kamera. To use selectInput see link to File Chooser in page header. We actually use the ruby Enumerable methods max and min methods to make max(*array) and min(*methods) available in picrate, so you could use the processing form providing you splat the array, but it is simpler to use the ruby method directly further you have the option with ruby of changing the [comparator via a block][comparator].

NB: if you have any trouble with save or save_frame then use the option of providing an absolute path. You can easily do this using the data_path wrapper that does it for you see data_path method.

Installing JRuby

Thu, 24 May 2018 07:34:13 +0000

Manual install

Pure jruby installation on raspbian no need for rbenv or rvm or existing ruby.

Get the latest version from http://jruby.org/download

cd /opt
sudo tar xzvf /pathToDownload/jruby-bin-9.3.2.0.tar.gz

Then use the excellent update-alternatives tool to provide symbolic links to jruby, jgem, jirb and rake especially if you haven’t installed mri ruby.

sudo update-alternatives --install /usr/bin/jruby jruby /opt/jruby{version}/bin/jruby 100
sudo update-alternatives --config jruby

GEM_HOME

You should prefer to install gems locally (no need for sudo). To do that it is convenient on linux to edit your ~/.profile (or equivalent eg ~./bashrc) file as follows, the important thing is ensure that the gem bin directory is on your path.

alias jpry="jruby -e \"require 'pry'; binding.pry\""
# export JAVA_HOME="/opt/jdk1.8.0_151" # if using oracle java openjdk-8 is fine though
export GEM_HOME="$HOME/.gem/ruby/2.6.0"
export GEM_PATH="$HOME/tux/.gem/ruby/2.6.0"
export PATH="${PATH}:${GEM_PATH}/bin"

Automated install using bash

The picrate2_install.sh script currently installs jruby-9.3.0.0 and picrate-2.5.0.

If you know better please post on wiki