@itwin/core-geometry 3.6.0-dev.10 → 3.6.0-dev.14

package/lib/cjs/geometry3d/OrderedRotationAngles.d.ts

@@ -5,19 +5,26 @@ import { AxisOrder } from "../Geometry";
 import { Angle } from "./Angle";
 import { Matrix3d } from "./Matrix3d";
 /**
- * * OrderedRotationAngles represents a non-trivial rotation using three simple axis rotation angles, and an order in which to apply them.
- * * This class accommodates application-specific interpretation of "Multiplying 3 rotation matrices" with regard to
+ * *   represents a non-trivial rotation using three simple axis rotation angles and an
+ * order in which to apply them.
+ * * This class accommodates application-specific interpretation of "multiplying 3 rotation matrices" with regard to
  *   * Whether a "vector" is a "row" or a "column"
- *   * The order in which the X,Y, Z rotations are applied.
+ *   * The order in which the X,Y,Z rotations are applied.
  * * Within the imodel geometry library, the preferred rotation order is encapsulated in `YawPitchRollAngles`.
  * @alpha
  */
 export declare class OrderedRotationAngles {
+    /** rotation around x */
     private _x;
+    /** rotation around y */
     private _y;
+    /** rotation around z */
     private _z;
+    /** rotation order. For example XYZ means to rotate around x axis first, then y axis, and finally Z axis */
     private _order;
+    /** treat vectors as matrix columns */
     private static _sTreatVectorsAsColumns;
+    /** constructor */
     private constructor();
     /** (Property accessor) Return the `AxisOrder` controlling matrix multiplication order. */
     get order(): AxisOrder;
@@ -42,20 +49,47 @@ export declare class OrderedRotationAngles {
     /** Flag controlling whether vectors are treated as rows or as columns */
     static get treatVectorsAsColumns(): boolean;
     static set treatVectorsAsColumns(value: boolean);
-    /** Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.
+    /**
+     * Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.
      * @param xRotation rotation around x
      * @param yRotation rotation around y
      * @param zRotation rotation around z
-     * @param axisOrder right to left order of axis names identifies the order that rotations are applied to xyz data.
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
      */
     static createAngles(xRotation: Angle, yRotation: Angle, zRotation: Angle, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles;
-    /** Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply them when rotating. */
+    /**
+     * Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply
+     * them when rotating.
+     * @param xRadians rotation around x
+     * @param yRadians rotation around y
+     * @param zRadians rotation around z
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
+     */
     static createRadians(xRadians: number, yRadians: number, zRadians: number, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles;
-    /** Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply them when rotating. */
+    /**
+     * Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply
+     * them when rotating.
+     * @param xRadians rotation around x
+     * @param yRadians rotation around y
+     * @param zRadians rotation around z
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
+     */
     static createDegrees(xDegrees: number, yDegrees: number, zDegrees: number, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles;
     /** Create an OrderedRotationAngles from a 3x3 rotational matrix, given the ordering of axis rotations that the matrix derives from. */
     static createFromMatrix3d(matrix: Matrix3d, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles;
-    /** Create a 3x3 rotational matrix from this OrderedRotationAngles. */
+    /**
+     * Create a 3x3 rotational matrix from this OrderedRotationAngles.
+     ** math details can be found at docs/learning/geometry/Angle.md
+     **/
     toMatrix3d(result?: Matrix3d): Matrix3d;
 }
 //# sourceMappingURL=OrderedRotationAngles.d.ts.map

package/lib/cjs/geometry3d/OrderedRotationAngles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrderedRotationAngles.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/OrderedRotationAngles.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAkB;IAExD,OAAO;IAOP,0FAA0F;IAC1F,IAAW,KAAK,IAAI,SAAS,CAAwB;IACrD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAA4B;IACtD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAA4B;IACtD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAA4B;IACtD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAA4B;IACzD,yEAAyE;IACzE,WAAkB,qBAAqB,IAAI,OAAO,CAA0D;IAC5G,WAAkB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAA4D;IAElH;;;;;OAKG;WACW,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAWzJ,2HAA2H;WAC7G,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAW1J,2HAA2H;WAC7G,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAW1J,uIAAuI;WACzH,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IA+F3H,sEAAsE;IAC/D,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ;CA6D/C"}
+{"version":3,"file":"OrderedRotationAngles.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/OrderedRotationAngles.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAQ;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAQ;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAQ;IAClB,2GAA2G;IAC3G,OAAO,CAAC,MAAM,CAAY;IAC1B,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAkB;IACxD,kBAAkB;IAClB,OAAO;IAMP,0FAA0F;IAC1F,IAAW,KAAK,IAAI,SAAS,CAE5B;IACD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAEzB;IACD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAEzB;IACD,gFAAgF;IAChF,IAAW,MAAM,IAAI,KAAK,CAEzB;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,4EAA4E;IAC5E,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,yEAAyE;IACzE,WAAkB,qBAAqB,IAAI,OAAO,CAEjD;IACD,WAAkB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAErD;IACD;;;;;;;;;OASG;WACW,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAC/F,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAUxD;;;;;;;;;;OAUG;WACW,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAChG,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAexD;;;;;;;;;;OAUG;WACW,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAChG,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAexD,uIAAuI;WACzH,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAiG3H;;;QAGI;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ;CA2D/C"}

package/lib/cjs/geometry3d/OrderedRotationAngles.js

@@ -11,15 +11,18 @@ exports.OrderedRotationAngles = void 0;
 const Geometry_1 = require("../Geometry");
 const Angle_1 = require("./Angle");
 const Matrix3d_1 = require("./Matrix3d");
+/* cspell:word cxcz, cxsz, cxcy, cxsy, sxcz, sxsz, sxcy, sxsy, cycz, cysz, sycz, sysz */
 /**
- * * OrderedRotationAngles represents a non-trivial rotation using three simple axis rotation angles, and an order in which to apply them.
- * * This class accommodates application-specific interpretation of "Multiplying 3 rotation matrices" with regard to
+ * *   represents a non-trivial rotation using three simple axis rotation angles and an
+ * order in which to apply them.
+ * * This class accommodates application-specific interpretation of "multiplying 3 rotation matrices" with regard to
  *   * Whether a "vector" is a "row" or a "column"
- *   * The order in which the X,Y, Z rotations are applied.
+ *   * The order in which the X,Y,Z rotations are applied.
  * * Within the imodel geometry library, the preferred rotation order is encapsulated in `YawPitchRollAngles`.
  * @alpha
  */
 class OrderedRotationAngles {
+    /** constructor */
     constructor(x, y, z, axisOrder) {
         this._x = x;
         this._y = y;
@@ -27,33 +30,61 @@ class OrderedRotationAngles {
         this._order = axisOrder;
     }
     /** (Property accessor) Return the `AxisOrder` controlling matrix multiplication order. */
-    get order() { return this._order; }
+    get order() {
+        return this._order;
+    }
     /** (Property accessor) Return the strongly typed angle of rotation around x. */
-    get xAngle() { return this._x.clone(); }
+    get xAngle() {
+        return this._x.clone();
+    }
     /** (Property accessor) Return the strongly typed angle of rotation around y. */
-    get yAngle() { return this._y.clone(); }
+    get yAngle() {
+        return this._y.clone();
+    }
     /** (Property accessor) Return the strongly typed angle of rotation around z. */
-    get zAngle() { return this._z.clone(); }
+    get zAngle() {
+        return this._z.clone();
+    }
     /** (Property accessor) Return the angle of rotation around x, in degrees */
-    get xDegrees() { return this._x.degrees; }
+    get xDegrees() {
+        return this._x.degrees;
+    }
     /** (Property accessor) Return the angle of rotation around y, in degrees */
-    get xRadians() { return this._x.radians; }
+    get xRadians() {
+        return this._x.radians;
+    }
     /** (Property accessor) Return the angle of rotation around z, in degrees */
-    get yDegrees() { return this._y.degrees; }
+    get yDegrees() {
+        return this._y.degrees;
+    }
     /** (Property accessor) Return the angle of rotation around x, in radians */
-    get yRadians() { return this._y.radians; }
+    get yRadians() {
+        return this._y.radians;
+    }
     /** (Property accessor) Return the angle of rotation around y, in radians */
-    get zDegrees() { return this._z.degrees; }
+    get zDegrees() {
+        return this._z.degrees;
+    }
     /** (Property accessor) Return the angle of rotation around z, in radians */
-    get zRadians() { return this._z.radians; }
+    get zRadians() {
+        return this._z.radians;
+    }
     /** Flag controlling whether vectors are treated as rows or as columns */
-    static get treatVectorsAsColumns() { return OrderedRotationAngles._sTreatVectorsAsColumns; }
-    static set treatVectorsAsColumns(value) { OrderedRotationAngles._sTreatVectorsAsColumns = value; }
-    /** Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.
+    static get treatVectorsAsColumns() {
+        return OrderedRotationAngles._sTreatVectorsAsColumns;
+    }
+    static set treatVectorsAsColumns(value) {
+        OrderedRotationAngles._sTreatVectorsAsColumns = value;
+    }
+    /**
+     * Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.
      * @param xRotation rotation around x
      * @param yRotation rotation around y
      * @param zRotation rotation around z
-     * @param axisOrder right to left order of axis names identifies the order that rotations are applied to xyz data.
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
      */
     static createAngles(xRotation, yRotation, zRotation, order, result) {
         if (result) {
@@ -65,7 +96,17 @@ class OrderedRotationAngles {
         }
         return new OrderedRotationAngles(xRotation.clone(), yRotation.clone(), zRotation.clone(), order);
     }
-    /** Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply them when rotating. */
+    /**
+     * Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply
+     * them when rotating.
+     * @param xRadians rotation around x
+     * @param yRadians rotation around y
+     * @param zRadians rotation around z
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
+     */
     static createRadians(xRadians, yRadians, zRadians, order, result) {
         if (result) {
             result._x.setRadians(xRadians);
@@ -76,7 +117,17 @@ class OrderedRotationAngles {
         }
         return new OrderedRotationAngles(Angle_1.Angle.createRadians(xRadians), Angle_1.Angle.createRadians(yRadians), Angle_1.Angle.createRadians(zRadians), order);
     }
-    /** Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply them when rotating. */
+    /**
+     * Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply
+     * them when rotating.
+     * @param xRadians rotation around x
+     * @param yRadians rotation around y
+     * @param zRadians rotation around z
+     * @param order left to right order of axis names identifies the order that rotations are applied.
+     * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.
+     * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation
+     * matrix multiplication would be zRot*yRot*xRot
+     */
     static createDegrees(xDegrees, yDegrees, zDegrees, order, result) {
         if (result) {
             result._x.setDegrees(xDegrees);
@@ -89,87 +140,95 @@ class OrderedRotationAngles {
     }
     /** Create an OrderedRotationAngles from a 3x3 rotational matrix, given the ordering of axis rotations that the matrix derives from. */
     static createFromMatrix3d(matrix, order, result) {
-        let m11 = matrix.coffs[0], m12 = matrix.coffs[3], m13 = matrix.coffs[6];
-        let m21 = matrix.coffs[1], m22 = matrix.coffs[4], m23 = matrix.coffs[7];
-        let m31 = matrix.coffs[2], m32 = matrix.coffs[5], m33 = matrix.coffs[8];
-        if (OrderedRotationAngles.treatVectorsAsColumns) {
-            // the formulas are from row order .. flip the mIJ
-            m11 = matrix.coffs[0], m12 = matrix.coffs[1], m13 = matrix.coffs[2];
-            m21 = matrix.coffs[3], m22 = matrix.coffs[4], m23 = matrix.coffs[5];
-            m31 = matrix.coffs[6], m32 = matrix.coffs[7], m33 = matrix.coffs[8];
+        // treat vector as columns
+        let m11 = matrix.coffs[0], m12 = matrix.coffs[1], m13 = matrix.coffs[2];
+        let m21 = matrix.coffs[3], m22 = matrix.coffs[4], m23 = matrix.coffs[5];
+        let m31 = matrix.coffs[6], m32 = matrix.coffs[7], m33 = matrix.coffs[8];
+        // treat vector as rows
+        if (!OrderedRotationAngles.treatVectorsAsColumns) {
+            m11 = matrix.coffs[0], m12 = matrix.coffs[3], m13 = matrix.coffs[6];
+            m21 = matrix.coffs[1], m22 = matrix.coffs[4], m23 = matrix.coffs[7];
+            m31 = matrix.coffs[2], m32 = matrix.coffs[5], m33 = matrix.coffs[8];
         }
         let xRad;
         let yRad;
         let zRad;
         switch (order) {
             case Geometry_1.AxisOrder.XYZ: {
-                yRad = Math.asin(Math.max(-1, Math.min(1, m13)));
-                if (Math.abs(m13) < 0.99999) {
-                    xRad = Math.atan2(-m23, m33);
-                    zRad = Math.atan2(-m12, m11);
+                yRad = Math.asin(Math.max(-1, Math.min(1, -m31))); // limit asin domain to [-1,1]
+                if (Math.abs(m31) < 0.99999) {
+                    xRad = Math.atan2(m32, m33);
+                    zRad = Math.atan2(m21, m11);
                 }
                 else {
-                    xRad = Math.atan2(m32, m22);
+                    /*
+                    * If Math.abs(m31) = 1 then yRad = 90 degrees and therefore, we have a gimbal lock.
+                    * This means xRad and zRad can be anything as long as their sum xRad + zRad is constant.
+                    * so we can pick zRad = 0 and calculate xRad (or pick xRad = 0 and calculate zRad).
+                    * Math details can be found
+                    * https://en.wikipedia.org/wiki/Gimbal_lock#Loss_of_a_degree_of_freedom_with_Euler_angles
+                    */
+                    xRad = Math.atan2(-m23, m22);
                     zRad = 0;
                 }
                 break;
             }
             case Geometry_1.AxisOrder.YXZ: {
-                xRad = Math.asin(-Math.max(-1, Math.min(1, m23)));
-                if (Math.abs(m23) < 0.99999) {
-                    yRad = Math.atan2(m13, m33);
-                    zRad = Math.atan2(m21, m22);
+                xRad = Math.asin(Math.max(-1, Math.min(1, m32))); // limit asin domain to [-1,1]
+                if (Math.abs(m32) < 0.99999) {
+                    yRad = Math.atan2(-m31, m33);
+                    zRad = Math.atan2(-m12, m22);
                 }
                 else {
-                    yRad = Math.atan2(-m31, m11);
+                    yRad = Math.atan2(m13, m11);
                     zRad = 0;
                 }
                 break;
             }
             case Geometry_1.AxisOrder.ZXY: {
-                xRad = Math.asin(Math.max(-1, Math.min(1, m32)));
-                if (Math.abs(m32) < 0.99999) {
-                    yRad = Math.atan2(-m31, m33);
-                    zRad = Math.atan2(-m12, m22);
+                xRad = Math.asin(Math.max(-1, Math.min(1, -m23))); // limit asin domain to [-1,1]
+                if (Math.abs(m23) < 0.99999) {
+                    yRad = Math.atan2(m13, m33);
+                    zRad = Math.atan2(m21, m22);
                 }
                 else {
                     yRad = 0;
-                    zRad = Math.atan2(m21, m11);
+                    zRad = Math.atan2(-m12, m11);
                 }
                 break;
             }
             case Geometry_1.AxisOrder.ZYX: {
-                yRad = -Math.asin(Math.max(-1, Math.min(1, m31)));
-                if (Math.abs(m31) < 0.99999) {
-                    xRad = Math.atan2(m32, m33);
-                    zRad = Math.atan2(m21, m11);
+                yRad = Math.asin(Math.max(-1, Math.min(1, m13))); // limit asin domain to [-1,1]
+                if (Math.abs(m13) < 0.99999) {
+                    xRad = Math.atan2(-m23, m33);
+                    zRad = Math.atan2(-m12, m11);
                 }
                 else {
                     xRad = 0;
-                    zRad = Math.atan2(-m12, m22);
+                    zRad = Math.atan2(m21, m22);
                 }
                 break;
             }
             case Geometry_1.AxisOrder.YZX: {
-                zRad = Math.asin(Math.max(-1, Math.min(1, m21)));
-                if (Math.abs(m21) < 0.99999) {
-                    xRad = Math.atan2(-m23, m22);
-                    yRad = Math.atan2(-m31, m11);
+                zRad = Math.asin(Math.max(-1, Math.min(1, -m12))); // limit asin domain to [-1,1]
+                if (Math.abs(m12) < 0.99999) {
+                    xRad = Math.atan2(m32, m22);
+                    yRad = Math.atan2(m13, m11);
                 }
                 else {
                     xRad = 0;
-                    yRad = Math.atan2(m13, m33);
+                    yRad = Math.atan2(-m31, m33);
                 }
                 break;
             }
             case Geometry_1.AxisOrder.XZY: {
-                zRad = -Math.asin(Math.max(-1, Math.min(1, m12)));
-                if (Math.abs(m12) < 0.99999) {
-                    xRad = Math.atan2(m32, m22);
-                    yRad = Math.atan2(m13, m11);
+                zRad = Math.asin(Math.max(-1, Math.min(1, m21))); // limit asin domain to [-1,1]
+                if (Math.abs(m21) < 0.99999) {
+                    xRad = Math.atan2(-m23, m22);
+                    yRad = Math.atan2(-m31, m11);
                 }
                 else {
-                    xRad = Math.atan2(-m23, m33);
+                    xRad = Math.atan2(m32, m33);
                     yRad = 0;
                 }
                 break;
@@ -178,55 +237,51 @@ class OrderedRotationAngles {
                 xRad = yRad = zRad = 0;
             }
         }
-        if (OrderedRotationAngles.treatVectorsAsColumns)
-            return OrderedRotationAngles.createRadians(-xRad, -yRad, -zRad, order, result);
         return OrderedRotationAngles.createRadians(xRad, yRad, zRad, order, result);
     }
-    /** Create a 3x3 rotational matrix from this OrderedRotationAngles. */
+    /**
+     * Create a 3x3 rotational matrix from this OrderedRotationAngles.
+     ** math details can be found at docs/learning/geometry/Angle.md
+     **/
     toMatrix3d(result) {
-        const rot = result !== undefined ? result : new Matrix3d_1.Matrix3d();
+        const rot = (result !== undefined) ? result : new Matrix3d_1.Matrix3d();
         const axisOrder = this.order;
         const x = this.xAngle, y = this.yAngle, z = this.zAngle;
-        const a = x.cos();
-        let b = x.sin();
-        const c = y.cos();
-        let d = y.sin();
-        const e = z.cos();
-        let f = z.sin();
-        if (OrderedRotationAngles.treatVectorsAsColumns) {
-            b = -b;
-            d = -d;
-            f = -f;
-        }
+        const cx = x.cos(), sx = x.sin();
+        const cy = y.cos(), sy = y.sin();
+        const cz = z.cos(), sz = z.sin();
+        const cxcz = cx * cz, cxsz = cx * sz, cxcy = cx * cy, cxsy = cx * sy;
+        const sxcz = sx * cz, sxsz = sx * sz, sxcy = sx * cy, sxsy = sx * sy;
+        const cycz = cy * cz, cysz = cy * sz, sycz = sy * cz, sysz = sy * sz;
+        // the rotation matrix we build below is created using column-based base rotation matrixes
         if (axisOrder === Geometry_1.AxisOrder.XYZ) {
-            const ae = a * e, af = a * f, be = b * e, bf = b * f;
-            rot.setRowValues(c * e, af + be * d, bf - ae * d, -c * f, ae - bf * d, be + af * d, d, -b * c, a * c);
+            rot.setRowValues(cy * cz, sxcz * sy - cxsz, cxcz * sy + sxsz, cy * sz, cxcz + sxsz * sy, cxsz * sy - sxcz, -sy, sx * cy, cx * cy);
         }
         else if (axisOrder === Geometry_1.AxisOrder.YXZ) {
-            const ce = c * e, cf = c * f, de = d * e, df = d * f;
-            rot.setRowValues(ce + df * b, a * f, cf * b - de, de * b - cf, a * e, df + ce * b, a * d, -b, a * c);
+            rot.setRowValues(cycz - sysz * sx, -cx * sz, cysz * sx + sycz, sycz * sx + cysz, cx * cz, sysz - cycz * sx, -cx * sy, sx, cx * cy);
         }
         else if (axisOrder === Geometry_1.AxisOrder.ZXY) {
-            const ce = c * e, cf = c * f, de = d * e, df = d * f;
-            rot.setRowValues(ce - df * b, cf + de * b, -a * d, -a * f, a * e, b, de + cf * b, df - ce * b, a * c);
+            rot.setRowValues(cycz + sysz * sx, sycz * sx - cysz, cx * sy, cx * sz, cx * cz, -sx, cysz * sx - sycz, cycz * sx + sysz, cx * cy);
         }
         else if (axisOrder === Geometry_1.AxisOrder.ZYX) {
-            const ae = a * e, af = a * f, be = b * e, bf = b * f;
-            rot.setRowValues(c * e, c * f, -d, be * d - af, bf * d + ae, b * c, ae * d + bf, af * d - be, a * c);
+            rot.setRowValues(cy * cz, -cy * sz, sy, sxcz * sy + cxsz, cxcz - sxsz * sy, -sx * cy, sxsz - cxcz * sy, sxcz + cxsz * sy, cx * cy);
         }
         else if (axisOrder === Geometry_1.AxisOrder.YZX) {
-            const ac = a * c, ad = a * d, bc = b * c, bd = b * d;
-            rot.setRowValues(c * e, f, -d * e, bd - ac * f, a * e, ad * f + bc, bc * f + ad, -b * e, ac - bd * f);
+            rot.setRowValues(cy * cz, -sz, sy * cz, sxsy + cxcy * sz, cx * cz, cxsy * sz - sxcy, sxcy * sz - cxsy, sx * cz, cxcy + sxsy * sz);
         }
         else if (axisOrder === Geometry_1.AxisOrder.XZY) {
-            const ac = a * c, ad = a * d, bc = b * c, bd = b * d;
-            rot.setRowValues(c * e, ac * f + bd, bc * f - ad, -f, a * e, b * e, d * e, ad * f - bc, bd * f + ac);
+            rot.setRowValues(cy * cz, sxsy - cxcy * sz, cxsy + sxcy * sz, sz, cx * cz, -sx * cz, -sy * cz, sxcy + cxsy * sz, cxcy - sxsy * sz);
+        }
+        else {
+            rot.setIdentity();
         }
-        if (OrderedRotationAngles.treatVectorsAsColumns)
+        // if we need row-based rotation matrix, we transpose the rotation matrix
+        if (!OrderedRotationAngles.treatVectorsAsColumns)
             rot.transposeInPlace();
         return rot;
     }
 }
 exports.OrderedRotationAngles = OrderedRotationAngles;
+/** treat vectors as matrix columns */
 OrderedRotationAngles._sTreatVectorsAsColumns = false;
 //# sourceMappingURL=OrderedRotationAngles.js.map

package/lib/cjs/geometry3d/OrderedRotationAngles.js.map

@@ -1 +1 @@
-{"version":3,"file":"OrderedRotationAngles.js","sourceRoot":"","sources":["../../../src/geometry3d/OrderedRotationAngles.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module CartesianGeometry\r\n */\r\n\r\nimport { AxisOrder } from \"../Geometry\";\r\nimport { Angle } from \"./Angle\";\r\nimport { Matrix3d } from \"./Matrix3d\";\r\n\r\n/**\r\n * * OrderedRotationAngles represents a non-trivial rotation using three simple axis rotation angles, and an order in which to apply them.\r\n * * This class accommodates application-specific interpretation of \"Multiplying 3 rotation matrices\" with regard to\r\n *   * Whether a \"vector\" is a \"row\" or a \"column\"\r\n *   * The order in which the X,Y, Z rotations are applied.\r\n * * Within the imodel geometry library, the preferred rotation order is encapsulated in `YawPitchRollAngles`.\r\n * @alpha\r\n */\r\nexport class OrderedRotationAngles {\r\n  private _x: Angle;\r\n  private _y: Angle;\r\n  private _z: Angle;\r\n  private _order: AxisOrder;\r\n  private static _sTreatVectorsAsColumns: boolean = false;\r\n\r\n  private constructor(x: Angle, y: Angle, z: Angle, axisOrder: AxisOrder) {\r\n    this._x = x;\r\n    this._y = y;\r\n    this._z = z;\r\n    this._order = axisOrder;\r\n  }\r\n\r\n  /** (Property accessor) Return the `AxisOrder` controlling matrix multiplication order. */\r\n  public get order(): AxisOrder { return this._order; }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around x. */\r\n  public get xAngle(): Angle { return this._x.clone(); }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around y. */\r\n  public get yAngle(): Angle { return this._y.clone(); }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around z. */\r\n  public get zAngle(): Angle { return this._z.clone(); }\r\n  /** (Property accessor) Return the angle of rotation around x, in degrees */\r\n  public get xDegrees(): number { return this._x.degrees; }\r\n  /** (Property accessor) Return the angle of rotation around y, in degrees */\r\n  public get xRadians(): number { return this._x.radians; }\r\n  /** (Property accessor) Return the angle of rotation around z, in degrees */\r\n  public get yDegrees(): number { return this._y.degrees; }\r\n  /** (Property accessor) Return the angle of rotation around x, in radians */\r\n  public get yRadians(): number { return this._y.radians; }\r\n  /** (Property accessor) Return the angle of rotation around y, in radians */\r\n  public get zDegrees(): number { return this._z.degrees; }\r\n  /** (Property accessor) Return the angle of rotation around z, in radians */\r\n  public get zRadians(): number { return this._z.radians; }\r\n  /** Flag controlling whether vectors are treated as rows or as columns */\r\n  public static get treatVectorsAsColumns(): boolean { return OrderedRotationAngles._sTreatVectorsAsColumns; }\r\n  public static set treatVectorsAsColumns(value: boolean) { OrderedRotationAngles._sTreatVectorsAsColumns = value; }\r\n\r\n  /** Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.\r\n   * @param xRotation rotation around x\r\n   * @param yRotation rotation around y\r\n   * @param zRotation rotation around z\r\n   * @param axisOrder right to left order of axis names identifies the order that rotations are applied to xyz data.\r\n   */\r\n  public static createAngles(xRotation: Angle, yRotation: Angle, zRotation: Angle, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setFrom(xRotation);\r\n      result._y.setFrom(yRotation);\r\n      result._z.setFrom(zRotation);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(xRotation.clone(), yRotation.clone(), zRotation.clone(), order);\r\n  }\r\n\r\n  /** Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply them when rotating. */\r\n  public static createRadians(xRadians: number, yRadians: number, zRadians: number, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setRadians(xRadians);\r\n      result._y.setRadians(yRadians);\r\n      result._z.setRadians(zRadians);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(Angle.createRadians(xRadians), Angle.createRadians(yRadians), Angle.createRadians(zRadians), order);\r\n  }\r\n\r\n  /** Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply them when rotating. */\r\n  public static createDegrees(xDegrees: number, yDegrees: number, zDegrees: number, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setDegrees(xDegrees);\r\n      result._y.setDegrees(yDegrees);\r\n      result._z.setDegrees(zDegrees);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(Angle.createDegrees(xDegrees), Angle.createDegrees(yDegrees), Angle.createDegrees(zDegrees), order);\r\n  }\r\n\r\n  /** Create an OrderedRotationAngles from a 3x3 rotational matrix, given the ordering of axis rotations that the matrix derives from. */\r\n  public static createFromMatrix3d(matrix: Matrix3d, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles {\r\n\r\n    let m11 = matrix.coffs[0], m12 = matrix.coffs[3], m13 = matrix.coffs[6];\r\n    let m21 = matrix.coffs[1], m22 = matrix.coffs[4], m23 = matrix.coffs[7];\r\n    let m31 = matrix.coffs[2], m32 = matrix.coffs[5], m33 = matrix.coffs[8];\r\n\r\n    if (OrderedRotationAngles.treatVectorsAsColumns) {\r\n      // the formulas are from row order .. flip the mIJ\r\n      m11 = matrix.coffs[0], m12 = matrix.coffs[1], m13 = matrix.coffs[2];\r\n      m21 = matrix.coffs[3], m22 = matrix.coffs[4], m23 = matrix.coffs[5];\r\n      m31 = matrix.coffs[6], m32 = matrix.coffs[7], m33 = matrix.coffs[8];\r\n\r\n    }\r\n\r\n    let xRad: number;\r\n    let yRad: number;\r\n    let zRad: number;\r\n\r\n    switch (order) {\r\n      case AxisOrder.XYZ: {\r\n        yRad = Math.asin(Math.max(-1, Math.min(1, m13)));\r\n\r\n        if (Math.abs(m13) < 0.99999) {\r\n          xRad = Math.atan2(- m23, m33);\r\n          zRad = Math.atan2(- m12, m11);\r\n        } else {\r\n          xRad = Math.atan2(m32, m22);\r\n          zRad = 0;\r\n        }\r\n        break;\r\n      } case AxisOrder.YXZ: {\r\n        xRad = Math.asin(-Math.max(-1, Math.min(1, m23)));\r\n\r\n        if (Math.abs(m23) < 0.99999) {\r\n          yRad = Math.atan2(m13, m33);\r\n          zRad = Math.atan2(m21, m22);\r\n        } else {\r\n          yRad = Math.atan2(-m31, m11);\r\n          zRad = 0;\r\n        }\r\n        break;\r\n      } case AxisOrder.ZXY: {\r\n        xRad = Math.asin(Math.max(-1, Math.min(1, m32)));\r\n\r\n        if (Math.abs(m32) < 0.99999) {\r\n          yRad = Math.atan2(-m31, m33);\r\n          zRad = Math.atan2(-m12, m22);\r\n        } else {\r\n          yRad = 0;\r\n          zRad = Math.atan2(m21, m11);\r\n        }\r\n        break;\r\n      } case AxisOrder.ZYX: {\r\n        yRad = -Math.asin(Math.max(-1, Math.min(1, m31)));\r\n\r\n        if (Math.abs(m31) < 0.99999) {\r\n          xRad = Math.atan2(m32, m33);\r\n          zRad = Math.atan2(m21, m11);\r\n        } else {\r\n          xRad = 0;\r\n          zRad = Math.atan2(-m12, m22);\r\n        }\r\n        break;\r\n      } case AxisOrder.YZX: {\r\n        zRad = Math.asin(Math.max(-1, Math.min(1, m21)));\r\n\r\n        if (Math.abs(m21) < 0.99999) {\r\n          xRad = Math.atan2(-m23, m22);\r\n          yRad = Math.atan2(-m31, m11);\r\n        } else {\r\n          xRad = 0;\r\n          yRad = Math.atan2(m13, m33);\r\n        }\r\n        break;\r\n      } case AxisOrder.XZY: {\r\n        zRad = -Math.asin(Math.max(-1, Math.min(1, m12)));\r\n\r\n        if (Math.abs(m12) < 0.99999) {\r\n          xRad = Math.atan2(m32, m22);\r\n          yRad = Math.atan2(m13, m11);\r\n        } else {\r\n          xRad = Math.atan2(-m23, m33);\r\n          yRad = 0;\r\n        }\r\n        break;\r\n      } default: {\r\n        xRad = yRad = zRad = 0;\r\n      }\r\n    }\r\n    if (OrderedRotationAngles.treatVectorsAsColumns)\r\n      return OrderedRotationAngles.createRadians(-xRad, -yRad, -zRad, order, result);\r\n\r\n    return OrderedRotationAngles.createRadians(xRad, yRad, zRad, order, result);\r\n  }\r\n\r\n  /** Create a 3x3 rotational matrix from this OrderedRotationAngles. */\r\n  public toMatrix3d(result?: Matrix3d): Matrix3d {\r\n    const rot = result !== undefined ? result : new Matrix3d();\r\n    const axisOrder = this.order;\r\n    const x = this.xAngle, y = this.yAngle, z = this.zAngle;\r\n    const a = x.cos(); let b = x.sin();\r\n    const c = y.cos(); let d = y.sin();\r\n    const e = z.cos(); let f = z.sin();\r\n    if (OrderedRotationAngles.treatVectorsAsColumns) {\r\n      b = -b;\r\n      d = -d;\r\n      f = -f;\r\n    }\r\n\r\n    if (axisOrder === AxisOrder.XYZ) {\r\n      const ae = a * e, af = a * f, be = b * e, bf = b * f;\r\n      rot.setRowValues(\r\n        c * e, af + be * d, bf - ae * d,\r\n        -c * f, ae - bf * d, be + af * d,\r\n        d, -b * c, a * c,\r\n      );\r\n    } else if (axisOrder === AxisOrder.YXZ) {\r\n      const ce = c * e, cf = c * f, de = d * e, df = d * f;\r\n      rot.setRowValues(\r\n        ce + df * b, a * f, cf * b - de,\r\n        de * b - cf, a * e, df + ce * b,\r\n        a * d, -b, a * c,\r\n      );\r\n    } else if (axisOrder === AxisOrder.ZXY) {\r\n      const ce = c * e, cf = c * f, de = d * e, df = d * f;\r\n      rot.setRowValues(\r\n        ce - df * b, cf + de * b, -a * d,\r\n        -a * f, a * e, b,\r\n        de + cf * b, df - ce * b, a * c,\r\n      );\r\n    } else if (axisOrder === AxisOrder.ZYX) {\r\n      const ae = a * e, af = a * f, be = b * e, bf = b * f;\r\n      rot.setRowValues(\r\n        c * e, c * f, -d,\r\n        be * d - af, bf * d + ae, b * c,\r\n        ae * d + bf, af * d - be, a * c,\r\n      );\r\n    } else if (axisOrder === AxisOrder.YZX) {\r\n      const ac = a * c, ad = a * d, bc = b * c, bd = b * d;\r\n      rot.setRowValues(\r\n        c * e, f, -d * e,\r\n        bd - ac * f, a * e, ad * f + bc,\r\n        bc * f + ad, -b * e, ac - bd * f,\r\n      );\r\n    } else if (axisOrder === AxisOrder.XZY) {\r\n      const ac = a * c, ad = a * d, bc = b * c, bd = b * d;\r\n      rot.setRowValues(\r\n        c * e, ac * f + bd, bc * f - ad,\r\n        -f, a * e, b * e,\r\n        d * e, ad * f - bc, bd * f + ac,\r\n      );\r\n    }\r\n    if (OrderedRotationAngles.treatVectorsAsColumns)\r\n      rot.transposeInPlace();\r\n\r\n    return rot;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"OrderedRotationAngles.js","sourceRoot":"","sources":["../../../src/geometry3d/OrderedRotationAngles.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module CartesianGeometry\r\n */\r\nimport { AxisOrder } from \"../Geometry\";\r\nimport { Angle } from \"./Angle\";\r\nimport { Matrix3d } from \"./Matrix3d\";\r\n\r\n/* cspell:word cxcz, cxsz, cxcy, cxsy, sxcz, sxsz, sxcy, sxsy, cycz, cysz, sycz, sysz */\r\n\r\n/**\r\n * *   represents a non-trivial rotation using three simple axis rotation angles and an\r\n * order in which to apply them.\r\n * * This class accommodates application-specific interpretation of \"multiplying 3 rotation matrices\" with regard to\r\n *   * Whether a \"vector\" is a \"row\" or a \"column\"\r\n *   * The order in which the X,Y,Z rotations are applied.\r\n * * Within the imodel geometry library, the preferred rotation order is encapsulated in `YawPitchRollAngles`.\r\n * @alpha\r\n */\r\nexport class OrderedRotationAngles {\r\n  /** rotation around x */\r\n  private _x: Angle;\r\n  /** rotation around y */\r\n  private _y: Angle;\r\n  /** rotation around z */\r\n  private _z: Angle;\r\n  /** rotation order. For example XYZ means to rotate around x axis first, then y axis, and finally Z axis */\r\n  private _order: AxisOrder;\r\n  /** treat vectors as matrix columns */\r\n  private static _sTreatVectorsAsColumns: boolean = false;\r\n  /** constructor */\r\n  private constructor(x: Angle, y: Angle, z: Angle, axisOrder: AxisOrder) {\r\n    this._x = x;\r\n    this._y = y;\r\n    this._z = z;\r\n    this._order = axisOrder;\r\n  }\r\n  /** (Property accessor) Return the `AxisOrder` controlling matrix multiplication order. */\r\n  public get order(): AxisOrder {\r\n    return this._order;\r\n  }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around x. */\r\n  public get xAngle(): Angle {\r\n    return this._x.clone();\r\n  }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around y. */\r\n  public get yAngle(): Angle {\r\n    return this._y.clone();\r\n  }\r\n  /** (Property accessor) Return the strongly typed angle of rotation around z. */\r\n  public get zAngle(): Angle {\r\n    return this._z.clone();\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around x, in degrees */\r\n  public get xDegrees(): number {\r\n    return this._x.degrees;\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around y, in degrees */\r\n  public get xRadians(): number {\r\n    return this._x.radians;\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around z, in degrees */\r\n  public get yDegrees(): number {\r\n    return this._y.degrees;\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around x, in radians */\r\n  public get yRadians(): number {\r\n    return this._y.radians;\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around y, in radians */\r\n  public get zDegrees(): number {\r\n    return this._z.degrees;\r\n  }\r\n  /** (Property accessor) Return the angle of rotation around z, in radians */\r\n  public get zRadians(): number {\r\n    return this._z.radians;\r\n  }\r\n  /** Flag controlling whether vectors are treated as rows or as columns */\r\n  public static get treatVectorsAsColumns(): boolean {\r\n    return OrderedRotationAngles._sTreatVectorsAsColumns;\r\n  }\r\n  public static set treatVectorsAsColumns(value: boolean) {\r\n    OrderedRotationAngles._sTreatVectorsAsColumns = value;\r\n  }\r\n  /**\r\n   * Create an OrderedRotationAngles from three angles and an ordering in which to apply them when rotating.\r\n   * @param xRotation rotation around x\r\n   * @param yRotation rotation around y\r\n   * @param zRotation rotation around z\r\n   * @param order left to right order of axis names identifies the order that rotations are applied.\r\n   * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.\r\n   * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation\r\n   * matrix multiplication would be zRot*yRot*xRot\r\n   */\r\n  public static createAngles(xRotation: Angle, yRotation: Angle, zRotation: Angle, order: AxisOrder,\r\n    result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setFrom(xRotation);\r\n      result._y.setFrom(yRotation);\r\n      result._z.setFrom(zRotation);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(xRotation.clone(), yRotation.clone(), zRotation.clone(), order);\r\n  }\r\n  /**\r\n   * Create an OrderedRotationAngles from three angles (in radians) and an ordering in which to apply\r\n   * them when rotating.\r\n   * @param xRadians rotation around x\r\n   * @param yRadians rotation around y\r\n   * @param zRadians rotation around z\r\n   * @param order left to right order of axis names identifies the order that rotations are applied.\r\n   * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.\r\n   * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation\r\n   * matrix multiplication would be zRot*yRot*xRot\r\n   */\r\n  public static createRadians(xRadians: number, yRadians: number, zRadians: number, order: AxisOrder,\r\n    result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setRadians(xRadians);\r\n      result._y.setRadians(yRadians);\r\n      result._z.setRadians(zRadians);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(\r\n      Angle.createRadians(xRadians),\r\n      Angle.createRadians(yRadians),\r\n      Angle.createRadians(zRadians),\r\n      order\r\n    );\r\n  }\r\n  /**\r\n   * Create an OrderedRotationAngles from three angles (in degrees) and an ordering in which to apply\r\n   * them when rotating.\r\n   * @param xRadians rotation around x\r\n   * @param yRadians rotation around y\r\n   * @param zRadians rotation around z\r\n   * @param order left to right order of axis names identifies the order that rotations are applied.\r\n   * For example XYZ means to rotate around x axis first, then y axis, and finally Z axis.\r\n   * * Note that rotation order is reverse of rotation matrix multiplication so for XYZ the rotation\r\n   * matrix multiplication would be zRot*yRot*xRot\r\n   */\r\n  public static createDegrees(xDegrees: number, yDegrees: number, zDegrees: number, order: AxisOrder,\r\n    result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    if (result) {\r\n      result._x.setDegrees(xDegrees);\r\n      result._y.setDegrees(yDegrees);\r\n      result._z.setDegrees(zDegrees);\r\n      result._order = order;\r\n      return result;\r\n    }\r\n    return new OrderedRotationAngles(\r\n      Angle.createDegrees(xDegrees),\r\n      Angle.createDegrees(yDegrees),\r\n      Angle.createDegrees(zDegrees),\r\n      order\r\n    );\r\n  }\r\n  /** Create an OrderedRotationAngles from a 3x3 rotational matrix, given the ordering of axis rotations that the matrix derives from. */\r\n  public static createFromMatrix3d(matrix: Matrix3d, order: AxisOrder, result?: OrderedRotationAngles): OrderedRotationAngles {\r\n    // treat vector as columns\r\n    let m11 = matrix.coffs[0], m12 = matrix.coffs[1], m13 = matrix.coffs[2];\r\n    let m21 = matrix.coffs[3], m22 = matrix.coffs[4], m23 = matrix.coffs[5];\r\n    let m31 = matrix.coffs[6], m32 = matrix.coffs[7], m33 = matrix.coffs[8];\r\n    // treat vector as rows\r\n    if (!OrderedRotationAngles.treatVectorsAsColumns) {\r\n      m11 = matrix.coffs[0], m12 = matrix.coffs[3], m13 = matrix.coffs[6];\r\n      m21 = matrix.coffs[1], m22 = matrix.coffs[4], m23 = matrix.coffs[7];\r\n      m31 = matrix.coffs[2], m32 = matrix.coffs[5], m33 = matrix.coffs[8];\r\n    }\r\n\r\n    let xRad: number;\r\n    let yRad: number;\r\n    let zRad: number;\r\n\r\n    switch (order) {\r\n      case AxisOrder.XYZ: {\r\n        yRad = Math.asin(Math.max(-1, Math.min(1, -m31))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m31) < 0.99999) {\r\n          xRad = Math.atan2(m32, m33);\r\n          zRad = Math.atan2(m21, m11);\r\n        } else {\r\n          /*\r\n          * If Math.abs(m31) = 1 then yRad = 90 degrees and therefore, we have a gimbal lock.\r\n          * This means xRad and zRad can be anything as long as their sum xRad + zRad is constant.\r\n          * so we can pick zRad = 0 and calculate xRad (or pick xRad = 0 and calculate zRad).\r\n          * Math details can be found\r\n          * https://en.wikipedia.org/wiki/Gimbal_lock#Loss_of_a_degree_of_freedom_with_Euler_angles\r\n          */\r\n          xRad = Math.atan2(-m23, m22);\r\n          zRad = 0;\r\n        }\r\n        break;\r\n      } case AxisOrder.YXZ: {\r\n        xRad = Math.asin(Math.max(-1, Math.min(1, m32))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m32) < 0.99999) {\r\n          yRad = Math.atan2(-m31, m33);\r\n          zRad = Math.atan2(-m12, m22);\r\n        } else {\r\n          yRad = Math.atan2(m13, m11);\r\n          zRad = 0;\r\n        }\r\n        break;\r\n      } case AxisOrder.ZXY: {\r\n        xRad = Math.asin(Math.max(-1, Math.min(1, -m23))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m23) < 0.99999) {\r\n          yRad = Math.atan2(m13, m33);\r\n          zRad = Math.atan2(m21, m22);\r\n        } else {\r\n          yRad = 0;\r\n          zRad = Math.atan2(-m12, m11);\r\n        }\r\n        break;\r\n      } case AxisOrder.ZYX: {\r\n        yRad = Math.asin(Math.max(-1, Math.min(1, m13))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m13) < 0.99999) {\r\n          xRad = Math.atan2(-m23, m33);\r\n          zRad = Math.atan2(-m12, m11);\r\n        } else {\r\n          xRad = 0;\r\n          zRad = Math.atan2(m21, m22);\r\n        }\r\n        break;\r\n      } case AxisOrder.YZX: {\r\n        zRad = Math.asin(Math.max(-1, Math.min(1, -m12))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m12) < 0.99999) {\r\n          xRad = Math.atan2(m32, m22);\r\n          yRad = Math.atan2(m13, m11);\r\n        } else {\r\n          xRad = 0;\r\n          yRad = Math.atan2(-m31, m33);\r\n        }\r\n        break;\r\n      } case AxisOrder.XZY: {\r\n        zRad = Math.asin(Math.max(-1, Math.min(1, m21))); // limit asin domain to [-1,1]\r\n\r\n        if (Math.abs(m21) < 0.99999) {\r\n          xRad = Math.atan2(-m23, m22);\r\n          yRad = Math.atan2(-m31, m11);\r\n        } else {\r\n          xRad = Math.atan2(m32, m33);\r\n          yRad = 0;\r\n        }\r\n        break;\r\n      } default: {\r\n        xRad = yRad = zRad = 0;\r\n      }\r\n    }\r\n\r\n    return OrderedRotationAngles.createRadians(xRad, yRad, zRad, order, result);\r\n  }\r\n  /**\r\n   * Create a 3x3 rotational matrix from this OrderedRotationAngles.\r\n   ** math details can be found at docs/learning/geometry/Angle.md\r\n   **/\r\n  public toMatrix3d(result?: Matrix3d): Matrix3d {\r\n    const rot = (result !== undefined) ? result : new Matrix3d();\r\n    const axisOrder = this.order;\r\n    const x = this.xAngle, y = this.yAngle, z = this.zAngle;\r\n\r\n    const cx = x.cos(), sx = x.sin();\r\n    const cy = y.cos(), sy = y.sin();\r\n    const cz = z.cos(), sz = z.sin();\r\n\r\n    const cxcz = cx * cz, cxsz = cx * sz, cxcy = cx * cy, cxsy = cx * sy;\r\n    const sxcz = sx * cz, sxsz = sx * sz, sxcy = sx * cy, sxsy = sx * sy;\r\n    const cycz = cy * cz, cysz = cy * sz, sycz = sy * cz, sysz = sy * sz;\r\n\r\n    // the rotation matrix we build below is created using column-based base rotation matrixes\r\n    if (axisOrder === AxisOrder.XYZ) {\r\n      rot.setRowValues(\r\n        cy * cz, sxcz * sy - cxsz, cxcz * sy + sxsz,\r\n        cy * sz, cxcz + sxsz * sy, cxsz * sy - sxcz,\r\n        -sy, sx * cy, cx * cy,\r\n      );\r\n    } else if (axisOrder === AxisOrder.YXZ) {\r\n      rot.setRowValues(\r\n        cycz - sysz * sx, -cx * sz, cysz * sx + sycz,\r\n        sycz * sx + cysz, cx * cz, sysz - cycz * sx,\r\n        -cx * sy, sx, cx * cy,\r\n      );\r\n    } else if (axisOrder === AxisOrder.ZXY) {\r\n      rot.setRowValues(\r\n        cycz + sysz * sx, sycz * sx - cysz, cx * sy,\r\n        cx * sz, cx * cz, -sx,\r\n        cysz * sx - sycz, cycz * sx + sysz, cx * cy,\r\n      );\r\n    } else if (axisOrder === AxisOrder.ZYX) {\r\n      rot.setRowValues(\r\n        cy * cz, -cy * sz, sy,\r\n        sxcz * sy + cxsz, cxcz - sxsz * sy, -sx * cy,\r\n        sxsz - cxcz * sy, sxcz + cxsz * sy, cx * cy,\r\n      );\r\n    } else if (axisOrder === AxisOrder.YZX) {\r\n      rot.setRowValues(\r\n        cy * cz, -sz, sy * cz,\r\n        sxsy + cxcy * sz, cx * cz, cxsy * sz - sxcy,\r\n        sxcy * sz - cxsy, sx * cz, cxcy + sxsy * sz,\r\n      );\r\n    } else if (axisOrder === AxisOrder.XZY) {\r\n      rot.setRowValues(\r\n        cy * cz, sxsy - cxcy * sz, cxsy + sxcy * sz,\r\n        sz, cx * cz, -sx * cz,\r\n        -sy * cz, sxcy + cxsy * sz, cxcy - sxsy * sz,\r\n      );\r\n    } else {\r\n      rot.setIdentity();\r\n    }\r\n    // if we need row-based rotation matrix, we transpose the rotation matrix\r\n    if (!OrderedRotationAngles.treatVectorsAsColumns)\r\n      rot.transposeInPlace();\r\n\r\n    return rot;\r\n  }\r\n}\r\n"]}

package/lib/cjs/geometry3d/Point2dVector2d.d.ts

@@ -182,6 +182,7 @@ export declare class Vector2d extends XY implements BeJSONFunctions {
     /**
      * Return a vector that bisects the angle between two normals and extends to the intersection of two offset lines
      * * returns `undefined` if `unitPerpA = -unitPerpB` (i.e., are opposite)
+     * * math details can be found at docs/learning/geometry/PointVector.md
      * @param unitPerpA unit perpendicular to incoming direction
      * @param unitPerpB  unit perpendicular to outgoing direction
      * @param offset offset distance

package/lib/cjs/geometry3d/Point2dVector2d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Point2dVector2d.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Point2dVector2d.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Point2dVector2d.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Point2dVector2d.ts"],"names":[],"mappings":"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"}

package/lib/cjs/geometry3d/Point2dVector2d.js

@@ -367,6 +367,7 @@ class Vector2d extends XY {
     /**
      * Return a vector that bisects the angle between two normals and extends to the intersection of two offset lines
      * * returns `undefined` if `unitPerpA = -unitPerpB` (i.e., are opposite)
+     * * math details can be found at docs/learning/geometry/PointVector.md
      * @param unitPerpA unit perpendicular to incoming direction
      * @param unitPerpB  unit perpendicular to outgoing direction
      * @param offset offset distance