picrate 2.0.0.pre-java → 2.2.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bd1310336366a9a78bccd5489b2ea6e261e9259c38aff780118310645b89e23
-  data.tar.gz: 4931647144b1e80b289ffb2e6712ad58ea272f5537b557ca24ade8ecdf6d513b
+  metadata.gz: bdddfc2a81e103e5e35ecf3e45af1420d9d476b8d972b4843c3476d4ad77cbe4
+  data.tar.gz: b58efaf4b2b75dea12197f91351832df20b259e620dcf533b993838e08ef7246
 SHA512:
-  metadata.gz: 416492b1f440ed69fcfb8e655a2e8fdac18a9e37510f2edbe446017b065316b83cccc2673d61030d2046869d34d9326e9e8c174cedc8f93b82e612ceafd59aa8
-  data.tar.gz: 1338e25d304f32f43e06d3ce73c9c64c23d2bc4a98c4913b18685c513442511e18f38beee0daf4cad1cd21ddbb58247e30e2da2f2ab8b131c6c5048b1eaf9d7c
+  metadata.gz: e1d0f48db5a13ba7ef0b52d4ceca8f856d71151e65ad8fb7edd863068cea034da00e2c961dac336b51a28d37f17a79a51c1a510ab4512d54a9dc68f088cda29b
+  data.tar.gz: 528f50eeb4307547999670ab4059a316ce671b748f86e2fc2beeebbd1c3bf7f38b89663c77b63ddafb9988d8c5345e3e51a10e8554d9b59262333c8f03fc7193

data/.mvn/extensions.xml

@@ -3,7 +3,7 @@
   <extension>
     <groupId>io.takari.polyglot</groupId>
     <artifactId>polyglot-ruby</artifactId>
-    <version>0.4.3
+    <version>0.4.5
     </version>
   </extension>
 </extensions>

data/.mvn/wrapper/MavenWrapperDownloader.java

@@ -20,7 +20,7 @@ import java.util.Properties;
 
 public class MavenWrapperDownloader {
 
-    private static final String WRAPPER_VERSION = "0.5.5";
+    private static final String WRAPPER_VERSION = "0.5.6";
     /**
      * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
      */

data/.mvn/wrapper/maven-wrapper.properties

@@ -1,2 +1,2 @@
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.1/apache-maven-3.6.1-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.5/maven-wrapper-0.5.5.jar
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+v2.2.0 Bump to latest JOGL-rc January 2021
+
+v2.1.2 Bump to JRuby-9.2.14.0
+
+v2.1.1 Bump to JRuby-9.2.13.0, include examples using ruby `clamp` in place of processing `constrain`, update to video-2.0 release, add run instruction to help
+
+v2.1.0 Refactor how we configure geany so we can use ENV['HOME'] rather hard code config file. Bump to JRuby-9.2.12.0, include Sam Pottingers July 2020 staging changes.
+
+v2.0.1 Use JOGL-2.4.0-rc fixes reflection warnings, remove geomerative and wordcram gem dependencies since can now be in step with JRubyArt and propane (re jdk compatibility), bump version for release. Removed Gottfreid Haider shaders, warn legacy driver doesn't work with P2D and P3D sketches. Support aarch64 architecture on RaspberriPI4.
+
 v2.0.0 Use JDK11+ update to processing-3.5.4 suggest jruby-9.2.11.0
 
 v1.2.4 Extract picrate examples to ~/projects/examples instead of ~/picrate_samples for tighter integration with geany editor. Remove non-functioning sound library as an install option (direct toward minim as option).

data/README.md

@@ -1,8 +1,8 @@
 __C6H3N3O7__ [![Gem Version](https://badge.fury.io/rb/picrate.svg)](https://badge.fury.io/rb/picrate)![Travis CI](https://travis-ci.org/ruby-processing/PiCrate.svg)
 
 # PiCrate
-New version for `Buster` on raspberryPI 3B+ assumes self installed jdk11 or greater.
-Create processing sketches in ruby on raspberry-pi and linux (this project is a parallel development of [propane][propane] targetting the raspberry-pi, but will initially be developed on a regular linux box). The aim is to produce a gem installable app that can be run with jruby, with minimal dependencies. Drop the `C` and you get pirate, or and an `e` and get `PiCreate`, a happy coincidence?
+New version for `Buster` on raspberryPI 3B+ works with jdk11 (reflective access warnings fixed for jdk11). Since version 2.0.1 also works on 64 bit Manjaro distro on RaspberryPI4. Create processing sketches in ruby on raspberry-pi and linux (this project is a parallel development of [propane][propane] targetting the raspberry-pi, but will initially be developed on a regular linux box). The aim is to produce a gem installable app that can be run with jruby, with minimal dependencies. Drop the `C` and you get pirate, or and an `e` and get `PiCreate`, a happy coincidence?
+
 
 ### To install from rubygems ###
 
@@ -12,21 +12,21 @@ jgem install picrate
 
 ### To Build and Test ###
 
-Clone this repo:-
+Clone main branch:-
 
-Requires java to build, but uses a maven wrapper so you don't need to install maven. Suggest build/test on regular linux box, but is designed for use on RaspberryPI 3B+. Needs installed jruby to test/run.
+Requires java to build (and [jogl-2.4.0-rc jars][jogl_jars]), but uses a maven wrapper so you don't need to install maven. Suggest build/test on regular linux box, but is designed for use on both RaspberryPI 3B+ and RaspberryPI4. Needs installed jruby to test/run.
 
 ```bash
-cd PiCrate
+cd PiCrate # or whatever you call it
 rake # assumes an installed version of vanilla processing
-jgem install picrate-1.2.4-java.gem
+jgem install picrate-2.2.0-java.gem
 
 ```
 To create a template sketch:-
 ```bash
 picrate -c my_sketch 200 200
 ```
-Edit sketch (vim is a good choice):-
+Edit sketch ([vim][vim] is a good choice, but we recommend [geany][geany]) :-
 ```ruby
 #!/usr/bin/env jruby
 # frozen_string_literal: false
@@ -55,6 +55,8 @@ MySketch.new
 jruby --dev my_sketch.rb # --dev flag speeds start-up
 ```
 
-
+[buster]:https://gist.github.com/monkstone/6ae9840d7b7008c177b4a9f589d14ec6
 [propane]:https://ruby-processing.github.io/propane/
-[oracle]:http://www.rpiblog.com/2014/03/installing-oracle-jdk-8-on-raspberry-pi.html
+[vim]:https://github.com/ruby-processing/PiCrate/blob/master/docs/_editors/vim.md
+[geany]:https://github.com/ruby-processing/PiCrate/blob/master/docs/_editors/geany.md
+[jogl_jars]:https://jogamp.org/deployment/archive/rc/v2.4.0-rc-20210111/jar/

data/Rakefile

@@ -6,18 +6,14 @@ HOME_DIR = ENV['HOME']
 
 task default: %i[init compile install test gem]
 
-# depends on installed processing, with processing on path
+# Currently depends on local jogl-2.4.0 jars on path ~/jogl24
 desc 'Copy Jars'
 task :init do
-  # for Archlinux etc
-  # processing_root = File.dirname(`readlink -f $(which processing)`)
-  # alternative for debian linux etc
-  processing_root = File.join(HOME_DIR, 'processing-3.5.4')
-  jar_dir = File.join(processing_root, 'core', 'library')
-  opengl = Dir.entries(jar_dir).grep(/amd64|armv6hf/).select { |jar| jar =~ /linux/ }
+  jogl24 = File.join(HOME_DIR, 'jogl-2.4-rc2021011')
+  opengl = Dir.entries(jogl24).grep(/amd64|armv6hf|aarch64/).select { |jar| jar =~ /linux/ }
   opengl.concat %w[jogl-all.jar gluegen-rt.jar]
   opengl.each do |gl|
-    FileUtils.cp(File.join(jar_dir, gl), File.join('.', 'lib'))
+    FileUtils.cp(File.join(jogl24, gl), File.join('.', 'lib'))
   end
 end
 
@@ -50,6 +46,11 @@ task :test do
   system 'jruby --dev test/vecmath_spec_test.rb'
 end
 
+desc 'JDeps Tool'
+task :jdeps do
+  system './mvnw jdeps:jdkinternals'
+end
+
 desc 'clean'
 task :clean do
   Dir['./**/*.{jar,gem}'].each do |path|

data/docs/_config.yml

@@ -4,7 +4,7 @@ title: PiCrate gem
 email: mamba2928@yahoo.co.uk
 description: > # this means to ignore newlines until "baseurl:"
   The picrate gem is ruby implementation of processing, targetting raspberrypi and
-  linux
+  linux works on 32 bit raspbian Buster (and 64 bit Manajaro raspberryPI4).
 baseurl: "" # the subpath of your site, e.g. /blog
 regenerate: true
 url: "https://ruby-processing.github.io/PiCrate"

data/docs/_editors/geany.md

@@ -9,6 +9,7 @@ Geany is highly configurable, and we have created a `geany` project file `picrat
 ```bash
 picrate --install samples
 ```
+Examples get installed in `~/projects/examples`, you can use `~/projects/sketchbook` to save your own sketches.
 
 #### Using picrate.rb template ####
 

data/docs/_gems/gems/gems.md

@@ -18,7 +18,7 @@ NB: the arcball gem is installed as a picrate dependency
 jbox2d ([pbox2d][jbox2d])
 
 ### Stand Alone Gems
-[cf3][cf3] context free art in ruby
+[cf3][cf3] context free art in ruby, examples may need a bit of hacking
 
 [cf3]:https://github.com/monkstone/cf3ruby/
 [arcball]:https://github.com/ruby-processing/ArcBall/

data/docs/_methods/alternative_methods.md

@@ -28,8 +28,9 @@ Here is a list of ruby alternatives to some 'processing' convenience methods; wh
 |               |`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`        |
+|               |`map(x, b0, eo, b1, e1)`|`p5map(x, b0, e0, b1, e1)`|
+|               |`constrain(x, lo, hi)`  |`x.clamp(lo, hi)`  |
 |               |`min(array)            `|`array.min`        |
 |conversion     |`degrees(theta)`        |`theta.degrees`    |
 |conversion     |`radians(theta)`        |`theta.radians`    |

data/docs/_posts/2018-05-06-getting_started.md

@@ -1,11 +1,11 @@
 ---
 layout: post
-title:  "Getting Started Stretch"
-date:   2018-05-24 07:34:13
+title:  "Getting Started Buster"
+date:   2020-03-09 07:34:13
 categories: PiCrate update
 permalink: /getting/
 ---
-Raspbian Stretch installs Oracle jdk-1.8.0_65-bi17 (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. Will work with OpenJDK-11 but currently performance is sub-optimal.
+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][jruby].
 
@@ -27,7 +27,7 @@ __Install processing libraries__
 
 ```bash
 picrate -i Sound
-picrate -i glvideo # preferred over vanilla video for now
+picrate -i video # install beta verion of vanilla video for now
 ```
 
 To create a template sketch from the command line:-

data/docs/_posts/2018-05-06-install_jruby.md

@@ -14,7 +14,7 @@ Get the latest version from [http://jruby.org/download][download]
 
 ```bash
 cd /opt
-sudo tar xzvf /pathToDownload/jruby-bin-9.2.11.0.tar.gz
+sudo tar xzvf /pathToDownload/jruby-bin-9.2.14.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.
@@ -36,17 +36,11 @@ export GEM_PATH="$HOME/tux/.gem/ruby/2.5.0"
 export PATH="${PATH}:${GEM_PATH}/bin"
 ```
 
-### Automated install using Rakefile ###
-Get the `Rakefile` [here][rake_gist] however it assumes an existing ruby install (which is not needed by PiCrate).
+### Automated install using bash ###
 
-```bash
-mkdir installer
-cd installer
-rake
-```
-Currently installs jruby-9.2.11.0
+The [picrate2_install.sh][bash] script currently installs jruby-9.2.14.0 and picrate-2.2.0.
 
 If you know better please post on wiki
 
-[download]:"https://repo1.maven.org/maven2/org/jruby/jruby-dist/9.2.11.0/jruby-dist-9.2.11.0-bin.tar.gz"
-[rake_gist]:https://gist.github.com/monkstone/159c5a9813c9cd181040b4715e74f6b2
+[download]:"https://repo1.maven.org/maven2/org/jruby/jruby-dist/9.2.14.0/jruby-dist-9.2.14.0-bin.tar.gz"
+[bash]:https://gist.github.com/monkstone/6ae9840d7b7008c177b4a9f589d14ec6

data/docs/_posts/2018-05-11-arch-linux-arm.md

@@ -4,14 +4,4 @@ title:  "Installing JRuby on Archlinux arm"
 date:   2018-05-24 07:34:13
 categories: PiCrate update
 ---
-It is quite likely that people wishing to experiment with PiCrate on arm have moved beyond the raspbian distribution. As a first step [archlinuxarm][alarm] which seems to be well thought out. Installing jdk8 and jruby should be as simple as:-
-
-```bash
-sudo pacman -Syu # get up to data
-sudo pacman jdk-arm # but I'm not 100% sure what version is installed jdk8+ is reqd
-sudo archlinux-java set java-8-openjdk/jre # case you have more than one java installed
-sudo pacman jruby # should install latest version
-```
-
-
-[alarm]:https://archlinuxarm.org/platforms/armv6/raspberry-pi
+Might work, please let us know!!! Manjaro works OK.

data/docs/_posts/2018-11-18-building-gem.md

@@ -6,9 +6,9 @@ categories: PiCrate update
 ---
 Requirements:-
 
-1. An installed version of vanilla processing to provide `processing.org` customised version of the `jogl` jars. The default `Rakefile` assumes root installation of processing, for debian distros you will need to adjust `processing_root` _ca. line 20_.
+1. Latest jogl-2.4.0-rc jars (place in ~/jogl-2.4-rc2021011 folder see [jogl-jars][jars]).
 
-2. jdk-11+ and maven (builds for jdk-8)
+2. jdk-11+ and maven
 
 Simply clone this distribution, then rake to build and test gem
 ```bash
@@ -16,3 +16,5 @@ git clone --depth 1 https://github.com/ruby-processing/PiCrate.git
 cd PiCrate
 rake # to build gem
 ```
+
+[jars]:https://jogamp.org/deployment/archive/rc/v2.4.0-rc-20210111/jar/

data/docs/_posts/2018-11-27-getting_started_geany.md

@@ -5,7 +5,7 @@ date:   2018-11-27 07:34:13
 categories: PiCrate update
 permalink: /geany_ide/
 ---
-The current version of raspbian installs jdk-1.8.0_65-bi17 (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.
+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][jruby].
 

data/docs/_posts/2019-11-11-getting_started_buster.md

@@ -5,17 +5,14 @@ date:   2019-11-11 07:34:13
 categories: PiCrate update
 permalink: /getting_buster/
 ---
-Currently Raspbian Buster does not come with a pre-installed java. So the first step is to install a `jdk` we currently recommend installing openjdk8 (_there a complications you don't need using jdk11_) to benefit from `client` optimisations. There is a bash script [here][buster], that will install `openjdk8`, `jruby-9.2.11.0` and picrate for you.
-```bash
-bash buster_install.sh
-```
+Raspbian Buster usually comes with a pre-installed jdk11. Before installing JRuby it is worth setting the `JAVA_HOME` environmental variable (needed to supress reflection warnings).
 
   __Otherwise follow these instructions in order as needed:-__
 
 ```bash
 sudo apt-get update # sync your local database with current release
 sudo update # update to latest release
-sudo apt install openjdk-8-jdk # installs latest jdk8
+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:-
@@ -46,7 +43,7 @@ Install a local version of rake:-
 ```bash
 jgem install rake
 ```
-To install picrate and its dependencies:-
+To install latest picrate and its dependencies:-
 
 ```bash
 jgem install picrate
@@ -59,7 +56,7 @@ picrate --install # no args, install samples and geany config
 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.
+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:-
 

data/docs/_posts/{2018-06-26-auto_install_picrate.md → 2020-03-09-auto_install_picrate.md}

@@ -1,28 +1,31 @@
 ---
 layout: post
 title:  "Automated PiCrate Install"
-date:   2018-06-26 07:34:13
+date:   2020-03-09 07:34:13
 categories: PiCrate update
 permalink: /install_picrate/
 ---
 
-For a semi-automated setup and install, download and extract [this gist](https://gist.github.com/monkstone/e9df8ea776aed58ce1c4de8e12982aad). To keep your system clean put the file in a folder say
+For a semi-automated setup and install, download and extract [this gist](https://gist.github.com/monkstone/6ae9840d7b7008c177b4a9f589d14ec6). To keep your system clean put the file in a folder say
 `~/install_picrate`
 
 ```bash
 cd ~/picrate_install
-bash picrate_install.sh # to run default task
+bash picrate2_install.sh # to run default task
 ```
 #### What the script does ###
 1. Downloads JRuby
 2. Installs JRuby to `/opt`
 3. Uses `update-alternatives` to configure `jruby`, `jgem` and `jirb`
 4. The script checks for `GEM_HOME`, if undefined it modifies `~/.profile` to define `GEM_HOME` and puts gem binaries on your path, at logon.
-5. Installs `picrate` gem
-6. Downloads and installs `picrate_samples` also configures `geanyIDE` for use with `picrate`
+5. Installs jdk11 if required sets `JAVA_HOME`, needed to support jruby
+6. Creates `~/.gemrc` with `gem: no-document`
+7. Installs `picrate` gem
+To install `picrate_samples` also configures `geanyIDE` for use with `picrate` run
+`picrate --install` in a bash console
 
 #### Note ####
-`GEM_HOME` and path to `gem` binaries is not available until next logon, to use immediately you could:-
+`GEM_HOME`, `JAVA_HOME` and path to `gem` binaries are not available until next logon, to use immediately you could:-
 
 ```bash
 source ~/.profile

data/docs/_posts/2020-05-11-getting_started_manjaro.md

@@ -0,0 +1,106 @@
+---
+layout: post
+title:  "Getting Started Manjaro"
+date:   2020-05-11 07:34:13
+categories: PiCrate update
+permalink: /getting_manjaro/
+---
+If Manjaro does not come with a pre-installed java, then the first step is to install a `jdk` the distro version (jdk14) should work. 
+
+```bash
+sudo pacman -S jdk-openjdk # current distro version jdk14
+```
+You can also use pacman to install jruby
+```bash
+sudo pacman -S jruby # current version jruby-9.2.14.0
+```
+It is probably a good idea to create a local gem store (rather needing to use sudo to install gems)
+
+```bash
+mkdir -p ~/.gem/ruby/2.5.0 # current MRI version supported by jruby
+```
+Now set your `GEM_HOME`, `GEM_PATH` and amend your `PATH` as follows:-
+
+```bash
+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
+
+```bash
+touch ~/.gemrc
+echo "gem: --no-document" > ~/.gemrc
+```
+To install latest picrate and its dependencies:-
+
+```bash
+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:-__
+
+```bash
+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:-
+
+```bash
+picrate -c my_sketch 600 400
+```
+creates file my_sketch.rb
+
+```ruby
+#!/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`
+```bash
+vim my_sketch.rb
+:!jruby % # from vim runs the sketch
+```
+
+To run sketches from command line:-
+
+```bash
+jruby --dev my_sketch.rb
+```
+
+Or even `chmod +x my_sketch.rb` to make an executable script.
+
+See [editors][geany] geany, for how to run sketches from a gui.
+
+### JWishy Sketch Running on RaspberryPI
+
+![jwishy_buster]({{ site.github.url }}/assets/jwishy_buster.png)
+
+[buster]: https://gist.github.com/monkstone/04a1272ca9274a2c7e3e1bf170877bfb
+[java]:http://ruby-processing.github.io/java/raspberry/
+[jruby]:{{ site.github.url }}/install_jruby/
+[geany]:{{ site.github.url }}/editors/geany