pbox2d 0.0.1-java → 0.1.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d58b2de1118d6e9cb55590c19e0cd0dd3d699e18
-  data.tar.gz: 1f2b801732b33388098101e973565821dd778661
+  metadata.gz: aec44c030cbe9cc96ddd4cc7b82ec504a2d16b35
+  data.tar.gz: 22f93126c2b21d6500771cc08b1050e1258a5d45
 SHA512:
-  metadata.gz: 8c323a434d3df3e99e9ab3cdfef46d528bad0cda056b31760852ae12d27f7a245e39e86be592f47c13c5639ea5a7c78efa8326b4dc8bf97d9ca2667f134a2779
-  data.tar.gz: 52c187591b38c671d9f13f0253dfe1bb53218340685621ae82976ba2b8a3c727b758219dd7da259b3eb7a46612e2250cb8b73a710d07765a69776ef9e23934ff
+  metadata.gz: abc802790642e67608f31891b40b3bd7da46146a9d6eac4b20aa0f6a45295332a71fcfd934c07307b0936141c1b2123ccb1e4464323d4a233f1f2b93d05dc973
+  data.tar.gz: 395b5211c73016df0872ab50d84a56f0ede04c5e9d68c9c801c55af5da8cb97836369011fba26d8edb4158718f3fbc78c2dae6504c7f52a8b817253552899874

data/README.md

@@ -1,6 +1,8 @@
 ### Using JBox2D in ruby-processing
 
 Here we demonstrate how to use JBox2D library as a rubygem. This approach could be an exemplar of how to use other processing/java libraries with ruby-processing  
+![liquidy](http://4.bp.blogspot.com/-dwnDQZVugwo/VFXrDxGOy4I/AAAAAAAAEgo/irsZxW_WLOA/s400/liquidy.png)
+
 
 ### Web Links
 
@@ -26,9 +28,28 @@ Copyright (c) 2014 Martin Prout
 
 ### To compile
 
-To compile the gem follow the instructions for [JRubyArt][]
+To compile the gem follow the instructions for [JRubyArt][], but also available as a ruby gem:-
+```bash
+jruby -S gem install box2d
+```
+Like really easy, but if you have to use rvm or rbenv you will also know what to do (but then you might find this all a bit difficult to understand, and wonder where the tests are, believe me you should throw away those crutches).
+
+### To use
+
+You need to `require 'pbox2d'` in the the usual way (to require a gem) but as in the included [examples][] you must also `include ContactListener` interface (by [jruby magic], including the interface as a module implements the java interface). Now you should create a new instance of Box2D.
+```ruby
+@box2d = Box2D.new(self)
+box2d.create_world 
+box2d.gravity(0, -20) # to set a custom gravity
+```
+That's about all you need to know, use the box2d instance to access the jbox2d physics world. Ordinarily (with jbox2d) you need to set some other parameters, and call `box2d.step` in the draw loop, to update the physics world.
+To make things dead simple, we have set those parameters to sensible defaults, and call `step` in the draw loop for you (under the hood using java reflection). The other thing you should know is there is a mismatch between the physics world and the sketch world (processing got it wrong to my view, down is up), further the scaling is different. This is why you need to keep translating from one worlds (coordinates) to the others coordinates, Dan Shiffman explains it in his [Nature of Code book][], Chapter 5 physics libraries, not that I've read it, I prefer to read code or [Sandi Metz][].
 
 [JBox2D Home]:http://www.jbox2d.org/
 [JBox2D on github]:https://github.com/jbox2d/jbox2d
 [Box2D for processing on github]:https://github.com/shiffman/Box2D-for-Processing
 [JRubyArt]:https://github.com/ruby-processing/JRubyArt
+[examples]:https://github.com/ruby-processing/jbox2d/blob/master/examples/liquidy.rb
+[jruby magic]:https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby
+[Nature of Code book]:http://natureofcode.com/
+[Sandi Metz]:http://www.poodr.com/

data/Rakefile

@@ -5,7 +5,7 @@ require 'rubygems/package_task'
 require 'rdoc/task'
 require 'rake/testtask'
 require 'rspec/core/rake_task'
-require_relative 'lib/box2d/version'
+require_relative 'lib/pbox2d/version'
 
 spec = Gem::Specification.new do |s|
   s.name = 'pbox2d'
@@ -23,7 +23,7 @@ EOF
   s.email = 'martin_p@lineone.net'
   s.homepage = 'https://github.com/ruby-processing/jbox2d'
   s.files = %w(LICENSE.md README.md Rakefile) + FileList['lib/**/*.rb', 'example/**/*.rb']
-  s.files << 'lib/pbox2d.jar'
+  s.files << 'lib/box2d.jar'
   s.files << 'lib/jbox2d-library-2.2.1-ds.jar' 
   s.require_path = 'lib'
   s.add_dependency "ruby-processing", "~> 2.6.4"
@@ -66,7 +66,7 @@ copy_jars(:processing_jars, 'lib')
 Rake::JavaExtensionTask.new('processing') do |ext|
   jars = FileList['lib/*.jar']
   ext.classpath = jars.map { |x| File.expand_path x}.join ':'
-  ext.name = 'pbox2d'
+  ext.name = 'box2d'
   ext.debug = true
   ext.lib_dir = 'lib'
   ext.source_version='1.7'

data/lib/pbox2d/version.rb

@@ -0,0 +1,3 @@
+module Pbox2D
+  VERSION = '0.1.0'
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pbox2d
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: java
 authors:
 - Martin Prout
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-11-01 00:00:00.000000000 Z
+date: 2014-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -65,11 +65,9 @@ files:
 - LICENSE.md
 - README.md
 - Rakefile
-- lib/box2d.rb
-- lib/box2d/version.rb
-- example/lib/particle_system.rb
-- example/liquidy.rb
-- lib/pbox2d.jar
+- lib/pbox2d.rb
+- lib/pbox2d/version.rb
+- lib/box2d.jar
 - lib/jbox2d-library-2.2.1-ds.jar
 homepage: https://github.com/ruby-processing/jbox2d
 licenses:

data/example/lib/particle_system.rb

@@ -1,152 +0,0 @@
-require 'forwardable'
-
-module Runnable
-  def run
-    reject! { |item| item.done }
-    each { |item| item.display }
-  end
-end
-
-class ParticleSystem
-  include Enumerable, Runnable
-  extend Forwardable
-  def_delegators(:@particles, :each, :reject!, :<<, :empty?)
-  def_delegator(:@particles, :empty?, :dead?)
-
-  attr_reader :particles, :x, :y
-  
-  def initialize(bd, num, x, y)
-    @particles = []          # Initialize the Array
-    @x, @y = x, y            # Store the origin point  
-    num.times do
-      self << Particle.new(bd, x, y)
-    end
-  end
-  
-  def add_particles(bd, n)
-    n.times do
-      self << Particle.new(bd, x, y)
-    end
-  end
-end
-
-# A Particle
-require 'pbox2d'
-
-class Particle
-  include Processing::Proxy
-  include PB
-  TRAIL_SIZE = 6
-  # We need to keep track of a Body
-  
-  attr_reader :trail, :body, :box2d
-  
-  # Constructor
-  def initialize(b2d, x, y)
-    @box2d = b2d
-    @trail = Array.new(TRAIL_SIZE, [x, y])
-    
-    # Add the box to the box2d world
-    # Here's a little trick, let's make a tiny tiny radius
-    # This way we have collisions, but they don't overwhelm the system
-    make_body(PB::Vec2.new(x,y), 0.2)
-  end
-  
-  # This function removes the particle from the box2d world
-  def kill_body
-    box2d.destroy_body(body)
-  end
-  
-  # Is the particle ready for deletion?
-  def done
-    # Let's find the screen position of the particle
-    pos = box2d.get_body_pixel_coord(body)
-    # Is it off the bottom of the screen?
-    return false unless (pos.y > $app.height + 20)
-    kill_body
-    true
-  end
-  
-  # Drawing the box
-  def display
-    # We look at each body and get its screen position
-    pos = box2d.get_body_pixel_coord(body)
-    # Keep track of a history of screen positions in an array
-    (TRAIL_SIZE - 1).times do |i|
-      trail[i] = trail[i + 1]
-    end
-    trail[TRAIL_SIZE - 1] = [pos.x, pos.y]
-    # Draw particle as a trail
-    begin_shape
-    no_fill
-    stroke_weight(2)
-    stroke(0, 150)
-    trail.each do |v|
-      vertex(v[0], v[1])
-    end
-    end_shape
-  end
-  
-  # This function adds the rectangle to the box2d world
-  def make_body(center, r)
-    # Define and create the body
-    bd = PB::BodyDef.new
-    bd.type = PB::BodyType::DYNAMIC
-    bd.position.set(box2d.coord_pixels_to_world(center))
-    @body = box2d.create_body(bd)
-    # Give it some initial random velocity
-    body.set_linear_velocity(PB::Vec2.new(rand(-1.0..1), rand(-1.0..1)))
-    # Make the body's shape a circle
-    cs = PB::CircleShape.new
-    cs.m_radius = box2d.scalar_pixels_to_world(r)
-    fd = PB::FixtureDef.new
-    fd.shape = cs
-    fd.density = 1
-    fd.friction = 0  # Slippery when wet!
-    fd.restitution = 0.5
-    # We could use this if we want to turn collisions off
-    #cd.filter.groupIndex = -10
-    # Attach fixture to body
-    body.create_fixture(fd)      
-  end    
-end
-  
-  
-class Boundary
-  include Processing::Proxy
-  include PB
-  attr_reader :box2d, :b, :x, :y, :w, :h 
-  
-  def initialize(b2d, x, y, w, h, a)
-    @box2d, @x, @y, @w, @h = b2d, x, y, w, h
-    # Define the polygon
-    sd = PB::PolygonShape.new
-    # Figure out the box2d coordinates
-    box2dW = box2d.scalar_pixels_to_world(w / 2)
-    box2dH = box2d.scalar_pixels_to_world(h / 2)
-    # We're just a box
-    sd.set_as_box(box2dW, box2dH)
-    # Create the body
-    bd = PB::BodyDef.new
-    bd.type = PB::BodyType::STATIC
-    bd.angle = a
-    bd.position.set(box2d.coord_pixels_to_world(x,y))
-    @b = box2d.create_body(bd)
-    # Attached the shape to the body using a Fixture
-    b.create_fixture(sd, 1)
-  end
-  
-  # Draw the boundary, it doesn't move so we don't have to ask the Body for location
-  def display
-    fill(0)
-    stroke(0)
-    stroke_weight(1)
-    rect_mode(CENTER)
-    a = b.get_angle
-    push_matrix
-    translate(x, y)
-    rotate(-a)
-    rect(0, 0, w, h)
-    pop_matrix
-  end    
-end  

data/example/liquidy.rb

@@ -1,40 +0,0 @@
-require 'box2d'
-require_relative 'lib/particle_system'
-attr_reader :box2d, :boundaries, :systems
-
-include ContactListener
-
-def setup
-  size(400,300)
-  @box2d = Box2D.new(self)
-  box2d.create_world  
-  # We are setting a custom gravity
-  box2d.set_gravity(0, -20)
-
-  # Create Arrays
-  @systems = []
-  @boundaries = []
-  # Add a bunch of fixed boundaries
-  boundaries << Boundary.new(box2d, 50, 100, 300, 5, -0.3)
-  boundaries << Boundary.new(box2d, 250, 175, 300, 5, 0.5)
-end
-
-def draw
-  background(255)
-  # Run all the particle systems
-  if systems.size > 0
-    systems.each do |system|
-      system.run
-      system.add_particles(box2d, rand(0..2))
-    end
-  end
-  # Display all the boundaries
-  boundaries.each(&:display)
-end
-
-def mouse_pressed
-  # Add a new Particle System whenever the mouse is clicked
-  systems << ParticleSystem.new(box2d, 0, mouse_x, mouse_y)
-end
-
-

data/lib/box2d/version.rb

@@ -1,3 +0,0 @@
-module Pbox2D
-  VERSION = '0.0.1'
-end