toxiclibs 0.4.0 → 0.8.0

data/README.md

@@ -1,13 +1,15 @@
-## Using Toxiclibs jars in JRubyArt
-Current Gem Version 0.4.0
+## Toxiclibs for JRubyArt
+
+![travis build](https://travis-ci.org/ruby-processing/toxicgem.svg)
+
 ### Installing
 ```bash
 gem install toxiclibs
 ```
 
-### NB: Also works with ruby-processing
+### NB: Use version 0.4 for ruby-processing
 
-Here I have created create a gem to use Karsten Schmidts (aka toxi, @postspectacular) toxiclibs jars in JRubyArt. To compile the gem follow the instructions for [JRubyArt][]. Most parts of toxiclibs API is exposed in the latest version, (but only a few examples are included) in principle it should be possible to make all available!!! For this demonstration I have used up to date source code for version 21, since [toxis final release][] may never materialise (he's probably got more interesting things to do). There are reported to be number of outstanding bugs with toxiclibs, if they affect you report it [here][] (or better fix them yourself and submit a pull request).
+Here I have created create a gem to use Karsten Schmidts (aka toxi, @postspectacular) toxiclibs jars in JRubyArt. To compile the gem follow the instructions for [JRubyArt][]. Most parts of toxiclibs API is exposed in the latest version, (but only a few examples are included) in principle it should be possible to make all available!!! For this demonstration I have used up to date source code for version 21, since [toxis final release][] may never materialise (he's probably got more interesting things to do). There are reported to be number of outstanding bugs with toxiclibs, if they affect you report it [here][] (or better fix them yourself and submit a pull request). Version 0.5.0+ features java code updated to use java lambda (jdk8) and was compiled against processing-3.0.1 core.jar.  Added features are export Mesh to PShape and export Mesh to [povray mesh2](http://www.povray.org/documentation/3.7.0/r3_4.html#r3_4_5_2_4).
 
 ![grayscott image](http://4.bp.blogspot.com/-d4MiL4_0Njk/VFJMv6VUicI/AAAAAAAAEgY/fFAfrXDxNXM/s400/grayscott.png)
 
@@ -23,9 +25,7 @@ Here I have created create a gem to use Karsten Schmidts (aka toxi, @postspectac
 
 ### Licensing
 
-I should be clear that toxiclibs are the work of Karsten Schmidt:-
-
-Copyright (c) 2010 Karsten Schmidt
+I should be clear that the original toxiclibs is the work of Karsten Schmidt see [Copyright[]
  
 This demo & library is free software you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -39,3 +39,5 @@ version 2.1 of the License, or (at your option) any later version.
 [Toxiclibs Documentation]:http://toxiclibs.org/
 [Example Usage]:https://github.com/ruby-processing/toxicgem/tree/master/examples
 [here]:https://github.com/ruby-processing/toxiclibs/issues
+[Copyright]:https://github.com/ruby-processing/toxiclibs/COPYING.md
+

data/Rakefile

@@ -1,94 +1,38 @@
-require 'rubygems'
-require 'rake'
-require 'rake/clean'
-require 'rubygems/package_task'
-require 'rdoc/task'
-require 'rake/testtask'
-require 'rspec/core/rake_task'
 require_relative 'lib/toxiclibs/version'
 
-spec = Gem::Specification.new do |s|
-  s.name = 'toxiclibs'
-  s.version = Toxiclibs::VERSION
-  s.has_rdoc = true
-  s.extra_rdoc_files = ['README.md', 'LICENSE.md']
-  s.summary = 'Experimental gem for some toxiclibs'
-  s.description = 'A gem wrapper for some toxiclibs jars'
-  s.license = 'GPLv3'
-  s.authors = ['Karsten Schmidt', 'Martin Prout']
-  s.email = 'martin_p@lineone.net'
-  s.homepage = 'https://github.com/ruby-processing/toxiclibs'
-  s.files = %w(LICENSE.md README.md Rakefile) + FileList['lib/**/*.rb', 'example/**/*.rb']
-  s.files << 'lib/toxiclibs.jar' 
-  s.require_path = 'lib'
-  s.add_development_dependency "rake", "~> 10.3"
-  s.add_development_dependency "rake-compiler", "~> 0.9"
-  s.requirements << 'A decent graphics card'
-  s.requirements << 'java runtime >= 1.7+'
-  s.requirements << 'jruby_art = 0.2+'
-end
-
-# -*- ruby -*-
-
-require 'java'
-require 'rake/javaextensiontask'
-
-# -*- encoding: utf-8 -*-
-require 'psych'
-
-def copy_jars(name, dest)
-  conf = '~/.jruby_art/config.yml'
-  begin
-    path = File.expand_path(conf)
-    rp_config = (Psych.load_file(path))
-    source= "#{rp_config["PROCESSING_ROOT"]}/core/library/"    
-  rescue
-    raise "WARNING: you must set PROCESSING_ROOT in #{conf} compile"
+def create_manifest
+  title =  'Implementation-Title: toxiclibs (java extension for toxicgem)    '        
+  version =  format('Implementation-Version: %s', Toxiclibs::VERSION)
+  file = File.open('MANIFEST.MF', 'w') do |f|
+    f.puts(title)
+    f.puts(version)
   end
-	body = proc {
-	  Dir["#{source}/core.jar"].each do |f|
-	    puts "Copying #{f} To #{dest}"
-	    FileUtils.cp f, dest
-	  end
-	}
-	Rake::Task.define_task(name, &body)	
 end
 
-copy_jars(:processing_jars, 'lib')
+task default: [:init, :compile, :gem]
 
-Rake::JavaExtensionTask.new('toxi') do |ext|
-  jar = 'lib/core.jar'
-  ext.classpath = File.expand_path(jar)
-  ext.name = 'toxiclibs'
-  ext.debug = true
-  ext.lib_dir = 'lib'
-  ext.source_version='1.7'
-  ext.target_version='1.7'
+desc 'Create Manifest'
+task :init do
+  create_manifest
 end
 
-Gem::PackageTask.new(spec) do |p|
-  p.gem_spec = spec
-  p.need_tar = true
-  p.need_zip = true
+desc 'Build gem'
+task :gem do
+  sh "gem build toxiclibs.gemspec" 
 end
 
-Rake::RDocTask.new do |rdoc|
-  files = ['README.md', 'LICENSE.md'] + FileList['lib/**/*.rb']
-  
-  rdoc.rdoc_files.add(files)
-  rdoc.main = "README.md" # page to start on
-  rdoc.title = "Toxiclibs Docs"
-  rdoc.rdoc_dir = 'doc/rdoc' # rdoc output folder
-  rdoc.options << '--line-numbers'
+desc 'Compile'
+task :compile do
+  sh "mvn package"
+  sh "mvn dependency:copy"
+  sh "mv target/toxiclibs.jar lib"
 end
 
-Rake::TestTask.new do |t|
-  t.test_files = FileList['test/**/*.rb']
-end
-
-RSpec::Core::RakeTask.new do |spec|
-  spec.pattern = 'spec/*_spec.rb'
-  spec.rspec_opts = [Dir["lib"].to_a.join(':')]
+desc 'clean'
+task :clean do
+  Dir['./**/*.%w{jar gem}'].each do |path|
+    puts "Deleting #{path} ..."
+    File.delete(path)
+  end
+  FileUtils.rm_rf('./target')
 end
-
-

data/examples/README.md

@@ -0,0 +1,5 @@
+Certain sketches in this folder need to be run with the `--nojruby` flag:-
+
+`physics_type.rb`
+
+`gray_scott_image.rb`

data/examples/attract_repel/attract_repel.rb

@@ -0,0 +1,30 @@
+require 'toxiclibs'
+require_relative 'attractor'
+require_relative 'particle'
+
+attr_reader :particles, :attractor, :physics
+
+def settings
+  size 640, 360
+end
+
+def setup
+  sketch_title "Attract Repel"
+  @physics = Physics::VerletPhysics2D.new
+  physics.setDrag(0.01)
+  @particles = (0..50).map { Particle.new(TVec2D.new(rand(width), rand(height))) }
+  @attractor = Attractor.new(TVec2D.new(width / 2, height / 2))
+end
+
+def draw
+  background(255)
+  physics.update
+  attractor.display
+  particles.each(&:display)
+  if mouse_pressed?
+    attractor.lock
+    attractor.set(mouse_x, mouse_y)
+  else
+    attractor.unlock
+  end
+end

data/examples/attract_repel/attractor.rb

@@ -0,0 +1,23 @@
+require 'forwardable'
+
+# The Nature of Code
+# Daniel Shiffman
+# http://natureofcode.com
+class Attractor < Physics::VerletParticle2D
+  extend Forwardable
+  def_delegators(:@app, :fill, :ellipse, :physics, :width)
+  attr_accessor :r
+
+  def initialize(loc)
+    super(loc)
+    @app = $app
+    @r = 24
+    physics.add_particle(self)
+    physics.add_behavior(Physics::AttractionBehavior2D.new(self, width, 0.1))
+  end
+
+  def display
+    fill(0)
+    ellipse(x, y, r * 2, r * 2)
+  end
+end

data/examples/attract_repel/particle.rb

@@ -0,0 +1,27 @@
+require 'forwardable'
+
+# The Nature of Code
+# Daniel Shiffman
+# http://natureofcode.com
+
+# class Spore extends the class "VerletParticle2D"
+class Particle < Physics::VerletParticle2D
+  extend Forwardable
+  def_delegators(:@app, :fill, :stroke, :stroke_weight, :ellipse, :physics)
+  attr_reader :r
+
+  def initialize(loc)
+    super(loc)
+    @app = $app
+    @r = 8
+    physics.add_particle(self)
+    physics.add_behavior(Physics::AttractionBehavior2D.new(self, r * 4, -1))
+  end
+
+  def display
+    fill 127
+    stroke 0
+    stroke_weight 2
+    ellipse x, y, r * 2, r * 2
+  end
+end

data/examples/force_directed/cluster.rb

@@ -0,0 +1,76 @@
+#
+# Copyright (c) 2010 Daniel Shiffman
+#
+# This demo & library is free software you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# http://creativecommons.org/licenses/LGPL/2.1/
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+class Cluster
+  attr_reader :nodes, :diameter, :physics
+
+  # We initialize a with a number of nodes, a diameter, and centerpoint
+  def initialize(physics, n, d, center)
+    @physics = physics
+    @diameter = d
+    @nodes = (0..n).map { Node.new(center.add(TVec2D.random_vector)) }
+    # Connect all the nodes with a Spring
+    nodes[1..nodes.size - 1].each_with_index do |pi, i|
+      nodes[0..i].each do |pj|
+        physics.add_spring(Physics::VerletSpring2D.new(pi, pj, diameter, 0.01))
+      end
+    end
+  end
+
+  def display
+    nodes.each(&:display)
+  end
+  # This functons connects one cluster to another
+  # Each point of one cluster connects to each point of the other cluster
+  # The connection is a "VerletMinDistanceSpring"
+  # A VerletMinDistanceSpring is a spring which only enforces its rest length if the
+  # current distance is less than its rest length. This is handy if you just want to
+  # ensure objects are at least a certain distance from each other, but don't
+  # care if it's bigger than the enforced minimum.
+
+  def connect(other)
+    other_nodes = other.nodes
+    nodes.each do |pi|
+      other_nodes.each do |pj|
+        physics.add_spring(Physics::VerletMinDistanceSpring2D.new(pi, pj, (diameter + other.diameter) * 0.5, 0.05))
+      end
+    end
+  end
+
+  # Draw all the internal connections
+  def internal_connections(app)
+    app.stroke(200, 0, 0, 80)
+    nodes[0..nodes.size - 1].each_with_index do |pi, i|
+      nodes[i + 1..nodes.size - 1].each do |pj|
+        app.line(pi.x, pi.y, pj.x, pj.y)
+      end
+    end
+  end
+
+  # Draw all the connections between this and another Cluster
+  def show_connections(app, other)
+    app.stroke(200, 200, 0, 20)
+    app.stroke_weight(2)
+    other_nodes = other.nodes
+    nodes.each do |pi|
+      other_nodes[0..other_nodes.size - 1].each do |pj|
+        app.line(pi.x, pi.y, pj.x, pj.y)
+      end
+    end
+  end
+end

data/examples/force_directed/force_directed_graph.rb

@@ -0,0 +1,92 @@
+require 'jruby_art'
+require 'toxiclibs'
+require_relative 'cluster'
+require_relative 'node'
+
+#
+# Copyright (c) 2010 Daniel Shiffman
+#
+# This demo & library is free software you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# http://creativecommons.org/licenses/LGPL/2.1/
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+attr_reader :physics, :clusters, :show_physics, :show_particles, :f
+
+def settings
+  size(640, 360)
+end
+
+def setup
+  sketch_title 'Force Directed Graph'
+  @f = create_font('Georgia', 12, true)
+  @show_physics = true
+  @show_particles = true
+  # Initialize the physics
+  @physics = Physics::VerletPhysics2D.new
+  physics.set_world_bounds(Toxi::Rect.new(10, 10, width - 20, height - 20))
+  # Spawn a new random graph
+  new_graph
+end
+
+# Spawn a new random graph
+def new_graph
+  # Clear physics
+  physics.clear
+  center = TVec2D.new(width / 2, height / 2)
+  @clusters = (0..8).map { Cluster.new(physics, rand(3..8), rand(20..100), center) }
+  #	All clusters connect to all clusters
+  clusters.each_with_index do |ci, i|
+    clusters[i + 1..clusters.size - 1].each do |cj|
+      ci.connect(cj)
+    end
+  end
+end
+
+def draw
+  # Update the physics world
+  physics.update
+  background(255)
+  # Display all points
+  clusters.each(&:display) if show_particles
+  # If we want to see the physics
+  if show_physics
+    clusters.each_with_index do |ci, i|
+      ci.internal_connections self
+      # Cluster connections to other clusters
+      clusters[1 + i..clusters.size - 1].each do |cj|
+        ci.show_connections(self, cj)
+      end
+    end
+  end
+  # Instructions
+  fill(0)
+  text_font(f)
+  text("'p' to display or hide particles\n'c' to display or hide connections\n'n' for new graph", 10, 20)
+end
+
+# Key press commands
+def key_pressed
+  case key
+  when 'c'
+    @show_physics = !show_physics
+    @show_particles = true unless show_physics
+  when 'p'
+    @show_particles = !show_particles
+    @show_physics = true unless show_particles
+  when 'n'
+    new_graph
+  end
+end
+

data/examples/force_directed/node.rb

@@ -0,0 +1,26 @@
+require 'forwardable'
+
+# The Nature of Code
+# Daniel Shiffman
+# http://natureofcode.com
+# Force directed graph
+# Heavily based on: http://code.google.com/p/fidgen/
+# Notice how we are using inheritance here!
+# We could have just stored a reference to a VerletParticle object
+# inside the Node class, but inheritance is a nice alternative
+class Node < Physics::VerletParticle2D
+  extend Forwardable
+  def_delegators(:@app, :fill, :stroke, :stroke_weight, :ellipse)
+  def initialize(pos)
+    super(pos)
+    @app = $app
+  end
+
+  # All we're doing really is adding a display function to a VerletParticle
+  def display
+    fill(50, 200, 200, 150)
+    stroke(50, 200, 200)
+    stroke_weight(2)
+    ellipse(x, y, 16, 16)
+  end
+end