Added GetPoint and GetPoints support to Circle, Ellipse and Line and exposed via the classes

Author: photonstorm

v3/src/geom/circle/Circle.js

@@ -1,4 +1,6 @@
 var Class = require('../../utils/Class');
+var GetPoint = require('./GetPoint');
+var GetPoints = require('./GetPoints');
 var Random = require('./Random');
 
 var Circle = new Class({
@@ -54,6 +56,16 @@ var Circle = new Class({
         this._diameter = radius * 2;
     },
 
+    getPoint: function (position, point)
+    {
+        return GetPoint(this, position, point);
+    },
+
+    getPoints: function (steps, output)
+    {
+        return GetPoints(this, steps, output);
+    },
+
     /**
      * [description]
      *

v3/src/geom/circle/GetPoint.js

@@ -0,0 +1,31 @@
+var CircumferencePoint = require('./CircumferencePoint');
+var FromPercent = require('../../math/FromPercent');
+var MATH_CONST = require('../../math/const');
+var Point = require('../point/Point');
+
+//  Returns a Point object containing the coordinates of a point on the circumference of the Circle 
+//  based on the given angle normalized to the range 0 to 1. I.e. a value of 0.5 will give the point
+//  at 180 degrees around the circle.
+
+/**
+ * [description]
+ *
+ * @function Phaser.Geom.Circle.GetPoint
+ * @since 3.0.0
+ *
+ * @param {Phaser.Geom.Circle} circle - The Circle to get the circumference point on.
+ * @param {float} position - A value between 0 and 1, where 0 equals 0 degrees, 0.5 equals 180 degrees and 1 equals 360 around the circle.
+ * @param {Phaser.Geom.Point|object} [out] - [description]
+ *
+ * @return {Phaser.Geom.Point|object} [description]
+ */
+var GetPoint = function (circle, position, out)
+{
+    if (out === undefined) { out = new Point(); }
+
+    var angle = FromPercent(position, 0, MATH_CONST.PI2);
+
+    return CircumferencePoint(circle, angle, out);
+};
+
+module.exports = GetPoint;

v3/src/geom/circle/GetPoints.js

@@ -0,0 +1,25 @@
+var CircumferencePoint = require('./CircumferencePoint');
+var FromPercent = require('../../math/FromPercent');
+var MATH_CONST = require('../../math/const');
+var Point = require('../point/Point');
+
+var GetPoints = function (circle, steps, out)
+{
+    if (out === undefined) { out = []; }
+
+    var t = 0;
+    var inc = MATH_CONST.PI2 / steps;
+
+    for (var i = 0; i < steps; i++)
+    {
+        var angle = FromPercent(i / steps, 0, MATH_CONST.PI2);
+
+        out.push(CircumferencePoint(circle, angle));
+
+        t += inc;
+    }
+
+    return out;
+};
+
+module.exports = GetPoints;

v3/src/geom/circle/index.js

@@ -12,6 +12,8 @@ Circle.ContainsRect = require('./ContainsRect');
 Circle.CopyFrom = require('./CopyFrom');
 Circle.Equals = require('./Equals');
 Circle.GetBounds = require('./GetBounds');
+Circle.GetPoint = require('./GetPoint');
+Circle.GetPoints = require('./GetPoints');
 Circle.Offset = require('./Offset');
 Circle.OffsetPoint = require('./OffsetPoint');
 Circle.Random = require('./Random');

v3/src/geom/ellipse/CircumferencePoint.js

@@ -1,7 +1,7 @@
 var Point = require('../point/Point');
 
 /**
- * Given an angle this will returna Point object containing the coordinates of the point
+ * Given an angle this will return a Point object containing the coordinates of the point
  * on the circumference of the ellipse.
  *
  * @function Phaser.Geom.Ellipse.CircumferencePoint

v3/src/geom/ellipse/Ellipse.js

@@ -1,4 +1,6 @@
 var Class = require('../../utils/Class');
+var GetPoint = require('./GetPoint');
+var GetPoints = require('./GetPoints');
 var Random = require('./Random');
 
 var Ellipse = new Class({
@@ -21,6 +23,16 @@ var Ellipse = new Class({
         this.height = height;
     },
 
+    getPoint: function (position, point)
+    {
+        return GetPoint(this, position, point);
+    },
+
+    getPoints: function (steps, output)
+    {
+        return GetPoints(this, steps, output);
+    },
+
     getRandomPoint: function (point)
     {
         return Random(this, point);

v3/src/geom/ellipse/GetPoint.js

@@ -0,0 +1,31 @@
+var CircumferencePoint = require('./CircumferencePoint');
+var FromPercent = require('../../math/FromPercent');
+var MATH_CONST = require('../../math/const');
+var Point = require('../point/Point');
+
+//  Returns a Point object containing the coordinates of a point on the circumference of the Ellipse
+//  based on the given angle normalized to the range 0 to 1. I.e. a value of 0.5 will give the point
+//  at 180 degrees around the ellipse.
+
+/**
+ * [description]
+ *
+ * @function Phaser.Geom.Ellipse.GetPoint
+ * @since 3.0.0
+ *
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to get the circumference point on.
+ * @param {float} position - A value between 0 and 1, where 0 equals 0 degrees, 0.5 equals 180 degrees and 1 equals 360 around the ellipse.
+ * @param {Phaser.Geom.Point|object} [out] - [description]
+ *
+ * @return {Phaser.Geom.Point|object} [description]
+ */
+var GetPoint = function (ellipse, position, out)
+{
+    if (out === undefined) { out = new Point(); }
+
+    var angle = FromPercent(position, 0, MATH_CONST.PI2);
+
+    return CircumferencePoint(ellipse, angle, out);
+};
+
+module.exports = GetPoint;

v3/src/geom/ellipse/GetPoints.js

@@ -0,0 +1,25 @@
+var CircumferencePoint = require('./CircumferencePoint');
+var FromPercent = require('../../math/FromPercent');
+var MATH_CONST = require('../../math/const');
+var Point = require('../point/Point');
+
+var GetPoints = function (ellipse, steps, out)
+{
+    if (out === undefined) { out = []; }
+
+    var t = 0;
+    var inc = MATH_CONST.PI2 / steps;
+
+    for (var i = 0; i < steps; i++)
+    {
+        var angle = FromPercent(i / steps, 0, MATH_CONST.PI2);
+
+        out.push(CircumferencePoint(ellipse, angle));
+
+        t += inc;
+    }
+
+    return out;
+};
+
+module.exports = GetPoints;

v3/src/geom/ellipse/index.js

@@ -11,6 +11,8 @@ Ellipse.ContainsRect = require('./ContainsRect');
 Ellipse.CopyFrom = require('./CopyFrom');
 Ellipse.Equals = require('./Equals');
 Ellipse.GetBounds = require('./GetBounds');
+Ellipse.GetPoint = require('./GetPoint');
+Ellipse.GetPoints = require('./GetPoints');
 Ellipse.Offset = require('./Offset');
 Ellipse.OffsetPoint = require('./OffsetPoint');
 Ellipse.Random = require('./Random');

v3/src/geom/line/GetPoint.js

@@ -10,17 +10,17 @@ var Point = require('../point/Point');
  * @since 3.0.0
  *
  * @param {Phaser.Geom.Line} line - [description]
- * @param {float} progress - [description]
+ * @param {float} position - A value between 0 and 1, where 0 equals 0 degrees, 0.5 equals 180 degrees and 1 equals 360 around the circle.
  * @param {Phaser.Geom.Point|object} [out] - [description]
  *
  * @return {Phaser.Geom.Point|object} [description]
  */
-var GetPoint = function (line, progress, out)
+var GetPoint = function (line, position, out)
 {
     if (out === undefined) { out = new Point(); }
 
-    out.x = line.x1 + (line.x2 - line.x1) * progress;
-    out.y = line.y1 + (line.y2 - line.y1) * progress;
+    out.x = line.x1 + (line.x2 - line.x1) * position;
+    out.y = line.y1 + (line.y2 - line.y1) * position;
 
     return out;
 };