Removed: Debug.renderSpriteTouching, Debug.renderLocalTransformInfo, Debug.renderWorldTransformInfo, Debug.renderSpriteCollision and Debug.dumpLinkedList.

Debug.renderPhysicsBody(body, color) is extremely useful for debugging the new physics bodies. Will draw the outline + points in the color given.
Debug.renderBodyInfo(sprite, x, y, color) will display lots of Sprite body data.

Author: photonstorm

README.md

@@ -72,6 +72,7 @@ Significant API changes:
 * Removed Body.deltaAbsX and deltaAbsY as they are no longer used internally.
 * Body.screenX and screenY moved to getters, no longer calculated every frame.
 * ArcadePhysics now has setBounds and setBoundsToWorld, and you can specify which walls are created or not (left, right, up, down)
+* Removed: Debug.renderSpriteTouching, Debug.renderLocalTransformInfo, Debug.renderWorldTransformInfo, Debug.renderSpriteCollision and Debug.dumpLinkedList.
 
 
 New features:
@@ -91,7 +92,7 @@ New features:
 * Group.set will let you deep set a new propery on a single child of the Group.
 * Stage.display property added. A direct reference to the root Pixi Stage object (very useful for RenderTexture manipulation)
 * Added Ejecta detection to Device (thanks endel)
-* Tweens can now work with relative + and - values. You can do: `tween(sprite).to( { x: '+400' })` and it will add 400 to the current sprite.x value, or '-400'.
+* Tweens can now work with relative + and - values. You can do: `tween(sprite).to( { x: '+400' })` and it will add 400 to the current sprite.x value.
 * Buttons now properly use their upFrame if set.
 * InputHandler now has snapOffsetX and snapOffsetY properties so your snap grid doesn't have to be 0,0 aligned (thanks srmeier)
 * Loader.progressFloat contains the actual non-rounded progress value, where-as Loader.progress contains a rounded value. Use progressFloat if you've > 100 files to load.
@@ -111,12 +112,15 @@ New features:
 * Math.normalizeAngle - normalises an angle, now in radians only.
 * Math.normalizeLatitude - Normalizes a latitude to the [-90,90] range.
 * Math.normalizeLongitude - Normalizes a longitude to the [-180,180] range.
-* Phaser.Line added to the group of geometry classes, with full point on line/segment and intersection tests (see new examples)
+* Phaser.Line added to the geometry classes, with full point on line/segment and intersection tests (see new examples)
 * Phaser.CANVAS_PX_ROUND is a boolean. If 'true' the Canvas renderer will Math.floor() all coordinates before drawImage, stopping pixel interpolation. Defaults to false.
 * Phaser.CANVAS_CLEAR_RECT is a boolean. If 'true' (the default) it will context.clearRect() every frame. If false this is skipped (useful if you know you don't need it)
 * Collision now works between Sprites positioned via sprite.x/y, sprite.body.x/y or sprite.body.velocity.
 * If you are tweening a sprite and still want physics collision, set `sprite.body.moves = false` otherwise it will fight against the tween motion.
-
+* Game.enableStep will enable core game loop stepping. When enabled you must call game.step() directly (perhaps via a DOM button?), very useful for debugging!
+* Game.disableStep turns core update loop stepping off.
+* Debug.renderPhysicsBody(body, color) is extremely useful for debugging the new physics bodies. Will draw the outline + points in the color given.
+* Debug.renderBodyInfo(sprite, x, y, color) will display lots of Sprite body data.
 
 
 New Examples:

examples/wip/rabbit map.js

@@ -54,15 +54,20 @@ console.log(' --- state create start ---');
 
     layer.resizeWorld();
 
-    // game.physics.gravity.y = 200;
+    game.physics.gravity.y = 200;
 
 
-    sprite = game.add.sprite(100, 180, 'phaser');
-    sprite.body.moves = false;
+    sprite = game.add.sprite(100, 240, 'phaser');
+    // sprite.anchor.setTo(0.5, 0.5);
+    // sprite.body.setCircle(20);
+
+    // sprite.body.moves = false;
 
     ball = game.add.sprite(200, 180, 'ball');
 
-    game.add.tween(sprite).to({x: 500},5000,Phaser.Easing.Linear.None,true);
+    // game.add.tween(sprite).to({x: 500},5000,Phaser.Easing.Linear.None,true);
+
+    // game.add.tween(sprite).to({angle: 360},5000,Phaser.Easing.Linear.None,true);
 
     // sprite = game.add.sprite(200, 240, 'phaser'); // 3-block corner test
 
@@ -74,7 +79,9 @@ console.log(' --- state create start ---');
     // sprite.body.velocity.y = 200;
 
 
-    // sprite.anchor.setTo(0.5, 0.5);
+
+
+
 
     //  We'll set a lower max angular velocity here to keep it from going totally nuts
     // sprite.body.maxAngular = 500;
@@ -83,7 +90,7 @@ console.log(' --- state create start ---');
     // sprite.body.angularDrag = 50;
 
     // sprite.body.bounce.x = 0.8;
-    // sprite.body.bounce.y = 0.8;
+    sprite.body.bounce.y = 0.8;
 
     // sprite.angle = 35;
 
@@ -124,14 +131,17 @@ function update() {
 
     // sprite.body.velocity.y = -300;
 
+        // sprite.body.angularVelocity = -100;
+        // sprite.body.angularAcceleration = 200;
+
+
     // sprite.body.velocity.x = 0;
     // sprite.body.velocity.y = 0;
     // sprite.body.angularVelocity = 0;
 
     // sprite.body.acceleration.x = 0;
     // sprite.body.angularAcceleration = 0;
 
-    /*
     if (cursors.left.isDown)
     {
         // sprite.body.acceleration.x = -200;
@@ -149,11 +159,6 @@ function update() {
     {
         game.physics.velocityFromAngle(sprite.angle, 300, sprite.body.velocity);
     }
-    else
-    {
-        // game.physics.velocityFromAngle(sprite.angle, sprite.body.velocity, sprite.body.velocity);
-    }
-    */
 
 
 
@@ -201,23 +206,23 @@ function update() {
     //     sprite.x += 2;
     // }
 
-    if (cursors.up.isDown)
-    {
-        sprite.body.y -= 2;
-    }
-    else if (cursors.down.isDown)
-    {
-        sprite.body.y += 2;
-    }
+    // if (cursors.up.isDown)
+    // {
+    //     sprite.body.y -= 2;
+    // }
+    // else if (cursors.down.isDown)
+    // {
+    //     sprite.body.y += 2;
+    // }
 
-    if (cursors.left.isDown)
-    {
-        sprite.body.x -= 2;
-    }
-    else if (cursors.right.isDown)
-    {
-        sprite.body.x += 2;
-    }
+    // if (cursors.left.isDown)
+    // {
+    //     sprite.body.x -= 2;
+    // }
+    // else if (cursors.right.isDown)
+    // {
+    //     sprite.body.x += 2;
+    // }
 
 
 
@@ -228,7 +233,7 @@ function render() {
     // game.debug.renderSpriteBody(sprite);
     // game.debug.renderSpriteBounds(sprite);
 
-    // game.debug.renderPhysicsBody(sprite.body);
+    game.debug.renderPhysicsBody(sprite.body);
     game.debug.renderBodyInfo(sprite, 32, 32);
 
     // game.debug.renderLine(marker, 'rgba(255,255,255,0.5)');

src/core/Game.js

@@ -226,6 +226,27 @@ Phaser.Game = function (width, height, renderer, parent, state, transparent, ant
     */
     this.particles = null;
 
+    /**
+    * @property {boolean} stepping - Enable core loop stepping with Game.enableStep().
+    * @default
+    * @readonly
+    */
+    this.stepping = false;
+
+    /**
+    * @property {boolean} stepping - An internal property used by enableStep, but also useful to query from your own game objects.
+    * @default
+    * @readonly
+    */
+    this.pendingStep = false;
+
+    /**
+    * @property {number} stepCount - When stepping is enabled this contains the current step cycle.
+    * @default
+    * @readonly
+    */
+    this.stepCount = 0;
+
     //  Parse the configuration object (if any)
     if (arguments.length === 1 && typeof arguments[0] === 'object')
     {
@@ -283,10 +304,6 @@ Phaser.Game = function (width, height, renderer, parent, state, transparent, ant
         window.addEventListener('load', this._onBoot, false);
     }
 
-    this.pendingStep = false;
-    this.stepping = false;
-    this.stepCount = 0;
-
     return this;
 
 };
@@ -592,21 +609,17 @@ Phaser.Game.prototype = {
                 }
 
                 this.plugins.preUpdate();
-        // console.log('world preUpdate');
                 this.world.preUpdate();
 
                 this.stage.update();
                 this.input.update();
                 this.tweens.update();
                 this.sound.update();
-        // console.log('state update');
                 this.state.update();
-        // console.log('world update');
                 this.world.update();
                 this.particles.update();            
                 this.plugins.update();
 
-        // console.log('world postUpdate');
                 this.world.postUpdate();
                 this.plugins.postUpdate();
             }
@@ -623,6 +636,12 @@ Phaser.Game.prototype = {
 
     },
 
+    /**
+    * Enable core game loop stepping. When enabled you must call game.step() directly (perhaps via a DOM button?)
+    * Calling step will advance the game loop by one frame. This is extremely useful to hard to track down errors!
+    *
+    * @method Phaser.Game#enableStep
+    */
     enableStep: function () {
 
         this.stepping = true;
@@ -631,12 +650,28 @@ Phaser.Game.prototype = {
 
     },
 
+    /**
+    * Disables core game loop stepping.
+    *
+    * @method Phaser.Game#disableStep
+    */
+    disableStep: function () {
+
+        this.stepping = false;
+        this.pendingStep = false;
+
+    },
+
+    /**
+    * When stepping is enabled you must call this function directly (perhaps via a DOM button?) to advance the game loop by one frame.
+    * This is extremely useful to hard to track down errors! Use the internal stepCount property to monitor progress.
+    *
+    * @method Phaser.Game#step
+    */
     step: function () {
 
         this.pendingStep = false;
         this.stepCount++;
-        console.log('');
-        console.log('----------------------------- Game step', this.stepCount);
 
     },
 

src/gameobjects/Sprite.js

@@ -373,13 +373,10 @@ Phaser.Sprite = function (game, x, y, key, frame) {
     this.updateCache();
     this.updateBounds();
 
-    this.debug = false;
-
     /**
     * @property {PIXI.Point} pivot - The pivot point of the displayObject that it rotates around.
     */
 
-
 };
 
 //  Needed to keep the PIXI.Sprite constructor in the prototype chain (as the core pixi renderer uses an instanceof check sadly)
@@ -394,11 +391,6 @@ Phaser.Sprite.prototype.constructor = Phaser.Sprite;
 */
 Phaser.Sprite.prototype.preUpdate = function() {
 
-if (this.debug)
-{
-    console.log('Sprite preUpdate xy: ', this.x, this.y, 'wxy:', this.world.x, this.world.y);
-}
-
     if (!this.exists || (this.group && !this.group.exists))
     {
         this.renderOrderID = -1;
@@ -706,12 +698,6 @@ Phaser.Sprite.prototype.postUpdate = function() {
 
         this.position.x = this._cache.x;
         this.position.y = this._cache.y;
-
-if (this.debug)
-{
-    console.log('Sprite postUpdate xy: ', this.x, this.y, 'right:', this.right);
-}
-
     }
 
 };

src/geom/Line.js

@@ -54,6 +54,14 @@ Phaser.Line.prototype = {
 
     },
 
+    /**
+    * Sets the line to match the x/y coordinates of the two given sprites.
+    * Can optionally be calculated from their center coordinates.
+    * @method Phaser.Line#fromSprite
+    * @param {Phaser.Sprite} startSprite - The coordinates of this Sprite will be set to the Line.start point.
+    * @param {Phaser.Sprite} endSprite - The coordinates of this Sprite will be set to the Line.start point.
+    * @param {boolean} [useCenter=true] - If true it will use startSprite.center.x, if false startSprite.x.
+    */
     fromSprite: function (startSprite, endSprite, useCenter) {
 
         if (typeof useCenter === 'undefined') { useCenter = true; }

src/physics/arcade/ArcadePhysics.js

@@ -99,6 +99,12 @@ Phaser.Physics.Arcade = function (game) {
     */
     this._angle = 0;
 
+    /**
+    * @property {number} _drag - Internal cache var.
+    * @private
+    */
+    this._drag = 0;
+
     /**
     * @property {number} _dx - Internal cache var.
     * @private
@@ -376,7 +382,8 @@ Phaser.Physics.Arcade.prototype = {
 
         if (body.sprite.debug)
         {
-            console.log('updateMotion: acx', body.acceleration.x, 'acy', body.acceleration.y, 'gravx', this._gravityX, 'gravy', this._gravityY, 'elapsed', this.game.time.physicsElapsed);
+            // console.log('updateMotion: acx', body.acceleration.x, 'acy', body.acceleration.y, 'gravx', this._gravityX, 'gravy', this._gravityY, 'elapsed', this.game.time.physicsElapsed);
+            console.log('updateMotion: rotation', body.rotation, 'vd', this._velocityDelta, 'drag', this._drag, 'acceleration', body.angularAcceleration);
         }
 
         this._p.setTo((body.acceleration.x + this._gravityX) * this.game.time.physicsElapsed, (body.acceleration.y + this._gravityY) * this.game.time.physicsElapsed);