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

package/lib/esm/geometry3d/IndexedXYZCollection.js

@@ -0,0 +1,98 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ArraysAndInterfaces
+ */
+// import { Point2d } from "./Geometry2d";
+import { Geometry } from "../Geometry";
+import { Point3d } from "./Point3dVector3d";
+import { Range3d } from "./Range";
+class PointsIterator {
+    constructor(collection) {
+        this._curIndex = -1;
+        this._collection = collection;
+    }
+    next() {
+        if (++this._curIndex >= this._collection.length) {
+            // The ECMAScript spec states that value=undefined is valid if done=true. The TypeScript interface violates the spec hence the cast to any and back below.
+            return { done: true };
+        }
+        return {
+            value: this._collection.getPoint3dAtUncheckedPointIndex(this._curIndex),
+            done: false,
+        };
+    }
+    [Symbol.iterator]() { return this; }
+}
+/**
+ * abstract base class for read-only access to XYZ data with indexed reference.
+ * * This allows algorithms to work with Point3d[] or GrowableXYZ.
+ * ** GrowableXYZArray implements these for its data.
+ * ** Point3dArrayCarrier carries a (reference to) a Point3d[] and implements the methods with calls on that array reference.
+ * * In addition to "point by point" accessors, there abstract members compute commonly useful vector data "between points".
+ * * Methods that create vectors among multiple indices allow callers to avoid creating temporaries.
+ * @public
+ */
+export class IndexedXYZCollection {
+    /** Adjust index into range by modulo with the length. */
+    cyclicIndex(i) {
+        return (i % this.length);
+    }
+    /** Return the range of the points. */
+    getRange() {
+        const range = Range3d.createNull();
+        const n = this.length;
+        const point = Point3d.create();
+        for (let i = 0; i < n; i++) {
+            this.getPoint3dAtUncheckedPointIndex(i, point);
+            range.extendPoint(point);
+        }
+        return range;
+    }
+    /**
+     * For each run of points with indices i+1 to i+n within distance tolerance of points[i], return the indices i+1, ..., i+n.
+     * @return ordered array of 0-based indices of duplicate points
+     */
+    findOrderedDuplicates(tolerance = Geometry.smallMetricDistance) {
+        const tol2 = tolerance * tolerance;
+        const indices = [];
+        if (this.length > 1) {
+            for (let i = 0; i < this.length - 1;) {
+                let j = i + 1;
+                for (; j < this.length; ++j) {
+                    const dist2 = this.distanceSquaredIndexIndex(i, j);
+                    if (dist2 !== undefined && dist2 < tol2)
+                        indices.push(j);
+                    else
+                        break;
+                }
+                i = j; // found next unique point
+            }
+        }
+        return indices;
+    }
+    /** Return iterator over the points in this collection. Usage:
+     * ```ts
+     *  for (const point: Point3d of collection.points) { ... }
+     * ```
+     */
+    get points() {
+        return new PointsIterator(this);
+    }
+    /** convert to Point3d[] */
+    getArray() {
+        const result = [];
+        for (const p of this.points)
+            result.push(p);
+        return result;
+    }
+}
+/**
+ * abstract base class extends IndexedXYZCollection, adding methods to push, peek, and pop, and rewrite.
+ * @public
+ */
+export class IndexedReadWriteXYZCollection extends IndexedXYZCollection {
+}
+//# sourceMappingURL=IndexedXYZCollection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedXYZCollection.js","sourceRoot":"","sources":["../../../src/geometry3d/IndexedXYZCollection.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AAEH,0CAA0C;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,cAAc;IAIlB,YAAmB,UAAgC;QAF3C,cAAS,GAAG,CAAC,CAAC,CAAC;QAGrB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAEM,IAAI;QACT,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;YAC/C,0JAA0J;YAC1J,OAAO,EAAE,IAAI,EAAE,IAAI,EAAoC,CAAC;SACzD;QAED,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC;YACvE,IAAI,EAAE,KAAK;SACZ,CAAC;IACJ,CAAC;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAwB,OAAO,IAAI,CAAC,CAAC,CAAC;CAC/D;AACD;;;;;;;;GAQG;AACH,MAAM,OAAgB,oBAAoB;IAoFxC,yDAAyD;IAClD,WAAW,CAAC,CAAS;QAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,sCAAsC;IAC/B,QAAQ;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,+BAA+B,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC/C,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;SAC1B;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACI,qBAAqB,CAAC,YAAoB,QAAQ,CAAC,mBAAmB;QAC3E,MAAM,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;QACnC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG;gBACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;oBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI;wBACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;wBAEhB,MAAM;iBACT;gBACD,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;aAClC;SACF;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAgBD;;;;OAIG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,2BAA2B;IACpB,QAAQ;QACb,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YACzB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AACD;;;GAGG;AACH,MAAM,OAAgB,6BAA8B,SAAQ,oBAAoB;CAsB/E","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 ArraysAndInterfaces\r\n */\r\n\r\n// import { Point2d } from \"./Geometry2d\";\r\nimport { Geometry } from \"../Geometry\";\r\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\r\nimport { Range3d } from \"./Range\";\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\nimport { XYAndZ } from \"./XYZProps\";\r\n\r\nclass PointsIterator implements Iterator<Point3d>, Iterable<Point3d> {\r\n  private readonly _collection: IndexedXYZCollection;\r\n  private _curIndex = -1;\r\n\r\n  public constructor(collection: IndexedXYZCollection) {\r\n    this._collection = collection;\r\n  }\r\n\r\n  public next(): IteratorResult<Point3d> {\r\n    if (++this._curIndex >= this._collection.length) {\r\n      // The ECMAScript spec states that value=undefined is valid if done=true. The TypeScript interface violates the spec hence the cast to any and back below.\r\n      return { done: true } as any as IteratorResult<Point3d>;\r\n    }\r\n\r\n    return {\r\n      value: this._collection.getPoint3dAtUncheckedPointIndex(this._curIndex),\r\n      done: false,\r\n    };\r\n  }\r\n\r\n  public [Symbol.iterator](): Iterator<Point3d> { return this; }\r\n}\r\n/**\r\n * abstract base class for read-only access to XYZ data with indexed reference.\r\n * * This allows algorithms to work with Point3d[] or GrowableXYZ.\r\n * ** GrowableXYZArray implements these for its data.\r\n * ** Point3dArrayCarrier carries a (reference to) a Point3d[] and implements the methods with calls on that array reference.\r\n * * In addition to \"point by point\" accessors, there abstract members compute commonly useful vector data \"between points\".\r\n * * Methods that create vectors among multiple indices allow callers to avoid creating temporaries.\r\n * @public\r\n */\r\nexport abstract class IndexedXYZCollection {\r\n  /**\r\n   * Return the point at `index` as a strongly typed Point3d.\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public abstract getPoint3dAtCheckedPointIndex(index: number, result?: Point3d): Point3d | undefined;\r\n  /**\r\n   * Return the point at `index` as a strongly typed Point3d, without checking the point index validity.\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public abstract getPoint3dAtUncheckedPointIndex(index: number, result?: Point3d): Point3d;\r\n  /**\r\n   * Get from `index` as a strongly typed Vector3d.\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public abstract getVector3dAtCheckedVectorIndex(index: number, result?: Vector3d): Vector3d | undefined;\r\n  /**\r\n   * Return a vector from the point at `indexA` to the point at `indexB`\r\n   * @param indexA index of point within the array\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public abstract vectorIndexIndex(indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\r\n  /**\r\n   * Return a vector from `origin` to the point at `indexB`\r\n   * @param origin origin for vector\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if index is out of bounds\r\n   */\r\n  public abstract vectorXYAndZIndex(origin: XYAndZ, indexB: number, result?: Vector3d): Vector3d | undefined;\r\n\r\n  /**\r\n   * Return the cross product of the vectors from `origin` to points at `indexA` and `indexB`\r\n   * @param origin origin for vector\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public abstract crossProductXYAndZIndexIndex(origin: XYAndZ, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\r\n  /**\r\n   * Return the cross product of vectors from `origin` to points at `indexA` and `indexB`\r\n   * @param origin origin for vector\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result optional caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public abstract crossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\r\n  /**\r\n   * Return the cross product of vectors from origin point at `indexA` to target points at `indexB` and `indexC`\r\n   * @param origin index of origin\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns return true if indexA, indexB both valid\r\n   */\r\n  public abstract accumulateCrossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result: Vector3d): void;\r\n\r\n  /**\r\n   * read-only property for number of XYZ in the collection.\r\n   */\r\n  public abstract get length(): number;\r\n  /**\r\n   * Return distance squared between indicated points.\r\n   * @param index0 first point index\r\n   * @param index1 second point index\r\n   */\r\n  public abstract distanceSquaredIndexIndex(index0: number, index1: number): number | undefined;\r\n  /**\r\n   * Return distance between indicated points.\r\n   * @param index0 first point index\r\n   * @param index1 second point index\r\n   */\r\n  public abstract distanceIndexIndex(index0: number, index1: number): number | undefined;\r\n\r\n  /** Adjust index into range by modulo with the length. */\r\n  public cyclicIndex(i: number): number {\r\n    return (i % this.length);\r\n  }\r\n  /** Return the range of the points. */\r\n  public getRange(): Range3d {\r\n    const range = Range3d.createNull();\r\n    const n = this.length;\r\n    const point = Point3d.create();\r\n    for (let i = 0; i < n; i++) {\r\n      this.getPoint3dAtUncheckedPointIndex(i, point);\r\n      range.extendPoint(point);\r\n    }\r\n    return range;\r\n  }\r\n\r\n  /**\r\n   * For each run of points with indices i+1 to i+n within distance tolerance of points[i], return the indices i+1, ..., i+n.\r\n   * @return ordered array of 0-based indices of duplicate points\r\n   */\r\n  public findOrderedDuplicates(tolerance: number = Geometry.smallMetricDistance): number[] {\r\n    const tol2 = tolerance * tolerance;\r\n    const indices: number[] = [];\r\n    if (this.length > 1) {\r\n      for (let i = 0; i < this.length - 1;) {\r\n        let j = i + 1;\r\n        for (; j < this.length; ++j) {\r\n          const dist2 = this.distanceSquaredIndexIndex(i, j);\r\n          if (dist2 !== undefined && dist2 < tol2)\r\n            indices.push(j);\r\n          else\r\n            break;\r\n        }\r\n        i = j; // found next unique point\r\n      }\r\n    }\r\n    return indices;\r\n  }\r\n\r\n  /** Accumulate scale times the x,y,z values at index.\r\n   * * No action if index is out of bounds.\r\n   */\r\n  public abstract accumulateScaledXYZ(index: number, scale: number, sum: Point3d): void;\r\n\r\n  /** access x of indexed point */\r\n  public abstract getXAtUncheckedPointIndex(pointIndex: number): number;\r\n\r\n  /** access y of indexed point */\r\n  public abstract getYAtUncheckedPointIndex(pointIndex: number): number;\r\n\r\n  /** access z of indexed point */\r\n  public abstract getZAtUncheckedPointIndex(pointIndex: number): number;\r\n\r\n  /** Return iterator over the points in this collection. Usage:\r\n   * ```ts\r\n   *  for (const point: Point3d of collection.points) { ... }\r\n   * ```\r\n   */\r\n  public get points(): Iterable<Point3d> {\r\n    return new PointsIterator(this);\r\n  }\r\n  /** convert to Point3d[] */\r\n  public getArray(): Point3d[] {\r\n    const result = [];\r\n    for (const p of this.points)\r\n      result.push(p);\r\n    return result;\r\n  }\r\n}\r\n/**\r\n * abstract base class extends IndexedXYZCollection, adding methods to push, peek, and pop, and rewrite.\r\n * @public\r\n */\r\nexport abstract class IndexedReadWriteXYZCollection extends IndexedXYZCollection {\r\n  /** push a (clone of) point onto the collection\r\n   * * point itself is not pushed -- xyz data is extracted into the native form of the collection.\r\n   */\r\n  public abstract push(data: XYAndZ): void;\r\n  /**\r\n   * push a new point (given by coordinates) onto the collection\r\n   * @param x x coordinate\r\n   * @param y y coordinate\r\n   * @param z z coordinate\r\n   */\r\n  public abstract pushXYZ(x?: number, y?: number, z?: number): void;\r\n  /** extract the final point */\r\n  public abstract back(result?: Point3d): Point3d | undefined;\r\n  /** extract the first point */\r\n  public abstract front(result?: Point3d): Point3d | undefined;\r\n  /** remove the final point. */\r\n  public abstract pop(): void;\r\n  /**  clear all entries */\r\n  public abstract clear(): void;\r\n  /** reverse the points in place. */\r\n  public abstract reverseInPlace(): void;\r\n}\r\n"]}

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

@@ -0,0 +1,63 @@
+/** @packageDocumentation
+ * @module CartesianGeometry
+ */
+import { BeJSONFunctions } from "../Geometry";
+import { Angle } from "./Angle";
+/**
+ * An `AngleAngleNumber` is a pair of angles (named `longitude` and `latitude`) and an additional number.
+ * * This is directly intended to support `Ellipsoid` computations, with the two angles used as
+ *    * `longitude` is "around the equator"
+ *    * `latitude` is "equator to pole"
+ *    * `h` is altitude above the `Ellipsoid surface.
+ * * The structure may also be used for torus coordinates.
+ * @public
+ */
+export declare class LongitudeLatitudeNumber implements BeJSONFunctions {
+    private _longitude;
+    private _latitude;
+    private _altitude;
+    /** (property getter) longitude in radians */
+    get longitudeRadians(): number;
+    /** (property getter) longitude in degrees */
+    get longitudeDegrees(): number;
+    /** (property getter) (reference to) longitude as a strongly typed `Angle` */
+    get longitudeRef(): Angle;
+    /** (property getter) (clone of)  longitude as a strongly typed `Angle` */
+    get longitude(): Angle;
+    /** (property getter) latitude in radians */
+    get latitudeRadians(): number;
+    /** (property getter) latitude in degrees */
+    get latitudeDegrees(): number;
+    /** (property getter) (reference to) latitude as a strongly typed `Angle` */
+    get latitudeRef(): Angle;
+    /** (property getter) (clone of)  latitude as a strongly typed `Angle` */
+    get latitude(): Angle;
+    /** Get or set the altitude. */
+    get altitude(): number;
+    set altitude(value: number);
+    /** Constructor: Capture angles and altitude */
+    private constructor();
+    /** Create with all zero angles and altitude. */
+    static createZero(): LongitudeLatitudeNumber;
+    /** Create with strongly typed `Angle` inputs */
+    static create(longitude: Angle, latitude: Angle, h?: number, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber;
+    /** Create with angles in radians. */
+    static createRadians(longitudeRadians: number, latitudeRadians: number, h?: number, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber;
+    /** Create with angles in degrees. */
+    static createDegrees(longitudeDegrees: number, latitudeDegrees: number, h?: number, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber;
+    /**
+     * Set content from a JSON object.
+     * If the json object is undefined or unrecognized, always set a default value.
+     *
+     */
+    setFromJSON(json: any): void;
+    /** Return a json object with this object's contents.
+     * * Tag names are: longitude, latitude, h
+     */
+    toJSON(): any;
+    /** Test for near equality */
+    isAlmostEqual(other: LongitudeLatitudeNumber): boolean;
+    /** Return a copy */
+    clone(): LongitudeLatitudeNumber;
+}
+//# sourceMappingURL=LongitudeLatitudeAltitude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LongitudeLatitudeAltitude.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/LongitudeLatitudeAltitude.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,6CAA6C;IAC7C,IAAW,gBAAgB,IAAI,MAAM,CAAoC;IACzE,6CAA6C;IAC7C,IAAW,gBAAgB,IAAI,MAAM,CAAoC;IACzE,6EAA6E;IAC7E,IAAW,YAAY,IAAI,KAAK,CAA4B;IAC5D,0EAA0E;IAC1E,IAAW,SAAS,IAAI,KAAK,CAAoC;IAEjE,4CAA4C;IAC5C,IAAW,eAAe,IAAI,MAAM,CAAmC;IACvE,4CAA4C;IAC5C,IAAW,eAAe,IAAI,MAAM,CAAmC;IACvE,4EAA4E;IAC5E,IAAW,WAAW,IAAI,KAAK,CAA2B;IAC1D,yEAAyE;IACzE,IAAW,QAAQ,IAAI,KAAK,CAAmC;IAE/D,+BAA+B;IAC/B,IAAW,QAAQ,IAAI,MAAM,CAA2B;IACxD,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAA6B;IAC9D,+CAA+C;IAC/C,OAAO;IAKP,gDAAgD;WAClC,UAAU,IAAI,uBAAuB;IACnD,gDAAgD;WAClC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,uBAAuB;IASjI,qCAAqC;WACvB,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,uBAAuB;IASxJ,qCAAqC;WACvB,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,uBAAuB;IASxJ;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,GAAG;IAoB5B;;OAEG;IACI,MAAM,IAAI,GAAG;IAGpB,6BAA6B;IACtB,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAK7D,oBAAoB;IACb,KAAK,IAAI,uBAAuB;CAGxC"}

package/lib/esm/geometry3d/LongitudeLatitudeAltitude.js

@@ -0,0 +1,119 @@
+/*---------------------------------------------------------------------------------------------
+* 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";
+import { Angle } from "./Angle";
+/**
+ * An `AngleAngleNumber` is a pair of angles (named `longitude` and `latitude`) and an additional number.
+ * * This is directly intended to support `Ellipsoid` computations, with the two angles used as
+ *    * `longitude` is "around the equator"
+ *    * `latitude` is "equator to pole"
+ *    * `h` is altitude above the `Ellipsoid surface.
+ * * The structure may also be used for torus coordinates.
+ * @public
+ */
+export class LongitudeLatitudeNumber {
+    /** Constructor: Capture angles and altitude */
+    constructor(longitude, latitude, altitude) {
+        this._longitude = longitude;
+        this._latitude = latitude;
+        this._altitude = altitude;
+    }
+    /** (property getter) longitude in radians */
+    get longitudeRadians() { return this._longitude.radians; }
+    /** (property getter) longitude in degrees */
+    get longitudeDegrees() { return this._longitude.degrees; }
+    /** (property getter) (reference to) longitude as a strongly typed `Angle` */
+    get longitudeRef() { return this._longitude; }
+    /** (property getter) (clone of)  longitude as a strongly typed `Angle` */
+    get longitude() { return this._longitude.clone(); }
+    /** (property getter) latitude in radians */
+    get latitudeRadians() { return this._latitude.radians; }
+    /** (property getter) latitude in degrees */
+    get latitudeDegrees() { return this._latitude.degrees; }
+    /** (property getter) (reference to) latitude as a strongly typed `Angle` */
+    get latitudeRef() { return this._latitude; }
+    /** (property getter) (clone of)  latitude as a strongly typed `Angle` */
+    get latitude() { return this._latitude.clone(); }
+    /** Get or set the altitude. */
+    get altitude() { return this._altitude; }
+    set altitude(value) { this._altitude = value; }
+    /** Create with all zero angles and altitude. */
+    static createZero() { return new LongitudeLatitudeNumber(Angle.createDegrees(0), Angle.createDegrees(0), 0); }
+    /** Create with strongly typed `Angle` inputs */
+    static create(longitude, latitude, h = 0, result) {
+        if (result) {
+            result._latitude.setFrom(latitude);
+            result._longitude.setFrom(longitude);
+            result._altitude = h;
+            return result;
+        }
+        return new LongitudeLatitudeNumber(longitude.clone(), latitude.clone(), h);
+    }
+    /** Create with angles in radians. */
+    static createRadians(longitudeRadians, latitudeRadians, h = 0, result) {
+        if (result) {
+            result._longitude.setRadians(longitudeRadians);
+            result._latitude.setRadians(latitudeRadians);
+            result._altitude = h;
+            return result;
+        }
+        return new LongitudeLatitudeNumber(Angle.createRadians(longitudeRadians), Angle.createRadians(latitudeRadians), h);
+    }
+    /** Create with angles in degrees. */
+    static createDegrees(longitudeDegrees, latitudeDegrees, h = 0, result) {
+        if (result) {
+            result._longitude.setRadians(longitudeDegrees);
+            result._latitude.setRadians(latitudeDegrees);
+            result._altitude = h;
+            return result;
+        }
+        return new LongitudeLatitudeNumber(Angle.createDegrees(longitudeDegrees), Angle.createDegrees(latitudeDegrees), h);
+    }
+    /**
+     * Set content from a JSON object.
+     * If the json object is undefined or unrecognized, always set a default value.
+     *
+     */
+    setFromJSON(json) {
+        if (json.latitude !== undefined) {
+            this._latitude.setFromJSON(json.latitude);
+        }
+        else {
+            this._latitude.setDegrees(0);
+        }
+        if (json.longitude !== undefined) {
+            this._longitude.setFromJSON(json.longitude);
+        }
+        else {
+            this._longitude.setDegrees(0);
+        }
+        if (json.h !== undefined && Number.isFinite(json.h)) {
+            this._altitude = json.h;
+        }
+        else {
+            this._altitude = 0;
+        }
+    }
+    /** Return a json object with this object's contents.
+     * * Tag names are: longitude, latitude, h
+     */
+    toJSON() {
+        return { latitude: this._latitude.toJSON(), longitude: this._longitude.toJSON(), h: this._altitude };
+    }
+    /** Test for near equality */
+    isAlmostEqual(other) {
+        return this._latitude.isAlmostEqual(other._latitude)
+            && this._longitude.isAlmostEqual(other._longitude)
+            && Geometry.isSameCoordinate(this._altitude, other._altitude);
+    }
+    /** Return a copy */
+    clone() {
+        return new LongitudeLatitudeNumber(this._longitude.clone(), this._latitude.clone(), this._altitude);
+    }
+}
+//# sourceMappingURL=LongitudeLatitudeAltitude.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LongitudeLatitudeAltitude.js","sourceRoot":"","sources":["../../../src/geometry3d/LongitudeLatitudeAltitude.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 { BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { Angle } from \"./Angle\";\r\n\r\n/**\r\n * An `AngleAngleNumber` is a pair of angles (named `longitude` and `latitude`) and an additional number.\r\n * * This is directly intended to support `Ellipsoid` computations, with the two angles used as\r\n *    * `longitude` is \"around the equator\"\r\n *    * `latitude` is \"equator to pole\"\r\n *    * `h` is altitude above the `Ellipsoid surface.\r\n * * The structure may also be used for torus coordinates.\r\n * @public\r\n */\r\nexport class LongitudeLatitudeNumber implements BeJSONFunctions {\r\n  private _longitude: Angle;\r\n  private _latitude: Angle;\r\n  private _altitude: number;\r\n  /** (property getter) longitude in radians */\r\n  public get longitudeRadians(): number { return this._longitude.radians; }\r\n  /** (property getter) longitude in degrees */\r\n  public get longitudeDegrees(): number { return this._longitude.degrees; }\r\n  /** (property getter) (reference to) longitude as a strongly typed `Angle` */\r\n  public get longitudeRef(): Angle { return this._longitude; }\r\n  /** (property getter) (clone of)  longitude as a strongly typed `Angle` */\r\n  public get longitude(): Angle { return this._longitude.clone(); }\r\n\r\n  /** (property getter) latitude in radians */\r\n  public get latitudeRadians(): number { return this._latitude.radians; }\r\n  /** (property getter) latitude in degrees */\r\n  public get latitudeDegrees(): number { return this._latitude.degrees; }\r\n  /** (property getter) (reference to) latitude as a strongly typed `Angle` */\r\n  public get latitudeRef(): Angle { return this._latitude; }\r\n  /** (property getter) (clone of)  latitude as a strongly typed `Angle` */\r\n  public get latitude(): Angle { return this._latitude.clone(); }\r\n\r\n  /** Get or set the altitude. */\r\n  public get altitude(): number { return this._altitude; }\r\n  public set altitude(value: number) { this._altitude = value; }\r\n  /** Constructor: Capture angles and altitude */\r\n  private constructor(longitude: Angle, latitude: Angle, altitude: number) {\r\n    this._longitude = longitude;\r\n    this._latitude = latitude;\r\n    this._altitude = altitude;\r\n  }\r\n  /** Create with all zero angles and altitude. */\r\n  public static createZero(): LongitudeLatitudeNumber { return new LongitudeLatitudeNumber(Angle.createDegrees(0), Angle.createDegrees(0), 0); }\r\n  /** Create with strongly typed `Angle` inputs */\r\n  public static create(longitude: Angle, latitude: Angle, h: number = 0, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber {\r\n    if (result) {\r\n      result._latitude.setFrom(latitude);\r\n      result._longitude.setFrom(longitude);\r\n      result._altitude = h;\r\n      return result;\r\n    }\r\n    return new LongitudeLatitudeNumber(longitude.clone(), latitude.clone(), h);\r\n  }\r\n  /** Create with angles in radians. */\r\n  public static createRadians(longitudeRadians: number, latitudeRadians: number, h: number = 0, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber {\r\n    if (result) {\r\n      result._longitude.setRadians(longitudeRadians);\r\n      result._latitude.setRadians(latitudeRadians);\r\n      result._altitude = h;\r\n      return result;\r\n    }\r\n    return new LongitudeLatitudeNumber(Angle.createRadians(longitudeRadians), Angle.createRadians(latitudeRadians), h);\r\n  }\r\n  /** Create with angles in degrees. */\r\n  public static createDegrees(longitudeDegrees: number, latitudeDegrees: number, h: number = 0, result?: LongitudeLatitudeNumber): LongitudeLatitudeNumber {\r\n    if (result) {\r\n      result._longitude.setRadians(longitudeDegrees);\r\n      result._latitude.setRadians(latitudeDegrees);\r\n      result._altitude = h;\r\n      return result;\r\n    }\r\n    return new LongitudeLatitudeNumber(Angle.createDegrees(longitudeDegrees), Angle.createDegrees(latitudeDegrees), h);\r\n  }\r\n  /**\r\n   * Set content from a JSON object.\r\n   * If the json object is undefined or unrecognized, always set a default value.\r\n   *\r\n   */\r\n  public setFromJSON(json: any) {\r\n    if (json.latitude !== undefined) {\r\n      this._latitude.setFromJSON(json.latitude);\r\n    } else {\r\n      this._latitude.setDegrees(0);\r\n    }\r\n\r\n    if (json.longitude !== undefined) {\r\n      this._longitude.setFromJSON(json.longitude);\r\n    } else {\r\n      this._longitude.setDegrees(0);\r\n    }\r\n\r\n    if (json.h !== undefined && Number.isFinite(json.h)) {\r\n      this._altitude = json.h;\r\n    } else {\r\n      this._altitude = 0;\r\n    }\r\n  }\r\n\r\n  /** Return a json object with this object's contents.\r\n   * * Tag names are: longitude, latitude, h\r\n   */\r\n  public toJSON(): any {\r\n    return { latitude: this._latitude.toJSON(), longitude: this._longitude.toJSON(), h: this._altitude };\r\n  }\r\n  /** Test for near equality */\r\n  public isAlmostEqual(other: LongitudeLatitudeNumber): boolean {\r\n    return this._latitude.isAlmostEqual(other._latitude)\r\n      && this._longitude.isAlmostEqual(other._longitude)\r\n      && Geometry.isSameCoordinate(this._altitude, other._altitude);\r\n  }\r\n  /** Return a copy */\r\n  public clone(): LongitudeLatitudeNumber {\r\n    return new LongitudeLatitudeNumber(this._longitude.clone(), this._latitude.clone(), this._altitude);\r\n  }\r\n}\r\n"]}