pbox2d 0.6.0-java → 0.8.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2b3b3f0c237c5cf38c10b625751a518d36d692f2
-  data.tar.gz: 28aa8334e4f84613d0743949cd4f67b031612c01
+  metadata.gz: e69111dc2c65e4a119363da0d977e4f741cbdfad
+  data.tar.gz: 11341dad291d2c0626f79e89fcb810e4a2dbf800
 SHA512:
-  metadata.gz: 2857f66b9284572a9259d40e75db177eebc48c722eaabb84cf7a4241f0f601b12e172f009482d5ea2c78df5927d2c259993461376a92da58415d94b4752cbb3d
-  data.tar.gz: 4fec10358a5a1b97cd0cda88523593a755f9a0fd44b2288cc15a1fe7de2106633c4db58c7be77e044de7c3295833a1d39cd1e78577fe3b363dd92380b9d7ed30
+  metadata.gz: 621cf6a8ccb688ce6a591504bf4522753d89e882c4563da3cf68ac6c872f1a017c05d1d29e8e1d9702fcdd2e5217d4ec5babcddfa6b2f8024885dc4e53a2c9b7
+  data.tar.gz: fce9e4cf698ceec4544ab2793b1f092f0390665fd5edc9f03edb73e66396edc43b6c5e3d2b769e1fa38c6b5dd495e3a53f6b90c532ed0be943248bb66025bfe2

data/.mvn/extensions.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extensions>
+  <extension>
+    <groupId>io.takari.polyglot</groupId>
+    <artifactId>polyglot-ruby</artifactId>
+    <version>0.1.15</version>
+  </extension>
+</extensions>

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

@@ -0,0 +1 @@
+distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.3.3/apache-maven-3.3.3-bin.zip

data/.travis.yml

@@ -0,0 +1,23 @@
+sudo: false
+
+language: ruby
+
+bundler_args: --without production
+
+addons:
+  apt:
+    packages:
+      - oracle-java8-installer
+
+rvm: 
+  - jruby-head
+
+jdk:
+  - oraclejdk8
+
+env:
+  - JRUBY_OPTS="$JRUBY_OPTS" JAVA_OPTS="-Djruby.version=$JRUBY_VERSION"
+
+before_script:
+  - export JRUBY_OPTS="-Xcext.enabled=false -Xcompile.invokedynamic=false"
+

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+### v0.8.0 
+
+Update for JRubyArt-1.1+ and processing-3.1+
+
+### v0.7.0 
+
+A strike for independence, now building from source using polyglot maven
+
 ### v0.6.0
 
 Added import for jbox2d Particle, ParticleGroup etc (see PB module).  Introduced WorldBuilder module to get rid of boilerplate code for the user. Reworked examples to use a common Boundary class.

data/README.md

@@ -30,7 +30,7 @@ Copyright (c) 2014 Daniel Shiffman
  
 This gem was created by Martin Prout
 
-Copyright (c) 2015 Martin Prout
+Copyright (c) 2015/16 Martin Prout
 
 ### To compile
 
@@ -44,11 +44,11 @@ Like really easy, but if you have to use rvm or rbenv you will also know what to
 
 You need to `require 'pbox2d'` in the the usual way (to require a gem). Now you should create a new instance of Box2D. However as in this included [example][] you may also need to `include ContactListener` interface (by [jruby magic][], including the interface as a module implements the java interface) if you wish to create your own jbox2d listener. 
 ```ruby
-@box2d = Box2D.new(self)
-box2d.init_options(gravity: [0, -20]) # this is new since version 0.2.0
-box2d.create_world
+# Since version 0.6.0, use the WorldBuilder factory module (avoids boiler-plate code)
+# Only app is required there, default gravity is [0, -10], defaults to warm start
+@box2d = WorldBuilder.build(app: self, gravity: [0, -20]) 
 ```
-That's about all you need to know, to use the box2d instance to access the jbox2d physics world. Since version 0.2.0 runtime options `scale`, `gravity`, `warm_start`, and `continous_physics` option should be set using the `init_options` method see above (if unset sensible defaults are used). The `step_options` are set in the same way, but default options are often suitable. NB: You do not need to call `box2d.step` in the draw loop, to update the physics world, because we do that for you under the hood (using java reflection arghhh.....).
+That's about all you need to know, to use the box2d instance to access the jbox2d physics world. Since version 0.6.0 runtime options `scale`, `gravity`, `warm_start`, and `continous_physics` options can be set using the keyword args see above (if unset sensible defaults are used). The `step_options` are set in the same way, but default options are often suitable. NB: You do not need to call `box2d.step` in the draw loop, to update the physics world, because we do that for you under the hood (using java reflection arghhh.....).
 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 system) to the others coordinates (system), 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][]. The really brave or adventurous should probably get [this book].
 
 [JBox2D Home]:http://www.jbox2d.org/
@@ -60,6 +60,6 @@ The other thing you should know is there is a mismatch between the physics world
 [Nature of Code book]:http://natureofcode.com/
 [Sandi Metz]:http://www.poodr.com/
 [this book]:http://www.crcpress.com/product/isbn/9781466565760
-[zip]:https://github.com/ruby-processing/jbox2d/archive/0.5.0-pre.zip
-[tar]:https://github.com/ruby-processing/jbox2d/archive/0.5.0-pre.tar.gz
+[zip]:https://github.com/ruby-processing/jbox2d/archive/0.6.0.zip
+[tar]:https://github.com/ruby-processing/jbox2d/archive/0.6.0.tar.gz
 [Wiki]:https://github.com/ruby-processing/jbox2d/wiki

data/Rakefile

@@ -25,13 +25,12 @@ end
 desc 'Compile'
 task :compile do
   sh "mvn package"
-  sh "cp ${HOME}/jbox2d/jbox2d-library/target/jbox2d-library-2.3.1-SNAPSHOT.jar lib"
   sh "mv target/box2d.jar lib"
 end
 
 desc 'Build Gem'
 task :gem do
-  sh "gem build pbox2d.gemspec"
+ sh "gem build pbox2d.gemspec"
 end
 
 Rake::TestTask.new do |t|

data/lib/pbox2d/version.rb

@@ -1,4 +1,4 @@
 # module to give version a namespace
 module Pbox2d
-  VERSION = '0.6.0'
+  VERSION = '0.8.0'
 end

data/lib/pbox2d.rb

@@ -5,6 +5,7 @@ Dir[File.join(working_directory, '*.jar')].each do |jar|
 end
 
 ContactListener = Java::OrgJbox2dCallbacks::ContactListener
+ContactAdaptor = Java::OrgJbox2dCallbacks::ContactAdaptor
 
 def import_class_list(list, string)
   list.each { |d| java_import format(string, d) }

data/pbox2d.gemspec

@@ -10,24 +10,19 @@ Gem::Specification.new do |spec|
   spec.has_rdoc = true
   spec.extra_rdoc_files = ['README.md', 'LICENSE.md']
   spec.authors       = ['Martin Prout']
-  spec.email         = ['martin_p@lineone.net']
+  spec.email         = ['mamba2928@yahoo.co.uk']
   spec.summary       = %q{jbox2d wrapped in a gem for JRubyArt}
   spec.description   = <<-EOF
-"An exemplar for how processing/java libraries can be made available for use 
-in JRubyArt.  Features a maven build, also is an example of how to avoid an 
-overdose of java reflection by letting jruby sugar implement an interface"
+"An exemplar for making processing/java libraries available as a gem, for use 
+in JRubyArt. Features a polyglot maven build, and also demonstrates how creating
+an interface can avoid the need for explicit calls to java reflection."
 EOF
   spec.homepage      = 'https://github.com/ruby-processing/jbox2d'
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.files << 'lib/box2d.jar'
-  spec.files << 'lib/jbox2d-library-2.3.1-SNAPSHOT.jar' 
   spec.require_paths = ['lib']
-  spec.add_dependency 'jruby_art', '~> 1.0' 
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_dependency 'jruby_art', '~> 1.1', '>= 1.1.1'
+  spec.add_development_dependency "rake", "~> 11.1"
   spec.add_development_dependency "minitest", "~> 5.8"
   spec.platform='java'
-#  spec.requirements << 'A decent graphics card'
-#  spec.requirements << 'java runtime >= 1.8+'
-#  spec.requirements << 'processing = 3.0.1+'
-  spec.requirements << 'maven = 3.3.3'
 end

data/pom.rb

@@ -0,0 +1,59 @@
+require 'fileutils'
+project 'pbox2d', 'https://github.com/ruby-processing/jbox2d' do
+
+  model_version '4.0.0'
+  id 'ruby-processing:pbox2d', '0.8'
+  packaging 'jar'
+
+  description 'jbox2d for JRubyArt'
+
+  organization 'ruby-processing', 'https://ruby-processing.github.io'
+
+  developer 'monkstone' do
+    name 'Martin Prout'
+    email 'martin_p@lineone.net'
+    roles 'developer' 
+  end
+
+  license 'BSD-2-clause', 'http://www.opensource.org/licenses/bsd-license.php'
+
+  issue_management 'https://github.com/ruby-processing/jbox2d/issues', 'Github'
+
+  source_control(
+    :url => 'https://github.com/ruby-processing/jbox2d',
+    :connection => 'scm:git:git://github.com/ruby-processing/jbox2d.git',
+    :developer_connection => 'scm:git:git@github.com/ruby-processing/jbox2dt.git'
+  )
+  
+  properties( 'maven.compiler.source' => '1.8',
+              'project.build.sourceEncoding' => 'UTF-8',
+              'maven.compiler.target' => '1.8',
+              'polyglot.dump.pom' => 'pom.xml',
+              'processing.api' => "http://processing.github.io/processing-javadocs/core/",
+              'jruby.api' => "http://jruby.org/apidocs/"
+            )
+
+  pom 'org.jruby:jruby:9.1.2.0'
+  jar 'org.processing:core:3.1'
+  plugin_management do
+    plugin :resources, '2.6'
+    plugin :dependency, '2.8'
+    plugin( :compiler, '3.3',
+          'source' =>  '1.8',
+          'target' =>  '1.8' )
+    plugin( :javadoc, '2.10.3',
+          'detectOfflineLinks' => 'false',
+          'links' => ['${processing.api}', '${jruby.api}']
+          )
+    plugin( :jar, '2.6',
+            'archive' => {
+              'manifestFile' => 'MANIFEST.MF'
+            }
+          )
+  end
+  build do
+    default_goal 'package'
+    source_directory 'src'
+    final_name 'box2d'
+  end
+end

data/pom.xml

@@ -1,104 +1,113 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion>
-  <groupId>org.ruby-processing</groupId>
-  <artifactId>box2d</artifactId>
-  <version>0.6.0</version>
-  <packaging>jar</packaging>
-  <description>
-    jbox2d-library for JRubyArt
-  </description>
+<!--
 
-  <parent>
-    <groupId>org.sonatype.oss</groupId>
-    <artifactId>oss-parent</artifactId>
-    <version>7</version>
-  </parent>
 
-  <issueManagement>
-    <system>Github</system>
-    <url>https://github.com/ruby-processing/jbox2d/issues</url>
-  </issueManagement>
+DO NOT MODIFIY - GENERATED CODE
 
-  <scm>
-    <connection>scm:git:git://github.com/ruby-processing/jbox2d.git</connection>
-    <developerConnection>scm:git:git@github.com:ruby-processing/jbox2d.git</developerConnection>
-    <url>https://github.com/ruby-processing/jbox2d</url>
-  </scm>
 
+-->
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>ruby-processing</groupId>
+  <artifactId>pbox2d</artifactId>
+  <version>0.8</version>
+  <name>pbox2d</name>
+  <description>jbox2d for JRubyArt</description>
+  <url>https://github.com/ruby-processing/jbox2d</url>
+  <organization>
+    <name>ruby-processing</name>
+    <url>https://ruby-processing.github.io</url>
+  </organization>
   <licenses>
     <license>
       <name>BSD-2-clause</name>
       <url>http://www.opensource.org/licenses/bsd-license.php</url>
     </license>
   </licenses>
-
   <developers>
     <developer>
       <id>monkstone</id>
       <name>Martin Prout</name>
       <email>martin_p@lineone.net</email>
+      <roles>
+        <role>developer</role>
+      </roles>
     </developer>
   </developers>
-
+  <scm>
+    <connection>scm:git:git://github.com/ruby-processing/jbox2d.git</connection>
+    <developerConnection>scm:git:git@github.com/ruby-processing/jbox2dt.git</developerConnection>
+    <url>https://github.com/ruby-processing/jbox2d</url>
+  </scm>
+  <issueManagement>
+    <system>Github</system>
+    <url>https://github.com/ruby-processing/jbox2d/issues</url>
+  </issueManagement>
+  <properties>
+    <processing.api>http://processing.github.io/processing-javadocs/core/</processing.api>
+    <polyglot.dump.pom>pom.xml</polyglot.dump.pom>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <jruby.api>http://jruby.org/apidocs/</jruby.api>
+    <maven.compiler.target>1.8</maven.compiler.target>
+  </properties>
   <dependencies>
     <dependency>
-      <groupId>org.jbox2d</groupId>
-      <artifactId>jbox2d-library</artifactId>
-      <version>2.3.1-SNAPSHOT</version>
-      <scope>system</scope>
-      <systemPath>${jbox2d.home}/jbox2d-library-2.3.1-SNAPSHOT.jar</systemPath>
+      <groupId>org.jruby</groupId>
+      <artifactId>jruby</artifactId>
+      <version>9.1.2.0</version>
+      <type>pom</type>
     </dependency>
     <dependency>
       <groupId>org.processing</groupId>
       <artifactId>core</artifactId>
-      <scope>system</scope>
-      <version>3.0.1</version>
-      <systemPath>${processing.home}/core/library/core.jar</systemPath>
+      <version>3.1</version>
     </dependency>
   </dependencies>
-  <properties>
-    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <maven.compiler.source>1.8</maven.compiler.source>
-    <maven.compiler.target>1.8</maven.compiler.target>
-    <!-- for Mac developers, non Archlinux and Windows can probably figure it out
-    <processing.home>/Applications/Processing.app/Contents/Java</processing.home>
-    -->
-    <processing.home>/usr/share/processing</processing.home>
-    <jbox2d.home>${user.home}/jbox2d/jbox2d-library/target</jbox2d.home>
-  </properties>
   <build>
     <sourceDirectory>src</sourceDirectory>
+    <defaultGoal>package</defaultGoal>
     <finalName>box2d</finalName>
-    <extensions>
-      <extension>
-        <groupId>org.apache.maven.wagon</groupId>
-        <artifactId>wagon-webdav-jackrabbit</artifactId>
-        <version>2.1</version>
-      </extension>
-    </extensions>
-    <plugins>
-      <plugin>
-        <artifactId>maven-compiler-plugin</artifactId>
-        <version>3.1</version>
-        <configuration>
-          <source>1.8</source>
-          <target>1.8</target>
-        </configuration>
-      </plugin>
-      <plugin>
-        <artifactId>maven-jar-plugin</artifactId>
-        <version>2.4</version>
-        <configuration>
-          <archive>
-            <manifestFile>MANIFEST.MF</manifestFile>
-          </archive>
-        </configuration>
-      </plugin>
-      <plugin>
-        <artifactId>maven-resources-plugin</artifactId>
-        <version>2.6</version>
-      </plugin>
-    </plugins>
+    <pluginManagement>
+      <plugins>
+        <plugin>
+          <artifactId>maven-resources-plugin</artifactId>
+          <version>2.6</version>
+        </plugin>
+        <plugin>
+          <artifactId>maven-dependency-plugin</artifactId>
+          <version>2.8</version>
+        </plugin>
+        <plugin>
+          <artifactId>maven-compiler-plugin</artifactId>
+          <version>3.3</version>
+          <configuration>
+            <source>1.8</source>
+            <target>1.8</target>
+          </configuration>
+        </plugin>
+        <plugin>
+          <artifactId>maven-javadoc-plugin</artifactId>
+          <version>2.10.3</version>
+          <configuration>
+            <detectOfflineLinks>false</detectOfflineLinks>
+            <links>
+              <link>${processing.api}</link>
+              <link>${jruby.api}</link>
+            </links>
+          </configuration>
+        </plugin>
+        <plugin>
+          <artifactId>maven-jar-plugin</artifactId>
+          <version>2.6</version>
+          <configuration>
+            <archive>
+              <manifestFile>MANIFEST.MF</manifestFile>
+            </archive>
+          </configuration>
+        </plugin>
+      </plugins>
+    </pluginManagement>
   </build>
 </project>

data/src/org/jbox2d/JBox2D.gwt.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC "-//Google Inc.//DTD Google Web Toolkit 2.2.0//EN" "http://google-web-toolkit.googlecode.com/svn/tags/2.2.0/distro-source/core/src/gwt-module.dtd">
+<module>
+  <inherits name="com.google.gwt.user.User" />
+  <source path="callbacks"/>
+  <source path="collision"/>
+  <source path="common"/>
+  <source path="dynamics"/>
+  <source path="pooling"/>
+
+  <super-source path="gwtemul" />
+</module>

data/src/org/jbox2d/callbacks/ContactAdaptor.java

@@ -0,0 +1,27 @@
+/**
+ * Reduce typing by using ContactAdaptor rather than ContactListener
+ * @author Martin Prout
+ */
+package org.jbox2d.callbacks;
+
+import org.jbox2d.collision.Manifold;
+import org.jbox2d.dynamics.contacts.Contact;
+
+public abstract class ContactAdaptor implements ContactListener {
+
+    @Override
+    public void beginContact(Contact cntct) {
+    }
+
+    @Override
+    public void endContact(Contact cntct) {
+    }
+
+    @Override
+    public void preSolve(Contact cntct, Manifold mnfld) {
+    }
+
+    @Override
+    public void postSolve(Contact cntct, ContactImpulse ci) {
+    }
+}

data/src/org/jbox2d/callbacks/ContactFilter.java

@@ -0,0 +1,59 @@
+/*******************************************************************************
+ * Copyright (c) 2013, Daniel Murphy
+ * All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * 	* Redistributions of source code must retain the above copyright notice,
+ * 	  this list of conditions and the following disclaimer.
+ * 	* Redistributions in binary form must reproduce the above copyright notice,
+ * 	  this list of conditions and the following disclaimer in the documentation
+ * 	  and/or other materials provided with the distribution.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ ******************************************************************************/
+/**
+ * Created at 4:25:42 AM Jul 15, 2010
+ */
+package org.jbox2d.callbacks;
+
+import org.jbox2d.dynamics.Filter;
+import org.jbox2d.dynamics.Fixture;
+
+// updated to rev 100
+/**
+ * Implement this class to provide collision filtering. In other words, you can implement
+ * this class if you want finer control over contact creation.
+ * @author Daniel Murphy
+ */
+public class ContactFilter {
+
+	/**
+	 * Return true if contact calculations should be performed between these two shapes.
+	 * @warning for performance reasons this is only called when the AABBs begin to overlap.
+	 * @param fixtureA
+	 * @param fixtureB
+	 * @return
+	 */
+	public boolean shouldCollide(Fixture fixtureA, Fixture fixtureB){
+		Filter filterA = fixtureA.getFilterData();
+		Filter filterB = fixtureB.getFilterData();
+
+		if (filterA.groupIndex == filterB.groupIndex && filterA.groupIndex != 0){
+			return filterA.groupIndex > 0;
+		}
+
+		boolean collide = (filterA.maskBits & filterB.categoryBits) != 0 &&
+						  (filterA.categoryBits & filterB.maskBits) != 0;
+		return collide;
+	}
+}

data/src/org/jbox2d/callbacks/ContactImpulse.java

@@ -0,0 +1,42 @@
+/*******************************************************************************
+ * Copyright (c) 2013, Daniel Murphy
+ * All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * 	* Redistributions of source code must retain the above copyright notice,
+ * 	  this list of conditions and the following disclaimer.
+ * 	* Redistributions in binary form must reproduce the above copyright notice,
+ * 	  this list of conditions and the following disclaimer in the documentation
+ * 	  and/or other materials provided with the distribution.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ ******************************************************************************/
+/**
+ * Created at 3:43:53 AM Jul 7, 2010
+ */
+package org.jbox2d.callbacks;
+
+import org.jbox2d.common.Settings;
+
+/**
+ * Contact impulses for reporting. Impulses are used instead of forces because sub-step forces may
+ * approach infinity for rigid body collisions. These match up one-to-one with the contact points in
+ * b2Manifold.
+ * 
+ * @author Daniel Murphy
+ */
+public class ContactImpulse {
+  public float[] normalImpulses = new float[Settings.maxManifoldPoints];
+  public float[] tangentImpulses = new float[Settings.maxManifoldPoints];
+  public int count;
+}

data/src/org/jbox2d/callbacks/ContactListener.java

@@ -0,0 +1,87 @@
+/*******************************************************************************
+ * Copyright (c) 2013, Daniel Murphy
+ * All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * 	* Redistributions of source code must retain the above copyright notice,
+ * 	  this list of conditions and the following disclaimer.
+ * 	* Redistributions in binary form must reproduce the above copyright notice,
+ * 	  this list of conditions and the following disclaimer in the documentation
+ * 	  and/or other materials provided with the distribution.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ ******************************************************************************/
+package org.jbox2d.callbacks;
+
+import org.jbox2d.collision.Manifold;
+import org.jbox2d.dynamics.contacts.Contact;
+
+// updated to rev 100
+/**
+ * Implement this class to get contact information. You can use these results for
+ * things like sounds and game logic. You can also get contact results by
+ * traversing the contact lists after the time step. However, you might miss
+ * some contacts because continuous physics leads to sub-stepping.
+ * Additionally you may receive multiple callbacks for the same contact in a
+ * single time step.
+ * You should strive to make your callbacks efficient because there may be
+ * many callbacks per time step.
+ * @warning You cannot create/destroy Box2D entities inside these callbacks.
+ * @author Daniel Murphy
+ *
+ */
+public interface ContactListener {
+
+	/**
+	 * Called when two fixtures begin to touch.
+	 * @param contact
+	 */
+	public void beginContact(Contact contact);
+	
+	/**
+	 * Called when two fixtures cease to touch.
+	 * @param contact
+	 */
+	public void endContact(Contact contact);
+	
+	/**
+	 * This is called after a contact is updated. This allows you to inspect a
+	 * contact before it goes to the solver. If you are careful, you can modify the
+	 * contact manifold (e.g. disable contact).
+	 * A copy of the old manifold is provided so that you can detect changes.
+	 * Note: this is called only for awake bodies.
+	 * Note: this is called even when the number of contact points is zero.
+	 * Note: this is not called for sensors.
+	 * Note: if you set the number of contact points to zero, you will not
+	 * get an EndContact callback. However, you may get a BeginContact callback
+	 * the next step.
+	 * Note: the oldManifold parameter is pooled, so it will be the same object for every callback
+	 * for each thread.
+	 * @param contact
+	 * @param oldManifold
+	 */
+	public void preSolve(Contact contact, Manifold oldManifold);
+	
+	/**
+	 * This lets you inspect a contact after the solver is finished. This is useful
+	 * for inspecting impulses.
+	 * Note: the contact manifold does not include time of impact impulses, which can be
+	 * arbitrarily large if the sub-step is small. Hence the impulse is provided explicitly
+	 * in a separate data structure.
+	 * Note: this is only called for contacts that are touching, solid, and awake.
+	 * @param contact
+	 * @param impulse this is usually a pooled variable, so it will be modified after
+	 * this call
+	 */
+	public void postSolve(Contact contact, ContactImpulse impulse);
+}