2018-02-12 16:01:20 +00:00
|
|
|
/**
|
|
|
|
* @author Richard Davey <rich@photonstorm.com>
|
2019-01-15 16:20:22 +00:00
|
|
|
* @copyright 2019 Photon Storm Ltd.
|
2019-05-10 15:15:04 +00:00
|
|
|
* @license {@link https://opensource.org/licenses/MIT|MIT License}
|
2018-02-12 16:01:20 +00:00
|
|
|
*/
|
|
|
|
|
2018-03-19 12:06:46 +00:00
|
|
|
// Adapted from [gl-matrix](https://github.com/toji/gl-matrix) by toji
|
2017-09-15 15:31:48 +00:00
|
|
|
// and [vecmath](https://github.com/mattdesl/vecmath) by mattdesl
|
|
|
|
|
|
|
|
var Class = require('../utils/Class');
|
|
|
|
|
2018-02-07 15:27:21 +00:00
|
|
|
/**
|
|
|
|
* @classdesc
|
2018-05-23 11:15:16 +00:00
|
|
|
* A representation of a vector in 3D space.
|
|
|
|
*
|
|
|
|
* A three-component vector.
|
2018-02-07 15:27:21 +00:00
|
|
|
*
|
|
|
|
* @class Vector3
|
2018-10-10 09:49:13 +00:00
|
|
|
* @memberof Phaser.Math
|
2018-02-07 15:27:21 +00:00
|
|
|
* @constructor
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-31 14:17:59 +00:00
|
|
|
* @param {number} [x] - The x component.
|
|
|
|
* @param {number} [y] - The y component.
|
|
|
|
* @param {number} [z] - The z component.
|
2018-02-07 15:27:21 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
var Vector3 = new Class({
|
|
|
|
|
|
|
|
initialize:
|
|
|
|
|
|
|
|
function Vector3 (x, y, z)
|
|
|
|
{
|
2018-02-07 15:27:21 +00:00
|
|
|
/**
|
|
|
|
* The x component of this Vector.
|
|
|
|
*
|
|
|
|
* @name Phaser.Math.Vector3#x
|
|
|
|
* @type {number}
|
|
|
|
* @default 0
|
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2018-05-23 11:15:16 +00:00
|
|
|
this.x = 0;
|
2018-02-07 15:27:21 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The y component of this Vector.
|
|
|
|
*
|
|
|
|
* @name Phaser.Math.Vector3#y
|
|
|
|
* @type {number}
|
|
|
|
* @default 0
|
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2018-05-23 11:15:16 +00:00
|
|
|
this.y = 0;
|
2018-02-07 15:27:21 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The z component of this Vector.
|
|
|
|
*
|
|
|
|
* @name Phaser.Math.Vector3#z
|
|
|
|
* @type {number}
|
|
|
|
* @default 0
|
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2018-05-23 11:15:16 +00:00
|
|
|
this.z = 0;
|
2018-02-07 15:27:21 +00:00
|
|
|
|
2017-09-15 15:31:48 +00:00
|
|
|
if (typeof x === 'object')
|
|
|
|
{
|
|
|
|
this.x = x.x || 0;
|
|
|
|
this.y = x.y || 0;
|
|
|
|
this.z = x.z || 0;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
this.x = x || 0;
|
|
|
|
this.y = y || 0;
|
|
|
|
this.z = z || 0;
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Set this Vector to point up.
|
|
|
|
*
|
|
|
|
* Sets the y component of the vector to 1, and the others to 0.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#up
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-12-07 02:20:06 +00:00
|
|
|
up: function ()
|
|
|
|
{
|
|
|
|
this.x = 0;
|
|
|
|
this.y = 1;
|
|
|
|
this.z = 0;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Make a clone of this Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#clone
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-03-19 11:25:46 +00:00
|
|
|
* @return {Phaser.Math.Vector3} A new Vector3 object containing this Vectors values.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
clone: function ()
|
|
|
|
{
|
|
|
|
return new Vector3(this.x, this.y, this.z);
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-10-01 10:35:01 +00:00
|
|
|
* Calculate the cross (vector) product of two given Vectors.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#crossVectors
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-10-01 10:35:01 +00:00
|
|
|
* @param {Phaser.Math.Vector3} a - The first Vector to multiply.
|
|
|
|
* @param {Phaser.Math.Vector3} b - The second Vector to multiply.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-20 15:50:48 +00:00
|
|
|
crossVectors: function (a, b)
|
|
|
|
{
|
|
|
|
var ax = a.x;
|
|
|
|
var ay = a.y;
|
|
|
|
var az = a.z;
|
|
|
|
var bx = b.x;
|
|
|
|
var by = b.y;
|
|
|
|
var bz = b.z;
|
|
|
|
|
|
|
|
this.x = ay * bz - az * by;
|
|
|
|
this.y = az * bx - ax * bz;
|
|
|
|
this.z = ax * by - ay * bx;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 14:00:03 +00:00
|
|
|
* Check whether this Vector is equal to a given Vector.
|
2018-05-23 11:15:16 +00:00
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* Performs a strict equality check against each Vector's components.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#equals
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-03-19 11:25:46 +00:00
|
|
|
* @param {Phaser.Math.Vector3} v - The Vector3 to compare against.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-03-19 11:25:46 +00:00
|
|
|
* @return {boolean} True if the two vectors strictly match, otherwise false.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-21 16:11:56 +00:00
|
|
|
equals: function (v)
|
|
|
|
{
|
|
|
|
return ((this.x === v.x) && (this.y === v.y) && (this.z === v.z));
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Copy the components of a given Vector into this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#copy
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} src - The Vector to copy the components from.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
copy: function (src)
|
|
|
|
{
|
|
|
|
this.x = src.x;
|
|
|
|
this.y = src.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
this.z = src.z || 0;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Set the `x`, `y`, and `z` components of this Vector to the given `x`, `y`, and `z` values.
|
|
|
|
*
|
2018-01-26 06:19:27 +00:00
|
|
|
* @method Phaser.Math.Vector3#set
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(number|object)} x - The x value to set for this Vector, or an object containing x, y and z components.
|
|
|
|
* @param {number} [y] - The y value to set for this Vector.
|
|
|
|
* @param {number} [z] - The z value to set for this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
set: function (x, y, z)
|
|
|
|
{
|
|
|
|
if (typeof x === 'object')
|
|
|
|
{
|
|
|
|
this.x = x.x || 0;
|
|
|
|
this.y = x.y || 0;
|
|
|
|
this.z = x.z || 0;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
this.x = x || 0;
|
|
|
|
this.y = y || 0;
|
|
|
|
this.z = z || 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Add a given Vector to this Vector. Addition is component-wise.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#add
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to add to this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
add: function (v)
|
|
|
|
{
|
|
|
|
this.x += v.x;
|
|
|
|
this.y += v.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
this.z += v.z || 0;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Subtract the given Vector from this Vector. Subtraction is component-wise.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#subtract
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to subtract from this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
subtract: function (v)
|
|
|
|
{
|
|
|
|
this.x -= v.x;
|
|
|
|
this.y -= v.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
this.z -= v.z || 0;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Perform a component-wise multiplication between this Vector and the given Vector.
|
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* Multiplies this Vector by the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#multiply
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to multiply this Vector by.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
multiply: function (v)
|
|
|
|
{
|
|
|
|
this.x *= v.x;
|
|
|
|
this.y *= v.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
this.z *= v.z || 1;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Scale this Vector by the given value.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#scale
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {number} scale - The value to scale this Vector by.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
scale: function (scale)
|
|
|
|
{
|
2017-09-20 15:50:48 +00:00
|
|
|
if (isFinite(scale))
|
|
|
|
{
|
|
|
|
this.x *= scale;
|
|
|
|
this.y *= scale;
|
|
|
|
this.z *= scale;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
this.x = 0;
|
|
|
|
this.y = 0;
|
|
|
|
this.z = 0;
|
|
|
|
}
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Perform a component-wise division between this Vector and the given Vector.
|
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* Divides this Vector by the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#divide
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to divide this Vector by.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
divide: function (v)
|
|
|
|
{
|
|
|
|
this.x /= v.x;
|
|
|
|
this.y /= v.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
this.z /= v.z || 1;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 14:00:03 +00:00
|
|
|
* Negate the `x`, `y` and `z` components of this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#negate
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
negate: function ()
|
|
|
|
{
|
|
|
|
this.x = -this.x;
|
|
|
|
this.y = -this.y;
|
|
|
|
this.z = -this.z;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 14:00:03 +00:00
|
|
|
* Calculate the distance between this Vector and the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#distance
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to calculate the distance to.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* @return {number} The distance from this Vector to the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
distance: function (v)
|
|
|
|
{
|
|
|
|
var dx = v.x - this.x;
|
|
|
|
var dy = v.y - this.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
var dz = v.z - this.z || 0;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return Math.sqrt(dx * dx + dy * dy + dz * dz);
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-06-14 14:12:10 +00:00
|
|
|
* Calculate the distance between this Vector and the given Vector, squared.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#distanceSq
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:19:31 +00:00
|
|
|
* @param {(Phaser.Math.Vector2|Phaser.Math.Vector3)} v - The Vector to calculate the distance to.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* @return {number} The distance from this Vector to the given Vector, squared.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
distanceSq: function (v)
|
|
|
|
{
|
|
|
|
var dx = v.x - this.x;
|
|
|
|
var dy = v.y - this.y;
|
2017-09-18 23:45:03 +00:00
|
|
|
var dz = v.z - this.z || 0;
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
return dx * dx + dy * dy + dz * dz;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Calculate the length (or magnitude) of this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#length
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {number} The length of this Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
length: function ()
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
|
|
|
|
return Math.sqrt(x * x + y * y + z * z);
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Calculate the length of this Vector squared.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#lengthSq
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {number} The length of this Vector, squared.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
lengthSq: function ()
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
|
|
|
|
return x * x + y * y + z * z;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Normalize this Vector.
|
|
|
|
*
|
|
|
|
* Makes the vector a unit length vector (magnitude of 1) in the same direction.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#normalize
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
normalize: function ()
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var len = x * x + y * y + z * z;
|
|
|
|
|
|
|
|
if (len > 0)
|
|
|
|
{
|
|
|
|
len = 1 / Math.sqrt(len);
|
|
|
|
|
|
|
|
this.x = x * len;
|
|
|
|
this.y = y * len;
|
|
|
|
this.z = z * len;
|
|
|
|
}
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Calculate the dot product of this Vector and the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#dot
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {Phaser.Math.Vector3} v - The Vector3 to dot product with this Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-10-01 10:35:01 +00:00
|
|
|
* @return {number} The dot product of this Vector and `v`.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
dot: function (v)
|
|
|
|
{
|
|
|
|
return this.x * v.x + this.y * v.y + this.z * v.z;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-10-01 10:35:01 +00:00
|
|
|
* Calculate the cross (vector) product of this Vector (which will be modified) and the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#cross
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-10-01 10:35:01 +00:00
|
|
|
* @param {Phaser.Math.Vector3} v - The Vector to cross product with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
cross: function (v)
|
|
|
|
{
|
|
|
|
var ax = this.x;
|
|
|
|
var ay = this.y;
|
|
|
|
var az = this.z;
|
|
|
|
var bx = v.x;
|
|
|
|
var by = v.y;
|
|
|
|
var bz = v.z;
|
|
|
|
|
|
|
|
this.x = ay * bz - az * by;
|
|
|
|
this.y = az * bx - ax * bz;
|
|
|
|
this.z = ax * by - ay * bx;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Linearly interpolate between this Vector and the given Vector.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* Interpolates this Vector towards the given Vector.
|
|
|
|
*
|
2018-01-26 06:19:27 +00:00
|
|
|
* @method Phaser.Math.Vector3#lerp
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {Phaser.Math.Vector3} v - The Vector3 to interpolate towards.
|
|
|
|
* @param {number} [t=0] - The interpolation percentage, between 0 and 1.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
lerp: function (v, t)
|
|
|
|
{
|
|
|
|
if (t === undefined) { t = 0; }
|
|
|
|
|
|
|
|
var ax = this.x;
|
|
|
|
var ay = this.y;
|
|
|
|
var az = this.z;
|
|
|
|
|
|
|
|
this.x = ax + t * (v.x - ax);
|
|
|
|
this.y = ay + t * (v.y - ay);
|
|
|
|
this.z = az + t * (v.z - az);
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Transform this Vector with the given Matrix.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#transformMat3
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:19:31 +00:00
|
|
|
* @param {Phaser.Math.Matrix3} mat - The Matrix3 to transform this Vector3 with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
transformMat3: function (mat)
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var m = mat.val;
|
|
|
|
|
|
|
|
this.x = x * m[0] + y * m[3] + z * m[6];
|
|
|
|
this.y = x * m[1] + y * m[4] + z * m[7];
|
|
|
|
this.z = x * m[2] + y * m[5] + z * m[8];
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Transform this Vector with the given Matrix.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#transformMat4
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:19:31 +00:00
|
|
|
* @param {Phaser.Math.Matrix4} mat - The Matrix4 to transform this Vector3 with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
transformMat4: function (mat)
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var m = mat.val;
|
|
|
|
|
|
|
|
this.x = m[0] * x + m[4] * y + m[8] * z + m[12];
|
|
|
|
this.y = m[1] * x + m[5] * y + m[9] * z + m[13];
|
|
|
|
this.z = m[2] * x + m[6] * y + m[10] * z + m[14];
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-10-19 15:14:51 +00:00
|
|
|
* Transforms the coordinates of this Vector3 with the given Matrix4.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#transformCoordinates
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* @param {Phaser.Math.Matrix4} mat - The Matrix4 to transform this Vector3 with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-12-07 02:20:06 +00:00
|
|
|
transformCoordinates: function (mat)
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var m = mat.val;
|
|
|
|
|
|
|
|
var tx = (x * m[0]) + (y * m[4]) + (z * m[8]) + m[12];
|
|
|
|
var ty = (x * m[1]) + (y * m[5]) + (z * m[9]) + m[13];
|
|
|
|
var tz = (x * m[2]) + (y * m[6]) + (z * m[10]) + m[14];
|
|
|
|
var tw = (x * m[3]) + (y * m[7]) + (z * m[11]) + m[15];
|
|
|
|
|
|
|
|
this.x = tx / tw;
|
|
|
|
this.y = ty / tw;
|
|
|
|
this.z = tz / tw;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Transform this Vector with the given Quaternion.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#transformQuat
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @param {Phaser.Math.Quaternion} q - The Quaternion to transform this Vector with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
transformQuat: function (q)
|
|
|
|
{
|
|
|
|
// benchmarks: http://jsperf.com/quaternion-transform-vec3-implementations
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var qx = q.x;
|
|
|
|
var qy = q.y;
|
|
|
|
var qz = q.z;
|
|
|
|
var qw = q.w;
|
|
|
|
|
|
|
|
// calculate quat * vec
|
|
|
|
var ix = qw * x + qy * z - qz * y;
|
|
|
|
var iy = qw * y + qz * x - qx * z;
|
|
|
|
var iz = qw * z + qx * y - qy * x;
|
|
|
|
var iw = -qx * x - qy * y - qz * z;
|
|
|
|
|
|
|
|
// calculate result * inverse quat
|
|
|
|
this.x = ix * qw + iw * -qx + iy * -qz - iz * -qy;
|
|
|
|
this.y = iy * qw + iw * -qy + iz * -qx - ix * -qz;
|
|
|
|
this.z = iz * qw + iw * -qz + ix * -qy - iy * -qx;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2018-03-19 11:25:46 +00:00
|
|
|
* Multiplies this Vector3 by the specified matrix, applying a W divide. This is useful for projection,
|
2017-09-15 15:31:48 +00:00
|
|
|
* e.g. unprojecting a 2D point into 3D space.
|
|
|
|
*
|
2018-01-26 06:19:27 +00:00
|
|
|
* @method Phaser.Math.Vector3#project
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 14:00:03 +00:00
|
|
|
* @param {Phaser.Math.Matrix4} mat - The Matrix4 to multiply this Vector3 with.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
project: function (mat)
|
|
|
|
{
|
|
|
|
var x = this.x;
|
|
|
|
var y = this.y;
|
|
|
|
var z = this.z;
|
|
|
|
var m = mat.val;
|
|
|
|
|
|
|
|
var a00 = m[0];
|
|
|
|
var a01 = m[1];
|
|
|
|
var a02 = m[2];
|
|
|
|
var a03 = m[3];
|
|
|
|
var a10 = m[4];
|
|
|
|
var a11 = m[5];
|
|
|
|
var a12 = m[6];
|
|
|
|
var a13 = m[7];
|
|
|
|
var a20 = m[8];
|
|
|
|
var a21 = m[9];
|
|
|
|
var a22 = m[10];
|
|
|
|
var a23 = m[11];
|
|
|
|
var a30 = m[12];
|
|
|
|
var a31 = m[13];
|
|
|
|
var a32 = m[14];
|
|
|
|
var a33 = m[15];
|
|
|
|
|
|
|
|
var lw = 1 / (x * a03 + y * a13 + z * a23 + a33);
|
|
|
|
|
|
|
|
this.x = (x * a00 + y * a10 + z * a20 + a30) * lw;
|
|
|
|
this.y = (x * a01 + y * a11 + z * a21 + a31) * lw;
|
|
|
|
this.z = (x * a02 + y * a12 + z * a22 + a32) * lw;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Unproject this point from 2D space to 3D space.
|
|
|
|
* The point should have its x and y properties set to
|
|
|
|
* 2D screen space, and the z either at 0 (near plane)
|
|
|
|
* or 1 (far plane). The provided matrix is assumed to already
|
|
|
|
* be combined, i.e. projection * view * model.
|
|
|
|
*
|
|
|
|
* After this operation, this vector's (x, y, z) components will
|
|
|
|
* represent the unprojected 3D coordinate.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#unproject
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-03-19 11:25:46 +00:00
|
|
|
* @param {Phaser.Math.Vector4} viewport - Screen x, y, width and height in pixels.
|
|
|
|
* @param {Phaser.Math.Matrix4} invProjectionView - Combined projection and view matrix.
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
unproject: function (viewport, invProjectionView)
|
|
|
|
{
|
|
|
|
var viewX = viewport.x;
|
|
|
|
var viewY = viewport.y;
|
|
|
|
var viewWidth = viewport.z;
|
|
|
|
var viewHeight = viewport.w;
|
2018-03-19 12:06:46 +00:00
|
|
|
|
2017-09-15 15:31:48 +00:00
|
|
|
var x = this.x - viewX;
|
|
|
|
var y = (viewHeight - this.y - 1) - viewY;
|
|
|
|
var z = this.z;
|
|
|
|
|
|
|
|
this.x = (2 * x) / viewWidth - 1;
|
|
|
|
this.y = (2 * y) / viewHeight - 1;
|
|
|
|
this.z = 2 * z - 1;
|
|
|
|
|
|
|
|
return this.project(invProjectionView);
|
|
|
|
},
|
|
|
|
|
2018-01-26 06:19:27 +00:00
|
|
|
/**
|
2018-05-23 11:15:16 +00:00
|
|
|
* Make this Vector the zero vector (0, 0, 0).
|
2018-01-26 06:19:27 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Math.Vector3#reset
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-05-23 11:15:16 +00:00
|
|
|
* @return {Phaser.Math.Vector3} This Vector3.
|
2018-01-26 06:19:27 +00:00
|
|
|
*/
|
2017-09-15 15:31:48 +00:00
|
|
|
reset: function ()
|
|
|
|
{
|
|
|
|
this.x = 0;
|
|
|
|
this.y = 0;
|
|
|
|
this.z = 0;
|
|
|
|
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
});
|
|
|
|
|
2019-01-11 02:11:26 +00:00
|
|
|
/**
|
|
|
|
* A static zero Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.ZERO
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
|
|
|
Vector3.ZERO = new Vector3();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A static right Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.RIGHT
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.RIGHT = new Vector3(1, 0, 0);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static left Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.LEFT
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.LEFT = new Vector3(-1, 0, 0);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static up Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.UP
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.UP = new Vector3(0, -1, 0);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static down Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.DOWN
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.DOWN = new Vector3(0, 1, 0);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static forward Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.FORWARD
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.FORWARD = new Vector3(0, 0, 1);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static back Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.BACK
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.BACK = new Vector3(0, 0, -1);
|
2019-01-11 02:11:26 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A static one Vector3 for use by reference.
|
|
|
|
*
|
|
|
|
* This constant is meant for comparison operations and should not be modified directly.
|
|
|
|
*
|
|
|
|
* @constant
|
|
|
|
* @name Phaser.Math.Vector3.ONE
|
|
|
|
* @type {Phaser.Math.Vector3}
|
|
|
|
* @since 3.16.0
|
|
|
|
*/
|
2019-01-18 16:11:59 +00:00
|
|
|
Vector3.ONE = new Vector3(1, 1, 1);
|
2017-09-15 15:31:48 +00:00
|
|
|
|
|
|
|
module.exports = Vector3;
|