Added in Line geometry functions.

Author: photonstorm

v3/src/geom/line/Angle.js

@@ -0,0 +1,6 @@
+var Angle = function (line)
+{
+    return Math.atan2(line.y2 - line.y1, line.x2 - line.x1);
+};
+
+module.exports = Angle;

v3/src/geom/line/GetNormal.js

@@ -0,0 +1,17 @@
+var MATH_CONST = require('../../math/const');
+var Angle = require('./Angle');
+var Point = require('../point/Point');
+
+var GetNormal = function (line, out)
+{
+    if (out === undefined) { out = new Point(); }
+
+    var a = Angle(line) - MATH_CONST.TAU;
+
+    out.x = Math.cos(a);
+    out.y = Math.sin(a);
+
+    return out;
+};
+
+module.exports = GetNormal;

v3/src/geom/line/Height.js

@@ -0,0 +1,6 @@
+var Height = function (line)
+{
+    return Math.abs(line.y1 - line.y2);
+};
+
+module.exports = Height;

v3/src/geom/line/Length.js

@@ -0,0 +1,6 @@
+var Length = function (line)
+{
+    return Math.sqrt((line.x2 - line.x1) * (line.x2 - line.x1) + (line.y2 - line.y1) * (line.y2 - line.y1));
+};
+
+module.exports = Length;

v3/src/geom/line/Line.js

@@ -0,0 +1,137 @@
+//  Defines a Line segment, a part of a line between two endpoints
+
+var Line = function (x1, y1, x2, y2)
+{
+    if (x1 === undefined) { x1 = 0; }
+    if (y1 === undefined) { y1 = 0; }
+    if (x2 === undefined) { x2 = 0; }
+    if (y2 === undefined) { y2 = 0; }
+
+    this.x1 = x1;
+
+    this.y1 = y1;
+
+    this.x2 = x2;
+
+    this.y2 = y2;
+};
+
+Line.prototype.constructor = Line;
+
+Line.prototype = {
+
+    setTo: function (x1, y1, x2, y2)
+    {
+        if (x1 === undefined) { x1 = 0; }
+        if (y1 === undefined) { y1 = 0; }
+        if (x2 === undefined) { x2 = 0; }
+        if (y2 === undefined) { y2 = 0; }
+
+        this.x1 = x1;
+        this.y1 = y1;
+
+        this.x2 = x2;
+        this.y2 = y2;
+
+        return this;
+    }
+
+};
+
+Object.defineProperties(Line.prototype, {
+
+    left: {
+
+        enumerable: true,
+
+        get: function ()
+        {
+            return Math.min(this.x1, this.x2);
+        },
+
+        set: function (value)
+        {
+            if (this.x1 <= this.x2)
+            {
+                this.x1 = value;
+            }
+            else
+            {
+                this.x2 = value;
+            }
+        }
+
+    },
+
+    right: {
+
+        enumerable: true,
+
+        get: function ()
+        {
+            return Math.max(this.x1, this.x2);
+        },
+
+        set: function (value)
+        {
+            if (this.x1 > this.x2)
+            {
+                this.x1 = value;
+            }
+            else
+            {
+                this.x2 = value;
+            }
+        }
+
+    },
+
+    top: {
+
+        enumerable: true,
+
+        get: function ()
+        {
+            return Math.min(this.y1, this.y2);
+        },
+
+        set: function (value)
+        {
+            if (this.y1 <= this.y2)
+            {
+                this.y1 = value;
+            }
+            else
+            {
+                this.y2 = value;
+            }
+        }
+
+    },
+
+    bottom: {
+
+        enumerable: true,
+
+        get: function ()
+        {
+            return Math.max(this.y1, this.y2);
+        },
+
+        set: function (value)
+        {
+            if (this.y1 > this.y2)
+            {
+                this.y1 = value;
+            }
+            else
+            {
+                this.y2 = value;
+            }
+        }
+
+    }
+
+});
+
+module.exports = Line;

v3/src/geom/line/NormalAngle.js

@@ -0,0 +1,12 @@
+var MATH_CONST = require('../../math/const');
+var Wrap = require('../../math/Wrap');
+var Angle = require('./Angle');
+
+var NormalAngle = function (line)
+{
+    var angle = Angle(line) - MATH_CONST.TAU;
+
+    return Wrap(angle, -Math.PI, Math.PI);
+};
+
+module.exports = NormalAngle;

v3/src/geom/line/NormalX.js

@@ -0,0 +1,9 @@
+var MATH_CONST = require('../../math/const');
+var Angle = require('./Angle');
+
+var NormalX = function (line)
+{
+    return Math.cos(Angle(line) - MATH_CONST.TAU);
+};
+
+module.exports = NormalX;

v3/src/geom/line/NormalY.js

@@ -0,0 +1,9 @@
+var MATH_CONST = require('../../math/const');
+var Angle = require('./Angle');
+
+var NormalY = function (line)
+{
+    return Math.sin(Angle(line) - MATH_CONST.TAU);
+};
+
+module.exports = NormalY;

v3/src/geom/line/PerpSlope.js

@@ -0,0 +1,6 @@
+var PerpSlope = function (line)
+{
+    return -((line.x2 - line.x1) / (line.y2 - line.y1));
+};
+
+module.exports = PerpSlope;

v3/src/geom/line/ReflectAngle.js

@@ -0,0 +1,18 @@
+var Angle = require('./Angle');
+var NormalAngle = require('./NormalAngle');
+
+/**
+* Returns the reflected angle between two lines.
+* This is the outgoing angle based on the angle of Line 1 and the normalAngle of Line 2.
+*
+* @method Phaser.Line.reflect
+* @param {Phaser.Line} a - The base line.
+* @param {Phaser.Line} b - The line to be reflected from the base line.
+* @return {number} The reflected angle in radians.
+*/
+var ReflectAngle = function (lineA, lineB)
+{
+    return (2 * NormalAngle(lineB) - Math.PI - Angle(lineA));
+};
+
+module.exports = ReflectAngle;