Rectangle.getPoint is a new method that returns a point based on the given location constant, such as Phaser.BOTTOM_LEFT. It returns the same result as calling Rectangle.bottomLeft (etc) but unlike those getters you are able to provide your own Point object.

Author: photonstorm

README.md

@@ -366,6 +366,7 @@ You can read all about the philosophy behind Lazer [here](http://phaser.io/news/
 * BitmapData.copyTransform allows you to draw a Game Object to the BitmapData, using its `worldTransform` property to control the location, scaling and rotation of the object. You can optionally provide 
 * BitmapData.drawGroup now uses the new `copyTransform` method, to provide for far more accurate results. Previously nested Game Objects wouldn't render correctly, nor would Sprites added via `addChild` to another Sprite. BitmapText objects also rendered without rotation taken into account, and the Sprites smoothing property was ignored. All of these things are now covered by the new drawGroup method, which also handles full deep iteration down the display list.
 * Added the following new constants: `Phaser.TOP_LEFT`, `Phaser.TOP_CENTER`, `Phaser.TOP_RIGHT`, `Phaser.MIDDLE_LEFT`, `Phaser.MIDDLE_CENTER`, `Phaser.MIDDLE_RIGHT`, `Phaser.BOTTOM_LEFT`, `Phaser.BOTTOM_CENTER` and `Phaser.BOTTOM_RIGHT`.
+* Rectangle.getPoint is a new method that returns a point based on the given location constant, such as `Phaser.BOTTOM_LEFT`. It returns the same result as calling `Rectangle.bottomLeft` (etc) but unlike those getters you are able to provide your own Point object.
 
 ### Updates
 

src/geom/Rectangle.js

@@ -383,6 +383,70 @@ Phaser.Rectangle.prototype = {
 
     },
 
+    /**
+    * Returns a point based on the given location constant.
+    * 
+    * Which can be one of:
+    * 
+    * `Phaser.TOP_LEFT`, `Phaser.TOP_CENTER`, `Phaser.TOP_RIGHT`, `Phaser.MIDDLE_LEFT`,
+    * `Phaser.MIDDLE_CENTER`, `Phaser.MIDDLE_RIGHT`, `Phaser.BOTTOM_LEFT`, 
+    * `Phaser.BOTTOM_CENTER` and `Phaser.BOTTOM_RIGHT`.
+    *
+    * This method returns the same values as calling Rectangle.bottomLeft, etc, but those
+    * calls always create a new Point object, where-as this one allows you to use your own.
+    * 
+    * @method Phaser.Rectangle#getPoint
+    * @param {integer} [location] - One of the Phaser location constants, such as `Phaser.TOP_RIGHT`.
+    * @param {Phaser.Point} [out] - A Phaser.Point that the values will be set in.
+    *     If no object is provided a new Phaser.Point object will be created. In high performance areas avoid this by re-using an existing object.
+    * @return {Phaser.Point} An object containing the point in its `x` and `y` properties.
+    */
+    getPoint: function (location, out) {
+
+        if (out === undefined) { out = new Phaser.Point(); }
+
+        switch (location)
+        {
+            default:
+            case Phaser.TOP_LEFT:
+                return out.set(this.x, this.y);
+                break;
+
+            case Phaser.TOP_CENTER:
+                return out.set(this.centerX, this.y);
+                break;
+
+            case Phaser.TOP_RIGHT:
+                return out.set(this.right, this.y);
+                break;
+
+            case Phaser.MIDDLE_LEFT:
+                return out.set(this.x, this.centerY);
+                break;
+
+            case Phaser.MIDDLE_CENTER:
+                return out.set(this.centerX, this.centerY);
+                break;
+
+            case Phaser.MIDDLE_RIGHT:
+                return out.set(this.right, this.centerY);
+                break;
+
+            case Phaser.BOTTOM_LEFT:
+                return out.set(this.x, this.bottom);
+                break;
+
+            case Phaser.BOTTOM_CENTER:
+                return out.set(this.centerX, this.bottom);
+                break;
+
+            case Phaser.BOTTOM_RIGHT:
+                return out.set(this.right, this.bottom);
+                break;
+        }
+
+    },
+
     /**
     * Returns a string representation of this object.
     * @method Phaser.Rectangle#toString