@itwin/core-common 3.4.0-dev.9 → 3.4.0

package/lib/esm/QPoint.d.ts

@@ -1,7 +1,8 @@
 /** @packageDocumentation
  * @module Geometry
  */
-import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d } from "@itwin/core-geometry";
+import { Uint16ArrayBuilder } from "@itwin/core-bentley";
+import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d, XAndY, XYAndZ } from "@itwin/core-geometry";
 /**
  * Provides facilities for quantizing floating point values within a specified range into 16-bit unsigned integers.
  * This is a lossy compression technique.
@@ -11,6 +12,7 @@ import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d } from "@itwin/c
  * These routines are chiefly used by classes like [[QPoint2d]] and [[QPoint3d]] to reduce the space required to store
  * coordinate values for [RenderGraphic]($frontend)s.
  * @public
+ * @extensions
  */
 export declare namespace Quantization {
     const rangeScale16 = 65535;
@@ -36,6 +38,7 @@ export declare namespace Quantization {
  * @see [[QPoint2d]] for the quantized representation of a [Point2d]($core-geometry).
  * @see [[QPoint2dList]] for a list of [[QPoint2d]]s quantized using a [[QParams2d]].
  * @public
+ * @extensions
  */
 export declare class QParams2d {
     /** The origin of the quantization range. */
@@ -72,6 +75,7 @@ export declare class QParams2d {
  * @see [[QParams2d]] to define quantization parameters for a range of points.
  * @see [[QPoint2dList]] for a list of points all quantized to the same range.
  * @public
+ * @extensions
  */
 export declare class QPoint2d {
     private _x;
@@ -84,8 +88,8 @@ export declare class QPoint2d {
     set y(y: number);
     /** Construct with `x` and `y` initialized to zero. */
     constructor();
-    /** Initialize this point by quantizing the supplied Point2d using the specified params */
-    init(pos: Point2d, params: QParams2d): void;
+    /** Initialize this point by quantizing the supplied { x, y } using the specified params */
+    init(pos: XAndY, params: QParams2d): void;
     /** Create a quantized point from the supplied Point2d using the specified params */
     static create(pos: Point2d, params: QParams2d): QPoint2d;
     /** Initialize `x` and `y` from `src`. */
@@ -109,8 +113,44 @@ export declare class QPoint2d {
     /** Return a Point2d unquantized according to the supplied `params`. If `out` is supplied, it will be modified in-place and returned. */
     unquantize(params: QParams2d, out?: Point2d): Point2d;
 }
+/** A compact representation of a list of [[QPoint2d]]s stored in a `Uint16Array`
+ * This representation is particularly useful when passing data to WebGL; for example, see [RealityMeshParams.uvs]($frontend).
+ * @see [[QPoint3dBuffer]] for 3d points.
+ * @public
+ * @extensions
+ */
+export interface QPoint2dBuffer {
+    /** The parameters used to quantize the [[points]]. */
+    params: QParams2d;
+    /** The [[QPoint2d]]s as pairs of unsigned 16-bit integers. The length must be a multiple of 2; the number of points in the array is half the array's length.
+     * To obtain the `n`th point, use `QPoint2d.fromScalars(buffer.points[n * 2], buffer.points[n * 2 + 1])`.
+     */
+    points: Uint16Array;
+}
+/** @public
+ * @extensions
+ */
+export declare namespace QPoint2dBuffer {
+    /** Extracts the point at the specified index from a buffer.
+     * @param points The buffer in which each consecutive pair of integers is a 2d quantized point.
+     * @param pointIndex The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [[QPoint2d]] to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function getQPoint(points: Uint16Array, pointIndex: number, result?: QPoint2d): QPoint2d;
+    /** Extracts and unquantizes the point at the specified index from a buffer.
+     * @param buffer The array of points and the quantization parameters.
+     * @param The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [Point2d]($core-geometry) to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function unquantizePoint(buffer: QPoint2dBuffer, pointIndex: number, result?: Point2d): Point2d;
+}
 /** A list of [[QPoint2d]]s all quantized to the same range.
  * @public
+ * @extensions
  */
 export declare class QPoint2dList {
     /** Parameters used to quantize the points. */
@@ -149,6 +189,7 @@ export declare class QPoint2dList {
  * @see [[QPoint3d]] for the quantized representation of a [Point3d]($core-geometry).
  * @see [[QPoint3dList]] for a list of [[QPoint3d]]s quantized using a [[QParams3d]].
  * @public
+ * @extensions
  */
 export declare class QParams3d {
     /** The origin of the quantization range. */
@@ -195,6 +236,7 @@ export declare class QParams3d {
  * @see [[QParams3d]] to define quantization parameters for a range of points.
  * @see [[QPoint3dList]] for a list of points all quantized to the same range.
  * @public
+ * @extensions
  */
 export declare class QPoint3d {
     private _x;
@@ -211,8 +253,8 @@ export declare class QPoint3d {
     set z(z: number);
     /** Construct with all components initialized to zero. */
     constructor();
-    /** Initialize this point by quantizing the supplied Point3d using the specified params */
-    init(pos: Point3d, params: QParams3d): void;
+    /** Initialize this point by quantizing the supplied { x, y, z } using the specified params */
+    init(pos: XYAndZ, params: QParams3d): void;
     /** Creates a quantized point from the supplied Point3d using the specified params */
     static create(pos: Point3d, params: QParams3d): QPoint3d;
     /** Set this points components from `src`. */
@@ -250,8 +292,43 @@ export declare class QPoint3d {
      */
     compare(rhs: QPoint3d): number;
 }
+/** A compact representation of a list of [[QPoint3d]]s stored in a `Uint16Array`.
+ * This representation is particularly useful when passing data to WebGL; for example, see [RealityMeshParams.positions]($frontend).
+ * @public
+ * @extensions
+ */
+export interface QPoint3dBuffer {
+    /** The parameters used to quantize the [[points]]. */
+    params: QParams3d;
+    /** The [[QPoint3d]]s as pairs of unsigned 16-bit integers. The length must be a multiple of 3; the number of points in the array is half the array's length.
+     * To obtain the `n`th point, use `QPoint3d.fromScalars(buffer.points[n * 3], buffer.points[n * 3 + 1], buffer.points[n * 3 + 2])`.
+     */
+    points: Uint16Array;
+}
+/** @public
+ * @extensions
+ */
+export declare namespace QPoint3dBuffer {
+    /** Extracts the point at the specified index from a buffer.
+     * @param points The buffer in which each consecutive pair of integers is a 3d quantized point.
+     * @param pointIndex The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [[QPoint3d]] to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function getQPoint(points: Uint16Array, pointIndex: number, result?: QPoint3d): QPoint3d;
+    /** Extracts and unquantizes the point at the specified index from a buffer.
+     * @param buffer The array of points and the quantization parameters.
+     * @param The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [Point3d]($core-geometry) to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function unquantizePoint(buffer: QPoint3dBuffer, pointIndex: number, result?: Point3d): Point3d;
+}
 /** A list of [[QPoint3d]]s all quantized to the same range.
  * @public
+ * @extensions
  */
 export declare class QPoint3dList {
     /** Parameters used to quantize the points. */
@@ -297,4 +374,107 @@ export declare class QPoint3dList {
     /** An iterator over the points in the list. */
     [Symbol.iterator](): IterableIterator<QPoint3d>;
 }
+/** Options used to construct a [[QPoint2dBufferBuilder]].
+ * @beta
+ * @extensions
+ */
+interface QPoint2dBufferBuilderOptions {
+    /** The range to which the points will be quantized. This must be large enough to contain all of the points that will be added to the buffer. */
+    range: Range2d;
+    /** The number of points for which to allocate space.
+     * @see [TypedArrayBuilderOptions.initialCapacity]($bentley).
+     */
+    initialCapacity?: number;
+    /** Multiplier used to compute new capacity when resizing the buffer.
+     * @see [TypedArrayBuilderOptions.growthFactor]($bentley).
+     */
+    growthFactor?: number;
+}
+/** Constructs a [[QPoint2dBuffer]] using a [Uint16ArrayBuilder]($bentley).
+ * @public
+ * @extensions
+ */
+export declare class QPoint2dBufferBuilder {
+    private readonly _scratchQPoint2d;
+    /** The parameters used to quantize the points in the [[buffer]]. */
+    readonly params: QParams2d;
+    /** The buffer that holds the points. */
+    readonly buffer: Uint16ArrayBuilder;
+    /** Construct a new buffer with a [[length]] of zero. */
+    constructor(options: QPoint2dBufferBuilderOptions);
+    /** Append a point with the specified quantized coordinates. */
+    pushXY(x: number, y: number): void;
+    /** Append a point with the specified quantized coordinates. */
+    push(pt: XAndY): void;
+    /** The number of points currently in the [[buffer]]. */
+    get length(): number;
+    /** Returns the quantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [[QPoint2d]] to initialize with the result and return.
+     * @returns The quantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    get(pointIndex: number, result?: QPoint2d): QPoint2d;
+    /** Returns the unquantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [Point2d]($core-geometry) to initialize with the result and return.
+     * @returns The unquantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    unquantize(pointIndex: number, result?: Point2d): Point2d;
+    /** Obtain a [[QPoint2dBuffer]] containing all of the points that have been appended by this builder. */
+    finish(): QPoint2dBuffer;
+}
+/** Options used to construct a [[QPoint3dBufferBuilder]].
+ * @beta
+ * @extensions
+ */
+interface QPoint3dBufferBuilderOptions {
+    /** The range to which the points will be quantized. This must be large enough to contain all of the points that will be added to the buffer. */
+    range: Range3d;
+    /** The number of points for which to allocate space.
+     * @see [TypedArrayBuilderOptions.initialCapacity]($bentley).
+     */
+    initialCapacity?: number;
+    /** Multiplier used to compute new capacity when resizing the buffer.
+     * @see [TypedArrayBuilderOptions.growthFactor]($bentley).
+     */
+    growthFactor?: number;
+}
+/** Constructs a [[QPoint3dBuffer]] using a [Uint16ArrayBuilder]($bentley).
+ * @public
+ * @extensions
+ */
+export declare class QPoint3dBufferBuilder {
+    private readonly _scratchQPoint3d;
+    /** The parameters used to quantize the points in the [[buffer]]. */
+    readonly params: QParams3d;
+    /** The buffer that holds the points. */
+    readonly buffer: Uint16ArrayBuilder;
+    /** Construct a new buffer with a [[length]] of zero. */
+    constructor(options: QPoint3dBufferBuilderOptions);
+    /** Append a point with the specified quantized coordinates. */
+    pushXYZ(x: number, y: number, z: number): void;
+    /** Append a point with the specified quantized coordinates. */
+    push(pt: XYAndZ): void;
+    /** The number of points currently in the [[buffer]]. */
+    get length(): number;
+    /** Returns the quantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [[QPoint3d]] to initialize with the result and return.
+     * @returns The quantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    get(pointIndex: number, result?: QPoint3d): QPoint3d;
+    /** Returns the unquantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [Point3d]($core-geometry) to initialize with the result and return.
+     * @returns The unquantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    unquantize(pointIndex: number, result?: Point3d): Point3d;
+    /** Obtain a [[QPoint3dBuffer]] containing all of the points that have been appended by this builder. */
+    finish(): QPoint3dBuffer;
+}
+export {};
 //# sourceMappingURL=QPoint.d.ts.map

package/lib/esm/QPoint.d.ts.map

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

package/lib/esm/QPoint.js

@@ -5,8 +5,8 @@
 /** @packageDocumentation
  * @module Geometry
  */
-import { assert } from "@itwin/core-bentley";
-import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d } from "@itwin/core-geometry";
+import { assert, Uint16ArrayBuilder } from "@itwin/core-bentley";
+import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d, } from "@itwin/core-geometry";
 /**
  * Provides facilities for quantizing floating point values within a specified range into 16-bit unsigned integers.
  * This is a lossy compression technique.
@@ -16,6 +16,7 @@ import { Point2d, Point3d, Range2d, Range3d, Vector2d, Vector3d } from "@itwin/c
  * These routines are chiefly used by classes like [[QPoint2d]] and [[QPoint3d]] to reduce the space required to store
  * coordinate values for [RenderGraphic]($frontend)s.
  * @public
+ * @extensions
  */
 export var Quantization;
 (function (Quantization) {
@@ -60,6 +61,7 @@ export var Quantization;
  * @see [[QPoint2d]] for the quantized representation of a [Point2d]($core-geometry).
  * @see [[QPoint2dList]] for a list of [[QPoint2d]]s quantized using a [[QParams2d]].
  * @public
+ * @extensions
  */
 export class QParams2d {
     constructor(ox = 0, oy = 0, sx = 0, sy = 0) {
@@ -135,6 +137,7 @@ export class QParams2d {
  * @see [[QParams2d]] to define quantization parameters for a range of points.
  * @see [[QPoint2dList]] for a list of points all quantized to the same range.
  * @public
+ * @extensions
  */
 export class QPoint2d {
     /** Construct with `x` and `y` initialized to zero. */
@@ -154,7 +157,7 @@ export class QPoint2d {
         assert(Quantization.isQuantized(y));
         this._y = y;
     }
-    /** Initialize this point by quantizing the supplied Point2d using the specified params */
+    /** Initialize this point by quantizing the supplied { x, y } using the specified params */
     init(pos, params) {
         this.x = Quantization.quantize(pos.x, params.origin.x, params.scale.x);
         this.y = Quantization.quantize(pos.y, params.origin.y, params.scale.y);
@@ -205,8 +208,46 @@ export class QPoint2d {
         return pt;
     }
 }
+/** @public
+ * @extensions
+ */
+export var QPoint2dBuffer;
+(function (QPoint2dBuffer) {
+    const scratchQPoint2d = new QPoint2d();
+    /** Extracts the point at the specified index from a buffer.
+     * @param points The buffer in which each consecutive pair of integers is a 2d quantized point.
+     * @param pointIndex The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [[QPoint2d]] to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function getQPoint(points, pointIndex, result) {
+        const index = pointIndex * 2;
+        const x = points[index + 0];
+        const y = points[index + 1];
+        if (undefined === x || undefined === y)
+            throw new Error("Index out of range");
+        result = result !== null && result !== void 0 ? result : new QPoint2d();
+        result.setFromScalars(x, y);
+        return result;
+    }
+    QPoint2dBuffer.getQPoint = getQPoint;
+    /** Extracts and unquantizes the point at the specified index from a buffer.
+     * @param buffer The array of points and the quantization parameters.
+     * @param The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [Point2d]($core-geometry) to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function unquantizePoint(buffer, pointIndex, result) {
+        const qpt = getQPoint(buffer.points, pointIndex, scratchQPoint2d);
+        return qpt.unquantize(buffer.params, result);
+    }
+    QPoint2dBuffer.unquantizePoint = unquantizePoint;
+})(QPoint2dBuffer || (QPoint2dBuffer = {}));
 /** A list of [[QPoint2d]]s all quantized to the same range.
  * @public
+ * @extensions
  */
 export class QPoint2dList {
     /** Construct an empty list set up to use the supplied quantization parameters. */
@@ -287,8 +328,9 @@ export class QPoint2dList {
             qPoints = out;
             qPoints.reset(qParams);
         }
-        else
+        else {
             qPoints = new QPoint2dList(qParams);
+        }
         for (const point of points)
             qPoints.add(point);
         return qPoints;
@@ -298,6 +340,7 @@ export class QPoint2dList {
  * @see [[QPoint3d]] for the quantized representation of a [Point3d]($core-geometry).
  * @see [[QPoint3dList]] for a list of [[QPoint3d]]s quantized using a [[QParams3d]].
  * @public
+ * @extensions
  */
 export class QParams3d {
     constructor(ox = 0, oy = 0, oz = 0, sx = 0, sy = 0, sz = 0) {
@@ -400,6 +443,7 @@ export class QParams3d {
  * @see [[QParams3d]] to define quantization parameters for a range of points.
  * @see [[QPoint3dList]] for a list of points all quantized to the same range.
  * @public
+ * @extensions
  */
 export class QPoint3d {
     /** Construct with all components initialized to zero. */
@@ -426,7 +470,7 @@ export class QPoint3d {
         assert(Quantization.isQuantized(z));
         this._z = z;
     }
-    /** Initialize this point by quantizing the supplied Point3d using the specified params */
+    /** Initialize this point by quantizing the supplied { x, y, z } using the specified params */
     init(pos, params) {
         this.x = Quantization.quantize(pos.x, params.origin.x, params.scale.x);
         this.y = Quantization.quantize(pos.y, params.origin.y, params.scale.y);
@@ -506,8 +550,47 @@ export class QPoint3d {
         return diff;
     }
 }
+/** @public
+ * @extensions
+ */
+export var QPoint3dBuffer;
+(function (QPoint3dBuffer) {
+    const scratchQPoint3d = new QPoint3d();
+    /** Extracts the point at the specified index from a buffer.
+     * @param points The buffer in which each consecutive pair of integers is a 3d quantized point.
+     * @param pointIndex The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [[QPoint3d]] to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function getQPoint(points, pointIndex, result) {
+        const index = pointIndex * 3;
+        const x = points[index + 0];
+        const y = points[index + 1];
+        const z = points[index + 2];
+        if (undefined === x || undefined === y || undefined === z)
+            throw new Error("Index out of range");
+        result = result !== null && result !== void 0 ? result : new QPoint3d();
+        result.setFromScalars(x, y, z);
+        return result;
+    }
+    QPoint3dBuffer.getQPoint = getQPoint;
+    /** Extracts and unquantizes the point at the specified index from a buffer.
+     * @param buffer The array of points and the quantization parameters.
+     * @param The index of the point to extract, ranging from zero to one less than the number of points in the buffer.
+     * @param result If supplied, a preallocated [Point3d]($core-geometry) to initialize with the result and return.
+     * @returns The point at `pointIndex`.
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    function unquantizePoint(buffer, pointIndex, result) {
+        const qpt = getQPoint(buffer.points, pointIndex, scratchQPoint3d);
+        return qpt.unquantize(buffer.params, result);
+    }
+    QPoint3dBuffer.unquantizePoint = unquantizePoint;
+})(QPoint3dBuffer || (QPoint3dBuffer = {}));
 /** A list of [[QPoint3d]]s all quantized to the same range.
  * @public
+ * @extensions
  */
 export class QPoint3dList {
     /** Construct an empty list set up to quantize to the supplied range.
@@ -615,4 +698,119 @@ export class QPoint3dList {
         return this.list[Symbol.iterator]();
     }
 }
+/** Constructs a [[QPoint2dBuffer]] using a [Uint16ArrayBuilder]($bentley).
+ * @public
+ * @extensions
+ */
+export class QPoint2dBufferBuilder {
+    /** Construct a new buffer with a [[length]] of zero. */
+    constructor(options) {
+        var _a;
+        this._scratchQPoint2d = new QPoint2d();
+        this.params = QParams2d.fromRange(options.range);
+        const initialCapacity = (_a = options.initialCapacity) !== null && _a !== void 0 ? _a : 0;
+        this.buffer = new Uint16ArrayBuilder({
+            growthFactor: options.growthFactor,
+            initialCapacity: 2 * initialCapacity,
+        });
+    }
+    /** Append a point with the specified quantized coordinates. */
+    pushXY(x, y) {
+        this.buffer.push(x);
+        this.buffer.push(y);
+    }
+    /** Append a point with the specified quantized coordinates. */
+    push(pt) {
+        this.pushXY(pt.x, pt.y);
+    }
+    /** The number of points currently in the [[buffer]]. */
+    get length() {
+        const len = this.buffer.length;
+        assert(len % 2 === 0);
+        return len / 2;
+    }
+    /** Returns the quantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [[QPoint2d]] to initialize with the result and return.
+     * @returns The quantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    get(pointIndex, result) {
+        return QPoint2dBuffer.getQPoint(this.buffer.toTypedArray(), pointIndex, result);
+    }
+    /** Returns the unquantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [Point2d]($core-geometry) to initialize with the result and return.
+     * @returns The unquantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    unquantize(pointIndex, result) {
+        return this.get(pointIndex, this._scratchQPoint2d).unquantize(this.params, result);
+    }
+    /** Obtain a [[QPoint2dBuffer]] containing all of the points that have been appended by this builder. */
+    finish() {
+        return {
+            params: this.params,
+            points: this.buffer.toTypedArray(),
+        };
+    }
+}
+/** Constructs a [[QPoint3dBuffer]] using a [Uint16ArrayBuilder]($bentley).
+ * @public
+ * @extensions
+ */
+export class QPoint3dBufferBuilder {
+    /** Construct a new buffer with a [[length]] of zero. */
+    constructor(options) {
+        var _a;
+        this._scratchQPoint3d = new QPoint3d();
+        this.params = QParams3d.fromRange(options.range);
+        const initialCapacity = (_a = options.initialCapacity) !== null && _a !== void 0 ? _a : 0;
+        this.buffer = new Uint16ArrayBuilder({
+            growthFactor: options.growthFactor,
+            initialCapacity: 3 * initialCapacity,
+        });
+    }
+    /** Append a point with the specified quantized coordinates. */
+    pushXYZ(x, y, z) {
+        this.buffer.push(x);
+        this.buffer.push(y);
+        this.buffer.push(z);
+    }
+    /** Append a point with the specified quantized coordinates. */
+    push(pt) {
+        this.pushXYZ(pt.x, pt.y, pt.z);
+    }
+    /** The number of points currently in the [[buffer]]. */
+    get length() {
+        const len = this.buffer.length;
+        assert(len % 3 === 0);
+        return len / 3;
+    }
+    /** Returns the quantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [[QPoint3d]] to initialize with the result and return.
+     * @returns The quantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    get(pointIndex, result) {
+        return QPoint3dBuffer.getQPoint(this.buffer.toTypedArray(), pointIndex, result);
+    }
+    /** Returns the unquantized point at the specified index in [[buffer]].
+     * @param pointIndex The index of the point of interest, ranging from zero to one minus the number of points currently in the [[buffer]].
+     * @param result If supplied, a [Point3d]($core-geometry) to initialize with the result and return.
+     * @returns The unquantized point at the specified index in [[buffer]].
+     * @throws Error if `pointIndex` is out of bounds.
+     */
+    unquantize(pointIndex, result) {
+        return this.get(pointIndex, this._scratchQPoint3d).unquantize(this.params, result);
+    }
+    /** Obtain a [[QPoint3dBuffer]] containing all of the points that have been appended by this builder. */
+    finish() {
+        return {
+            params: this.params,
+            points: this.buffer.toTypedArray(),
+        };
+    }
+}
 //# sourceMappingURL=QPoint.js.map