@onerjs/core 8.51.6 → 8.51.7

package/Meshes/GaussianSplatting/gaussianSplattingDebugger.pure.js

@@ -0,0 +1,257 @@
+/** This file must only contain pure code and pure imports */
+import { GaussianSplattingMaterial } from "../../Materials/GaussianSplatting/gaussianSplattingMaterial.pure.js";
+import { GaussianSplattingDebugMaterialPlugin } from "../../Materials/GaussianSplatting/gaussianSplattingDebugMaterialPlugin.pure.js";
+/**
+ * Manages debug rendering options across a set of Gaussian splat meshes.
+ * Create one instance, add meshes via addMesh(), then set options to apply
+ * them to every registered mesh simultaneously.
+ *
+ * All options default to their "off" states so there is no rendering cost
+ * until a feature is explicitly enabled.
+ *
+ * @example
+ * ```ts
+ * // Global options — applied to every registered mesh
+ * const gsDebugger = new GaussianSplattingDebugger();
+ * gsDebugger.addMesh(mesh1);
+ * gsDebugger.addMesh(compoundMesh); // compound mesh with multiple parts
+ * gsDebugger.clippingBox = { min: new Vector3(-2, -2, -2), max: new Vector3(2, 2, 2) };
+ * gsDebugger.shOrder1 = false;
+ *
+ * // Per-part override — saturate opacity on part 0 of the compound mesh only,
+ * // leaving all other parts (and mesh1) unaffected
+ * gsDebugger.setPartOptions(compoundMesh, 0, { opacitySaturate: true });
+ * // Later, restore part 0 to the global setting
+ * gsDebugger.clearPartOptions(compoundMesh, 0);
+ * ```
+ */
+export class GaussianSplattingDebugger {
+    constructor() {
+        this._plugins = [];
+        this._meshes = [];
+        this._disposeObservers = [];
+        // Cached option state so newly added meshes inherit current settings
+        this._clippingBox = null;
+        this._opacityCulling = null;
+        this._sizeCulling = null;
+        this._opacityScale = 1.0;
+        this._opacitySaturate = false;
+        this._shDc = true;
+        this._shOrder1 = true;
+        this._shOrder2 = true;
+        this._shOrder3 = true;
+        this._shOrder4 = true;
+    }
+    /**
+     * Adds a mesh to the debugger, attaching a debug plugin to its material.
+     * The mesh must already have a GaussianSplattingMaterial assigned (i.e., data
+     * must have been loaded at least once). Current option values are applied immediately.
+     * The mesh is automatically unregistered if it is disposed.
+     * @param mesh The mesh to register.
+     */
+    addMesh(mesh) {
+        if (this._meshes.indexOf(mesh) !== -1) {
+            return;
+        }
+        const mat = mesh.material;
+        if (!(mat instanceof GaussianSplattingMaterial)) {
+            throw new Error("GaussianSplattingDebugger.addMesh: mesh must have a GaussianSplattingMaterial.");
+        }
+        const plugin = new GaussianSplattingDebugMaterialPlugin(mat);
+        plugin.partCount = mesh.partCount ?? 0;
+        this._applyAllTo(plugin);
+        this._meshes.push(mesh);
+        this._plugins.push(plugin);
+        this._disposeObservers.push(mesh.onDisposeObservable.add(() => this.removeMesh(mesh)));
+    }
+    /**
+     * Removes a mesh and disposes its debug plugin.
+     * @param mesh The mesh to unregister.
+     */
+    removeMesh(mesh) {
+        const idx = this._meshes.indexOf(mesh);
+        if (idx === -1) {
+            return;
+        }
+        mesh.onDisposeObservable.remove(this._disposeObservers[idx]);
+        this._plugins[idx].dispose();
+        this._meshes.splice(idx, 1);
+        this._plugins.splice(idx, 1);
+        this._disposeObservers.splice(idx, 1);
+    }
+    /** Disposes all debug plugins and clears the mesh list. */
+    dispose() {
+        for (let i = 0; i < this._meshes.length; i++) {
+            this._meshes[i].onDisposeObservable.remove(this._disposeObservers[i]);
+            this._plugins[i].dispose();
+        }
+        this._meshes.length = 0;
+        this._plugins.length = 0;
+        this._disposeObservers.length = 0;
+    }
+    /**
+     * Returns the min/max size range of splats in a mesh.
+     * Convenience wrapper for GaussianSplattingMeshBase.splatSizeRange.
+     * @param mesh The mesh to query.
+     * @returns the splat size range, or null if not yet computed.
+     */
+    static GetSplatSizeRange(mesh) {
+        return mesh.splatSizeRange;
+    }
+    // ----- Option setters (broadcast to all plugins) -----
+    _applyAllTo(plugin) {
+        plugin.clippingBox = this._clippingBox;
+        plugin.opacityCulling = this._opacityCulling;
+        plugin.sizeCulling = this._sizeCulling;
+        plugin.opacityScale = this._opacityScale;
+        plugin.opacitySaturate = this._opacitySaturate;
+        plugin.shDc = this._shDc;
+        plugin.shOrder1 = this._shOrder1;
+        plugin.shOrder2 = this._shOrder2;
+        plugin.shOrder3 = this._shOrder3;
+        plugin.shOrder4 = this._shOrder4;
+    }
+    /**
+     * World-space axis-aligned clipping box. Splats outside are not rendered.
+     * Set to null to disable.
+     */
+    get clippingBox() {
+        return this._clippingBox;
+    }
+    set clippingBox(value) {
+        this._clippingBox = value;
+        for (const p of this._plugins) {
+            p.clippingBox = value;
+        }
+    }
+    /**
+     * Opacity culling range [0..1]. Splats outside this range are not rendered.
+     * Set to null to disable.
+     */
+    get opacityCulling() {
+        return this._opacityCulling;
+    }
+    set opacityCulling(value) {
+        this._opacityCulling = value;
+        for (const p of this._plugins) {
+            p.opacityCulling = value;
+        }
+    }
+    /**
+     * Size culling range. Size is pow(|det(Σ)|, 1/6) of the 3D covariance matrix,
+     * equal to the geometric mean of the principal radii. Splats outside this range are not rendered.
+     * Use GaussianSplattingDebugger.GetSplatSizeRange(mesh) to find an asset's range.
+     * Set to null to disable.
+     */
+    get sizeCulling() {
+        return this._sizeCulling;
+    }
+    set sizeCulling(value) {
+        this._sizeCulling = value;
+        for (const p of this._plugins) {
+            p.sizeCulling = value;
+        }
+    }
+    /** Scalar multiplier applied to every splat's opacity. 1.0 = no change. */
+    get opacityScale() {
+        return this._opacityScale;
+    }
+    set opacityScale(value) {
+        this._opacityScale = value;
+        for (const p of this._plugins) {
+            p.opacityScale = value;
+        }
+    }
+    /**
+     * When true, replaces the Gaussian spatial falloff with a flat uniform opacity,
+     * showing each splat as a solid disk.
+     */
+    get opacitySaturate() {
+        return this._opacitySaturate;
+    }
+    set opacitySaturate(value) {
+        this._opacitySaturate = value;
+        for (const p of this._plugins) {
+            p.opacitySaturate = value;
+        }
+    }
+    /** Include the DC (base) color from colorsTexture. Default: true. */
+    get shDc() {
+        return this._shDc;
+    }
+    set shDc(value) {
+        this._shDc = value;
+        for (const p of this._plugins) {
+            p.shDc = value;
+        }
+    }
+    /** Include SH band 1 contribution. Default: true. */
+    get shOrder1() {
+        return this._shOrder1;
+    }
+    set shOrder1(value) {
+        this._shOrder1 = value;
+        for (const p of this._plugins) {
+            p.shOrder1 = value;
+        }
+    }
+    /** Include SH band 2 contribution. Default: true. */
+    get shOrder2() {
+        return this._shOrder2;
+    }
+    set shOrder2(value) {
+        this._shOrder2 = value;
+        for (const p of this._plugins) {
+            p.shOrder2 = value;
+        }
+    }
+    /** Include SH band 3 contribution. Default: true. */
+    get shOrder3() {
+        return this._shOrder3;
+    }
+    set shOrder3(value) {
+        this._shOrder3 = value;
+        for (const p of this._plugins) {
+            p.shOrder3 = value;
+        }
+    }
+    /** Include SH band 4 contribution. Default: true. */
+    get shOrder4() {
+        return this._shOrder4;
+    }
+    set shOrder4(value) {
+        this._shOrder4 = value;
+        for (const p of this._plugins) {
+            p.shOrder4 = value;
+        }
+    }
+    // ----- Per-part API (compound meshes only) -----
+    /**
+     * Sets per-part debug overrides for a specific part of a compound mesh.
+     * The mesh must already be registered via addMesh(). Logs an error if the mesh
+     * is not compound (partCount is 0).
+     * @param mesh The compound mesh.
+     * @param partIndex The zero-based part index.
+     * @param options Partial set of debug options to override for this part.
+     */
+    setPartOptions(mesh, partIndex, options) {
+        const idx = this._meshes.indexOf(mesh);
+        if (idx < 0) {
+            return;
+        }
+        this._plugins[idx].setPartOptions(partIndex, options);
+    }
+    /**
+     * Clears all per-part debug overrides for a specific part, falling back to global settings.
+     * @param mesh The compound mesh.
+     * @param partIndex The zero-based part index.
+     */
+    clearPartOptions(mesh, partIndex) {
+        const idx = this._meshes.indexOf(mesh);
+        if (idx < 0) {
+            return;
+        }
+        this._plugins[idx].clearPartOptions(partIndex);
+    }
+}
+//# sourceMappingURL=gaussianSplattingDebugger.pure.js.map

package/Meshes/GaussianSplatting/gaussianSplattingDebugger.pure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaussianSplattingDebugger.pure.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/GaussianSplatting/gaussianSplattingDebugger.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\n\nimport { type Nullable } from \"../../types\";\nimport { type Observer } from \"../../Misc/observable\";\nimport { type Node } from \"../../node\";\nimport { type Vector3 } from \"../../Maths/math.vector\";\nimport { GaussianSplattingMaterial } from \"../../Materials/GaussianSplatting/gaussianSplattingMaterial.pure\";\nimport { GaussianSplattingDebugMaterialPlugin, type IGaussianSplattingDebugOptions } from \"../../Materials/GaussianSplatting/gaussianSplattingDebugMaterialPlugin.pure\";\nimport { type GaussianSplattingMeshBase } from \"./gaussianSplattingMeshBase.pure\";\n\n/**\n * Manages debug rendering options across a set of Gaussian splat meshes.\n * Create one instance, add meshes via addMesh(), then set options to apply\n * them to every registered mesh simultaneously.\n *\n * All options default to their \"off\" states so there is no rendering cost\n * until a feature is explicitly enabled.\n *\n * @example\n * ```ts\n * // Global options — applied to every registered mesh\n * const gsDebugger = new GaussianSplattingDebugger();\n * gsDebugger.addMesh(mesh1);\n * gsDebugger.addMesh(compoundMesh); // compound mesh with multiple parts\n * gsDebugger.clippingBox = { min: new Vector3(-2, -2, -2), max: new Vector3(2, 2, 2) };\n * gsDebugger.shOrder1 = false;\n *\n * // Per-part override — saturate opacity on part 0 of the compound mesh only,\n * // leaving all other parts (and mesh1) unaffected\n * gsDebugger.setPartOptions(compoundMesh, 0, { opacitySaturate: true });\n * // Later, restore part 0 to the global setting\n * gsDebugger.clearPartOptions(compoundMesh, 0);\n * ```\n */\nexport class GaussianSplattingDebugger {\n    private _plugins: GaussianSplattingDebugMaterialPlugin[] = [];\n    private _meshes: GaussianSplattingMeshBase[] = [];\n    private _disposeObservers: Observer<Node>[] = [];\n\n    // Cached option state so newly added meshes inherit current settings\n    private _clippingBox: Nullable<{ min: Vector3; max: Vector3 }> = null;\n    private _opacityCulling: Nullable<{ min: number; max: number }> = null;\n    private _sizeCulling: Nullable<{ min: number; max: number }> = null;\n    private _opacityScale: number = 1.0;\n    private _opacitySaturate: boolean = false;\n    private _shDc: boolean = true;\n    private _shOrder1: boolean = true;\n    private _shOrder2: boolean = true;\n    private _shOrder3: boolean = true;\n    private _shOrder4: boolean = true;\n\n    /**\n     * Adds a mesh to the debugger, attaching a debug plugin to its material.\n     * The mesh must already have a GaussianSplattingMaterial assigned (i.e., data\n     * must have been loaded at least once). Current option values are applied immediately.\n     * The mesh is automatically unregistered if it is disposed.\n     * @param mesh The mesh to register.\n     */\n    public addMesh(mesh: GaussianSplattingMeshBase): void {\n        if (this._meshes.indexOf(mesh) !== -1) {\n            return;\n        }\n        const mat = mesh.material;\n        if (!(mat instanceof GaussianSplattingMaterial)) {\n            throw new Error(\"GaussianSplattingDebugger.addMesh: mesh must have a GaussianSplattingMaterial.\");\n        }\n        const plugin = new GaussianSplattingDebugMaterialPlugin(mat);\n        plugin.partCount = (mesh as unknown as { partCount?: number }).partCount ?? 0;\n        this._applyAllTo(plugin);\n        this._meshes.push(mesh);\n        this._plugins.push(plugin);\n        this._disposeObservers.push(mesh.onDisposeObservable.add(() => this.removeMesh(mesh))!);\n    }\n\n    /**\n     * Removes a mesh and disposes its debug plugin.\n     * @param mesh The mesh to unregister.\n     */\n    public removeMesh(mesh: GaussianSplattingMeshBase): void {\n        const idx = this._meshes.indexOf(mesh);\n        if (idx === -1) {\n            return;\n        }\n        mesh.onDisposeObservable.remove(this._disposeObservers[idx]);\n        this._plugins[idx].dispose();\n        this._meshes.splice(idx, 1);\n        this._plugins.splice(idx, 1);\n        this._disposeObservers.splice(idx, 1);\n    }\n\n    /** Disposes all debug plugins and clears the mesh list. */\n    public dispose(): void {\n        for (let i = 0; i < this._meshes.length; i++) {\n            this._meshes[i].onDisposeObservable.remove(this._disposeObservers[i]);\n            this._plugins[i].dispose();\n        }\n        this._meshes.length = 0;\n        this._plugins.length = 0;\n        this._disposeObservers.length = 0;\n    }\n\n    /**\n     * Returns the min/max size range of splats in a mesh.\n     * Convenience wrapper for GaussianSplattingMeshBase.splatSizeRange.\n     * @param mesh The mesh to query.\n     * @returns the splat size range, or null if not yet computed.\n     */\n    public static GetSplatSizeRange(mesh: GaussianSplattingMeshBase): Nullable<{ min: number; max: number }> {\n        return mesh.splatSizeRange;\n    }\n\n    // ----- Option setters (broadcast to all plugins) -----\n\n    private _applyAllTo(plugin: GaussianSplattingDebugMaterialPlugin): void {\n        plugin.clippingBox = this._clippingBox;\n        plugin.opacityCulling = this._opacityCulling;\n        plugin.sizeCulling = this._sizeCulling;\n        plugin.opacityScale = this._opacityScale;\n        plugin.opacitySaturate = this._opacitySaturate;\n        plugin.shDc = this._shDc;\n        plugin.shOrder1 = this._shOrder1;\n        plugin.shOrder2 = this._shOrder2;\n        plugin.shOrder3 = this._shOrder3;\n        plugin.shOrder4 = this._shOrder4;\n    }\n\n    /**\n     * World-space axis-aligned clipping box. Splats outside are not rendered.\n     * Set to null to disable.\n     */\n    public get clippingBox(): Nullable<{ min: Vector3; max: Vector3 }> {\n        return this._clippingBox;\n    }\n    public set clippingBox(value: Nullable<{ min: Vector3; max: Vector3 }>) {\n        this._clippingBox = value;\n        for (const p of this._plugins) {\n            p.clippingBox = value;\n        }\n    }\n\n    /**\n     * Opacity culling range [0..1]. Splats outside this range are not rendered.\n     * Set to null to disable.\n     */\n    public get opacityCulling(): Nullable<{ min: number; max: number }> {\n        return this._opacityCulling;\n    }\n    public set opacityCulling(value: Nullable<{ min: number; max: number }>) {\n        this._opacityCulling = value;\n        for (const p of this._plugins) {\n            p.opacityCulling = value;\n        }\n    }\n\n    /**\n     * Size culling range. Size is pow(|det(Σ)|, 1/6) of the 3D covariance matrix,\n     * equal to the geometric mean of the principal radii. Splats outside this range are not rendered.\n     * Use GaussianSplattingDebugger.GetSplatSizeRange(mesh) to find an asset's range.\n     * Set to null to disable.\n     */\n    public get sizeCulling(): Nullable<{ min: number; max: number }> {\n        return this._sizeCulling;\n    }\n    public set sizeCulling(value: Nullable<{ min: number; max: number }>) {\n        this._sizeCulling = value;\n        for (const p of this._plugins) {\n            p.sizeCulling = value;\n        }\n    }\n\n    /** Scalar multiplier applied to every splat's opacity. 1.0 = no change. */\n    public get opacityScale(): number {\n        return this._opacityScale;\n    }\n    public set opacityScale(value: number) {\n        this._opacityScale = value;\n        for (const p of this._plugins) {\n            p.opacityScale = value;\n        }\n    }\n\n    /**\n     * When true, replaces the Gaussian spatial falloff with a flat uniform opacity,\n     * showing each splat as a solid disk.\n     */\n    public get opacitySaturate(): boolean {\n        return this._opacitySaturate;\n    }\n    public set opacitySaturate(value: boolean) {\n        this._opacitySaturate = value;\n        for (const p of this._plugins) {\n            p.opacitySaturate = value;\n        }\n    }\n\n    /** Include the DC (base) color from colorsTexture. Default: true. */\n    public get shDc(): boolean {\n        return this._shDc;\n    }\n    public set shDc(value: boolean) {\n        this._shDc = value;\n        for (const p of this._plugins) {\n            p.shDc = value;\n        }\n    }\n\n    /** Include SH band 1 contribution. Default: true. */\n    public get shOrder1(): boolean {\n        return this._shOrder1;\n    }\n    public set shOrder1(value: boolean) {\n        this._shOrder1 = value;\n        for (const p of this._plugins) {\n            p.shOrder1 = value;\n        }\n    }\n\n    /** Include SH band 2 contribution. Default: true. */\n    public get shOrder2(): boolean {\n        return this._shOrder2;\n    }\n    public set shOrder2(value: boolean) {\n        this._shOrder2 = value;\n        for (const p of this._plugins) {\n            p.shOrder2 = value;\n        }\n    }\n\n    /** Include SH band 3 contribution. Default: true. */\n    public get shOrder3(): boolean {\n        return this._shOrder3;\n    }\n    public set shOrder3(value: boolean) {\n        this._shOrder3 = value;\n        for (const p of this._plugins) {\n            p.shOrder3 = value;\n        }\n    }\n\n    /** Include SH band 4 contribution. Default: true. */\n    public get shOrder4(): boolean {\n        return this._shOrder4;\n    }\n    public set shOrder4(value: boolean) {\n        this._shOrder4 = value;\n        for (const p of this._plugins) {\n            p.shOrder4 = value;\n        }\n    }\n\n    // ----- Per-part API (compound meshes only) -----\n\n    /**\n     * Sets per-part debug overrides for a specific part of a compound mesh.\n     * The mesh must already be registered via addMesh(). Logs an error if the mesh\n     * is not compound (partCount is 0).\n     * @param mesh The compound mesh.\n     * @param partIndex The zero-based part index.\n     * @param options Partial set of debug options to override for this part.\n     */\n    public setPartOptions(mesh: GaussianSplattingMeshBase, partIndex: number, options: Partial<IGaussianSplattingDebugOptions>): void {\n        const idx = this._meshes.indexOf(mesh);\n        if (idx < 0) {\n            return;\n        }\n        this._plugins[idx].setPartOptions(partIndex, options);\n    }\n\n    /**\n     * Clears all per-part debug overrides for a specific part, falling back to global settings.\n     * @param mesh The compound mesh.\n     * @param partIndex The zero-based part index.\n     */\n    public clearPartOptions(mesh: GaussianSplattingMeshBase, partIndex: number): void {\n        const idx = this._meshes.indexOf(mesh);\n        if (idx < 0) {\n            return;\n        }\n        this._plugins[idx].clearPartOptions(partIndex);\n    }\n}\n"]}

package/Meshes/GaussianSplatting/gaussianSplattingMeshBase.pure.d.ts

@@ -256,6 +256,8 @@ export declare class GaussianSplattingMeshBase extends Mesh {
     protected _useRGBACovariants: boolean;
     private _material;
     private _tmpCovariances;
+    private _splatSizeMin;
+    private _splatSizeMax;
     private _sortIsDirty;
     protected _cachedBoundingMin: Nullable<Vector3>;
     protected _cachedBoundingMax: Nullable<Vector3>;
@@ -322,6 +324,15 @@ export declare class GaussianSplattingMeshBase extends Mesh {
      * Only available if the mesh was created with keepInRam: true
      */
     get shData(): Nullable<Uint8Array<ArrayBufferLike>[]>;
+    /**
+     * Returns the min/max size range of splats in this mesh, where size is pow(|det(Σ)|, 1/6)
+     * of the 3D covariance matrix — equivalent to the geometric mean of the principal radii.
+     * Computed automatically during updateData(). Returns null before any data has been loaded.
+     */
+    get splatSizeRange(): Nullable<{
+        min: number;
+        max: number;
+    }>;
     /**
      * Set the number of batch (a batch is 16384 splats) after which a display update is performed
      * A value of 0 (default) means display update will not happens before splat is ready.

package/Meshes/GaussianSplatting/gaussianSplattingMeshBase.pure.js

@@ -286,6 +286,17 @@ export class GaussianSplattingMeshBase extends Mesh {
     get shData() {
         return this._keepInRam ? this._shData : null;
     }
+    /**
+     * Returns the min/max size range of splats in this mesh, where size is pow(|det(Σ)|, 1/6)
+     * of the 3D covariance matrix — equivalent to the geometric mean of the principal radii.
+     * Computed automatically during updateData(). Returns null before any data has been loaded.
+     */
+    get splatSizeRange() {
+        if (!isFinite(this._splatSizeMin) || !isFinite(this._splatSizeMax)) {
+            return null;
+        }
+        return { min: this._splatSizeMin, max: this._splatSizeMax };
+    }
     /**
      * Gets the covariancesA texture
      */
@@ -449,6 +460,8 @@ export class GaussianSplattingMeshBase extends Mesh {
         this._useRGBACovariants = false;
         this._material = null;
         this._tmpCovariances = [0, 0, 0, 0, 0, 0];
+        this._splatSizeMin = Infinity;
+        this._splatSizeMax = -Infinity;
         this._sortIsDirty = false;
         // Cached bounding box for incremental addPart updates (O(1) vs O(N) scan of positions)
         this._cachedBoundingMin = null;
@@ -1712,6 +1725,20 @@ export class GaussianSplattingMeshBase extends Mesh {
         covA[dstIndex * 4 + 3] = ToHalfFloat(covariances[3] / transform);
         covB[dstIndex * covBSItemSize + 0] = ToHalfFloat(covariances[4] / transform);
         covB[dstIndex * covBSItemSize + 1] = ToHalfFloat(covariances[5] / transform);
+        const c0 = covariances[0];
+        const c1 = covariances[1];
+        const c2 = covariances[2];
+        const c3 = covariances[3];
+        const c4 = covariances[4];
+        const c5 = covariances[5];
+        const det3d = c0 * (c3 * c5 - c4 * c4) - c1 * (c1 * c5 - c4 * c2) + c2 * (c1 * c4 - c3 * c2);
+        const splatSize = Math.pow(Math.abs(det3d), 1.0 / 6.0);
+        if (splatSize < this._splatSizeMin) {
+            this._splatSizeMin = splatSize;
+        }
+        if (splatSize > this._splatSizeMax) {
+            this._splatSizeMax = splatSize;
+        }
         // colors
         colorArray[dstIndex * 4 + 0] = uBuffer[32 * srcIndex + 24 + 0];
         colorArray[dstIndex * 4 + 1] = uBuffer[32 * srcIndex + 24 + 1];
@@ -1932,6 +1959,10 @@ export class GaussianSplattingMeshBase extends Mesh {
         // GPU region untouched. Falls through to the full-rebuild path when textures don't exist yet
         // or the texture height needs to grow.
         const incremental = this._canReuseCachedData(previousVertexCount, vertexCount);
+        if (!incremental) {
+            this._splatSizeMin = Infinity;
+            this._splatSizeMax = -Infinity;
+        }
         // The first texture line/texel that must be (re-)processed and uploaded.
         // For a full rebuild this is 0. For an incremental update it is the row boundary just before
         // previousVertexCount so that any partial old row is re-processed as a complete row.