@itwin/core-geometry 3.3.0-dev.76 → 3.3.0-dev.79

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

@@ -12,21 +12,36 @@ import { XAndY, XYAndZ } from "./XYZProps";
  */
 export declare class GrowableXYArray extends IndexedXYCollection {
     /**
-     * array of packed xyz xyz xyz components
+     * array of packed xy xy xy components
      */
     private _data;
     /**
-     * Number of xyz triples (not floats) in the array
+     * Number of xy tuples (not floats) in the array
      */
     private _xyInUse;
     /**
-     * capacity in xyz triples. (not floats)
+     * capacity in xy tuples. (not floats)
      */
-    private _xyzCapacity;
-    /** Construct a new GrowablePoint2d array.
-     * @param numPoints [in] initial capacity.
+    private _xyCapacity;
+    /**
+     * multiplier used by ensureCapacity to expand requested reallocation size
      */
-    constructor(numPoints?: number);
+    private _growthFactor;
+    /** Construct a new GrowablePoint2d array.
+     * @param numPoints initial capacity in xy tuples (default 8)
+     * @param growthFactor used by ensureCapacity to expand requested reallocation size (default 1.5)
+     */
+    constructor(numPoints?: number, growthFactor?: number);
+    /** Copy xy points from source array. Does not reallocate or change active point count.
+     * @param source array to copy from
+     * @param sourceCount copy the first sourceCount points; all points if undefined
+     * @param destOffset copy to instance array starting at this point index; zero if undefined
+     * @return count and offset of points copied
+     */
+    protected copyData(source: Float64Array | number[], sourceCount?: number, destOffset?: number): {
+        count: number;
+        offset: number;
+    };
     /** The number of points in use. When the length is increased, the array is padded with zeroes. */
     get length(): number;
     set length(newLength: number);
@@ -37,9 +52,14 @@ export declare class GrowableXYArray extends IndexedXYCollection {
      */
     float64Data(): Float64Array;
     /** If necessary, increase the capacity to a new pointCount.  Current coordinates and point count (length) are unchanged. */
-    ensureCapacity(pointCapacity: number): void;
-    /** Resize the actual point count, preserving excess capacity. */
-    resize(pointCount: number): void;
+    ensureCapacity(pointCapacity: number, applyGrowthFactor?: boolean): void;
+    /**
+     * * If pointCount is less than current length, just reset current length to pointCount, effectively trimming active points but preserving original capacity.
+     * * If pointCount is greater than current length, reallocate to exactly pointCount, copy existing points, and optionally pad excess with zero.
+     * @param pointCount new number of active points in array
+     * @param padWithZero when increasing point count, whether to zero out new points (default false)
+     */
+    resize(pointCount: number, padWithZero?: boolean): void;
     /**
      * Make a copy of the (active) points in this array.
      * (The clone does NOT get excess capacity)
@@ -61,24 +81,24 @@ export declare class GrowableXYArray extends IndexedXYCollection {
     /** push all points of an array */
     pushAllXYAndZ(points: XYAndZ[] | GrowableXYZArray): void;
     /**
-     * Replicate numWrap xyz values from the front of the array as new values at the end.
-     * @param numWrap number of xyz values to replicate
+     * Replicate numWrap xy values from the front of the array as new values at the end.
+     * @param numWrap number of xy values to replicate
      */
     pushWrap(numWrap: number): void;
     /** push a point given by x,y coordinates */
     pushXY(x: number, y: number): void;
     /** Remove one point from the back.
      * * NOTE that (in the manner of std::vector native) this is "just" removing the point -- no point is NOT returned.
-     * * Use `back ()` to get the last x,y,z assembled into a `Point3d `
+     * * Use `back ()` to get the last x,y assembled into a `Point2d `
      */
     pop(): void;
     /**
-     * Test if index is valid for an xyz (point or vector) within this array
-     * @param index xyz index to test.
+     * Test if index is valid for an xy (point or vector) within this array
+     * @param index xy index to test.
      */
     isIndexValid(index: number): boolean;
     /**
-     * Clear all xyz data, but leave capacity unchanged.
+     * Clear all xy data, but leave capacity unchanged.
      */
     clear(): void;
     /**
@@ -101,9 +121,9 @@ export declare class GrowableXYArray extends IndexedXYCollection {
      * Gather all points as a Point2d[]
      */
     getPoint2dArray(): Point2d[];
-    /** copy xyz into strongly typed Point2d */
+    /** copy xy into strongly typed Point2d */
     getPoint2dAtCheckedPointIndex(pointIndex: number, result?: Point2d): Point2d | undefined;
-    /** copy xyz into strongly typed Vector2d */
+    /** copy xy into strongly typed Vector2d */
     getVector2dAtCheckedVectorIndex(vectorIndex: number, result?: Vector2d): Vector2d | undefined;
     /**
      * Read coordinates from source array, place them at index within this array.
@@ -116,8 +136,8 @@ export declare class GrowableXYArray extends IndexedXYCollection {
     /**
      * push coordinates from the source array to the end of this array.
      * @param source source array
-     * @param sourceIndex xyz index within the source.  If undefined, push entire contents of source
-     * @returns true if sourceIndex is valid.
+     * @param sourceIndex xy index within the source.  If undefined, push entire contents of source
+     * @returns number of points pushed.
      */
     pushFromGrowableXYArray(source: GrowableXYArray, sourceIndex?: number): number;
     /**
@@ -126,9 +146,9 @@ export declare class GrowableXYArray extends IndexedXYCollection {
      */
     pushInterpolatedFromGrowableXYArray(source: GrowableXYArray, i: number, fraction: number, j: number): void;
     /**
-     * push coordinates from the source array to the end of this array.
-     * @param source source array
-     * @param transform optional transform to apply to points.
+     * Create an array of xy points from source xyz points.
+     * @param source source array of xyz
+     * @param transform optional transform to apply to xyz points.
      * @param dest optional result.
      */
     static createFromGrowableXYZArray(source: GrowableXYZArray, transform?: Transform, dest?: GrowableXYArray): GrowableXYArray;
@@ -152,16 +172,21 @@ export declare class GrowableXYArray extends IndexedXYCollection {
      * @param x x coordinate
      * @param y y coordinate
      */
+    setXYAtCheckedPointIndex(pointIndex: number, x: number, y: number): boolean;
+    /**
+     * Set the coordinates of a single point given as coordinates.
+     * @deprecated Use setXYAtCheckedPointIndex instead
+     */
     setXYZAtCheckedPointIndex(pointIndex: number, x: number, y: number): boolean;
     /**
-     * Copy all points into a simple array of Point3D with given z.
+     * Copy all points into a simple array of Point3d with given z.
      */
     getPoint3dArray(z?: number): Point3d[];
     /** reverse the order of points. */
     reverseInPlace(): void;
     /** multiply each point by the transform, replace values. */
     multiplyTransformInPlace(transform: Transform): void;
-    /** multiply each xyz (as a vector) by matrix, replace values. */
+    /** multiply each xy (as a vector) by matrix, replace values. */
     multiplyMatrix3dInPlace(matrix: Matrix3d): void;
     /** multiply each point by the transform, replace values. */
     tryTransformInverseInPlace(transform: Transform): boolean;
@@ -170,7 +195,7 @@ export declare class GrowableXYArray extends IndexedXYCollection {
     /** sum the lengths of segments between points. */
     sumLengths(): number;
     /**
-     * Multiply each x,y,z by the scale factor.
+     * Multiply each x,y by the scale factor.
      * @param factor
      */
     scaleInPlace(factor: number): void;

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

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

package/lib/esm/geometry3d/GrowableXYArray.js

@@ -16,27 +16,51 @@ import { PointStreamGrowableXYZArrayCollector, VariantPointDataStream } from "./
  */
 export class GrowableXYArray extends IndexedXYCollection {
     /** Construct a new GrowablePoint2d array.
-     * @param numPoints [in] initial capacity.
+     * @param numPoints initial capacity in xy tuples (default 8)
+     * @param growthFactor used by ensureCapacity to expand requested reallocation size (default 1.5)
      */
-    constructor(numPoints = 8) {
+    constructor(numPoints = 8, growthFactor) {
         super();
-        this._data = new Float64Array(numPoints * 2); // 8 Points to start (2 values each)
+        this._data = new Float64Array(numPoints * 2); // 2 values per point
         this._xyInUse = 0;
-        this._xyzCapacity = numPoints;
+        this._xyCapacity = numPoints;
+        this._growthFactor = (undefined !== growthFactor && growthFactor >= 1.0) ? growthFactor : 1.5;
+    }
+    /** Copy xy points from source array. Does not reallocate or change active point count.
+     * @param source array to copy from
+     * @param sourceCount copy the first sourceCount points; all points if undefined
+     * @param destOffset copy to instance array starting at this point index; zero if undefined
+     * @return count and offset of points copied
+     */
+    copyData(source, sourceCount, destOffset) {
+        // validate inputs and convert from points to entries
+        let myOffset = (undefined !== destOffset) ? destOffset * 2 : 0;
+        if (myOffset < 0)
+            myOffset = 0;
+        if (myOffset >= this._data.length)
+            return { count: 0, offset: 0 };
+        let myCount = (undefined !== sourceCount) ? sourceCount * 2 : source.length;
+        if (myCount > 0) {
+            if (myCount > source.length)
+                myCount = source.length;
+            if (myOffset + myCount > this._data.length)
+                myCount = this._data.length - myOffset;
+            if (myCount % 2 !== 0)
+                myCount -= myCount % 2;
+        }
+        if (myCount <= 0)
+            return { count: 0, offset: 0 };
+        if (myCount === source.length)
+            this._data.set(source, myOffset);
+        else if (source instanceof Float64Array)
+            this._data.set(source.subarray(0, myCount), myOffset);
+        else
+            this._data.set(source.slice(0, myCount), myOffset);
+        return { count: myCount / 2, offset: myOffset / 2 };
     }
     /** The number of points in use. When the length is increased, the array is padded with zeroes. */
     get length() { return this._xyInUse; }
-    set length(newLength) {
-        let oldLength = this.length;
-        if (newLength < oldLength) {
-            this._xyInUse = newLength;
-        }
-        else if (newLength > oldLength) {
-            this.ensureCapacity(newLength);
-            while (oldLength++ < newLength)
-                this.pushXY(0, 0);
-        }
-    }
+    set length(newLength) { this.resize(newLength, true); }
     /** Return the number of float64 in use. */
     get float64Length() { return this._xyInUse * 2; }
     /** Return the raw packed data.
@@ -44,31 +68,29 @@ export class GrowableXYArray extends IndexedXYCollection {
      */
     float64Data() { return this._data; }
     /** If necessary, increase the capacity to a new pointCount.  Current coordinates and point count (length) are unchanged. */
-    ensureCapacity(pointCapacity) {
-        if (pointCapacity > this._xyzCapacity) {
-            const newData = new Float64Array(pointCapacity * 2);
-            const numCopy = this.length * 2;
-            for (let i = 0; i < numCopy; i++)
-                newData[i] = this._data[i];
-            this._data = newData;
-            this._xyzCapacity = pointCapacity;
-        }
-    }
-    /** Resize the actual point count, preserving excess capacity. */
-    resize(pointCount) {
-        if (pointCount < this.length) {
-            this._xyInUse = pointCount >= 0 ? pointCount : 0;
-        }
-        else if (pointCount > this._xyzCapacity) {
-            const newArray = new Float64Array(pointCount * 2);
-            // Copy contents
-            for (let i = 0; i < this._data.length; i += 2) {
-                newArray[i] = this._data[i];
-                newArray[i + 1] = this._data[i + 1];
-                newArray[i + 2] = this._data[i + 2];
-            }
-            this._data = newArray;
-            this._xyzCapacity = pointCount;
+    ensureCapacity(pointCapacity, applyGrowthFactor = true) {
+        if (pointCapacity > this._xyCapacity) {
+            if (applyGrowthFactor)
+                pointCapacity *= this._growthFactor;
+            const prevData = this._data;
+            this._data = new Float64Array(pointCapacity * 2);
+            this.copyData(prevData, this._xyInUse);
+            this._xyCapacity = pointCapacity;
+        }
+    }
+    /**
+     * * If pointCount is less than current length, just reset current length to pointCount, effectively trimming active points but preserving original capacity.
+     * * If pointCount is greater than current length, reallocate to exactly pointCount, copy existing points, and optionally pad excess with zero.
+     * @param pointCount new number of active points in array
+     * @param padWithZero when increasing point count, whether to zero out new points (default false)
+     */
+    resize(pointCount, padWithZero) {
+        if (pointCount >= 0 && pointCount < this._xyInUse)
+            this._xyInUse = pointCount;
+        else if (pointCount > this._xyInUse) {
+            this.ensureCapacity(pointCount, false);
+            if (padWithZero !== null && padWithZero !== void 0 ? padWithZero : false)
+                this._data.fill(0, this._xyInUse * 2);
             this._xyInUse = pointCount;
         }
     }
@@ -78,11 +100,7 @@ export class GrowableXYArray extends IndexedXYCollection {
      */
     clone() {
         const newPoints = new GrowableXYArray(this.length);
-        const numValue = this.length * 2;
-        const newData = newPoints._data;
-        const data = this._data;
-        for (let i = 0; i < numValue; i++)
-            newData[i] = data[i];
+        newPoints.copyData(this._data, this.length);
         newPoints._xyInUse = this.length;
         return newPoints;
     }
@@ -114,17 +132,18 @@ export class GrowableXYArray extends IndexedXYCollection {
     }
     /** push all points of an array */
     pushAll(points) {
+        this.ensureCapacity(this._xyInUse + points.length, false);
         for (const p of points)
             this.push(p);
     }
     /** push all points of an array */
     pushAllXYAndZ(points) {
+        this.ensureCapacity(this._xyInUse + points.length, false);
         if (points instanceof GrowableXYZArray) {
             const xyzBuffer = points.float64Data();
             const n = points.length * 3;
-            for (let i = 0; i + 2 < n; i += 3) {
+            for (let i = 0; i + 2 < n; i += 3)
                 this.pushXY(xyzBuffer[i], xyzBuffer[i + 1]);
-            }
         }
         else {
             for (const p of points)
@@ -132,38 +151,37 @@ export class GrowableXYArray extends IndexedXYCollection {
         }
     }
     /**
-     * Replicate numWrap xyz values from the front of the array as new values at the end.
-     * @param numWrap number of xyz values to replicate
+     * Replicate numWrap xy values from the front of the array as new values at the end.
+     * @param numWrap number of xy values to replicate
      */
     pushWrap(numWrap) {
-        if (this._xyInUse > 0) {
-            let k;
+        if (this._xyInUse >= numWrap) {
+            this.ensureCapacity(this._xyInUse + numWrap, false);
             for (let i = 0; i < numWrap; i++) {
-                k = 2 * i;
+                const k = 2 * i;
                 this.pushXY(this._data[k], this._data[k + 1]);
             }
         }
     }
     /** push a point given by x,y coordinates */
     pushXY(x, y) {
+        this.ensureCapacity(this._xyInUse + 1);
         const index = this._xyInUse * 2;
-        if (index >= this._data.length)
-            this.ensureCapacity(this.length === 0 ? 4 : this.length * 2);
         this._data[index] = x;
         this._data[index + 1] = y;
         this._xyInUse++;
     }
     /** Remove one point from the back.
      * * NOTE that (in the manner of std::vector native) this is "just" removing the point -- no point is NOT returned.
-     * * Use `back ()` to get the last x,y,z assembled into a `Point3d `
+     * * Use `back ()` to get the last x,y assembled into a `Point2d `
      */
     pop() {
         if (this._xyInUse > 0)
             this._xyInUse--;
     }
     /**
-     * Test if index is valid for an xyz (point or vector) within this array
-     * @param index xyz index to test.
+     * Test if index is valid for an xy (point or vector) within this array
+     * @param index xy index to test.
      */
     isIndexValid(index) {
         if (index >= this._xyInUse || index < 0)
@@ -171,7 +189,7 @@ export class GrowableXYArray extends IndexedXYCollection {
         return true;
     }
     /**
-     * Clear all xyz data, but leave capacity unchanged.
+     * Clear all xy data, but leave capacity unchanged.
      */
     clear() {
         this._xyInUse = 0;
@@ -210,18 +228,18 @@ export class GrowableXYArray extends IndexedXYCollection {
             result.push(Point2d.create(data[i], data[i + 1]));
         return result;
     }
-    /** copy xyz into strongly typed Point2d */
+    /** copy xy into strongly typed Point2d */
     getPoint2dAtCheckedPointIndex(pointIndex, result) {
-        const index = 2 * pointIndex;
         if (this.isIndexValid(pointIndex)) {
+            const index = 2 * pointIndex;
             return Point2d.create(this._data[index], this._data[index + 1], result);
         }
         return undefined;
     }
-    /** copy xyz into strongly typed Vector2d */
+    /** copy xy into strongly typed Vector2d */
     getVector2dAtCheckedVectorIndex(vectorIndex, result) {
-        const index = 2 * vectorIndex;
         if (this.isIndexValid(vectorIndex)) {
+            const index = 2 * vectorIndex;
             return Vector2d.create(this._data[index], this._data[index + 1], result);
         }
         return undefined;
@@ -239,7 +257,6 @@ export class GrowableXYArray extends IndexedXYCollection {
             const j = sourceIndex * 2;
             this._data[i] = source._data[j];
             this._data[i + 1] = source._data[j + 1];
-            this._data[i + 2] = source._data[j + 2];
             return true;
         }
         return false;
@@ -247,21 +264,19 @@ export class GrowableXYArray extends IndexedXYCollection {
     /**
      * push coordinates from the source array to the end of this array.
      * @param source source array
-     * @param sourceIndex xyz index within the source.  If undefined, push entire contents of source
-     * @returns true if sourceIndex is valid.
+     * @param sourceIndex xy index within the source.  If undefined, push entire contents of source
+     * @returns number of points pushed.
      */
     pushFromGrowableXYArray(source, sourceIndex) {
+        // full array push  . . .
         if (sourceIndex === undefined) {
-            const numPresent = this.length;
-            const numPush = source.length;
-            this.ensureCapacity(numPresent + numPush);
-            const numFloatPresent = 2 * numPresent;
-            const numFloatAdd = 2 * numPush;
-            for (let i = 0; i < numFloatAdd; i++)
-                this._data[numFloatPresent + i] = source._data[i];
-            this._xyInUse += numPush;
-            return numPush;
+            const numXYAdd = source.length;
+            this.ensureCapacity(this.length + numXYAdd, false);
+            this.copyData(source._data, numXYAdd, this.length);
+            this._xyInUse += numXYAdd;
+            return numXYAdd;
         }
+        // single point push . . .
         if (source.isIndexValid(sourceIndex)) {
             const j = sourceIndex * 2;
             this.pushXY(source._data[j], source._data[j + 1]);
@@ -275,29 +290,31 @@ export class GrowableXYArray extends IndexedXYCollection {
      */
     pushInterpolatedFromGrowableXYArray(source, i, fraction, j) {
         if (source.isIndexValid(i) && source.isIndexValid(j)) {
+            const fraction0 = 1.0 - fraction;
             const data = source._data;
-            i = 3 * i;
-            j = 3 * j;
-            this.pushXY(Geometry.interpolate(data[i], fraction, data[j]), Geometry.interpolate(data[i + 1], fraction, data[j + 1]));
+            i = 2 * i;
+            j = 2 * j;
+            this.pushXY(fraction0 * data[i] + fraction * data[j], fraction0 * data[i + 1] + fraction * data[j + 1]);
         }
     }
     /**
-     * push coordinates from the source array to the end of this array.
-     * @param source source array
-     * @param transform optional transform to apply to points.
+     * Create an array of xy points from source xyz points.
+     * @param source source array of xyz
+     * @param transform optional transform to apply to xyz points.
      * @param dest optional result.
      */
     static createFromGrowableXYZArray(source, transform, dest) {
-        const packedXYZ = source.float64Data();
-        const numXYZ = source.length; // this is in xyz points
-        const nDouble = 3 * numXYZ;
+        const numPoints = source.length;
         if (!dest)
-            dest = new GrowableXYArray(numXYZ);
-        dest.clear();
-        let x;
-        let y;
-        let z;
+            dest = new GrowableXYArray(numPoints);
+        else {
+            dest.ensureCapacity(numPoints, false);
+            dest.clear();
+        }
         if (transform) {
+            const packedXYZ = source.float64Data();
+            const nDouble = 3 * numPoints;
+            let x, y, z;
             for (let i = 0; i < nDouble; i += 3) {
                 x = packedXYZ[i];
                 y = packedXYZ[i + 1];
@@ -306,11 +323,7 @@ export class GrowableXYArray extends IndexedXYCollection {
             }
         }
         else {
-            for (let i = 0; i < nDouble; i += 3) {
-                x = packedXYZ[i];
-                y = packedXYZ[i + 1];
-                dest.pushXY(x, y);
-            }
+            dest.pushAllXYAndZ(source);
         }
         return dest;
     }
@@ -349,7 +362,7 @@ export class GrowableXYArray extends IndexedXYCollection {
      * @param x x coordinate
      * @param y y coordinate
      */
-    setXYZAtCheckedPointIndex(pointIndex, x, y) {
+    setXYAtCheckedPointIndex(pointIndex, x, y) {
         if (!this.isIndexValid(pointIndex))
             return false;
         const index = pointIndex * 2;
@@ -358,15 +371,21 @@ export class GrowableXYArray extends IndexedXYCollection {
         return true;
     }
     /**
-     * Copy all points into a simple array of Point3D with given z.
+     * Set the coordinates of a single point given as coordinates.
+     * @deprecated Use setXYAtCheckedPointIndex instead
+     */
+    setXYZAtCheckedPointIndex(pointIndex, x, y) {
+        return this.setXYAtCheckedPointIndex(pointIndex, x, y);
+    }
+    /**
+     * Copy all points into a simple array of Point3d with given z.
      */
     getPoint3dArray(z = 0) {
+        const n = 2 * this._xyInUse;
         const result = [];
         const data = this._data;
-        const n = this.length;
-        for (let i = 0; i < n; i++) {
-            result.push(Point3d.create(data[i * 2], data[i * 2 + 1], z));
-        }
+        for (let i = 0; i < n; i += 2)
+            result.push(Point3d.create(data[i], data[i + 1], z));
         return result;
     }
     /** reverse the order of points. */
@@ -398,21 +417,21 @@ export class GrowableXYArray extends IndexedXYCollection {
         const y0 = origin.y;
         let x = 0;
         let y = 0;
-        for (let i = 0; i + 2 <= nDouble; i += 2) {
+        for (let i = 0; i + 1 < nDouble; i += 2) {
             x = data[i];
             y = data[i + 1];
             data[i] = coffs[0] * x + coffs[1] * y + x0;
             data[i + 1] = coffs[3] * x + coffs[4] * y + y0;
         }
     }
-    /** multiply each xyz (as a vector) by matrix, replace values. */
+    /** multiply each xy (as a vector) by matrix, replace values. */
     multiplyMatrix3dInPlace(matrix) {
         const data = this._data;
         const nDouble = this.float64Length;
         const coffs = matrix.coffs;
         let x = 0;
         let y = 0;
-        for (let i = 0; i + 2 <= nDouble; i += 2) {
+        for (let i = 0; i + 1 < nDouble; i += 2) {
             x = data[i];
             y = data[i + 1];
             data[i] = coffs[0] * x + coffs[1] * y;
@@ -433,12 +452,11 @@ export class GrowableXYArray extends IndexedXYCollection {
         const y0 = origin.y;
         let x = 0;
         let y = 0;
-        for (let i = 0; i + 2 <= nDouble; i += 2) {
+        for (let i = 0; i + 1 < nDouble; i += 2) {
             x = data[i] - x0;
             y = data[i + 1] - y0;
             data[i] = coffs[0] * x + coffs[1] * y;
             data[i + 1] = coffs[3] * x + coffs[4] * y;
-            data[i + 2] = coffs[6] * x + coffs[7] * y;
         }
         return true;
     }
@@ -447,11 +465,11 @@ export class GrowableXYArray extends IndexedXYCollection {
         const numDouble = this.float64Length;
         const data = this._data;
         if (transform) {
-            for (let i = 0; i + 2 <= numDouble; i += 2)
+            for (let i = 0; i + 1 < numDouble; i += 2)
                 rangeToExtend.extendTransformedXY(transform, data[i], data[i + 1]);
         }
         else {
-            for (let i = 0; i + 2 <= numDouble; i += 2)
+            for (let i = 0; i + 1 < numDouble; i += 2)
                 rangeToExtend.extendXY(data[i], data[i + 1]);
         }
     }
@@ -465,7 +483,7 @@ export class GrowableXYArray extends IndexedXYCollection {
         return sum;
     }
     /**
-     * Multiply each x,y,z by the scale factor.
+     * Multiply each x,y by the scale factor.
      * @param factor
      */
     scaleInPlace(factor) {
@@ -525,21 +543,23 @@ export class GrowableXYArray extends IndexedXYCollection {
     }
     /** Compute the cross product of vectors from from indexed origin to indexed targets i and j */
     crossProductIndexIndexIndex(originIndex, targetAIndex, targetBIndex) {
-        const i = originIndex * 2;
-        const j = targetAIndex * 2;
-        const k = targetBIndex * 2;
-        const data = this._data;
-        if (this.isIndexValid(originIndex) && this.isIndexValid(targetAIndex) && this.isIndexValid(targetBIndex))
+        if (this.isIndexValid(originIndex) && this.isIndexValid(targetAIndex) && this.isIndexValid(targetBIndex)) {
+            const i = originIndex * 2;
+            const j = targetAIndex * 2;
+            const k = targetBIndex * 2;
+            const data = this._data;
             return Geometry.crossProductXYXY(data[j] - data[i], data[j + 1] - data[i + 1], data[k] - data[i], data[k + 1] - data[i + 1]);
+        }
         return undefined;
     }
     /** Compute the cross product of vectors from from origin to indexed targets i and j */
     crossProductXAndYIndexIndex(origin, targetAIndex, targetBIndex) {
-        const j = targetAIndex * 2;
-        const k = targetBIndex * 2;
-        const data = this._data;
-        if (this.isIndexValid(targetAIndex) && this.isIndexValid(targetBIndex))
+        if (this.isIndexValid(targetAIndex) && this.isIndexValid(targetBIndex)) {
+            const j = targetAIndex * 2;
+            const k = targetBIndex * 2;
+            const data = this._data;
             return Geometry.crossProductXYXY(data[j] - origin.x, data[j + 1] - origin.y, data[k] - origin.x, data[k + 1] - origin.y);
+        }
         return undefined;
     }
     /** Return the distance between two points in the array. */