You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

112 lines
2.0 KiB
JavaScript

import Check from "../Core/Check.js";
import CesiumMath from "../Core/Math.js";
import Matrix3 from "../Core/Matrix3.js";
import Matrix4 from "../Core/Matrix4.js";
/**
* An enum describing the x, y, and z axes and helper conversion functions.
*
* @enum {Number}
*/
var Axis = {
/**
* Denotes the x-axis.
*
* @type {Number}
* @constant
*/
X: 0,
/**
* Denotes the y-axis.
*
* @type {Number}
* @constant
*/
Y: 1,
/**
* Denotes the z-axis.
*
* @type {Number}
* @constant
*/
Z: 2,
};
/**
* Matrix used to convert from y-up to z-up
*
* @type {Matrix4}
* @constant
*/
Axis.Y_UP_TO_Z_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationX(CesiumMath.PI_OVER_TWO)
);
/**
* Matrix used to convert from z-up to y-up
*
* @type {Matrix4}
* @constant
*/
Axis.Z_UP_TO_Y_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationX(-CesiumMath.PI_OVER_TWO)
);
/**
* Matrix used to convert from x-up to z-up
*
* @type {Matrix4}
* @constant
*/
Axis.X_UP_TO_Z_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationY(-CesiumMath.PI_OVER_TWO)
);
/**
* Matrix used to convert from z-up to x-up
*
* @type {Matrix4}
* @constant
*/
Axis.Z_UP_TO_X_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationY(CesiumMath.PI_OVER_TWO)
);
/**
* Matrix used to convert from x-up to y-up
*
* @type {Matrix4}
* @constant
*/
Axis.X_UP_TO_Y_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationZ(CesiumMath.PI_OVER_TWO)
);
/**
* Matrix used to convert from y-up to x-up
*
* @type {Matrix4}
* @constant
*/
Axis.Y_UP_TO_X_UP = Matrix4.fromRotationTranslation(
Matrix3.fromRotationZ(-CesiumMath.PI_OVER_TWO)
);
/**
* Gets the axis by name
*
* @param {String} name The name of the axis.
* @returns {Number} The axis enum.
*/
Axis.fromName = function (name) {
//>>includeStart('debug', pragmas.debug);
Check.typeOf.string("name", name);
//>>includeEnd('debug');
return Axis[name];
};
export default Object.freeze(Axis);