@itwin/core-geometry 3.0.0-dev.76 → 3.0.0-dev.80

package/lib/esm/geometry3d/Angle.js

@@ -0,0 +1,399 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module CartesianGeometry
+ */
+import { Geometry } from "../Geometry";
+/**
+ * An `Angle` carries the numeric value of an angle, with methods to allow (require!) callers to be clear about whether their angle is degrees or radians.
+ * * The numeric value is private, and callers should not know or care whether it is in degrees or radians.
+ * * The various access method are named so that callers can specify whether untyped numbers passed in or out are degrees or radians.
+ * @public
+ */
+export class Angle {
+    constructor(radians = 0, degrees) { this._radians = radians; this._degrees = degrees; }
+    /** Return a new angle with the same content. */
+    clone() { return new Angle(this._radians, this._degrees); }
+    /** Freeze this instance so it is read-only */
+    freeze() { return Object.freeze(this); }
+    /**
+     * Return a new Angle object for angle given in degrees.
+     * @param degrees angle in degrees
+     */
+    static createDegrees(degrees) { return new Angle(Angle.degreesToRadians(degrees), degrees); }
+    /**
+     * Return a (new) Angle object for a value given in radians.
+     * @param radians angle in radians
+     */
+    static createRadians(radians) { return new Angle(radians); }
+    /**
+     * Return a (new) Angle object that is interpolated between two inputs
+     * @param radians angle in radians
+     */
+    static createInterpolate(angle0, fraction, angle1) {
+        return new Angle(Geometry.interpolate(angle0.radians, fraction, angle1.radians));
+    }
+    /**
+     * Return a (new) Angle object, with angle scaled from existing angle.
+     * @param scale scale factor to apply to angle.
+     */
+    cloneScaled(scale) { return new Angle(this.radians * scale); }
+    /**
+     * Set this angle to a value given in radians.
+     * @param radians angle given in radians
+     */
+    setRadians(radians) { this._radians = radians; this._degrees = undefined; }
+    /**
+     * Set this angle to a value given in degrees.
+     * @param degrees angle given in degrees.
+     */
+    setDegrees(degrees) { this._radians = Angle.degreesToRadians(degrees); this._degrees = degrees; }
+    /** Create an angle for a full circle. */
+    static create360() { return new Angle(Math.PI * 2.0, 360.0); }
+    /**
+     * @return a (strongly typed) Angle whose tangent is `numerator/denominator`, using the signs of both in determining the (otherwise ambiguous)
+     * quadrant.
+     * @param numerator numerator for tangent
+     * @param denominator denominator for tangent
+     */
+    static createAtan2(numerator, denominator) { return new Angle(Math.atan2(numerator, denominator)); }
+    /**
+     * Copy all contents of `other` to this Angle.
+     * @param other source data
+     */
+    setFrom(other) { this._radians = other._radians; this._degrees = other._degrees; }
+    /**
+     * Create an Angle from a JSON object
+     * @param json object from JSON.parse. If a number, value is in *DEGREES*
+     * @param defaultValRadians if json is undefined, default value in radians.
+     * @return a new Angle
+     */
+    static fromJSON(json, defaultValRadians) {
+        const val = new Angle();
+        val.setFromJSON(json, defaultValRadians);
+        return val;
+    }
+    /**
+     * set an Angle from a JSON object
+     * * A simple number is degrees.
+     * * specified `json.degrees` or `json._degrees` is degree value.
+     * * specified `son.radians` or `json._radians` is radians value.
+     * @param json object from JSON.parse. If a number, value is in *DEGREES*
+     * @param defaultValRadians if json is undefined, default value in radians.
+     */
+    setFromJSON(json, defaultValRadians) {
+        this._radians = defaultValRadians ? defaultValRadians : 0;
+        if (!json)
+            return;
+        if (typeof json === "number") {
+            this.setDegrees(json);
+        }
+        else if (typeof json.degrees === "number") {
+            this.setDegrees(json.degrees);
+        }
+        else if (typeof json._degrees === "number") {
+            this.setDegrees(json._degrees);
+        }
+        else if (typeof json.radians === "number") {
+            this.setRadians(json.radians);
+        }
+        else if (typeof json._radians === "number") {
+            this.setRadians(json._radians);
+        }
+    }
+    /** Convert an Angle to a JSON object as a number in degrees */
+    toJSON() { return this.degrees; }
+    /** Return a json object with radians keyword, e.g. `{ radians: 0.10}` */
+    toJSONRadians() { return { radians: this.radians }; }
+    /**  Return the angle measured in radians. */
+    get radians() { return this._radians; }
+    /**  Return the angle measured in degrees. */
+    get degrees() { return this._degrees !== undefined ? this._degrees : Angle.radiansToDegrees(this._radians); }
+    /**
+     * Convert an angle in degrees to radians.
+     * @param degrees angle in degrees
+     */
+    static degreesToRadians(degrees) { return degrees * Math.PI / 180; }
+    /**
+     * Convert an angle in radians to degrees.
+     * @param degrees angle in radians
+     */
+    static radiansToDegrees(radians) {
+        if (radians < 0)
+            return -Angle.radiansToDegrees(-radians);
+        // Now radians is positive ...
+        const pi = Math.PI;
+        const factor = 180.0 / pi;
+        if (radians <= 0.25 * pi)
+            return factor * radians;
+        if (radians < 0.75 * pi)
+            return 90.0 + 180 * ((radians - 0.5 * pi) / pi);
+        if (radians <= 1.25 * pi)
+            return 180.0 + 180 * ((radians - pi) / pi);
+        if (radians <= 1.75 * pi)
+            return 270.0 + 180 * ((radians - 1.5 * pi) / pi);
+        // all larger radians reference from 360 degrees (2PI)
+        return 360.0 + 180 * ((radians - 2.0 * pi) / pi);
+    }
+    /**
+     * Return the cosine of this Angle object's angle.
+     */
+    cos() { return Math.cos(this._radians); }
+    /**
+     * Return the sine of this Angle object's angle.
+     */
+    sin() { return Math.sin(this._radians); }
+    /**
+     * Return the tangent of this Angle object's angle.
+     */
+    tan() { return Math.tan(this._radians); }
+    /** Test if a radians (absolute) value is nearly 2PI or larger (!) */
+    static isFullCircleRadians(radians) {
+        return Math.abs(radians) >= Geometry.fullCircleRadiansMinusSmallAngle;
+    }
+    /** Test if the radians value  is a complete circle */
+    static isHalfCircleRadians(radians) {
+        return Math.abs(Math.abs(radians) - Math.PI) <= Geometry.smallAngleRadians;
+    }
+    /** test if the angle is aa full circle */
+    get isFullCircle() { return Angle.isFullCircleRadians(this._radians); }
+    /** test if the angle is a half circle (in either direction) */
+    get isHalfCircle() { return Angle.isHalfCircleRadians(this._radians); }
+    /** Adjust a radians value so it is positive in 0..360 */
+    static adjustDegrees0To360(degrees) {
+        if (degrees >= 0) {
+            const period = 360.0;
+            if (degrees < period)
+                return degrees;
+            const numPeriods = Math.floor(degrees / period);
+            return degrees - numPeriods * period;
+        }
+        else if (degrees < 0) {
+            // negative angle ...
+            const radians1 = Angle.adjustDegrees0To360(-degrees);
+            return 360.0 - radians1;
+        }
+        // fall through for Nan (disaster) !!!
+        return 0;
+    }
+    /** Adjust a radians value so it is in -180..180 */
+    static adjustDegreesSigned180(degrees) {
+        if (Math.abs(degrees) <= 180.0)
+            return degrees;
+        if (degrees >= 0) {
+            const period = 360.0;
+            const numPeriods = 1 + Math.floor((degrees - 180.0) / period);
+            return degrees - numPeriods * period;
+        }
+        else if (degrees < 0) {
+            // negative angle ...
+            return -Angle.adjustDegreesSigned180(-degrees);
+        }
+        // fall through for NaN disaster.
+        return 0;
+    }
+    /** Adjust a radians value so it is positive in 0..2Pi */
+    static adjustRadians0To2Pi(radians) {
+        if (radians >= 0) {
+            const period = Math.PI * 2.0;
+            if (radians < period)
+                return radians;
+            const numPeriods = Math.floor(radians / period);
+            return radians - numPeriods * period;
+        }
+        else if (radians < 0) {
+            // negative angle ...
+            const radians1 = Angle.adjustRadians0To2Pi(-radians);
+            return Math.PI * 2.0 - radians1;
+        }
+        // fall through for NaN disaster.
+        return 0;
+    }
+    /** Adjust a radians value so it is positive in -PI..PI */
+    static adjustRadiansMinusPiPlusPi(radians) {
+        if (Math.abs(radians) <= Math.PI)
+            return radians;
+        if (radians >= 0) {
+            const period = Math.PI * 2.0;
+            const numPeriods = 1 + Math.floor((radians - Math.PI) / period);
+            return radians - numPeriods * period;
+        }
+        else if (radians < 0) {
+            // negative angle ...
+            return -Angle.adjustRadiansMinusPiPlusPi(-radians);
+        }
+        // fall through for NaN disaster.
+        return 0;
+    }
+    /** return a (newly allocated) Angle object with value 0 radians */
+    static zero() { return new Angle(0); }
+    /** Test if the angle is exactly zero. */
+    get isExactZero() { return this.radians === 0; }
+    /** Test if the angle is almost zero (within tolerance `Geometry.smallAngleRadians`) */
+    get isAlmostZero() { return Math.abs(this.radians) < Geometry.smallAngleRadians; }
+    /** Test if the angle is almost a north or south pole (within tolerance `Geometry.smallAngleRadians`) */
+    get isAlmostNorthOrSouthPole() { return Angle.isHalfCircleRadians(this.radians * 2.0); }
+    /** Create an angle object with degrees adjusted into 0..360. */
+    static createDegreesAdjustPositive(degrees) { return Angle.createDegrees(Angle.adjustDegrees0To360(degrees)); }
+    /** Create an angle object with degrees adjusted into -180..180. */
+    static createDegreesAdjustSigned180(degrees) { return Angle.createDegrees(Angle.adjustDegreesSigned180(degrees)); }
+    /**
+     * Test if two radians values are equivalent, allowing shift by full circle (i.e. by a multiple of `2*PI`)
+     * @param radiansA first radians value
+     * @param radiansB second radians value
+     */
+    static isAlmostEqualRadiansAllowPeriodShift(radiansA, radiansB) {
+        // try to get simple conclusions with un-shifted radians ...
+        const delta = Math.abs(radiansA - radiansB);
+        if (delta <= Geometry.smallAngleRadians)
+            return true;
+        const period = Math.PI * 2.0;
+        if (Math.abs(delta - period) <= Geometry.smallAngleRadians)
+            return true;
+        const numPeriod = Math.round(delta / period);
+        const delta1 = delta - numPeriod * period;
+        return Math.abs(delta1) <= Geometry.smallAngleRadians;
+    }
+    /**
+     * Test if this angle and other are equivalent, allowing shift by full circle (i.e. by a multiple of 360 degrees)
+     */
+    isAlmostEqualAllowPeriodShift(other) {
+        return Angle.isAlmostEqualRadiansAllowPeriodShift(this._radians, other._radians);
+    }
+    /**
+     * Test if two this angle and other are almost equal, NOT allowing shift by full circle multiples of 360 degrees.
+     */
+    isAlmostEqualNoPeriodShift(other) { return Math.abs(this._radians - other._radians) < Geometry.smallAngleRadians; }
+    /**
+     * Test if two angle (in radians)  almost equal, NOT allowing shift by full circle multiples of `2 * PI`.
+     * * (Same test as isAlmostEqualRadiansNoPeriodShift)
+     */
+    isAlmostEqual(other) { return this.isAlmostEqualNoPeriodShift(other); }
+    /**
+     * Test if two angle (in radians)  almost equal, NOT allowing shift by full circle multiples of `2 * PI`.
+     */
+    static isAlmostEqualRadiansNoPeriodShift(radiansA, radiansB) { return Math.abs(radiansA - radiansB) < Geometry.smallAngleRadians; }
+    /**
+     * Test if dot product values indicate non-zero length perpendicular vectors.
+     * @param dotUU dot product of vectorU with itself
+     * @param dotVV dot product of vectorV with itself
+     * @param dotUV dot product of vectorU with vectorV
+     */
+    static isPerpendicularDotSet(dotUU, dotVV, dotUV) {
+        return dotUU > Geometry.smallMetricDistanceSquared
+            && dotVV > Geometry.smallMetricDistanceSquared
+            && dotUV * dotUV <= Geometry.smallAngleRadiansSquared * dotUU * dotVV;
+    }
+    /**
+     * Return cosine, sine, and radians for the half angle of a cosine,sine pair.
+     * @param rCos2A cosine value (scaled by radius) for initial angle.
+     * @param rSin2A sine value (scaled by radius) for final angle.
+     */
+    static trigValuesToHalfAngleTrigValues(rCos2A, rSin2A) {
+        const r = Geometry.hypotenuseXY(rCos2A, rSin2A);
+        if (r < Geometry.smallMetricDistance) {
+            return { c: 1.0, s: 0.0, radians: 0.0 };
+        }
+        else {
+            /* If the caller really gave you sine and cosine values, r should be 1.  However,*/
+            /* to allow scaled values -- e.g. the x and y components of any vector -- we normalize*/
+            /* right here.  This adds an extra sqrt and 2 divides to the whole process, but improves*/
+            /* both the usefulness and robustness of the computation.*/
+            let cosA;
+            let sinA = 0.0;
+            const cos2A = rCos2A / r;
+            const sin2A = rSin2A / r;
+            if (cos2A >= 0.0) {
+                /* Original angle in NE and SE quadrants.  Half angle in same quadrant */
+                cosA = Math.sqrt(0.5 * (1.0 + cos2A));
+                sinA = sin2A / (2.0 * (cosA));
+            }
+            else {
+                if (sin2A > 0.0) {
+                    /* Original angle in NW quadrant. Half angle in NE quadrant */
+                    sinA = Math.sqrt(0.5 * (1.0 - cos2A));
+                }
+                else {
+                    /* Original angle in SW quadrant. Half angle in SE quadrant*/
+                    /* cosA comes out positive because both sines are negative. */
+                    sinA = -Math.sqrt(0.5 * (1.0 - cos2A));
+                }
+                cosA = sin2A / (2.0 * (sinA));
+            }
+            return { c: cosA, s: sinA, radians: Math.atan2(sinA, cosA) };
+        }
+    }
+    /** If value is close to -1, -0.5, 0, 0.5, 1, adjust it to the exact value. */
+    static cleanupTrigValue(value, tolerance = 1.0e-15) {
+        const absValue = Math.abs(value);
+        if (absValue <= tolerance)
+            return 0;
+        let a = Math.abs(absValue - 0.5);
+        if (a <= tolerance)
+            return value < 0.0 ? -0.5 : 0.5;
+        a = Math.abs(absValue - 1.0);
+        if (a <= tolerance)
+            return value < 0.0 ? -1.0 : 1.0;
+        return value;
+    }
+    /**
+     * Return the half angle cosine, sine, and radians for given dot products between vectors.
+     * @param dotUU dot product of vectorU with itself
+     * @param dotVV dot product of vectorV with itself
+     * @param dotUV dot product of vectorU with vectorV
+     */
+    static dotProductsToHalfAngleTrigValues(dotUU, dotVV, dotUV, favorZero = true) {
+        const rCos = dotUU - dotVV;
+        const rSin = 2.0 * dotUV;
+        if (favorZero && Math.abs(rSin) < Geometry.smallAngleRadians * (Math.abs(dotUU) + Math.abs(dotVV)))
+            return { c: 1.0, s: 0.0, radians: 0.0 };
+        return Angle.trigValuesToHalfAngleTrigValues(rCos, rSin);
+    }
+    /**
+     * * Returns the angle between two vectors, with the vectors given as xyz components
+     * * The returned angle is between 0 and PI
+     *
+     * @param ux x component of vector u
+     * @param uy y component of vector u
+     * @param uz z component of vector u
+     * @param vx x component of vector v
+     * @param vy y component of vector v
+     * @param vz z component of vector v
+     */
+    static radiansBetweenVectorsXYZ(ux, uy, uz, vx, vy, vz) {
+        //  const uu = ux * ux + uy * uy + uz * uz;
+        const uDotV = ux * vx + uy * vy + uz * vz; // magU magV cos(theta)
+        //    const vv = vx * vx + vy * vy + vz * vz;
+        return Math.atan2(Geometry.crossProductMagnitude(ux, uy, uz, vx, vy, vz), uDotV);
+    }
+    /**
+     * Add a multiple of a full circle angle (360 degrees, 2PI) in place.
+     * @param multiple multiplier factor
+     */
+    addMultipleOf2PiInPlace(multiple) {
+        if (this._degrees !== undefined) {
+            this._degrees += multiple * 360.0;
+            this._radians = Angle.degreesToRadians(this._degrees);
+        }
+        else {
+            this._radians += multiple * Angle.pi2Radians;
+        }
+    }
+}
+/** maximal accuracy value of pi/4 ( 45 degrees), in radians */
+Angle.piOver4Radians = 7.85398163397448280000e-001;
+/** maximal accuracy value of pi/2 ( 90 degrees), in radians */
+Angle.piOver2Radians = 1.57079632679489660000e+000;
+/** maximal accuracy value of pi ( 180 degrees), in radians */
+Angle.piRadians = 3.14159265358979310000e+000;
+/** maximal accuracy value of 2*pi (360 degrees), in radians */
+Angle.pi2Radians = 6.28318530717958620000e+000;
+/** scale factor for converting radians to degrees */
+Angle.degreesPerRadian = (45.0 / Angle.piOver4Radians);
+/** scale factor for converting degrees to radians */
+Angle.radiansPerDegree = (Angle.piOver4Radians / 45.0);
+/** maximal accuracy value of pi/12 ( 15 degrees), in radians */
+Angle.piOver12Radians = 0.26179938779914943653855361527329;
+//# sourceMappingURL=Angle.js.map

package/lib/esm/geometry3d/Angle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Angle.js","sourceRoot":"","sources":["../../../src/geometry3d/Angle.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/** @packageDocumentation\r\n * @module CartesianGeometry\r\n */\r\n\r\nimport { AngleProps, BeJSONFunctions, Geometry, TrigValues } from \"../Geometry\";\r\n\r\n/**\r\n * An `Angle` carries the numeric value of an angle, with methods to allow (require!) callers to be clear about whether their angle is degrees or radians.\r\n * * The numeric value is private, and callers should not know or care whether it is in degrees or radians.\r\n * * The various access method are named so that callers can specify whether untyped numbers passed in or out are degrees or radians.\r\n * @public\r\n */\r\nexport class Angle implements BeJSONFunctions {\r\n  /** maximal accuracy value of pi/4 ( 45 degrees), in radians */\r\n  public static readonly piOver4Radians = 7.85398163397448280000e-001;\r\n  /** maximal accuracy value of pi/2 ( 90 degrees), in radians */\r\n  public static readonly piOver2Radians = 1.57079632679489660000e+000;\r\n  /** maximal accuracy value of pi ( 180 degrees), in radians */\r\n  public static readonly piRadians = 3.14159265358979310000e+000;\r\n  /** maximal accuracy value of 2*pi (360 degrees), in radians */\r\n  public static readonly pi2Radians = 6.28318530717958620000e+000;\r\n  /** scale factor for converting radians to degrees */\r\n  public static readonly degreesPerRadian = (45.0 / Angle.piOver4Radians);\r\n  /** scale factor for converting degrees to radians */\r\n  public static readonly radiansPerDegree = (Angle.piOver4Radians / 45.0);\r\n  /** maximal accuracy value of pi/12 ( 15 degrees), in radians */\r\n  public static readonly piOver12Radians = 0.26179938779914943653855361527329;\r\n  private _radians: number;\r\n  private _degrees?: number;\r\n  private constructor(radians = 0, degrees?: number) { this._radians = radians; this._degrees = degrees; }\r\n  /** Return a new angle with the same content. */\r\n  public clone(): Angle { return new Angle(this._radians, this._degrees); }\r\n  /** Freeze this instance so it is read-only */\r\n  public freeze(): Readonly<this> { return Object.freeze(this); }\r\n\r\n  /**\r\n   * Return a new Angle object for angle given in degrees.\r\n   * @param degrees angle in degrees\r\n   */\r\n  public static createDegrees(degrees: number) { return new Angle(Angle.degreesToRadians(degrees), degrees); }\r\n  /**\r\n   * Return a (new) Angle object for a value given in radians.\r\n   * @param radians angle in radians\r\n   */\r\n  public static createRadians(radians: number) { return new Angle(radians); }\r\n  /**\r\n   * Return a (new) Angle object that is interpolated between two inputs\r\n   * @param radians angle in radians\r\n   */\r\n  public static createInterpolate(angle0: Angle, fraction: number, angle1: Angle) {\r\n    return new Angle(Geometry.interpolate(angle0.radians, fraction, angle1.radians));\r\n  }\r\n  /**\r\n   * Return a (new) Angle object, with angle scaled from existing angle.\r\n   * @param scale scale factor to apply to angle.\r\n   */\r\n  public cloneScaled(scale: number) { return new Angle(this.radians * scale); }\r\n\r\n  /**\r\n   * Set this angle to a value given in radians.\r\n   * @param radians angle given in radians\r\n   */\r\n  public setRadians(radians: number) { this._radians = radians; this._degrees = undefined; }\r\n  /**\r\n   * Set this angle to a value given in degrees.\r\n   * @param degrees angle given in degrees.\r\n   */\r\n  public setDegrees(degrees: number) { this._radians = Angle.degreesToRadians(degrees); this._degrees = degrees; }\r\n  /** Create an angle for a full circle. */\r\n  public static create360() { return new Angle(Math.PI * 2.0, 360.0); }\r\n  /**\r\n   * @return a (strongly typed) Angle whose tangent is `numerator/denominator`, using the signs of both in determining the (otherwise ambiguous)\r\n   * quadrant.\r\n   * @param numerator numerator for tangent\r\n   * @param denominator denominator for tangent\r\n   */\r\n  public static createAtan2(numerator: number, denominator: number): Angle { return new Angle(Math.atan2(numerator, denominator)); }\r\n  /**\r\n   * Copy all contents of `other` to this Angle.\r\n   * @param other source data\r\n   */\r\n  public setFrom(other: Angle) { this._radians = other._radians; this._degrees = other._degrees; }\r\n  /**\r\n   * Create an Angle from a JSON object\r\n   * @param json object from JSON.parse. If a number, value is in *DEGREES*\r\n   * @param defaultValRadians if json is undefined, default value in radians.\r\n   * @return a new Angle\r\n   */\r\n  public static fromJSON(json?: AngleProps, defaultValRadians?: number): Angle {\r\n    const val = new Angle();\r\n    val.setFromJSON(json, defaultValRadians);\r\n    return val;\r\n  }\r\n  /**\r\n   * set an Angle from a JSON object\r\n   * * A simple number is degrees.\r\n   * * specified `json.degrees` or `json._degrees` is degree value.\r\n   * * specified `son.radians` or `json._radians` is radians value.\r\n   * @param json object from JSON.parse. If a number, value is in *DEGREES*\r\n   * @param defaultValRadians if json is undefined, default value in radians.\r\n   */\r\n  public setFromJSON(json?: AngleProps, defaultValRadians?: number) {\r\n    this._radians = defaultValRadians ? defaultValRadians : 0;\r\n    if (!json)\r\n      return;\r\n    if (typeof json === \"number\") {\r\n      this.setDegrees(json);\r\n    } else if (typeof (json as any).degrees === \"number\") {\r\n      this.setDegrees((json as any).degrees);\r\n    } else if (typeof (json as any)._degrees === \"number\") {\r\n      this.setDegrees((json as any)._degrees);\r\n    } else if (typeof (json as any).radians === \"number\") {\r\n      this.setRadians((json as any).radians);\r\n    } else if (typeof (json as any)._radians === \"number\") {\r\n      this.setRadians((json as any)._radians);\r\n    }\r\n  }\r\n  /** Convert an Angle to a JSON object as a number in degrees */\r\n  public toJSON(): AngleProps { return this.degrees; }\r\n  /** Return a json object with radians keyword, e.g. `{ radians: 0.10}` */\r\n  public toJSONRadians(): AngleProps { return { radians: this.radians }; }\r\n  /**  Return the angle measured in radians. */\r\n  public get radians(): number { return this._radians; }\r\n  /**  Return the angle measured in degrees. */\r\n  public get degrees(): number { return this._degrees !== undefined ? this._degrees : Angle.radiansToDegrees(this._radians); }\r\n  /**\r\n   * Convert an angle in degrees to radians.\r\n   * @param degrees angle in degrees\r\n   */\r\n  public static degreesToRadians(degrees: number) { return degrees * Math.PI / 180; }\r\n  /**\r\n   * Convert an angle in radians to degrees.\r\n   * @param degrees angle in radians\r\n   */\r\n  public static radiansToDegrees(radians: number): number {\r\n    if (radians < 0)\r\n      return -Angle.radiansToDegrees(-radians);\r\n    // Now radians is positive ...\r\n    const pi = Math.PI;\r\n    const factor = 180.0 / pi;\r\n    if (radians <= 0.25 * pi)\r\n      return factor * radians;\r\n    if (radians < 0.75 * pi)\r\n      return 90.0 + 180 * ((radians - 0.5 * pi) / pi);\r\n    if (radians <= 1.25 * pi)\r\n      return 180.0 + 180 * ((radians - pi) / pi);\r\n    if (radians <= 1.75 * pi)\r\n      return 270.0 + 180 * ((radians - 1.5 * pi) / pi);\r\n    // all larger radians reference from 360 degrees (2PI)\r\n    return 360.0 + 180 * ((radians - 2.0 * pi) / pi);\r\n  }\r\n  /**\r\n   * Return the cosine of this Angle object's angle.\r\n   */\r\n  public cos(): number { return Math.cos(this._radians); }\r\n  /**\r\n   * Return the sine of this Angle object's angle.\r\n   */\r\n  public sin(): number { return Math.sin(this._radians); }\r\n  /**\r\n   * Return the tangent of this Angle object's angle.\r\n   */\r\n  public tan(): number { return Math.tan(this._radians); }\r\n  /** Test if a radians (absolute) value is nearly 2PI or larger (!) */\r\n  public static isFullCircleRadians(radians: number): boolean {\r\n    return Math.abs(radians) >= Geometry.fullCircleRadiansMinusSmallAngle;\r\n  }\r\n  /** Test if the radians value  is a complete circle */\r\n  public static isHalfCircleRadians(radians: number): boolean {\r\n    return Math.abs(Math.abs(radians) - Math.PI) <= Geometry.smallAngleRadians;\r\n  }\r\n  /** test if the angle is aa full circle */\r\n  public get isFullCircle(): boolean { return Angle.isFullCircleRadians(this._radians); }\r\n\r\n  /** test if the angle is a half circle (in either direction) */\r\n  public get isHalfCircle(): boolean { return Angle.isHalfCircleRadians(this._radians); }\r\n  /** Adjust a radians value so it is positive in 0..360 */\r\n  public static adjustDegrees0To360(degrees: number): number {\r\n    if (degrees >= 0) {\r\n      const period = 360.0;\r\n      if (degrees < period)\r\n        return degrees;\r\n      const numPeriods = Math.floor(degrees / period);\r\n      return degrees - numPeriods * period;\r\n    } else if (degrees < 0) {\r\n      // negative angle ...\r\n      const radians1 = Angle.adjustDegrees0To360(-degrees);\r\n      return 360.0 - radians1;\r\n    }\r\n    // fall through for Nan (disaster) !!!\r\n    return 0;\r\n  }\r\n  /** Adjust a radians value so it is in -180..180 */\r\n  public static adjustDegreesSigned180(degrees: number): number {\r\n    if (Math.abs(degrees) <= 180.0)\r\n      return degrees;\r\n    if (degrees >= 0) {\r\n      const period = 360.0;\r\n      const numPeriods = 1 + Math.floor((degrees - 180.0) / period);\r\n      return degrees - numPeriods * period;\r\n    } else if (degrees < 0) {\r\n      // negative angle ...\r\n      return -Angle.adjustDegreesSigned180(-degrees);\r\n    }\r\n    // fall through for NaN disaster.\r\n    return 0;\r\n  }\r\n  /** Adjust a radians value so it is positive in 0..2Pi */\r\n  public static adjustRadians0To2Pi(radians: number): number {\r\n    if (radians >= 0) {\r\n      const period = Math.PI * 2.0;\r\n      if (radians < period)\r\n        return radians;\r\n      const numPeriods = Math.floor(radians / period);\r\n      return radians - numPeriods * period;\r\n    } else if (radians < 0) {\r\n      // negative angle ...\r\n      const radians1 = Angle.adjustRadians0To2Pi(-radians);\r\n      return Math.PI * 2.0 - radians1;\r\n    }\r\n    // fall through for NaN disaster.\r\n    return 0;\r\n  }\r\n  /** Adjust a radians value so it is positive in -PI..PI */\r\n  public static adjustRadiansMinusPiPlusPi(radians: number): number {\r\n    if (Math.abs(radians) <= Math.PI)\r\n      return radians;\r\n    if (radians >= 0) {\r\n      const period = Math.PI * 2.0;\r\n      const numPeriods = 1 + Math.floor((radians - Math.PI) / period);\r\n      return radians - numPeriods * period;\r\n    } else if (radians < 0) {\r\n      // negative angle ...\r\n      return -Angle.adjustRadiansMinusPiPlusPi(-radians);\r\n    }\r\n    // fall through for NaN disaster.\r\n    return 0;\r\n  }\r\n  /** return a (newly allocated) Angle object with value 0 radians */\r\n  public static zero() { return new Angle(0); }\r\n  /** Test if the angle is exactly zero. */\r\n  public get isExactZero() { return this.radians === 0; }\r\n  /** Test if the angle is almost zero (within tolerance `Geometry.smallAngleRadians`) */\r\n  public get isAlmostZero() { return Math.abs(this.radians) < Geometry.smallAngleRadians; }\r\n  /** Test if the angle is almost a north or south pole (within tolerance `Geometry.smallAngleRadians`) */\r\n  public get isAlmostNorthOrSouthPole() { return Angle.isHalfCircleRadians(this.radians * 2.0); }\r\n\r\n  /** Create an angle object with degrees adjusted into 0..360. */\r\n  public static createDegreesAdjustPositive(degrees: number): Angle { return Angle.createDegrees(Angle.adjustDegrees0To360(degrees)); }\r\n  /** Create an angle object with degrees adjusted into -180..180. */\r\n  public static createDegreesAdjustSigned180(degrees: number): Angle { return Angle.createDegrees(Angle.adjustDegreesSigned180(degrees)); }\r\n  /**\r\n   * Test if two radians values are equivalent, allowing shift by full circle (i.e. by a multiple of `2*PI`)\r\n   * @param radiansA first radians value\r\n   * @param radiansB second radians value\r\n   */\r\n  public static isAlmostEqualRadiansAllowPeriodShift(radiansA: number, radiansB: number): boolean {\r\n    // try to get simple conclusions with un-shifted radians ...\r\n    const delta = Math.abs(radiansA - radiansB);\r\n    if (delta <= Geometry.smallAngleRadians)\r\n      return true;\r\n    const period = Math.PI * 2.0;\r\n    if (Math.abs(delta - period) <= Geometry.smallAngleRadians)\r\n      return true;\r\n    const numPeriod = Math.round(delta / period);\r\n    const delta1 = delta - numPeriod * period;\r\n    return Math.abs(delta1) <= Geometry.smallAngleRadians;\r\n  }\r\n  /**\r\n   * Test if this angle and other are equivalent, allowing shift by full circle (i.e. by a multiple of 360 degrees)\r\n   */\r\n  public isAlmostEqualAllowPeriodShift(other: Angle): boolean {\r\n    return Angle.isAlmostEqualRadiansAllowPeriodShift(this._radians, other._radians);\r\n  }\r\n  /**\r\n   * Test if two this angle and other are almost equal, NOT allowing shift by full circle multiples of 360 degrees.\r\n   */\r\n  public isAlmostEqualNoPeriodShift(other: Angle): boolean { return Math.abs(this._radians - other._radians) < Geometry.smallAngleRadians; }\r\n  /**\r\n   * Test if two angle (in radians)  almost equal, NOT allowing shift by full circle multiples of `2 * PI`.\r\n   * * (Same test as isAlmostEqualRadiansNoPeriodShift)\r\n   */\r\n  public isAlmostEqual(other: Angle): boolean { return this.isAlmostEqualNoPeriodShift(other); }\r\n  /**\r\n   * Test if two angle (in radians)  almost equal, NOT allowing shift by full circle multiples of `2 * PI`.\r\n   */\r\n  public static isAlmostEqualRadiansNoPeriodShift(radiansA: number, radiansB: number): boolean { return Math.abs(radiansA - radiansB) < Geometry.smallAngleRadians; }\r\n  /**\r\n   * Test if dot product values indicate non-zero length perpendicular vectors.\r\n   * @param dotUU dot product of vectorU with itself\r\n   * @param dotVV dot product of vectorV with itself\r\n   * @param dotUV dot product of vectorU with vectorV\r\n   */\r\n  public static isPerpendicularDotSet(dotUU: number, dotVV: number, dotUV: number) {\r\n    return dotUU > Geometry.smallMetricDistanceSquared\r\n      && dotVV > Geometry.smallMetricDistanceSquared\r\n      && dotUV * dotUV <= Geometry.smallAngleRadiansSquared * dotUU * dotVV;\r\n  }\r\n  /**\r\n   * Return cosine, sine, and radians for the half angle of a cosine,sine pair.\r\n   * @param rCos2A cosine value (scaled by radius) for initial angle.\r\n   * @param rSin2A sine value (scaled by radius) for final angle.\r\n   */\r\n  public static trigValuesToHalfAngleTrigValues(rCos2A: number, rSin2A: number): TrigValues {\r\n    const r = Geometry.hypotenuseXY(rCos2A, rSin2A);\r\n    if (r < Geometry.smallMetricDistance) {\r\n      return { c: 1.0, s: 0.0, radians: 0.0 };\r\n    } else {\r\n      /* If the caller really gave you sine and cosine values, r should be 1.  However,*/\r\n      /* to allow scaled values -- e.g. the x and y components of any vector -- we normalize*/\r\n      /* right here.  This adds an extra sqrt and 2 divides to the whole process, but improves*/\r\n      /* both the usefulness and robustness of the computation.*/\r\n      let cosA;\r\n      let sinA = 0.0;\r\n      const cos2A = rCos2A / r;\r\n      const sin2A = rSin2A / r;\r\n      if (cos2A >= 0.0) {\r\n        /* Original angle in NE and SE quadrants.  Half angle in same quadrant */\r\n        cosA = Math.sqrt(0.5 * (1.0 + cos2A));\r\n        sinA = sin2A / (2.0 * (cosA));\r\n      } else {\r\n        if (sin2A > 0.0) {\r\n          /* Original angle in NW quadrant. Half angle in NE quadrant */\r\n          sinA = Math.sqrt(0.5 * (1.0 - cos2A));\r\n        } else {\r\n          /* Original angle in SW quadrant. Half angle in SE quadrant*/\r\n          /* cosA comes out positive because both sines are negative. */\r\n          sinA = -Math.sqrt(0.5 * (1.0 - cos2A));\r\n        }\r\n        cosA = sin2A / (2.0 * (sinA));\r\n      }\r\n      return { c: cosA, s: sinA, radians: Math.atan2(sinA, cosA) };\r\n    }\r\n  }\r\n  /** If value is close to -1, -0.5, 0, 0.5, 1, adjust it to the exact value. */\r\n  public static cleanupTrigValue(value: number, tolerance: number = 1.0e-15): number {\r\n    const absValue = Math.abs(value);\r\n    if (absValue <= tolerance)\r\n      return 0;\r\n    let a = Math.abs(absValue - 0.5);\r\n    if (a <= tolerance)\r\n      return value < 0.0 ? -0.5 : 0.5;\r\n    a = Math.abs(absValue - 1.0);\r\n    if (a <= tolerance)\r\n      return value < 0.0 ? -1.0 : 1.0;\r\n    return value;\r\n  }\r\n  /**\r\n   * Return the half angle cosine, sine, and radians for given dot products between vectors.\r\n   * @param dotUU dot product of vectorU with itself\r\n   * @param dotVV dot product of vectorV with itself\r\n   * @param dotUV dot product of vectorU with vectorV\r\n   */\r\n  public static dotProductsToHalfAngleTrigValues(dotUU: number, dotVV: number, dotUV: number, favorZero: boolean = true): TrigValues {\r\n    const rCos = dotUU - dotVV;\r\n    const rSin = 2.0 * dotUV;\r\n    if (favorZero && Math.abs(rSin) < Geometry.smallAngleRadians * (Math.abs(dotUU) + Math.abs(dotVV)))\r\n      return { c: 1.0, s: 0.0, radians: 0.0 };\r\n    return Angle.trigValuesToHalfAngleTrigValues(rCos, rSin);\r\n  }\r\n  /**\r\n   * * Returns the angle between two vectors, with the vectors given as xyz components\r\n   * * The returned angle is between 0 and PI\r\n   *\r\n   * @param ux x component of vector u\r\n   * @param uy y component of vector u\r\n   * @param uz z component of vector u\r\n   * @param vx x component of vector v\r\n   * @param vy y component of vector v\r\n   * @param vz z component of vector v\r\n   */\r\n  public static radiansBetweenVectorsXYZ(ux: number, uy: number, uz: number, vx: number, vy: number, vz: number): number {\r\n    //  const uu = ux * ux + uy * uy + uz * uz;\r\n    const uDotV = ux * vx + uy * vy + uz * vz; // magU magV cos(theta)\r\n    //    const vv = vx * vx + vy * vy + vz * vz;\r\n    return Math.atan2(Geometry.crossProductMagnitude(ux, uy, uz, vx, vy, vz), uDotV);\r\n  }\r\n  /**\r\n   * Add a multiple of a full circle angle (360 degrees, 2PI) in place.\r\n   * @param multiple multiplier factor\r\n   */\r\n  public addMultipleOf2PiInPlace(multiple: number) {\r\n    if (this._degrees !== undefined) {\r\n      this._degrees += multiple * 360.0;\r\n      this._radians = Angle.degreesToRadians(this._degrees);\r\n    } else {\r\n      this._radians += multiple * Angle.pi2Radians;\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/esm/geometry3d/AngleSweep.d.ts

@@ -0,0 +1,187 @@
+/** @packageDocumentation
+ * @module CartesianGeometry
+ */
+import { AngleSweepProps, BeJSONFunctions } from "../Geometry";
+import { Angle } from "./Angle";
+import { GrowableFloat64Array } from "./GrowableFloat64Array";
+/**
+ * An `AngleSweep` is a pair of angles at start and end of an interval.
+ *
+ * *  For stroking purposes, the "included interval" is all angles numerically reached by theta = start + f*(end-start), where f is between 0 and 1.
+ * *  This stroking formula is simple numbers -- 2PI shifts are not involved.
+ * *  2PI shifts do become important in the reverse mapping of an angle to a fraction.
+ * *  If (start < end) the angle proceeds CCW around the unit circle.
+ * *  If (end < start) the angle proceeds CW around the unit circle.
+ * *  Angles beyond 360 are fine as endpoints.
+ *   *  (350,370) covers the same unit angles as (-10,10).
+ *   *  (370,350) covers the same unit angles as (10,-10).
+ * @public
+ */
+export declare class AngleSweep implements BeJSONFunctions {
+    private _radians0;
+    private _radians1;
+    /** Read-property for degrees at the start of this AngleSweep. */
+    get startDegrees(): number;
+    /** Read-property for degrees at the end of this AngleSweep. */
+    get endDegrees(): number;
+    /** Read-property for signed start-to-end sweep in degrees. */
+    get sweepDegrees(): number;
+    /** Read-property for degrees at the start of this AngleSweep. */
+    get startRadians(): number;
+    /** Read-property for degrees at the end of this AngleSweep. */
+    get endRadians(): number;
+    /** Read-property for signed start-to-end sweep in radians. */
+    get sweepRadians(): number;
+    /** Return the (strongly typed) start angle */
+    get startAngle(): Angle;
+    /** Return the (strongly typed) end angle */
+    get endAngle(): Angle;
+    /** Create a sweep as one of
+     * * A clone of a given sweep
+     * * 0 to given angle
+     * * full circle if no arg given (sweep 0 to 360 degrees)
+     */
+    static create(data?: AngleSweep | Angle): AngleSweep;
+    /** (private) constructor with start and end angles in radians.
+     *  * Use explicitly named static methods to clarify intent and units of inputs:
+     *
+     * * createStartEndRadians (startRadians:number, endRadians:number)
+     * * createStartEndDegrees (startDegrees:number, endDegrees:number)
+     * * createStartEnd (startAngle:Angle, endAngle:Angle)
+     * * createStartSweepRadians (startRadians:number, sweepRadians:number)
+     * * createStartSweepDegrees (startDegrees:number, sweepDegrees:number)
+     * * createStartSweep (startAngle:Angle, sweepAngle:Angle)
+     */
+    private constructor();
+    /** create an AngleSweep from start and end angles given in radians. */
+    static createStartEndRadians(startRadians?: number, endRadians?: number, result?: AngleSweep): AngleSweep;
+    /** Return the angle obtained by subtracting radians from this angle. */
+    cloneMinusRadians(radians: number): AngleSweep;
+    /** create an AngleSweep from start and end angles given in degrees. */
+    static createStartEndDegrees(startDegrees?: number, endDegrees?: number, result?: AngleSweep): AngleSweep;
+    /** create an angle sweep from strongly typed start and end angles */
+    static createStartEnd(startAngle: Angle, endAngle: Angle, result?: AngleSweep): AngleSweep;
+    /** Create an angle sweep with limits given as (strongly typed) angles for start and sweep */
+    static createStartSweep(startAngle: Angle, sweepAngle: Angle, result?: AngleSweep): AngleSweep;
+    /** Return a sweep with limits interpolated between this and other. */
+    interpolate(fraction: number, other: AngleSweep): AngleSweep;
+    /** create an AngleSweep from start and end angles given in radians. */
+    static createStartSweepRadians(startRadians?: number, sweepRadians?: number, result?: AngleSweep): AngleSweep;
+    /** create an AngleSweep from start and sweep given in degrees.  */
+    static createStartSweepDegrees(startDegrees?: number, sweepDegrees?: number, result?: AngleSweep): AngleSweep;
+    /** directly set the start and end angles in radians */
+    setStartEndRadians(startRadians?: number, endRadians?: number): void;
+    /** directly set the start and end angles in degrees */
+    setStartEndDegrees(startDegrees?: number, endDegrees?: number): void;
+    /** copy from other AngleSweep. */
+    setFrom(other: AngleSweep): void;
+    /** create a full circle sweep (CCW). startRadians defaults to 0 */
+    static create360(startRadians?: number): AngleSweep;
+    /** create a sweep from the south pole to the north pole. */
+    static createFullLatitude(): AngleSweep;
+    /** Reverse the start and end angle in place. */
+    reverseInPlace(): void;
+    /**  return a sweep for the "other" part of the circe.
+     * @param reverse true to retain the start and move backwards, false to more forwards.
+     */
+    cloneComplement(reverseDirection?: boolean, result?: AngleSweep): AngleSweep;
+    /** Restrict start and end angles into the range (-90,+90) in degrees. */
+    capLatitudeInPlace(): void;
+    /** Ask if the sweep is counterclockwise, i.e. positive sweep */
+    get isCCW(): boolean;
+    /** Ask if the sweep is a full circle. */
+    get isFullCircle(): boolean;
+    /** Ask if the sweep is a full sweep from south pole to north pole. */
+    get isFullLatitudeSweep(): boolean;
+    /** return a clone of this sweep. */
+    clone(): AngleSweep;
+    /** Convert fractional position in the sweep to radians. */
+    fractionToRadians(fraction: number): number;
+    /** Convert fractional position in the sweep to strongly typed Angle object. */
+    fractionToAngle(fraction: number): Angle;
+    /** return 2PI divided by the sweep radians (i.e. 360 degrees divided by sweep angle).
+     * This is the number of fractional intervals required to cover a whole circle.
+     */
+    fractionPeriod(): number;
+    /** return the fractionalized position of the angle,
+     * computed without consideration of 2PI period.
+     * That is, an angle that is numerically much beyond than the end angle
+     * will produce a large fraction and an angle much beyond the start angle
+     * will produce a large negative fraction.
+     *
+     */
+    angleToUnboundedFraction(theta: Angle): number;
+    /** map an angle to a fractional coordinate which is:
+     *
+     * *  the start angle is at fraction 0
+     * *  the end angle is at fraction 1
+     * *  interior angles are between 0 and 1
+     * *  all exterior angles are at fractions greater than 1
+     * *  the periodic jump is at full wraparound to the start angle
+     */
+    angleToPositivePeriodicFraction(theta: Angle): number;
+    /**
+     * Convert each value in an array from radians to fraction.
+     * @param data array that is input as radians, output as fractions
+     */
+    radiansArrayToPositivePeriodicFractions(data: GrowableFloat64Array): void;
+    /**
+     * Convert a radians value to a fraction that is always positive and can wrap.  See `angleToPositivePeriodicFraction` for detailed description.
+     * @param radians
+     */
+    radiansToPositivePeriodicFraction(radians: number, zeroSweepDefault?: number): number;
+    /**
+     * Convert a radians value to a fraction that is always positive and can wrap.  See `angleToPositivePeriodicFraction` for detailed description.
+     * @param radians
+     */
+    static radiansToPositivePeriodicFractionStartEnd(radians: number, radians0: number, radians1: number, zeroSweepDefault?: number): number;
+    /** map an angle to a fractional coordinate which is:
+     *
+     * *  the start angle is at fraction 0
+     * *  the end angle is at fraction 1
+     * *  interior angles are between 0 and 1
+     * *  small negative for angles just "before" the start angle
+     * *  more than one for angles just "after" the end angle
+     * *  the periodic jump is at the middle of the "outside" interval
+     */
+    angleToSignedPeriodicFraction(theta: Angle): number;
+    /**
+     * Convert a radians value to a fraction, allowing wraparound.  See `angleToSignedPeriodicFraction` for detailed description.
+     */
+    radiansToSignedPeriodicFraction(radians: number): number;
+    /** test if an angle is within the sweep */
+    isAngleInSweep(angle: Angle): boolean;
+    /** test if radians are within sweep  */
+    isRadiansInSweep(radians: number, allowPeriodShift?: boolean): boolean;
+    /** test if radians are within sweep  */
+    static isRadiansInStartEnd(radians: number, radians0: number, radians1: number, allowPeriodShift?: boolean): boolean;
+    /** set this AngleSweep from various sources:
+     *
+     * * if json is undefined, a full-circle sweep is returned.
+     * * If json is an AngleSweep object it is cloned
+     * * If json is an array of 2 numbers, those numbers are start and end angles in degrees.
+     * * If `json.degrees` is an array of 2 numbers, those numbers are start and end angles in degrees.
+     * * If `json.radians` is an array of 2 numbers, those numbers are start and end angles in radians.
+     */
+    setFromJSON(json?: any): void;
+    /** create an AngleSweep from a json object. */
+    static fromJSON(json?: AngleSweepProps): AngleSweep;
+    /**
+     * Convert an AngleSweep to a JSON object.
+     * @return {*} {degrees: [startAngleInDegrees, endAngleInDegrees}
+     */
+    toJSON(): any;
+    /** test if start and end angles match, with explicit name to clarify that there is no test for 360-degree shifts. */
+    isAlmostEqualAllowPeriodShift(other: AngleSweep): boolean;
+    /** test if start and end angles match, explicit name to clarify that 360-degree shifts are allowed. */
+    isAlmostEqualNoPeriodShift(other: AngleSweep): boolean;
+    /** test if start and end angles match with radians tolerance.
+     * * This is equivalent to isAlmostEqualNoPeriodShift.
+     * * it is present for consistency with other classes
+     * * It is recommended that all callers use one of he longer names to be clear of their intentions:
+     * * * isAlmostEqualAllowPeriodShift
+     * * * isAlmostEqualRadiansNoPeriodShift
+     */
+    isAlmostEqual(other: AngleSweep): boolean;
+}
+//# sourceMappingURL=AngleSweep.d.ts.map

package/lib/esm/geometry3d/AngleSweep.d.ts.map

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