picrate 2.0.1-java → 2.3.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7698cb99a4ff6ebff96bc82f20a3121bda1af52118a1cdcfd48942bec2ed7a4
-  data.tar.gz: 42555f15e9ed7f238283878ec6291f84242d3a3782b5d9d41c23abc62eed45dd
+  metadata.gz: 2e297a6447b346b596fdc87a909fe388a0cd42f7f8a7f4b2a48d523bba03a2e6
+  data.tar.gz: 8d0ead8d48a2c9a05caa6e0e27674f433af3acea1c1fd9045f19aa00f45f08db
 SHA512:
-  metadata.gz: a3c695a7cbbb47660d0cf472ac1ce50e859ecdb4e6271bdb6b9e1862a9a94b479a58ad4be146632d245322660995d020b517ae171acc665a252e41a885cc4757
-  data.tar.gz: 94eaeb3df23ea29ad3bf58cfd8b1d8a5008c21133c52a76bbf709b87a1c0954fcaca6bcc4457d3d804c92c761fdcfc62e202bb26b947bef4c8a4fdd89b851563
+  metadata.gz: e1f3cdf8c0d0e22193b6d2686a4b0d5bb2f37129e5df058086b5279ca2711fdd6eee91d6701cccc59c7c564db2012da86fad2cfd648df31ed6f091e1166b4409
+  data.tar.gz: 7df4dfab9072b06f42190aa042fa47cb91979f323f3040b6697b799e31dfff79ca4f6b12f7998bd7909ca8dcb90566ab152fd1ab4e50f639b597671b6885e8a5

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.6
     </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.3.0 Abandon Processing Value Noise in favour of OpenSimplex2, with choosable options. Added pdf library using iText5.
+
+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

data/README.md

@@ -14,19 +14,19 @@ jgem install picrate
 
 Clone main branch:-
 
-Requires java to build (and jogl-2.4.0-rc 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.
+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 # or whatever you call it
 rake # assumes an installed version of vanilla processing
-jgem install picrate-2.0.1-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
@@ -57,3 +57,6 @@ jruby --dev my_sketch.rb # --dev flag speeds start-up
 
 [buster]:https://gist.github.com/monkstone/6ae9840d7b7008c177b4a9f589d14ec6
 [propane]:https://ruby-processing.github.io/propane/
+[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

@@ -9,7 +9,7 @@ task default: %i[init compile install test gem]
 # Currently depends on local jogl-2.4.0 jars on path ~/jogl24
 desc 'Copy Jars'
 task :init do
-  jogl24 = File.join(HOME_DIR, 'jogl24')
+  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|
@@ -19,6 +19,7 @@ end
 
 desc 'Install'
 task :install do
+  sh "mvn dependency:copy"
   FileUtils.mv "target/picrate-#{PiCrate::VERSION}.jar", 'lib'
 end
 

data/docs/_includes/footer.html

@@ -29,7 +29,7 @@
       </div>
 
       <div class="footer-col footer-col-3">
-        <p>{{ site.description }}</p>
+        <p>{{ site.description }}
       </div>
     </div>
 

data/docs/_layouts/post.html

@@ -5,7 +5,7 @@ layout: default
 
   <header class="post-header">
     <h1 class="post-title">{{ page.title }}</h1>
-    <p class="post-meta">{{ page.date | date: "%b %-d, %Y" }}{% if page.author %} • {{ page.author }}{% endif %}{% if page.meta %} • {{ page.meta }}{% endif %}</p>
+    <p class="post-meta">{{ page.date | date: "%b %-d, %Y" }}{% if page.author %} • {{ page.author }}{% endif %}{% if page.meta %} • {{ page.meta }}{% endif %}
   </header>
 
   <article class="post-content">

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/_methods/noise_mode.md

@@ -0,0 +1,88 @@
+---
+layout: post
+title:  "noise_mode"
+---
+
+### Name ###
+
+`noise_mode` _NB: not currently available in vanilla processing_.
+
+### Examples ###
+
+```ruby
+#!/usr/bin/env jruby -w
+require 'picrate'
+
+class TestNoise < Processing::App
+  attr_reader :z
+
+  def setup
+    stroke(255, 64)
+    @z = 0
+  end
+
+  def draw
+    noise_scale = 0.01
+    background(0)
+    grid(width, height, 10, 10) do |x, y|
+      arrow(x, y, noise(x * noise_scale, y * noise_scale, z * noise_scale) * TWO_PI * 2)
+    end
+    @z += 1
+  end
+
+  def mouse_pressed
+    mode = NoiseMode::OPEN_SMOOTH # Smooth classic OpenSimplex2
+    noise_mode mode
+    sketch_title mode.description
+  end
+
+  def mouse_released
+    mode = NoiseMode::DEFAULT # Fast classic OpenSimplex2
+    noise_mode(mode)
+    sketch_title mode.description
+  end
+
+
+  def arrow(x, y, ang)
+    push_matrix()
+    translate(x, y)
+    rotate(ang)
+    line(0, 0, 20, 0)
+    translate(20, 0)
+    rotate(PI + 0.4)
+    line(0, 0, 5, 0)
+    rotate(-0.8)
+    line(0, 0, 5, 0)
+    pop_matrix()
+  end
+
+  def settings
+    size(600, 400, P2D)
+  end
+end
+
+TestNoise.new
+
+```
+
+### Description	###
+
+Currently supports four implementations of noise:-
+1. DEFAULT # fast classic OpenSimplex2
+2. OPEN_SMOOTH # smoother class OpenSimplex2F
+3. FAST_TERRAIN # more suited to terrain
+4. SMOOTH_TERRAIN # as above but smoother
+
+### Syntax ###
+
+```ruby
+noise_mode(mode) # default is NoiseMode::DEFAULT, a fast classic OpenSimplex2
+```
+
+### Related ###
+
+`noise(x, y, z, w)`
+
+`noise(x, y, z)`
+
+`noise(x, y)`

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.
@@ -38,9 +38,9 @@ export PATH="${PATH}:${GEM_PATH}/bin"
 
 ### Automated install using bash ###
 
-The [picrate2_install.sh][bash] script currently installs jruby-9.2.11.0 and picrate-2.0.pre.
+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"
+[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-11-18-building-gem.md

@@ -6,7 +6,7 @@ categories: PiCrate update
 ---
 Requirements:-
 
-1. Latest jogl-2.4.0-rc jars (place in ~/jogl24 folder).
+1. Latest jogl-2.4.0-rc jars (place in ~/jogl-2.4-rc2021011 folder see [jogl-jars][jars]).
 
 2. jdk-11+ and maven
 
@@ -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/2020-03-09-auto_install_picrate.md

@@ -18,10 +18,9 @@ bash picrate2_install.sh # to run default task
 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 jdk11 if required sets `JAVA_HOME`, needed to support jruby (--add-opens)
+5. Installs jdk11 if required sets `JAVA_HOME`, needed to support jruby
 6. Creates `~/.gemrc` with `gem: no-document`
-7. Creates `~/.jruby.java_opts` with `--add-opens` to suppress reflective access warnings.
-8. Installs `picrate` gem
+7. Installs `picrate` gem
 To install `picrate_samples` also configures `geanyIDE` for use with `picrate` run
 `picrate --install` in a bash console
 

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

@@ -5,11 +5,19 @@ date:   2020-05-11 07:34:13
 categories: PiCrate update
 permalink: /getting_manjaro/
 ---
-Currently Manjaro does not come with a pre-installed java. So the first step is to install a `jdk` we currently recommend installing hotspot adopt-openjdk11 from the AdoptOpenJDK project. Setting the JDK_HOME environment and then manually install the latest JRuby. It is probably worth creating a symbolic links to `/usr/bin/jruby` and `/usr/bin/jgem` from wherever you installed jruby eg /opt folder.
+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/jruby/2.5.0
+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:-
 
@@ -19,16 +27,20 @@ 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.
-Install a local version of rake:-
+Now should be ready to install `picrate` and other gems. But speed up install time you should set `--no-document` option in ~/.gemrc
+
 ```bash
-jgem install rake
+touch ~/.gemrc
+echo "gem: --no-document" > ~/.gemrc
 ```
 To install latest picrate and its dependencies:-
 
 ```bash
-jgem install picrate --pre
+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
@@ -37,7 +49,7 @@ picrate --install # no args, install samples and geany config
 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.
+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:-
 
@@ -77,7 +89,7 @@ vim my_sketch.rb
 To run sketches from command line:-
 
 ```bash
-jruby my_sketch.rb
+jruby --dev my_sketch.rb
 ```
 
 Or even `chmod +x my_sketch.rb` to make an executable script.

data/docs/classes.md

@@ -5,6 +5,6 @@ title: Classes
 
 {% for class in site.classes %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ class.url | prepend: site.github.url }}">{{ class.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ class.url | prepend: site.github.url }}">{{ class.title }}</a></h2>
 {% endfor %}

data/docs/editors.md

@@ -5,6 +5,6 @@ title: Editors
 
 {% for editor in site.editors %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ editor.url | prepend: site.github.url }}">{{ editor.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ editor.url | prepend: site.github.url }}">{{ editor.title }}</a></h2>
 {% endfor %}

data/docs/gems.md

@@ -4,8 +4,8 @@ title: Gems
 ---
 {% for gem in site.gems %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ gem.url | prepend: site.github.url }}">{{ gem.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ gem.url | prepend: site.github.url }}">{{ gem.title }}</a></h2>
 {% endfor %}
 
-<p>If you are new to ruby, see <a href="http://guides.rubygems.org/what-is-a-gem/">what is a gem here</a></p>
+<p>If you are new to ruby, see <a href="http://guides.rubygems.org/what-is-a-gem/">what is a gem here</a>

data/docs/index.html

@@ -23,6 +23,6 @@ layout: default
     {% endfor %}
   </ul>
 
-  <p class="rss-subscribe">subscribe <a href="{{ "/feed.xml" | prepend: site.github.url }}">via RSS</a></p>
+  <p class="rss-subscribe">subscribe <a href="{{ "/feed.xml" | prepend: site.github.url }}">via RSS</a>
 
 </div>

data/docs/libraries.md

@@ -6,8 +6,8 @@ It is possible to use vanilla <a href="https://www.processing.org/reference/libr
 
 {% for library in site.libraries %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ library.url | prepend: site.github.url }}">{{ library.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ library.url | prepend: site.github.url }}">{{ library.title }}</a></h2>
 {% endfor %}
 
 <h4>Key To Library Types</h4>

data/docs/live.md

@@ -6,6 +6,6 @@ Spoiler alert, initially a least it is better just to accept the live works...
 
 {% for live_mode in site.live %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ live_mode.url | prepend: site.github.url }}">{{ live_mode.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ live_mode.url | prepend: site.github.url }}">{{ live_mode.title }}</a></h2>
 {% endfor %}

data/docs/magic.md

@@ -6,6 +6,6 @@ Spoiler alert, initially a least it is better just to accept the magic works...
 
 {% for spell in site.magic %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ spell.url | prepend: site.github.url }}">{{ spell.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ spell.url | prepend: site.github.url }}">{{ spell.title }}</a></h2>
 {% endfor %}

data/docs/methods.md

@@ -5,6 +5,6 @@ title: Methods
 
 {% for method in site.methods %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ method.url | prepend: site.github.url }}">{{ method.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ method.url | prepend: site.github.url }}">{{ method.title }}</a></h2>
 {% endfor %}

data/docs/modules.md

@@ -5,8 +5,8 @@ title: Modules
 
 {% for module in site.modules %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ module.url | prepend: site.github.url }}">{{ module.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ module.url | prepend: site.github.url }}">{{ module.title }}</a></h2>
 {% endfor %}
 
-<p>If you are new to ruby, you can read more about <a href="https://www.tutorialspoint.com/ruby/ruby_modules.htm">modules here</a></p>
+<p>If you are new to ruby, you can read more about <a href="https://www.tutorialspoint.com/ruby/ruby_modules.htm">modules here</a>

data/docs/objects.md

@@ -4,6 +4,6 @@ title: Variables and Objects
 ---
 {% for object in site.objects %}
   <h2>{{ item.title }}</h2>
-  <p>{{ item.description }}</p>
-  <p><h2><a href="{{ object.url | prepend: site.github.url }}">{{ object.title }}</a></h2></p>
+  <p>{{ item.description }}
+  <p><h2><a href="{{ object.url | prepend: site.github.url }}">{{ object.title }}</a></h2>
 {% endfor %}