gl-matrix
Version:
Javascript Matrix and Vector library for High Performance WebGL apps
1,042 lines (901 loc) • 47.9 kB
JavaScript
/* Copyright (c) 2015, Brandon Jones, Colin MacKenzie IV.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE. */
import * as glMatrix from "../../src/gl-matrix/common"
import * as mat4 from "../../src/gl-matrix/mat4"
import * as quat from "../../src/gl-matrix/quat"
import * as vec3 from "../../src/gl-matrix/vec3"
function buildMat4Tests() {
return function() {
let out, matA, matB, identity, result;
beforeEach(function() {
// Attempting to portray a semi-realistic transform matrix
matA = new Float32Array([1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1]);
matB = new Float32Array([1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
4, 5, 6, 1]);
out = new Float32Array([0, 0, 0, 0,
0, 0, 0, 0,
0, 0, 0, 0,
0, 0, 0, 0]);
identity = new Float32Array([1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1]);
});
describe("create", function() {
beforeEach(function() { result = mat4.create(); });
it("should return a 16 element array initialized to a 4x4 identity matrix", function() { expect(result).toBeEqualish(identity); });
});
describe("clone", function() {
beforeEach(function() { result = mat4.clone(matA); });
it("should return a 16 element array initialized to the values in matA", function() { expect(result).toBeEqualish(matA); });
});
describe("copy", function() {
beforeEach(function() { result = mat4.copy(out, matA); });
it("should place values into out", function() { expect(out).toBeEqualish(matA); });
it("should return out", function() { expect(result).toBe(out); });
});
describe("identity", function() {
beforeEach(function() { result = mat4.identity(out); });
it("should place values into out", function() { expect(result).toBeEqualish(identity); });
it("should return out", function() { expect(result).toBe(out); });
});
describe("transpose", function() {
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.transpose(out, matA); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 1,
0, 1, 0, 2,
0, 0, 1, 3,
0, 0, 0, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.transpose(matA, matA); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 1,
0, 1, 0, 2,
0, 0, 1, 3,
0, 0, 0, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("invert", function() {
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.invert(out, matA); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
-1, -2, -3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.invert(matA, matA); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
-1, -2, -3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("adjoint", function() {
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.adjoint(out, matA); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
-1, -2, -3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.adjoint(matA, matA); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
-1, -2, -3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("determinant", function() {
beforeEach(function() { result = mat4.determinant(matA); });
it("should return the determinant", function() { expect(result).toEqual(1); });
});
describe("multiply", function() {
it("should have an alias called 'mul'", function() { expect(mat4.mul).toEqual(mat4.multiply); });
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.multiply(out, matA, matB); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
5, 7, 9, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
it("should not modify matB", function() {
expect(matB).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
4, 5, 6, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.multiply(matA, matA, matB); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
5, 7, 9, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
it("should not modify matB", function() {
expect(matB).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
4, 5, 6, 1
]);
});
});
describe("when matB is the output matrix", function() {
beforeEach(function() { result = mat4.multiply(matB, matA, matB); });
it("should place values into matB", function() {
expect(matB).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
5, 7, 9, 1
]);
});
it("should return matB", function() { expect(result).toBe(matB); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
});
describe("translate", function() {
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.translate(out, matA, [4, 5, 6]); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
5, 7, 9, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.translate(matA, matA, [4, 5, 6]); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
5, 7, 9, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("scale", function() {
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.scale(out, matA, [4, 5, 6]); });
it("should place values into out", function() {
expect(out).toBeEqualish([
4, 0, 0, 0,
0, 5, 0, 0,
0, 0, 6, 0,
1, 2, 3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.scale(matA, matA, [4, 5, 6]); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
4, 0, 0, 0,
0, 5, 0, 0,
0, 0, 6, 0,
1, 2, 3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("rotate", function() {
let rad = Math.PI * 0.5;
let axis = [1, 0, 0];
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.rotate(out, matA, rad, axis); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, Math.cos(rad), Math.sin(rad), 0,
0, -Math.sin(rad), Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.rotate(matA, matA, rad, axis); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, Math.cos(rad), Math.sin(rad), 0,
0, -Math.sin(rad), Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("rotateX", function() {
let rad = Math.PI * 0.5;
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.rotateX(out, matA, rad); });
it("should place values into out", function() {
expect(out).toBeEqualish([
1, 0, 0, 0,
0, Math.cos(rad), Math.sin(rad), 0,
0, -Math.sin(rad), Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.rotateX(matA, matA, rad); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, Math.cos(rad), Math.sin(rad), 0,
0, -Math.sin(rad), Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("rotateY", function() {
let rad = Math.PI * 0.5;
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.rotateY(out, matA, rad); });
it("should place values into out", function() {
expect(out).toBeEqualish([
Math.cos(rad), 0, -Math.sin(rad), 0,
0, 1, 0, 0,
Math.sin(rad), 0, Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.rotateY(matA, matA, rad); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
Math.cos(rad), 0, -Math.sin(rad), 0,
0, 1, 0, 0,
Math.sin(rad), 0, Math.cos(rad), 0,
1, 2, 3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("rotateZ", function() {
let rad = Math.PI * 0.5;
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat4.rotateZ(out, matA, rad); });
it("should place values into out", function() {
expect(out).toBeEqualish([
Math.cos(rad), Math.sin(rad), 0, 0,
-Math.sin(rad), Math.cos(rad), 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() {
expect(matA).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat4.rotateZ(matA, matA, rad); });
it("should place values into matA", function() {
expect(matA).toBeEqualish([
Math.cos(rad), Math.sin(rad), 0, 0,
-Math.sin(rad), Math.cos(rad), 0, 0,
0, 0, 1, 0,
1, 2, 3, 1
]);
});
it("should return matA", function() { expect(result).toBe(matA); });
});
});
// TODO: fromRotationTranslation
describe("getTranslation", function() {
describe("from the identity matrix", function() {
beforeEach(function() {
result = vec3.fromValues(1, 2, 3);
out = vec3.fromValues(1, 2, 3);
result = mat4.getTranslation(out, identity);
});
it("should place result both in result and out", function() { expect(result).toBe(out); });
it("should return the zero vector", function() { expect(result).toBeEqualish([0, 0, 0]); });
});
describe("from a translation-only matrix", function() {
beforeEach(function() {
result = vec3.fromValues(1, 2, 3);
out = vec3.fromValues(1, 2, 3);
result = mat4.getTranslation(out, matB);
});
it("should return translation vector", function() { expect(out).toBeEqualish([4, 5, 6]); });
});
describe("from a translation and rotation matrix", function() {
beforeEach(function() {
let q = quat.create();
let v = vec3.fromValues(5, 6, 7);
q = quat.setAxisAngle(q, [0.26726124, 0.534522474, 0.8017837], 0.55);
mat4.fromRotationTranslation(out, q, v);
result = vec3.create();
mat4.getTranslation(result, out);
});
it("should keep the same translation vector, regardless of rotation", function() {
expect(result).toBeEqualish([5, 6, 7]);
});
});
});
describe("getScaling", function() {
describe("from the identity matrix", function() {
beforeEach(function() {
result = vec3.fromValues(1, 2, 3);
out = vec3.fromValues(1, 2, 3);
result = mat4.getScaling(out, identity);
});
it("should place result both in result and out", function() { expect(result).toBe(out); });
it("should return the identity vector", function() { expect(result).toBeEqualish([1, 1, 1]); });
});
describe("from a scale-only matrix", function() {
beforeEach(function() {
let v = vec3.fromValues(4, 5, 6);
result = vec3.fromValues(1, 2, 3)
out = vec3.fromValues(1, 2, 3);
mat4.fromScaling(matA, v);
result = mat4.getScaling(out, matA);
});
it("should return translation vector", function() { expect(out).toBeEqualish([4, 5, 6]); });
});
describe("from a translation and rotation matrix", function() {
beforeEach(function() {
let q = quat.create();
let v = vec3.fromValues(5, 6, 7);
q = quat.setAxisAngle(q, [1, 0, 0], 0.5);
mat4.fromRotationTranslation(out, q, v);
result = vec3.fromValues(1, 2, 3);
mat4.getScaling(result, out);
})
it("should return the identity vector", function() { expect(result).toBeEqualish([1, 1, 1]); });
});
describe("from a translation, rotation and scale matrix", function() {
beforeEach(function() {
let q = quat.create();
let t = vec3.fromValues(1, 2, 3);
let s = vec3.fromValues(5, 6, 7);
q = quat.setAxisAngle(q, [0, 1, 0], 0.7);
mat4.fromRotationTranslationScale(out, q, t, s);
result = vec3.fromValues(5, 6, 7);
mat4.getScaling(result, out);
})
it("should return the same scaling factor when created", function() { expect(result).toBeEqualish([5, 6, 7]); });
});
});
describe("getRotation", function() {
describe("from the identity matrix", function() {
beforeEach(function() {
result = quat.fromValues(1, 2, 3, 4);
out = quat.fromValues(1, 2, 3, 4);
result = mat4.getRotation(out, identity);
});
it("should place result both in result and out", function() { expect(result).toBe(out); });
it("should return the unit quaternion", function() {
let unitQuat = quat.create();
quat.identity(unitQuat);
expect(result).toBeEqualish(unitQuat);
});
});
describe("from a translation-only matrix", function() {
beforeEach(function() {
result = quat.fromValues(1, 2, 3, 4);
out = quat.fromValues(1, 2, 3, 4);
result = mat4.getRotation(out, matB);
});
it("should return the unit quaternion", function() {
let unitQuat = quat.create();
quat.identity(unitQuat);
expect(result).toBeEqualish(unitQuat);
});
});
describe("from a translation and rotation matrix", function() {
it("should keep the same rotation as when created", function() {
let q = quat.create();
let outVec = vec3.fromValues(5, 6, 7);
let testVec = vec3.fromValues(1, 5, 2);
let ang = 0.78972;
vec3.normalize(testVec, testVec);
q = quat.setAxisAngle(q, testVec, ang);
mat4.fromRotationTranslation(out, q, outVec);
result = quat.fromValues(2, 3, 4, 6);
mat4.getRotation(result, out);
let outaxis = vec3.create();
let outangle = quat.getAxisAngle(outaxis, result);
expect(outaxis).toBeEqualish(testVec);
expect(outangle).toBeEqualish(ang);
});
});
});
describe("frustum", function() {
beforeEach(function() { result = mat4.frustum(out, -1, 1, -1, 1, -1, 1); });
it("should place values into out", function() { expect(result).toBeEqualish([
-1, 0, 0, 0,
0, -1, 0, 0,
0, 0, 0, -1,
0, 0, 1, 0
]);
});
it("should return out", function() { expect(result).toBe(out); });
});
describe("perspective", function() {
let fovy = Math.PI * 0.5;
beforeEach(function() { result = mat4.perspective(out, fovy, 1, 0, 1); });
it("should place values into out", function() { expect(result).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, -1, -1,
0, 0, 0, 0
]);
});
it("should return out", function() { expect(result).toBe(out); });
describe("with nonzero near, 45deg fovy, and realistic aspect ratio", function() {
beforeEach(function() { result = mat4.perspective(out, 45 * Math.PI / 180.0, 640/480, 0.1, 200); });
it("should calculate correct matrix", function() { expect(result).toBeEqualish([
1.81066, 0, 0, 0,
0, 2.414213, 0, 0,
0, 0, -1.001, -1,
0, 0, -0.2001, 0
]); });
});
});
describe("ortho", function() {
beforeEach(function() { result = mat4.ortho(out, -1, 1, -1, 1, -1, 1); });
it("should place values into out", function() { expect(result).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, -1, 0,
0, 0, 0, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
});
describe("lookAt", function() {
let eye = new Float32Array([0, 0, 1]);
let center = new Float32Array([0, 0, -1]);
let up = new Float32Array([0, 1, 0]);
let view, right;
describe("looking down", function() {
beforeEach(function() {
view = new Float32Array([0, -1, 0]);
up = new Float32Array([0, 0, -1]);
right= new Float32Array([1, 0, 0]);
result = mat4.lookAt(out, [0, 0, 0], view, up);
});
it("should transform view into local -Z", function() {
result = vec3.transformMat4(new Float32Array(3), view, out);
expect(result).toBeEqualish([0, 0, -1]);
});
it("should transform up into local +Y", function() {
result = vec3.transformMat4(new Float32Array(3), up, out);
expect(result).toBeEqualish([0, 1, 0]);
});
it("should transform right into local +X", function() {
result = vec3.transformMat4(new Float32Array(3), right, out);
expect(result).toBeEqualish([1, 0, 0]);
});
it("should return out", function() { expect(result).toBe(out); });
});
describe("#74", function() {
beforeEach(function() {
mat4.lookAt(out,
new Float32Array([0,2,0]),
new Float32Array([0,0.6,0]),
new Float32Array([0,0,-1]));
});
it("should transform a point 'above' into local +Y", function() {
result = vec3.transformMat4(new Float32Array(3), [0, 2, -1], out);
expect(result).toBeEqualish([0, 1, 0]);
});
it("should transform a point 'right of' into local +X", function() {
result = vec3.transformMat4(new Float32Array(3), [1, 2, 0], out);
expect(result).toBeEqualish([1, 0, 0]);
});
it("should transform a point 'in front of' into local -Z", function() {
result = vec3.transformMat4(new Float32Array(3), [0, 1, 0], out);
expect(result).toBeEqualish([0, 0, -1]);
});
});
beforeEach(function() {
eye = new Float32Array([0, 0, 1]);
center = new Float32Array([0, 0, -1]);
up = new Float32Array([0, 1, 0]);
result = mat4.lookAt(out, eye, center, up);
});
it("should place values into out", function() { expect(result).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, -1, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
});
describe("targetTo", function() {
var eye = new Float32Array([0, 0, 1]);
var center = new Float32Array([0, 0, -1]);
var up = new Float32Array([0, 1, 0]);
var view, up, right;
describe("looking down", function() {
beforeEach(function() {
view = new Float32Array([0, -1, 0]);
up = new Float32Array([0, 0, -1]);
right= new Float32Array([1, 0, 0]);
result = mat4.targetTo(out, [0, 0, 0], view, up);
});
it("should transform view into local Z", function() {
result = vec3.transformMat4(new Float32Array(3), view, out);
expect(result).toBeEqualish([0, 0, 1]);
});
it("should transform up into local -Y", function() {
result = vec3.transformMat4(new Float32Array(3), up, out);
expect(result).toBeEqualish([0, -1, 0]);
});
it("should transform right into local +X", function() {
result = vec3.transformMat4(new Float32Array(3), right, out);
expect(result).toBeEqualish([1, 0, 0]);
});
it("should return out", function() { expect(result).toBe(out); });
it("scaling should be [1, 1, 1]", function(){
var scaling = mat4.getScaling(new Float32Array(3), out);
expect(scaling).toBeEqualish([1, 1, 1]);
});
});
describe("#74", function() {
beforeEach(function() {
mat4.targetTo(out,
new Float32Array([0,2,0]),
new Float32Array([0,0.6,0]),
new Float32Array([0,0,-1]));
});
it("should transform a point 'above' into local +Y", function() {
result = vec3.transformMat4(new Float32Array(3), [0, 2, -1], out);
expect(result).toBeEqualish([0, 1, -2]);
});
it("should transform a point 'right of' into local +X", function() {
result = vec3.transformMat4(new Float32Array(3), [1, 2, 0], out);
expect(result).toBeEqualish([1, 2, -2]);
});
it("should transform a point 'in front of' into local -Z", function() {
result = vec3.transformMat4(new Float32Array(3), [0, 1, 0], out);
expect(result).toBeEqualish([0, 2, -1]);
});
it("scaling should be [1, 1, 1]", function(){
var scaling = mat4.getScaling(new Float32Array(3), out);
expect(scaling).toBeEqualish([1, 1, 1]);
});
});
describe("scaling test", function(){
beforeEach(function() {
mat4.targetTo(out,
new Float32Array([0,1,0]),
new Float32Array([0,0,1]),
new Float32Array([0,0,-1]));
});
it("scaling should be [1, 1, 1]", function(){
var scaling = mat4.getScaling(new Float32Array(3), out);
expect(scaling).toBeEqualish([1, 1, 1]);
});
});
beforeEach(function() {
eye = new Float32Array([0, 0, 1]);
center = new Float32Array([0, 0, -1]);
up = new Float32Array([0, 1, 0]);
result = mat4.targetTo(out, eye, center, up);
});
it("should place values into out", function() { expect(result).toBeEqualish([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 1, 1
]);
});
it("should return out", function() { expect(result).toBe(out); });
it("scaling should be [1, 1, 1]", function(){
var scaling = mat4.getScaling(new Float32Array(3), out);
expect(scaling).toBeEqualish([1, 1, 1]);
});
});
describe("str", function() {
beforeEach(function() { result = mat4.str(matA); });
it("should return a string representation of the matrix", function() { expect(result).toEqual("mat4(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 1, 2, 3, 1)"); });
});
describe("frob", function() {
beforeEach(function() { result = mat4.frob(matA); });
it("should return the Frobenius Norm of the matrix", function() { expect(result).toEqual( Math.sqrt(Math.pow(1, 2) + Math.pow(1, 2) + Math.pow(1, 2) + Math.pow(1, 2) + Math.pow(1, 2) + Math.pow(2, 2) + Math.pow(3, 2) )); });
});
};
describe("add", function() {
beforeEach(function() {
matA = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
matB = [17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32];
});
describe("with a separate output matrix", function() {
beforeEach(function() {
result = mat3.add(out, matA, matB);
});
it("should place values into out", function() { expect(out).toBeEqualish([18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48]); });
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat3.add(matA, matA, matB); });
it("should place values into matA", function() { expect(matA).toBeEqualish([18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48]); });
it("should return matA", function() { expect(result).toBe(matA); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matB is the output matrix", function() {
beforeEach(function() { result = mat3.add(matB, matA, matB); });
it("should place values into matB", function() { expect(matB).toBeEqualish([18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48]); });
it("should return matB", function() { expect(result).toBe(matB); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
});
});
describe("subtract", function() {
beforeEach(function() {
matA = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
matB = [17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32];
});
it("should have an alias called 'sub'", function() { expect(mat3.sub).toEqual(mat3.subtract); });
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat3.subtract(out, matA, matB); });
it("should place values into out", function() { expect(out).toBeEqualish([-16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16]); });
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat3.subtract(matA, matA, matB); });
it("should place values into matA", function() { expect(matA).toBeEqualish([-16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16]); });
it("should return matA", function() { expect(result).toBe(matA); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matB is the output matrix", function() {
beforeEach(function() { result = mat3.subtract(matB, matA, matB); });
it("should place values into matB", function() { expect(matB).toBeEqualish([-16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16, -16]); });
it("should return matB", function() { expect(result).toBe(matB); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
});
});
describe("fromValues", function() {
beforeEach(function() { result = mat4.fromValues(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16); });
it("should return a 16 element array initialized to the values passed", function() { expect(result).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
});
describe("set", function() {
beforeEach(function() { result = mat4.set(out, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16); });
it("should place values into out", function() { expect(out).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
it("should return out", function() { expect(result).toBe(out); });
});
describe("multiplyScalar", function() {
beforeEach(function() {
matA = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
});
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat3.multiplyScalar(out, matA, 2); });
it("should place values into out", function() { expect(out).toBeEqualish([2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32]); });
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat3.multiplyScalar(matA, matA, 2); });
it("should place values into matA", function() { expect(matA).toBeEqualish([2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32]); });
it("should return matA", function() { expect(result).toBe(matA); });
});
});
describe("multiplyScalarAndAdd", function() {
beforeEach(function() {
matA = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
matB = [17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32];
});
describe("with a separate output matrix", function() {
beforeEach(function() { result = mat3.multiplyScalarAndAdd(out, matA, matB, 0.5); });
it("should place values into out", function() { expect(out).toBeEqualish([9.5, 11, 12.5, 14, 15.5, 17, 18.5, 20, 21.5, 23, 24.5, 26, 27.5, 29, 30.5, 32]); });
it("should return out", function() { expect(result).toBe(out); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matA is the output matrix", function() {
beforeEach(function() { result = mat3.multiplyScalarAndAdd(matA, matA, matB, 0.5); });
it("should place values into matA", function() { expect(matA).toBeEqualish([9.5, 11, 12.5, 14, 15.5, 17, 18.5, 20, 21.5, 23, 24.5, 26, 27.5, 29, 30.5, 32]); });
it("should return matA", function() { expect(result).toBe(matA); });
it("should not modify matB", function() { expect(matB).toBeEqualish([17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32]); });
});
describe("when matB is the output matrix", function() {
beforeEach(function() { result = mat3.multiplyScalarAndAdd(matB, matA, matB, 0.5); });
it("should place values into matB", function() { expect(matB).toBeEqualish([9.5, 11, 12.5, 14, 15.5, 17, 18.5, 20, 21.5, 23, 24.5, 26, 27.5, 29, 30.5, 32]); });
it("should return matB", function() { expect(result).toBe(matB); });
it("should not modify matA", function() { expect(matA).toBeEqualish([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]); });
});
});
describe("exactEquals", function() {
let matC, r0, r1;
beforeEach(function() {
matA = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
matB = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
matC = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
r0 = mat4.exactEquals(matA, matB);
r1 = mat4.exactEquals(matA, matC);
});
it("should return true for identical matrices", function() { expect(r0).toBe(true); });
it("should return false for different matrices", function() { expect(r1).toBe(false); });
it("should not modify matA", function() { expect(matA).toBeEqualish([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]); });
it("should not modify matB", function() { expect(matB).toBeEqualish([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]); });
});
describe("equals", function() {
let matC, matD, r0, r1, r2;
beforeEach(function() {
matA = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
matB = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
matC = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
matD = [1e-16, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
r0 = mat4.equals(matA, matB);
r1 = mat4.equals(matA, matC);
r2 = mat4.equals(matA, matD);
});
it("should return true for identical matrices", function() { expect(r0).toBe(true); });
it("should return false for different matrices", function() { expect(r1).toBe(false); });
it("should return true for close but not identical matrices", function() { expect(r2).toBe(true); });
it("should not modify matA", function() { expect(matA).toBeEqualish([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]); });
it("should not modify matB", function() { expect(matB).toBeEqualish([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]); });
});
}
describe("mat4", buildMat4Tests());