@ifc-lite/pointcloud 0.7.2 → 0.9.0

package/dist/formats/ply-fixed-binary.d.ts

@@ -0,0 +1,9 @@
+import type { PlyPropertyDecl } from './ply.js';
+interface FixedBinaryLayout {
+    count: number;
+    recordSize: number;
+    properties: PlyPropertyDecl[];
+}
+export declare function decodeFixedBinaryPlyBody(view: DataView, vertex: FixedBinaryLayout, positions: Float32Array, colors: Float32Array | undefined, normals: Float32Array | undefined, intensities: Uint16Array | undefined, littleEndian: boolean, originOffset?: readonly [number, number, number]): void;
+export {};
+//# sourceMappingURL=ply-fixed-binary.d.ts.map

package/dist/formats/ply-fixed-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-fixed-binary.d.ts","sourceRoot":"","sources":["../../src/formats/ply-fixed-binary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAClE,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,EACnE,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,EAC3D,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC/C,IAAI,CAmCN"}

package/dist/formats/ply-fixed-binary.js

@@ -0,0 +1,60 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export function decodeFixedBinaryPlyBody(view, vertex, positions, colors, normals, intensities, littleEndian, originOffset) {
+    const offX = originOffset?.[0] ?? 0;
+    const offY = originOffset?.[1] ?? 0;
+    const offZ = originOffset?.[2] ?? 0;
+    const find = (name) => vertex.properties.find((property) => property.name === name);
+    const xProp = find('x');
+    const yProp = find('y');
+    const zProp = find('z');
+    const rProp = colors ? find('red') ?? find('r') : undefined;
+    const gProp = colors ? find('green') ?? find('g') : undefined;
+    const bProp = colors ? find('blue') ?? find('b') : undefined;
+    const nxProp = normals ? find('nx') : undefined;
+    const nyProp = normals ? find('ny') : undefined;
+    const nzProp = normals ? find('nz') : undefined;
+    const iProp = intensities ? find('intensity') ?? find('scalar_Intensity') : undefined;
+    for (let i = 0; i < vertex.count; i++) {
+        const base = i * vertex.recordSize;
+        positions[i * 3] = readScalar(view, base + xProp.offset, xProp.type, littleEndian) - offX;
+        positions[i * 3 + 1] = readScalar(view, base + yProp.offset, yProp.type, littleEndian) - offY;
+        positions[i * 3 + 2] = readScalar(view, base + zProp.offset, zProp.type, littleEndian) - offZ;
+        if (colors && rProp && gProp && bProp) {
+            colors[i * 3] = readScalar(view, base + rProp.offset, rProp.type, littleEndian);
+            colors[i * 3 + 1] = readScalar(view, base + gProp.offset, gProp.type, littleEndian);
+            colors[i * 3 + 2] = readScalar(view, base + bProp.offset, bProp.type, littleEndian);
+        }
+        if (normals && nxProp && nyProp && nzProp) {
+            normals[i * 3] = readScalar(view, base + nxProp.offset, nxProp.type, littleEndian);
+            normals[i * 3 + 1] = readScalar(view, base + nyProp.offset, nyProp.type, littleEndian);
+            normals[i * 3 + 2] = readScalar(view, base + nzProp.offset, nzProp.type, littleEndian);
+        }
+        if (intensities && iProp) {
+            intensities[i] = Math.min(65535, Math.max(0, readScalar(view, base + iProp.offset, iProp.type, littleEndian) | 0));
+        }
+    }
+}
+function readScalar(view, offset, type, littleEndian) {
+    switch (type) {
+        case 'char':
+        case 'int8': return view.getInt8(offset);
+        case 'uchar':
+        case 'uint8': return view.getUint8(offset);
+        case 'short':
+        case 'int16': return view.getInt16(offset, littleEndian);
+        case 'ushort':
+        case 'uint16': return view.getUint16(offset, littleEndian);
+        case 'int':
+        case 'int32': return view.getInt32(offset, littleEndian);
+        case 'uint':
+        case 'uint32': return view.getUint32(offset, littleEndian);
+        case 'float':
+        case 'float32': return view.getFloat32(offset, littleEndian);
+        case 'double':
+        case 'float64': return view.getFloat64(offset, littleEndian);
+        default: throw new Error(`PLY: cannot read scalar of type "${type}"`);
+    }
+}
+//# sourceMappingURL=ply-fixed-binary.js.map

package/dist/formats/ply-fixed-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-fixed-binary.js","sourceRoot":"","sources":["../../src/formats/ply-fixed-binary.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAU/D,MAAM,UAAU,wBAAwB,CACtC,IAAc,EAAE,MAAyB,EAAE,SAAuB,EAClE,MAAgC,EAAE,OAAiC,EACnE,WAAoC,EAAE,YAAqB,EAC3D,YAAgD;IAEhD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QACnC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QAC1F,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9F,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9F,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACtC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAChF,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACpF,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACnF,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACvF,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc,EAAE,IAAY,EAAE,YAAqB;IACrF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QAAC,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,KAAK,OAAO,CAAC;QAAC,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzD,KAAK,OAAO,CAAC;QAAC,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACvE,KAAK,QAAQ,CAAC;QAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC1E,KAAK,KAAK,CAAC;QAAC,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC;QAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACxE,KAAK,OAAO,CAAC;QAAC,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3E,KAAK,QAAQ,CAAC;QAAC,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,GAAG,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/formats/ply-scalar.d.ts

@@ -0,0 +1,6 @@
+interface ScalarProperty {
+    type: string;
+}
+export declare function readPlyScalar(view: DataView, offset: number, prop: ScalarProperty, littleEndian: boolean): number;
+export {};
+//# sourceMappingURL=ply-scalar.d.ts.map

package/dist/formats/ply-scalar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-scalar.d.ts","sourceRoot":"","sources":["../../src/formats/ply-scalar.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IAAG,IAAI,EAAE,MAAM,CAAA;CAAE;AAEzC,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,OAAO,GACpB,MAAM,CAoBR"}

package/dist/formats/ply-scalar.js

@@ -0,0 +1,25 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export function readPlyScalar(view, offset, prop, littleEndian) {
+    switch (prop.type) {
+        case 'char':
+        case 'int8': return view.getInt8(offset);
+        case 'uchar':
+        case 'uint8': return view.getUint8(offset);
+        case 'short':
+        case 'int16': return view.getInt16(offset, littleEndian);
+        case 'ushort':
+        case 'uint16': return view.getUint16(offset, littleEndian);
+        case 'int':
+        case 'int32': return view.getInt32(offset, littleEndian);
+        case 'uint':
+        case 'uint32': return view.getUint32(offset, littleEndian);
+        case 'float':
+        case 'float32': return view.getFloat32(offset, littleEndian);
+        case 'double':
+        case 'float64': return view.getFloat64(offset, littleEndian);
+        default: throw new Error(`PLY: cannot read scalar of type "${prop.type}"`);
+    }
+}
+//# sourceMappingURL=ply-scalar.js.map

package/dist/formats/ply-scalar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-scalar.js","sourceRoot":"","sources":["../../src/formats/ply-scalar.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAI/D,MAAM,UAAU,aAAa,CAC3B,IAAc,EACd,MAAc,EACd,IAAoB,EACpB,YAAqB;IAErB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzD,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3D,KAAK,KAAK,CAAC;QACX,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3D,KAAK,OAAO,CAAC;QACb,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7D,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/formats/ply-variable-row.d.ts

@@ -0,0 +1,15 @@
+import type { PlyPropertyOrderEntry } from './ply.js';
+export declare function parseAsciiVariableRow(tokens: readonly string[], order: readonly PlyPropertyOrderEntry[], row: number): Map<string, number>;
+export declare function parseBinaryVariableRow(view: DataView, start: number, order: readonly PlyPropertyOrderEntry[], littleEndian: boolean, row: number): {
+    values: Map<string, number>;
+    end: number;
+};
+export interface VariablePlyOutputs {
+    positions: Float32Array;
+    colors?: Float32Array;
+    normals?: Float32Array;
+    intensities?: Uint16Array;
+    originOffset?: readonly [number, number, number];
+}
+export declare function writeVariablePlyRow(values: ReadonlyMap<string, number>, row: number, output: VariablePlyOutputs): void;
+//# sourceMappingURL=ply-variable-row.d.ts.map

package/dist/formats/ply-variable-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-variable-row.d.ts","sourceRoot":"","sources":["../../src/formats/ply-variable-row.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGtD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,qBAAqB,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAe1I;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,qBAAqB,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAkB/L;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAClG,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAmBtH"}

package/dist/formats/ply-variable-row.js

@@ -0,0 +1,66 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { readPlyScalar } from './ply-scalar.js';
+export function parseAsciiVariableRow(tokens, order, row) {
+    const values = new Map();
+    let cursor = 0;
+    for (const entry of order) {
+        if (entry.kind === 'scalar') {
+            if (cursor >= tokens.length)
+                throw new Error(`PLY ascii: vertex row ${row + 1} is missing property ${entry.property.name}`);
+            values.set(entry.property.name, Number(tokens[cursor++]));
+            continue;
+        }
+        const count = Number(tokens[cursor++]);
+        if (!Number.isSafeInteger(count) || count < 0 || cursor + count > tokens.length)
+            throw new Error(`PLY ascii: vertex row ${row + 1} has an invalid ${entry.name} list`);
+        cursor += count;
+    }
+    if (cursor !== tokens.length)
+        throw new Error(`PLY ascii: vertex row ${row + 1} has unexpected trailing values`);
+    return values;
+}
+export function parseBinaryVariableRow(view, start, order, littleEndian, row) {
+    const values = new Map();
+    let cursor = start;
+    for (const entry of order) {
+        if (entry.kind === 'scalar') {
+            if (cursor + entry.property.size > view.byteLength)
+                throw new Error(`PLY binary: vertex row ${row + 1} is truncated`);
+            values.set(entry.property.name, readPlyScalar(view, cursor, entry.property, littleEndian));
+            cursor += entry.property.size;
+            continue;
+        }
+        if (cursor + entry.countSize > view.byteLength)
+            throw new Error(`PLY binary: vertex row ${row + 1} list count is truncated`);
+        const count = readPlyScalar(view, cursor, { type: entry.countType }, littleEndian);
+        cursor += entry.countSize;
+        const bytes = count * entry.itemSize;
+        if (!Number.isSafeInteger(count) || count < 0 || cursor + bytes > view.byteLength)
+            throw new Error(`PLY binary: vertex row ${row + 1} has an invalid ${entry.name} list`);
+        cursor += bytes;
+    }
+    return { values, end: cursor };
+}
+export function writeVariablePlyRow(values, row, output) {
+    const origin = output.originOffset ?? [0, 0, 0];
+    output.positions[row * 3] = (values.get('x') ?? Number.NaN) - origin[0];
+    output.positions[row * 3 + 1] = (values.get('y') ?? Number.NaN) - origin[1];
+    output.positions[row * 3 + 2] = (values.get('z') ?? Number.NaN) - origin[2];
+    if (output.colors) {
+        output.colors[row * 3] = values.get('red') ?? values.get('r') ?? Number.NaN;
+        output.colors[row * 3 + 1] = values.get('green') ?? values.get('g') ?? Number.NaN;
+        output.colors[row * 3 + 2] = values.get('blue') ?? values.get('b') ?? Number.NaN;
+    }
+    if (output.normals) {
+        output.normals[row * 3] = values.get('nx') ?? Number.NaN;
+        output.normals[row * 3 + 1] = values.get('ny') ?? Number.NaN;
+        output.normals[row * 3 + 2] = values.get('nz') ?? Number.NaN;
+    }
+    if (output.intensities) {
+        const value = values.get('intensity') ?? values.get('scalar_Intensity') ?? 0;
+        output.intensities[row] = Math.min(65535, Math.max(0, value | 0));
+    }
+}
+//# sourceMappingURL=ply-variable-row.js.map

package/dist/formats/ply-variable-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-variable-row.js","sourceRoot":"","sources":["../../src/formats/ply-variable-row.ts"],"names":[],"mappings":"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"}

package/dist/formats/ply.d.ts

@@ -7,23 +7,37 @@
  * meshes but not for the scan-style files this viewer ingests).
  *
  * Position fields (x/y/z) are required. RGB (r/g/b or red/green/blue,
- * uchar) and intensity (intensity, uchar/ushort/float) are optional and
- * surfaced when present. Returns a single `DecodedPointChunk` — large
- * .ply files (>25M points) get bounded by `streamPointCloud`'s memory
- * cap which downsamples upstream.
+ * uchar), complete source normals (nx/ny/nz) and intensity
+ * (intensity, uchar/ushort/float) are optional and surfaced when present.
+ * `decodePly` is the direct whole-buffer API. The canonical Open/Add path
+ * uses `PlyStreamingSource`, whose bounded decoder never allocates full-count
+ * channels before applying its host-selected stride.
  */
-import type { DecodedPointChunk } from '../types.js';
-interface PropertyDecl {
+import type { DecodedPointChunk, PointNormalState } from '../types.js';
+export interface PlyPropertyDecl {
     name: string;
     type: string;
     size: number;
     /** Byte offset within a single vertex record (binary mode only). */
     offset: number;
 }
-interface ElementDecl {
+export interface PlyListPropertyDecl {
+    kind: 'list';
+    name: string;
+    countType: string;
+    itemType: string;
+    countSize: number;
+    itemSize: number;
+}
+export type PlyPropertyOrderEntry = {
+    kind: 'scalar';
+    property: PlyPropertyDecl;
+} | PlyListPropertyDecl;
+export interface PlyElementDecl {
     name: string;
     count: number;
-    properties: PropertyDecl[];
+    properties: PlyPropertyDecl[];
+    propertyOrder: PlyPropertyOrderEntry[];
     /** Bytes per record (binary mode); unused for ascii. */
     recordSize: number;
     /**
@@ -33,15 +47,28 @@ interface ElementDecl {
      * decoders walk with a fixed stride.
      */
     hasListProperty: boolean;
+    listPropertyNames: string[];
 }
 export interface PlyHeader {
     format: 'ascii' | 'binary_little_endian' | 'binary_big_endian';
     version: string;
-    elements: ElementDecl[];
+    elements: PlyElementDecl[];
     /** Byte offset where the body data starts. */
     bodyOffset: number;
 }
 export declare function parsePlyHeader(buffer: Uint8Array): PlyHeader;
+export interface PlyVertexLayout {
+    vertex: PlyElementDecl;
+    xProp: PlyPropertyDecl;
+    yProp: PlyPropertyDecl;
+    zProp: PlyPropertyDecl;
+    nxProp?: PlyPropertyDecl;
+    nyProp?: PlyPropertyDecl;
+    nzProp?: PlyPropertyDecl;
+    normalState: PointNormalState;
+}
+/** Validate the fixed-row vertex schema shared by whole-file and streaming decode. */
+export declare function inspectPlyVertex(header: PlyHeader): PlyVertexLayout;
 export declare function decodePly(buffer: Uint8Array, 
 /**
  * Native (X, Y, Z)-axis offset subtracted from each decoded vertex in
@@ -51,5 +78,4 @@ export declare function decodePly(buffer: Uint8Array,
  * byte-for-byte.
  */
 originOffset?: readonly [number, number, number]): DecodedPointChunk;
-export {};
 //# sourceMappingURL=ply.d.ts.map

package/dist/formats/ply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ply.d.ts","sourceRoot":"","sources":["../../src/formats/ply.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAWrE,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAwF5D;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU;AAClB;;;;;;GAMG;AACH,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC/C,iBAAiB,CA8FnB"}
+{"version":3,"file":"ply.d.ts","sourceRoot":"","sources":["../../src/formats/ply.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAavF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAAG,mBAAmB,CAAC;AAExG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAiG5D;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IACvE,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAC7E,WAAW,EAAE,gBAAgB,CAAC;CAC/B;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAqBnE;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU;AAClB;;;;;;GAMG;AACH,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC/C,iBAAiB,CAiFnB"}

package/dist/formats/ply.js

@@ -2,6 +2,8 @@
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
 import { normalizePlyColors } from './ply-color.js';
+import { parseAsciiVariableRow, parseBinaryVariableRow, writeVariablePlyRow } from './ply-variable-row.js';
+import { decodeFixedBinaryPlyBody } from './ply-fixed-binary.js';
 /** Name → byte size for the PLY-defined scalar types. */
 const TYPE_SIZES = {
     char: 1, int8: 1, uchar: 1, uint8: 1,
@@ -65,8 +67,10 @@ export function parsePlyHeader(buffer) {
                 name: parts[1],
                 count: parseInt(parts[2], 10),
                 properties: [],
+                propertyOrder: [],
                 recordSize: 0,
                 hasListProperty: false,
+                listPropertyNames: [],
             };
             elements.push(current);
             continue;
@@ -80,7 +84,13 @@ export function parsePlyHeader(buffer) {
             // fact and skip them — harmless on elements we never decode, rejected
             // for the vertex element in decodePly.
             if (parts[1] === 'list') {
+                const countType = parts[2], itemType = parts[3], name = parts[4];
+                const countSize = TYPE_SIZES[countType], itemSize = TYPE_SIZES[itemType];
+                if (!name || countSize === undefined || itemSize === undefined)
+                    throw new Error(`PLY: invalid list property declaration "${line}"`);
                 current.hasListProperty = true;
+                current.listPropertyNames.push(name);
+                current.propertyOrder.push({ kind: 'list', name, countType, itemType, countSize, itemSize });
                 continue;
             }
             const type = parts[1];
@@ -89,7 +99,9 @@ export function parsePlyHeader(buffer) {
             if (size === undefined) {
                 throw new Error(`PLY: unknown property type "${type}"`);
             }
-            current.properties.push({ name, type, size, offset: current.recordSize });
+            const property = { name, type, size, offset: current.recordSize };
+            current.properties.push(property);
+            current.propertyOrder.push({ kind: 'scalar', property });
             current.recordSize += size;
             continue;
         }
@@ -101,6 +113,32 @@ export function parsePlyHeader(buffer) {
     }
     return { format, version, elements, bodyOffset };
 }
+/** Validate the fixed-row vertex schema shared by whole-file and streaming decode. */
+export function inspectPlyVertex(header) {
+    const vertex = header.elements.find((element) => element.name === 'vertex');
+    if (!vertex)
+        throw new Error('PLY: no vertex element');
+    if (header.elements[0] !== vertex) {
+        throw new Error(`PLY: vertex element must appear first; saw "${header.elements[0]?.name}" first`);
+    }
+    const normalNames = new Set(['nx', 'ny', 'nz']);
+    const one = (name) => {
+        const matches = vertex.properties.filter((property) => property.name === name);
+        if (matches.length > 1)
+            throw new Error(`PLY: vertex property "${name}" must not be declared more than once`);
+        return matches[0];
+    };
+    const xProp = one('x'), yProp = one('y'), zProp = one('z');
+    if (!xProp || !yProp || !zProp)
+        throw new Error('PLY: vertex element must define x, y, z properties');
+    const normalProps = (name) => vertex.properties.filter((property) => property.name === name);
+    const nx = normalProps('nx'), ny = normalProps('ny'), nz = normalProps('nz');
+    const declared = nx.length + ny.length + nz.length + vertex.listPropertyNames.filter((name) => normalNames.has(name)).length;
+    const complete = declared === 3 && nx.length === 1 && ny.length === 1 && nz.length === 1;
+    return { vertex, xProp, yProp, zProp, nxProp: complete ? nx[0] : undefined,
+        nyProp: complete ? ny[0] : undefined, nzProp: complete ? nz[0] : undefined,
+        normalState: declared === 0 ? 'absent' : complete ? 'supplied' : 'invalid' };
+}
 export function decodePly(buffer, 
 /**
  * Native (X, Y, Z)-axis offset subtracted from each decoded vertex in
@@ -111,32 +149,13 @@ export function decodePly(buffer,
  */
 originOffset) {
     const header = parsePlyHeader(buffer);
-    const vertex = header.elements.find((e) => e.name === 'vertex');
-    if (!vertex)
-        throw new Error('PLY: no vertex element');
-    // Both decoders start at header.bodyOffset, so vertex MUST be the first
-    // element. Files that declare another element first would silently
-    // produce garbage point data otherwise. Reject deterministically.
-    if (header.elements[0] !== vertex) {
-        throw new Error(`PLY: vertex element must appear first; saw "${header.elements[0]?.name}" first`);
-    }
-    // A list property on the vertex element makes its records variable length:
-    // `recordSize` (binary stride) and the ascii column map would both drift and
-    // silently read garbage. Reject up front; list properties on OTHER elements
-    // (face indices) stay fine because those elements are never decoded.
-    if (vertex.hasListProperty) {
-        throw new Error('PLY: list-valued properties on the vertex element are not supported (variable-length records)');
-    }
-    const xProp = vertex.properties.find((p) => p.name === 'x');
-    const yProp = vertex.properties.find((p) => p.name === 'y');
-    const zProp = vertex.properties.find((p) => p.name === 'z');
-    if (!xProp || !yProp || !zProp) {
-        throw new Error('PLY: vertex element must define x, y, z properties');
-    }
+    const layout = inspectPlyVertex(header);
+    const { vertex } = layout;
     const rProp = vertex.properties.find((p) => p.name === 'red' || p.name === 'r');
     const gProp = vertex.properties.find((p) => p.name === 'green' || p.name === 'g');
     const bProp = vertex.properties.find((p) => p.name === 'blue' || p.name === 'b');
     const hasRgb = !!(rProp && gProp && bProp);
+    const { nxProp, nyProp, nzProp } = layout;
     const intensityProp = vertex.properties.find((p) => p.name === 'intensity' || p.name === 'scalar_Intensity');
     const count = vertex.count;
     if (!Number.isFinite(count) || count < 0) {
@@ -163,12 +182,34 @@ originOffset) {
     }
     const positions = new Float32Array(count * 3);
     const colors = hasRgb ? new Float32Array(count * 3) : undefined;
+    const normals = nxProp && nyProp && nzProp ? new Float32Array(count * 3) : undefined;
     const intensities = intensityProp ? new Uint16Array(count) : undefined;
     if (header.format === 'ascii') {
-        decodeAsciiBody(buffer, header, vertex, positions, colors, intensities, originOffset);
+        if (vertex.hasListProperty) {
+            const lines = TEXT_DECODER.decode(buffer.subarray(header.bodyOffset)).split(/\r?\n/).filter(line => line.trim());
+            if (lines.length < count)
+                throw new Error(`PLY ascii: expected ${count} vertex lines, got ${lines.length}`);
+            for (let row = 0; row < count; row++)
+                writeVariablePlyRow(parseAsciiVariableRow(lines[row].trim().split(/\s+/), vertex.propertyOrder, row), row, { positions, colors, normals, intensities, originOffset });
+        }
+        else
+            decodeAsciiBody(buffer, header, vertex, positions, colors, normals, intensities, originOffset);
     }
     else {
-        decodeBinaryBody(buffer, header, vertex, positions, colors, intensities, header.format === 'binary_little_endian', originOffset);
+        const littleEndian = header.format === 'binary_little_endian';
+        if (vertex.hasListProperty) {
+            const view = new DataView(buffer.buffer, buffer.byteOffset + header.bodyOffset, buffer.length - header.bodyOffset);
+            let cursor = 0;
+            for (let row = 0; row < count; row++) {
+                const parsed = parseBinaryVariableRow(view, cursor, vertex.propertyOrder, littleEndian, row);
+                writeVariablePlyRow(parsed.values, row, { positions, colors, normals, intensities, originOffset });
+                cursor = parsed.end;
+            }
+        }
+        else {
+            const view = new DataView(buffer.buffer, buffer.byteOffset + header.bodyOffset, count * vertex.recordSize);
+            decodeFixedBinaryPlyBody(view, vertex, positions, colors, normals, intensities, littleEndian, originOffset);
+        }
     }
     if (colors && rProp && gProp && bProp) {
         normalizePlyColors(colors, [rProp.type, gProp.type, bProp.type]);
@@ -176,13 +217,20 @@ originOffset) {
     return {
         positions,
         colors,
+        normals,
+        normalState: normals && normals.every(Number.isFinite) && everyNormalNonzero(normals) ? 'supplied' : layout.normalState === 'supplied' ? 'invalid' : layout.normalState,
         intensities,
         pointCount: count,
         bbox: computeBBox(positions),
     };
 }
-// ─── ascii body ─────────────────────────────────────────────────────────────
-function decodeAsciiBody(buffer, header, vertex, positions, colors, intensities, originOffset) {
+function everyNormalNonzero(normals) {
+    for (let i = 0; i < normals.length; i += 3)
+        if (normals[i] ** 2 + normals[i + 1] ** 2 + normals[i + 2] ** 2 === 0)
+            return false;
+    return true;
+}
+function decodeAsciiBody(buffer, header, vertex, positions, colors, normals, intensities, originOffset) {
     // Decode just the vertex part of the body (other elements come after).
     // For ascii, each line = one vertex (in the order properties were
     // declared).
@@ -196,6 +244,9 @@ function decodeAsciiBody(buffer, header, vertex, positions, colors, intensities,
     const rCol = vertex.properties.findIndex((p) => p.name === 'red' || p.name === 'r');
     const gCol = vertex.properties.findIndex((p) => p.name === 'green' || p.name === 'g');
     const bCol = vertex.properties.findIndex((p) => p.name === 'blue' || p.name === 'b');
+    const nxCol = vertex.properties.findIndex((p) => p.name === 'nx');
+    const nyCol = vertex.properties.findIndex((p) => p.name === 'ny');
+    const nzCol = vertex.properties.findIndex((p) => p.name === 'nz');
     const iCol = vertex.properties.findIndex((p) => p.name === 'intensity' || p.name === 'scalar_Intensity');
     let lineStart = 0;
     let written = 0;
@@ -216,6 +267,11 @@ function decodeAsciiBody(buffer, header, vertex, positions, colors, intensities,
             colors[written * 3 + 1] = Number(parts[gCol]);
             colors[written * 3 + 2] = Number(parts[bCol]);
         }
+        if (normals) {
+            normals[written * 3] = Number(parts[nxCol]);
+            normals[written * 3 + 1] = Number(parts[nyCol]);
+            normals[written * 3 + 2] = Number(parts[nzCol]);
+        }
         if (intensities && iCol >= 0) {
             intensities[written] = Math.min(65535, Math.max(0, Number(parts[iCol]) | 0));
         }
@@ -225,62 +281,6 @@ function decodeAsciiBody(buffer, header, vertex, positions, colors, intensities,
         throw new Error(`PLY ascii: expected ${vertex.count} vertex lines, got ${written}`);
     }
 }
-// ─── binary body ────────────────────────────────────────────────────────────
-function decodeBinaryBody(buffer, header, vertex, positions, colors, intensities, littleEndian, originOffset) {
-    const stride = vertex.recordSize;
-    const need = vertex.count * stride;
-    if (buffer.length < header.bodyOffset + need) {
-        throw new Error(`PLY binary: expected ${need} body bytes, got ${buffer.length - header.bodyOffset}`);
-    }
-    const view = new DataView(buffer.buffer, buffer.byteOffset + header.bodyOffset, need);
-    const offX = originOffset?.[0] ?? 0;
-    const offY = originOffset?.[1] ?? 0;
-    const offZ = originOffset?.[2] ?? 0;
-    const xProp = vertex.properties.find((p) => p.name === 'x');
-    const yProp = vertex.properties.find((p) => p.name === 'y');
-    const zProp = vertex.properties.find((p) => p.name === 'z');
-    const rProp = colors ? vertex.properties.find((p) => p.name === 'red' || p.name === 'r') : undefined;
-    const gProp = colors ? vertex.properties.find((p) => p.name === 'green' || p.name === 'g') : undefined;
-    const bProp = colors ? vertex.properties.find((p) => p.name === 'blue' || p.name === 'b') : undefined;
-    const iProp = intensities
-        ? vertex.properties.find((p) => p.name === 'intensity' || p.name === 'scalar_Intensity')
-        : undefined;
-    for (let i = 0; i < vertex.count; i++) {
-        const base = i * stride;
-        positions[i * 3] = readScalar(view, base + xProp.offset, xProp, littleEndian) - offX;
-        positions[i * 3 + 1] = readScalar(view, base + yProp.offset, yProp, littleEndian) - offY;
-        positions[i * 3 + 2] = readScalar(view, base + zProp.offset, zProp, littleEndian) - offZ;
-        if (colors && rProp && gProp && bProp) {
-            colors[i * 3] = readScalar(view, base + rProp.offset, rProp, littleEndian);
-            colors[i * 3 + 1] = readScalar(view, base + gProp.offset, gProp, littleEndian);
-            colors[i * 3 + 2] = readScalar(view, base + bProp.offset, bProp, littleEndian);
-        }
-        if (intensities && iProp) {
-            intensities[i] = Math.min(65535, Math.max(0, readScalar(view, base + iProp.offset, iProp, littleEndian) | 0));
-        }
-    }
-}
-function readScalar(view, offset, prop, le) {
-    switch (prop.type) {
-        case 'char':
-        case 'int8': return view.getInt8(offset);
-        case 'uchar':
-        case 'uint8': return view.getUint8(offset);
-        case 'short':
-        case 'int16': return view.getInt16(offset, le);
-        case 'ushort':
-        case 'uint16': return view.getUint16(offset, le);
-        case 'int':
-        case 'int32': return view.getInt32(offset, le);
-        case 'uint':
-        case 'uint32': return view.getUint32(offset, le);
-        case 'float':
-        case 'float32': return view.getFloat32(offset, le);
-        case 'double':
-        case 'float64': return view.getFloat64(offset, le);
-        default: throw new Error(`PLY: cannot read scalar of type "${prop.type}"`);
-    }
-}
 function computeBBox(positions) {
     let minX = Infinity, minY = Infinity, minZ = Infinity;
     let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity;