Rectangle.random will return a uniformly distributed random point from anywhere within the rectangle.

Author: photonstorm

README.md

@@ -306,6 +306,7 @@ Version 2.4 - "Katar" - in dev
 * Circle.random will return a uniformly distributed random point from anywhere within the circle.
 * Line.random will return a random point from anywhere on the Line segment.
 * Ellipse.random will return a uniformly distributed random point from anywhere within the ellipse.
+* Rectangle.random will return a uniformly distributed random point from anywhere within the rectangle.
 
 ### Updates
 

src/geom/Rectangle.js

@@ -364,6 +364,25 @@ Phaser.Rectangle.prototype = {
 
     },
 
+    /**
+    * Returns a uniformly distributed random point from anywhere within this Rectangle.
+    * 
+    * @method Phaser.Rectangle#random
+    * @param {Phaser.Point|object} [out] - A Phaser.Point, or any object with public x/y properties, 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 random point in its `x` and `y` properties.
+    */
+    random: function (out) {
+
+        if (typeof out === 'undefined') { out = new Phaser.Point(); }
+
+        out.x = this.randomX;
+        out.y = this.randomY;
+
+        return out;
+
+    },
+
     /**
     * Returns a string representation of this object.
     * @method Phaser.Rectangle#toString

typescript/phaser.d.ts

@@ -3680,6 +3680,7 @@ declare module Phaser {
         intersectsRaw(left: number, right: number, top: number, bottom: number, tolerance: number): boolean;
         offset(dx: number, dy: number): Phaser.Rectangle;
         offsetPoint(point: Phaser.Point): Phaser.Rectangle;
+        random(out?: Phaser.Point): Phaser.Point;
         resize(width: number, height: number): Phaser.Rectangle;
         setTo(x: number, y: number, width: number, height: number): Phaser.Rectangle;
         scale(x: number, y?: number): Phaser.Rectangle;