P2 updates finished.

Author: photonstorm

README.md

@@ -245,10 +245,18 @@ Version 2.4 - "Katar" - in dev
 * Phaser.BitmapText no longer extends PIXI.BitmapText but replaces it entirely.
 * Phaser.Text no longer extends PIXI.Text but replaces it entirely. Phaser.Text now natively extends a Phaser Sprite, meaning it can be enabled for physics, damaged, etc.
 * Mouse.button and MSPointer.button have been removed. They never supported complex button events (such as holding down 2 buttons and releasing just one) or any buttons other than left and right. They have been replaced with the far more robust and accurate Pointer button properties such as `Pointer.leftButton`, `Pointer.rightButton` and so on.
+
+### p2.js Upgraded to version 0.7.0
+
+Phaser has been upgraded internally to use the new release of p2 physics. All Phaser based API call signatures remain unchanged unless listed below.
+
+For the full list of p2 additions please read [their change log](https://github.com/schteppe/p2.js/releases/tag/v0.7.0).
+
 * The P2.Body.onBeginContact arguments have changed. It now sends 5 arguments: The Phaser.P2.Body, the p2.Body, the p2 Shape from Body A, the p2 Shape from Body B and the contact equations array. Note that the Phaser.P2.Body may be null if you collide with a 'native' p2 body (such as the world bounds). However the p2.Body argument will always be populated.
 * The P2.Body.onEndContact arguments have changed. It now sends 4 arguments: The Phaser.P2.Body, the p2.Body, the p2 Shape from Body A and the p2 Shape from Body B. Note that the Phaser.P2.Body may be null if this is the end of a contact with a 'native' p2 body (such as the world bounds). However the p2.Body argument will always be populated.
-
-### p2.js Upgraded to version 0.7
+* P2.Body.applyImpulse allows you to apply an impulse to a Body. An impulse is a force added to a body during a short period of time.
+* P2.Body.applyImpulseLocal allows you to apply an impulse to a point local to the Body. An impulse is a force added to a body during a short period of time.
+* P2.Body.getVelocityAtPoint gets the velocity of a point in the body.
 
 ### New Features
 

src/physics/p2/Body.js

@@ -435,6 +435,20 @@ Phaser.Physics.P2.Body.prototype = {
 
     },
 
+    /**
+    * Gets the velocity of a point in the body.
+    *
+    * @method Phaser.Physics.P2.Body#getVelocityAtPoint
+    * @param {Array} result - A vector to store the result in.
+    * @param {Array} relativePoint - A world oriented vector, indicating the position of the point to get the velocity from.
+    * @return {Array} The result vector.
+    */
+    getVelocityAtPoint: function (result, relativePoint) {
+
+        return this.data.getVelocityAtPoint(result, relativePoint);
+
+    },
+
     /**
     * Apply damping, see http://code.google.com/p/bullet/issues/detail?id=74 for details.
     *
@@ -447,6 +461,38 @@ Phaser.Physics.P2.Body.prototype = {
 
     },
 
+    /**
+    * Apply impulse to a point relative to the body.
+    * This could for example be a point on the Body surface. An impulse is a force added to a body during a short 
+    * period of time (impulse = force * time). Impulses will be added to Body.velocity and Body.angularVelocity.
+    *
+    * @method Phaser.Physics.P2.Body#applyImpulse
+    * @param {Float32Array|Array} impulse - The impulse vector to add, oriented in world space.
+    * @param {number} worldX - A point relative to the body in world space. If not given, it is set to zero and all of the impulse will be exerted on the center of mass.
+    * @param {number} worldY - A point relative to the body in world space. If not given, it is set to zero and all of the impulse will be exerted on the center of mass.
+    */
+    applyImpulse: function (impulse, worldX, worldY) {
+
+        this.data.applyImpulse(impulse, [this.world.pxmi(worldX), this.world.pxmi(worldY)]);
+
+    },
+
+    /**
+    * Apply impulse to a point local to the body.
+    * This could for example be a point on the Body surface. An impulse is a force added to a body during a short 
+    * period of time (impulse = force * time). Impulses will be added to Body.velocity and Body.angularVelocity.
+    *
+    * @method Phaser.Physics.P2.Body#applyImpulseLocal
+    * @param {Float32Array|Array} impulse - The impulse vector to add, oriented in world space.
+    * @param {number} localX - A local point on the body.
+    * @param {number} localY - A local point on the body.
+    */
+    applyImpulseLocal: function (force, localX, localY) {
+
+        this.data.applyImpulseLocal(force, [this.world.pxmi(localX), this.world.pxmi(localY)]);
+
+    },
+
     /**
     * Apply force to a world point. This could for example be a point on the RigidBody surface. Applying force this way will add to Body.force and Body.angularForce.
     *
@@ -1631,7 +1677,7 @@ Object.defineProperty(Phaser.Physics.P2.Body.prototype, "inertia", {
 
 /**
 * @name Phaser.Physics.P2.Body#mass
-* @property {number} mass -
+* @property {number} mass - The mass of the body.
 */
 Object.defineProperty(Phaser.Physics.P2.Body.prototype, "mass", {
 

src/physics/p2/BodyDebug.js

@@ -90,6 +90,7 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     draw: function() {
 
         var angle, child, color, i, j, lineColor, lw, obj, offset, sprite, v, verts, vrot, _j, _ref1;
+
         obj = this.body;
         sprite = this.canvas;
         sprite.clear();
@@ -106,10 +107,8 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
             while (i !== l)
             {
                 child = obj.shapes[i];
-                offset = obj.shapeOffsets[i];
-                angle = obj.shapeAngles[i];
-                offset = offset || 0;
-                angle = angle || 0;
+                offset = child.position || 0;
+                angle = child.angle || 0;
 
                 if (child instanceof p2.Circle)
                 {
@@ -127,7 +126,7 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
                 {
                     this.drawLine(sprite, child.length * this.ppu, lineColor, lw);
                 }
-                else if (child instanceof p2.Rectangle)
+                else if (child instanceof p2.Box)
                 {
                     this.drawRectangle(sprite, offset[0] * this.ppu, offset[1] * this.ppu, angle, child.width * this.ppu, child.height * this.ppu, lineColor, color, lw);
                 }
@@ -153,9 +152,10 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     },
 
     /**
-    * Draws the P2 shapes to the Graphics object.
+    * Draws a p2.Box to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawRectangle
+    * @private
     */
     drawRectangle: function(g, x, y, angle, w, h, color, fillColor, lineWidth) {
 
@@ -165,12 +165,14 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
         g.lineStyle(lineWidth, color, 1);
         g.beginFill(fillColor);
         g.drawRect(x - w / 2, y - h / 2, w, h);
+
     },
 
     /**
-    * Draws a P2 Circle shape.
+    * Draws a p2.Circle to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawCircle
+    * @private
     */
     drawCircle: function(g, x, y, angle, radius, color, lineWidth) {
 
@@ -186,9 +188,10 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     },
 
     /**
-    * Draws a P2 Line shape.
+    * Draws a p2.Line to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawLine
+    * @private
     */
     drawLine: function(g, len, color, lineWidth) {
 
@@ -202,9 +205,10 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     },
 
     /**
-    * Draws a P2 Convex shape.
+    * Draws a p2.Convex to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawConvex
+    * @private
     */
     drawConvex: function(g, verts, triangles, color, fillColor, lineWidth, debug, offset) {
 
@@ -272,9 +276,10 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     },
 
     /**
-    * Draws a P2 Path.
+    * Draws a p2.Path to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawPath
+    * @private
     */
     drawPath: function(g, path, color, fillColor, lineWidth) {
 
@@ -342,9 +347,10 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     },
 
     /**
-    * Draws a P2 Plane shape.
+    * Draws a p2.Plane to the Graphics object.
     *
     * @method Phaser.Physics.P2.BodyDebug#drawPlane
+    * @private
     */
     drawPlane: function(g, x0, x1, color, lineColor, lineWidth, diagMargin, diagSize, maxLength, angle) {
 
@@ -368,6 +374,12 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
 
     },
 
+    /**
+    * Draws a p2.Capsule to the Graphics object.
+    *
+    * @method Phaser.Physics.P2.BodyDebug#drawCapsule
+    * @private
+    */
     drawCapsule: function(g, x, y, angle, len, radius, color, fillColor, lineWidth) {
 
         if (typeof lineWidth === 'undefined') { lineWidth = 1; }
@@ -406,6 +418,7 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     * Picks a random pastel color.
     *
     * @method Phaser.Physics.P2.BodyDebug#randomPastelHex
+    * @private
     */
     randomPastelHex: function() {
 
@@ -428,6 +441,7 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     * Converts from RGB to Hex.
     *
     * @method Phaser.Physics.P2.BodyDebug#rgbToHex
+    * @private
     */
     rgbToHex: function(r, g, b) {
         return this.componentToHex(r) + this.componentToHex(g) + this.componentToHex(b);
@@ -437,6 +451,7 @@ Phaser.Utils.extend(Phaser.Physics.P2.BodyDebug.prototype, {
     * Component to hex conversion.
     *
     * @method Phaser.Physics.P2.BodyDebug#componentToHex
+    * @private
     */
     componentToHex: function(c) {