Merge pull request #5206 from samme/feature/math-RotateTo

Add Phaser.Math#RotateTo

src/math/RotateTo.js

@@ -0,0 +1,31 @@
+/**
+ * @author       samme
+ * @copyright    2020 Photon Storm Ltd.
+ * @license      {@link https://opensource.org/licenses/MIT|MIT License}
+ */
+
+/**
+ * Position a `point` at the given `angle` and `distance` to (`x`, `y`).
+ *
+ * @function Phaser.Math.RotateTo
+ * @since 3.24.0
+ *
+ * @generic {Phaser.Math.Vector2Like} T - [point,$return]
+ *
+ * @param {Phaser.Math.Vector2Like} point - The point to be positioned.
+ * @param {number} x - The horizontal coordinate to position from.
+ * @param {number} y - The vertical coordinate to position from.
+ * @param {number} angle - The angle of rotation in radians.
+ * @param {number} distance - The distance from (x, y) to place the point at.
+ *
+ * @return {Phaser.Math.Vector2Like} The given point.
+ */
+var RotateTo = function (point, x, y, angle, distance)
+{
+    point.x = x + (distance * Math.cos(angle));
+    point.y = y + (distance * Math.sin(angle));
+
+    return point;
+};
+
+module.exports = RotateTo;

src/math/index.js

@@ -52,6 +52,7 @@ var PhaserMath = {
     Rotate: require('./Rotate'),
     RotateAround: require('./RotateAround'),
     RotateAroundDistance: require('./RotateAroundDistance'),
+    RotateTo: require('./RotateTo'),
     RoundAwayFromZero: require('./RoundAwayFromZero'),
     RoundTo: require('./RoundTo'),
     SinCosTableGenerator: require('./SinCosTableGenerator'),