You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You will need to install jdk8, maven (apache-maven-3.5), jruby-9.1.16.0+, have access to processing-3.3.7 jars. Note we prefer a local install of [minitest][minitest] for testing. For the moment avoid jdk9+, except for propane development stuff.
6
+
# Tools of the Trade
8
7
9
-
### How to build ruby-processing projects ###
10
-
Install the processing core jar in your local [maven repository][local], unfortunately you will need to do this until the processing guys (mainly Ben Fry) see the light and convert vanilla processing to use a maven build. Do this for any other jars you require that are not available from maven central.
8
+
You will need to install jdk11, maven (apache-maven-3.5+), jruby-9.2.7.0+, and have access to processing jogl jars. Note we prefer a local install of [minitest] for testing. Use jdk11+, except for propane development stuff.
9
+
10
+
# How to build ruby-processing projects
11
+
12
+
Install the processing so you can access the processing hacked jogl jars, unfortunately you will need to do this until the processing guys (mainly Ben Fry) see the light and convert vanilla processing to use a maven build. Do this for any other jars you require that are not available from maven central.
11
13
12
14
```bash
13
15
git clone repo
14
16
cd repo
15
17
rake
16
18
```
19
+
17
20
It really is as simple as that...
18
21
19
22
We are using a [polyglot maven build][polyglot] and the pom.xml is only produced for reference, if modifications are required modify `pom.rb`, `Rakefile` and `*.gemspec` please don't alter the `Gemfile` (_which is only included for bundler fans_), preferably don't use `bundler` you probably don't need it, and it can't control jruby version, java version, jar version (or much else that is important to JRubyArt/propane). If your crutch is broken why use it?
Copy file name to clipboardExpand all lines: _building/hype.md
+7-6Lines changed: 7 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
layout: page
3
-
title: "Building hype library"
3
+
title: Building hype library
4
4
---
5
5
6
6
```bash
@@ -17,7 +17,8 @@ touch .mvn/extensions.xml # see below
17
17
touch pom.rb # see below
18
18
```
19
19
20
-
### extensions.xml ###
20
+
# extensions.xml
21
+
21
22
This file tells maven to do a polyglot-ruby build
22
23
23
24
```xml
@@ -31,7 +32,7 @@ This file tells maven to do a polyglot-ruby build
31
32
</extensions>
32
33
```
33
34
34
-
###pom.rb ###
35
+
# pom.rb
35
36
36
37
This is the ruby polyglot version of `pom.xml`
37
38
@@ -71,14 +72,14 @@ project 'hype' do
71
72
final_name 'hype'
72
73
end
73
74
end
74
-
75
75
```
76
+
76
77
Ideally you need apache-maven-3.5.0 installed (at least 3.3.1), to compile with
77
78
78
79
```bash
79
80
mvn package # outputs hype.jar into target folder
80
81
```
81
82
82
-
For JRubyArt wrap `hype.jar` in `library` folder, put `library` folder in a `hype` folder (and put that alondside regular processing libraries in `sketchbook/libraries` linux etc). For propane put nested hype library in `~/.propane/libraries folder` see how to install [contributed][contributed] libraries for propane.
83
+
For JRubyArt wrap `hype.jar` in `library` folder, put `library` folder in a `hype` folder (and put that alondside regular processing libraries in `sketchbook/libraries` linux etc). For propane put nested hype library in `~/.propane/libraries folder` see how to install [contributed] libraries for propane.
The natural successor to ruby-processing, for processing-3.3.7 and jruby-9.1.16.0, requires vanilla processing install. Executable `k9`. Can work without jruby install (using jruby-complete.jar). Features a --watch (-w) mode, where sketch will reload on saved changes. Supports `bare` sketches (like vanilla processing)
9
+
The natural successor to ruby-processing, for processing-3.3.7 and jruby-9.1.16.0, since version 2.0 does not require vanilla processing install. Executable `k9`. Can work without jruby install (using jruby-complete.jar). Features a --watch (-w) mode, where sketch will reload on saved changes. Supports `bare` sketches (like vanilla processing)
10
10
11
-
###propane ###
11
+
# propane
12
12
13
-
An alternative ruby-processing implementation, for processing-3.3.7 and jruby-9.1.16.0, does not require vanilla processing install, does require jruby install. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
13
+
An alternative ruby-processing implementation, for processing-3.3.7+ and jruby-9.2.7.0, does not require vanilla processing install, does require jruby install. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
14
14
15
-
###PiCrate ###
15
+
# PiCrate
16
16
17
-
An experimental ruby-processing implementation, for processing-3.3.7 and jruby-9.1.16.0, targeting linux and the raspberrypi. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
17
+
An experimental ruby-processing implementation, for processing-3.3.7 and jruby-9.2.7.0, targeting linux and the raspberrypi. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
18
18
19
-
###pbox2d ###
19
+
# pbox2d
20
20
21
21
Gem wrapper around [jbox2d][pbox2d] for JRubyArt and propane
22
22
23
-
###toxiclibs ###
23
+
# toxiclibs
24
24
25
25
Gem wrapper around [toxiclibs libraries][toxiclibs] for JRubyArt and propane
26
26
27
-
###geomerative ###
27
+
# geomerative
28
28
29
29
Gem wrapper around [geomerative library][geomerative] for JRubyArt and propane
30
30
31
-
###ruby_wordcram ###
31
+
# ruby_wordcram
32
32
33
33
Gem wrapper around [WordCram library][wordcram] for JRubyArt and propane, create word clouds in ruby.
34
34
35
-
###joonsrenderer ###
35
+
# joonsrenderer
36
36
37
37
Gem wrapper around [joonsrenderer library][joonsrenderer] for JRubyArt and propane, enables sunflow raytracing of sketches
38
38
39
-
###filters4jruby_art
39
+
# filters4jruby_art
40
40
41
41
A set of GLSL filters for use with JRubyArt (propane), as [example sketches][examples]
42
42
43
-
###atom-k9 ###
43
+
# atom-k9
44
44
45
-
The [atom-k9][atom-k9] package allows you run JRubyArt sketches from atom editor
45
+
The [atom-k9] package allows you run JRubyArt sketches from atom editor
46
46
47
-
###language-jruby-art ###
47
+
# language-jruby-art
48
48
49
-
The [language-jruby-art][language-jruby-art] provides syntax highlighting and snippets for JRubyArt and propane
49
+
The [language-jruby-art] provides syntax highlighting and snippets for JRubyArt and propane
Copy file name to clipboardExpand all lines: about.md
+24-22Lines changed: 24 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -3,35 +3,37 @@ layout: page
3
3
title: About
4
4
permalink: /about/
5
5
---
6
-
### The group ###
7
-
The ruby-processing group exists to collect together projects that support creating and running processing sketches in ruby. It is also designed to hide the inevitably high [bus factor][bus] of what is an essentially __one man band__, but I am trying hard to make it otherwise (including evolving the code). You could play your part...
8
6
9
-
There are three main projects [JRubyArt][jruby_art], [PiCrate][picrate] and [propane][propane], [JRubyArt][jruby_art] is the closest to the original ruby-processing and provides a ruby wrapper around the latest [vanilla processing][processing], it depends on a vanilla processing install (but can be configured to not require a jruby install).
7
+
# The group
10
8
11
-
[PiCrate][picrate] is a standalone version designed for the [RaspberryPI][rpi].
9
+
The ruby-processing group exists to collect together projects that support creating and running processing sketches in ruby. It is also designed to hide the inevitably high [bus factor][bus] of what is an essentially **one man band**, but I am trying hard to make it otherwise (including evolving the code). You could play your part...
12
10
13
-
[Propane][propane]is a configuration free, complete version of ruby-processing (_does not require installed vanilla processing_) that depends on an installed jruby (_is slightly more experimental however since a modified PApplet is required with jdk9+ propane may take over in future_). Since propane-3.2.0, propane is compiled with jdk11, and thus jdk11 is a requirement.
11
+
There are three main projects [JRubyArt][jruby_art], [PiCrate] and [propane], [JRubyArt][jruby_art]is the closest to the original ruby-processing and provides a ruby implementation that approximates to the latest [vanilla processing][processing] (but can be configured to not require a jruby install).
14
12
15
-
Other projects include the pbox2d gem (a gem wrapper around [jbox2d][jbox2d]), toxiclibs gem (a gem wrapper around [toxiclibs][toxiclibs]) and geomerative gem (a gem wrapper around [geomerative][geomerative]).
13
+
[Propane] is a configuration free, complete version of ruby-processing (_does not require installed vanilla processing_) that depends on an installed jruby (_is slightly more experimental however since a modified PApplet is required with jdk9+ propane may take over in future_). Since propane-3.2.0, propane is compiled with jdk11, and thus jdk11 is a requirement.
16
14
17
-
Not forgetting the atom editor projects [atom-k9][atom-k9]and [language-jruby-art][language]
15
+
[PiCrate] is a standalone version designed for the [RaspberryPI][rpi], but can be developed and run 64 bit linux.
18
16
19
-
#### Martin Prout ####
17
+
Other projects include the pbox2d gem (a gem wrapper around [jbox2d]), toxiclibs gem (a gem wrapper around [toxiclibs]) and geomerative gem (a gem wrapper around [geomerative]).
20
18
21
-
First degree was BSc hons Biochemistry from University of Surrey, I went on to specialize in xenobiotic metabolism (at first drugs, then industrial chemicals and pesticides). I later studied for a computer science degree with the Open University (BSc hons 2:1 but completed insufficient specific modules to be a named degree), course included some smalltalk but mainly java. Subsequently I dabbled a bit with C++, perl python, and even lisp, but got hooked on ruby, particulary ruby-processing. OS experience Windows-98 up to Windows-XP and mainly linux since 2004 (tried gentoo, fedora, even pardus) now using exclusively Archlinux and Mint (Debian). Since November 2012 I have been sole developer/maintainer of [ruby-processing][ruby-processing] (_did update for processing-2.0_), and I have since developed JRubyArt and propane (_for processing-3.0+_) and ensured that jruby-9.2.0.0+ (with support from jruby group) continues to work with ruby-processing, and its descendants.
19
+
Not forgetting the atom editor projects [atom-k9]and [language-jruby-art][language]
22
20
23
-
Personally I can't understand why processing group spawned p5*js (javascript is just horrible), but I learned sufficient to develop atom packages [atom-k9][atom-k9] and [language-jruby-art][language] for JRubyArt / propane.
21
+
## Martin Prout
24
22
23
+
First degree was BSc hons Biochemistry from University of Surrey, I went on to specialize in xenobiotic metabolism (at first drugs, then industrial chemicals and pesticides). I later studied for a computer science degree with the Open University (BSc hons 2:1 but completed insufficient specific modules to be a named degree), course included some smalltalk but mainly java. Subsequently I dabbled a bit with C++, perl python, and even lisp, but got hooked on ruby, particulary ruby-processing. OS experience Windows-98 up to Windows-XP and mainly linux since 2004 (tried gentoo, fedora, even pardus) now using exclusively Archlinux and Mint (Debian). Since November 2012 I have been sole developer/maintainer of [ruby-processing] (_did update for processing-2.0_), and I have since developed JRubyArt and propane (_for processing-3.0+_) and ensured that jruby-9.2.0.0+ (with support from jruby group) continues to work with ruby-processing, and its descendants.
24
+
25
+
Personally I can't understand why processing group spawned p5*js (javascript is just horrible), but I learned sufficient to develop atom packages [atom-k9] and [language-jruby-art][language] for JRubyArt / propane.
0 commit comments