fixedToCamera now works across all display objects. When enabled it will fix at its current x/y coordinate, but can be changed via cameraOffset.

fixedToCamrea now works for Groups as well :) You can fix a Group to the camera and it will influence its children.
Also fixed the issue with World.preUpdate/postUpdate not being called and various small documentation issues.

Author: photonstorm

README.md

@@ -115,6 +115,8 @@ New features:
 * Added Cache.updateFrameData which is really useful for swapping FrameData blocks in the cache.
 * Loader.physics now lets you load Lime + Corona JSON Physics data, which can be used with Body.loadPolygon and Body.loadData.
 * Cache.addPhysicsData and Cache.getPhysicsData allow you to store parsed JSON physics data in the cache, for sharing between Bodies.
+* fixedToCamera now works across all display objects. When enabled it will fix at its current x/y coordinate, but can be changed via cameraOffset.
+* fixedToCamrea now works for Groups as well :) You can fix a Group to the camera and it will influence its children.
 
 
 Updates:

examples/wip/fixed to cam.js

@@ -0,0 +1,83 @@
+
+var game = new Phaser.Game(800, 600, Phaser.CANVAS, 'phaser-example', { preload: preload, create: create, update: update, render: render });
+
+function preload() {
+
+    game.load.image('backdrop', 'assets/pics/remember-me.jpg');
+    game.load.image('mushroom', 'assets/sprites/mushroom2.png');
+	game.load.image('coke', 'assets/sprites/cokecan.png');
+    game.load.bitmapFont('desyrel', 'assets/fonts/desyrel.png', 'assets/fonts/desyrel.xml', null, 0, -32);
+
+}
+
+var cursors;
+var mushroom;
+
+function create() {
+
+    game.world.setBounds(0, 0, 1920, 1200);
+    game.add.image(0, 0, 'backdrop');
+
+    mushroom = game.add.sprite(400, 400, 'mushroom');
+
+    //  Test Fixing an Image to the Camera
+    var fixie = game.add.image(100, 100, 'coke');
+    fixie.fixedToCamera = true;
+
+    //  And tween it
+    game.add.tween(fixie.cameraOffset).to({ y: 500 }, 2000, Phaser.Easing.Bounce.Out, true, 0, 1000, true);
+
+    //  Test Fixing a Sprite to the Camera
+    var fixie2 = game.add.sprite(600, 100, 'coke');
+    fixie2.fixedToCamera = true;
+    fixie2.inputEnabled = true;
+    fixie2.events.onInputDown.add(clicked, this);
+
+    //  Test Fixing a Text to the Camera
+    var text = game.add.text(300, 32, '-phaser-');
+    text.fixedToCamera = true;
+
+    //  Test fixing a BitmapText to the Camera
+    var text2 = game.add.bitmapText(200, 500, 'desyrel', 'camera fixies', 32);
+    text2.fixedToCamera = true;
+
+    //  Button! do mouse events still work then?
+
+    game.camera.follow(mushroom);
+
+    cursors = game.input.keyboard.createCursorKeys();
+
+}
+
+function clicked() {
+
+    console.log('boom');
+
+}
+
+function update() {
+
+    if (cursors.left.isDown)
+    {
+    	mushroom.x -= 8;
+    }
+    else if (cursors.right.isDown)
+    {
+    	mushroom.x += 8;
+    }
+
+    if (cursors.up.isDown)
+    {
+    	mushroom.y -= 8;
+    }
+    else if (cursors.down.isDown)
+    {
+    	mushroom.y += 8;
+    }
+
+}
+
+function render() {
+
+
+}

examples/wip/group fixed to cam.js

@@ -0,0 +1,68 @@
+
+var game = new Phaser.Game(800, 600, Phaser.CANVAS, 'phaser-example', { preload: preload, create: create, update: update, render: render });
+
+function preload() {
+
+    game.load.image('backdrop', 'assets/pics/remember-me.jpg');
+    game.load.image('mushroom', 'assets/sprites/mushroom2.png');
+	game.load.image('coke', 'assets/sprites/cokecan.png');
+
+}
+
+var cursors;
+var mushroom;
+
+function create() {
+
+    game.world.setBounds(0, 0, 1920, 1200);
+    game.add.image(0, 0, 'backdrop');
+
+    mushroom = game.add.sprite(400, 400, 'mushroom');
+
+    var group = game.add.group();
+
+    for (var i = 0; i < 20; i++)
+    {
+        group.create(Math.random() * 800, Math.random() * 600, 'coke');
+    }
+
+    group.fixedToCamera = true;
+
+    game.camera.follow(mushroom);
+
+    cursors = game.input.keyboard.createCursorKeys();
+
+}
+
+function clicked() {
+
+    console.log('boom');
+
+}
+
+function update() {
+
+    if (cursors.left.isDown)
+    {
+    	mushroom.x -= 8;
+    }
+    else if (cursors.right.isDown)
+    {
+    	mushroom.x += 8;
+    }
+
+    if (cursors.up.isDown)
+    {
+    	mushroom.y -= 8;
+    }
+    else if (cursors.down.isDown)
+    {
+    	mushroom.y += 8;
+    }
+
+}
+
+function render() {
+
+
+}

examples/wip/tilesprite fixed to cam.js

@@ -0,0 +1,59 @@
+
+var game = new Phaser.Game(800, 600, Phaser.AUTO, 'phaser-example', { preload: preload, create: create, update: update, render: render });
+
+function preload() {
+
+    game.load.image('backdrop', 'assets/pics/remember-me.jpg');
+    game.load.image('mushroom', 'assets/sprites/mushroom2.png');
+    game.load.image('starfield', 'assets/misc/starfield.jpg');
+
+}
+
+var sprite;
+var cursors;
+var mushroom;
+
+function create() {
+
+    game.world.setBounds(0, 0, 1920, 1200);
+    game.add.image(0, 0, 'backdrop');
+
+    sprite = game.add.tileSprite(100, 100, 200, 200, 'starfield');
+    sprite.autoScroll(0, 100);
+    sprite.fixedToCamera = true;
+
+    mushroom = game.add.sprite(400, 400, 'mushroom');
+
+    game.camera.follow(mushroom);
+
+    cursors = game.input.keyboard.createCursorKeys();
+
+}
+
+function update() {
+
+    if (cursors.left.isDown)
+    {
+        mushroom.x -= 8;
+    }
+    else if (cursors.right.isDown)
+    {
+        mushroom.x += 8;
+    }
+
+    if (cursors.up.isDown)
+    {
+        mushroom.y -= 8;
+    }
+    else if (cursors.down.isDown)
+    {
+        mushroom.y += 8;
+    }
+
+}
+
+function render() {
+
+    // game.debug.renderText(sprite.frame, 32, 32);
+
+}

src/core/Group.js

@@ -89,6 +89,26 @@ Phaser.Group = function (game, parent, name, addToStage) {
 
     this._cursorIndex = 0;
 
+    /**
+    * @property {Phaser.Point} cameraOffset - If this object is fixedToCamera then this stores the x/y offset that its drawn at, from the top-left of the camera view.
+    */
+    this.cameraOffset = new Phaser.Point();
+
+    /**
+    * A small internal cache:
+    * 0 = previous position.x
+    * 1 = previous position.y
+    * 2 = previous rotation
+    * 3 = renderID
+    * 4 = fresh? (0 = no, 1 = yes)
+    * 5 = outOfBoundsFired (0 = no, 1 = yes)
+    * 6 = exists (0 = no, 1 = yes)
+    * 7 = fixed to camera (0 = no, 1 = yes)
+    * @property {Int16Array} _cache
+    * @private
+    */
+    this._cache = new Int16Array([0, 0, 0, 0, 1, 0, 1, 0]);
+
 };
 
 Phaser.Group.prototype = Object.create(PIXI.DisplayObjectContainer.prototype);
@@ -708,11 +728,19 @@ Phaser.Group.prototype.callAll = function (method, context) {
 */
 Phaser.Group.prototype.preUpdate = function () {
 
+    if (!this.exists || !this.parent.exists)
+    {
+        this.renderOrderID = -1;
+        return false;
+    }
+
     for (var i = this.children.length - 1; i >= 0; i--)
     {
         this.children[i].preUpdate();
     }
 
+    return true;
+
 }
 
 /**
@@ -736,6 +764,13 @@ Phaser.Group.prototype.update = function () {
 */
 Phaser.Group.prototype.postUpdate = function () {
 
+    //  Fixed to Camera?
+    if (this._cache[7] === 1)
+    {
+        this.x = this.game.camera.view.x + this.cameraOffset.x;
+        this.y = this.game.camera.view.y + this.cameraOffset.y;
+    }
+
     for (var i = this.children.length - 1; i >= 0; i--)
     {
         this.children[i].postUpdate();
@@ -1177,6 +1212,37 @@ Object.defineProperty(Phaser.Group.prototype, "angle", {
 
 });
 
+/**
+* A Group that is fixed to the camera uses its x/y coordinates as offsets from the top left of the camera. These are stored in Group.cameraOffset.
+* Note that the cameraOffset values are in addition to any parent in the display list.
+* So if this Group was in a Group that has x: 200, then this will be added to the cameraOffset.x
+*
+* @name Phaser.Group#fixedToCamera
+* @property {boolean} fixedToCamera - Set to true to fix this Group to the Camera at its current world coordinates.
+*/
+Object.defineProperty(Phaser.Group.prototype, "fixedToCamera", {
+    
+    get: function () {
+
+        return !!this._cache[7];
+
+    },
+
+    set: function (value) {
+
+        if (value)
+        {
+            this._cache[7] = 1;
+            this.cameraOffset.set(this.x, this.y);
+        }
+        else
+        {
+            this._cache[7] = 0;
+        }
+    }
+
+});
+
 //  Documentation stubs
 
 /**

src/core/Stage.js

@@ -82,7 +82,7 @@ Phaser.Stage.prototype.preUpdate = function () {
 
     var i = this.children.length;
 
-    while(i--)
+    while (i--)
     {
         this.children[i].preUpdate();
     }
@@ -98,7 +98,7 @@ Phaser.Stage.prototype.update = function () {
 
     var i = this.children.length;
 
-    while(i--)
+    while (i--)
     {
         this.children[i].update();
     }
@@ -123,7 +123,7 @@ Phaser.Stage.prototype.postUpdate = function () {
 
         var i = this.children.length;
 
-        while(i--)
+        while (i--)
         {
             if (this.children[i] !== this.game.world.camera.target)
             {
@@ -137,7 +137,7 @@ Phaser.Stage.prototype.postUpdate = function () {
 
         var i = this.children.length;
 
-        while(i--)
+        while (i--)
         {
             this.children[i].postUpdate();
         }