@babylonjs/core 9.12.0 → 9.12.1

package/Meshes/GaussianSplatting/gaussianSplattingSortWorker.d.ts

@@ -0,0 +1,37 @@
+/** This file must only contain pure code and pure imports */
+/**
+ * Message commands exchanged with the Gaussian Splatting depth-sort worker. Every message carries a
+ * `command` field naming the intended work, instead of inferring it from which payload is present.
+ */
+export declare const GaussianSplattingSortWorkerCommand: {
+    /** Main -> worker: set the source splat centers (stride 4: xyz + 1). */
+    readonly POSITIONS: "positions";
+    /** Main -> worker: set the compound-mesh rig node matrices. */
+    readonly PART_MATRICES: "partMatrices";
+    /** Main -> worker: set the compound-mesh per-splat rig node indices. */
+    readonly PART_INDICES: "partIndices";
+    /** Main -> worker: set the active source-splat ranges (flat [start0, count0, ...]). */
+    readonly INTERVALS: "intervals";
+    /** Main -> worker: sort the active splats for a camera view. */
+    readonly SORT: "sort";
+    /** Worker -> main: a completed sort result. */
+    readonly SORTED: "sorted";
+};
+/**
+ * Depth-sort web worker body for Gaussian Splatting meshes.
+ *
+ * The function is self-contained: it is serialized with `Function.prototype.toString()` and run
+ * inside a `Blob`-backed `Worker`, so it must not reference anything from its enclosing module
+ * (including {@link GaussianSplattingSortWorkerCommand} — the command literals are duplicated here).
+ *
+ * The intended work for each message is selected explicitly via its `command` field:
+ * - `positions`    set source splat centers (stride 4: xyz + 1).
+ * - `partMatrices` set compound-mesh rig node matrices.
+ * - `partIndices`  set compound-mesh per-splat rig node indices.
+ * - `intervals`    set active source-splat ranges (flat [start0, count0, ...]); persisted across sorts.
+ * - `sort`         sort the active splats for `{ worldMatrix, cameraForward, cameraPosition, depthMix,
+ *                  cameraId, sortRequestId }` and post back a `sorted` result.
+ *
+ * @param self - the worker global scope
+ */
+export declare const GaussianSplattingSortWorker: (self: Worker) => void;

package/Meshes/GaussianSplatting/gaussianSplattingSortWorker.js

@@ -0,0 +1,160 @@
+/** This file must only contain pure code and pure imports */
+/**
+ * Message commands exchanged with the Gaussian Splatting depth-sort worker. Every message carries a
+ * `command` field naming the intended work, instead of inferring it from which payload is present.
+ */
+export const GaussianSplattingSortWorkerCommand = {
+    /** Main -> worker: set the source splat centers (stride 4: xyz + 1). */
+    POSITIONS: "positions",
+    /** Main -> worker: set the compound-mesh rig node matrices. */
+    PART_MATRICES: "partMatrices",
+    /** Main -> worker: set the compound-mesh per-splat rig node indices. */
+    PART_INDICES: "partIndices",
+    /** Main -> worker: set the active source-splat ranges (flat [start0, count0, ...]). */
+    INTERVALS: "intervals",
+    /** Main -> worker: sort the active splats for a camera view. */
+    SORT: "sort",
+    /** Worker -> main: a completed sort result. */
+    SORTED: "sorted",
+};
+/**
+ * Depth-sort web worker body for Gaussian Splatting meshes.
+ *
+ * The function is self-contained: it is serialized with `Function.prototype.toString()` and run
+ * inside a `Blob`-backed `Worker`, so it must not reference anything from its enclosing module
+ * (including {@link GaussianSplattingSortWorkerCommand} — the command literals are duplicated here).
+ *
+ * The intended work for each message is selected explicitly via its `command` field:
+ * - `positions`    set source splat centers (stride 4: xyz + 1).
+ * - `partMatrices` set compound-mesh rig node matrices.
+ * - `partIndices`  set compound-mesh per-splat rig node indices.
+ * - `intervals`    set active source-splat ranges (flat [start0, count0, ...]); persisted across sorts.
+ * - `sort`         sort the active splats for `{ worldMatrix, cameraForward, cameraPosition, depthMix,
+ *                  cameraId, sortRequestId }` and post back a `sorted` result.
+ *
+ * @param self - the worker global scope
+ */
+export const GaussianSplattingSortWorker = function (self) {
+    let positions;
+    let depthMix;
+    let indices;
+    let floatMix;
+    let partIndices;
+    let partMatrices;
+    // Active source-splat intervals as flat [start0, count0, start1, count1, ...]. Persisted between
+    // sort requests and refreshed by the main thread via the `intervals` message.
+    let intervals = null;
+    self.onmessage = (e) => {
+        // The intended work is selected explicitly via the message `command` field. These string
+        // literals must match GaussianSplattingSortWorkerCommand above (this body is serialized in
+        // isolation and cannot reference the shared constant).
+        const command = e.data.command;
+        if (command === "positions") {
+            positions = e.data.positions;
+        }
+        else if (command === "partMatrices") {
+            partMatrices = e.data.partMatrices;
+        }
+        else if (command === "partIndices") {
+            partIndices = e.data.partIndices;
+        }
+        else if (command === "intervals") {
+            intervals = e.data.intervals;
+        }
+        else if (command === "sort") {
+            const cameraId = e.data.cameraId;
+            const sortRequestId = e.data.sortRequestId;
+            const rangeVersion = e.data.rangeVersion;
+            const globalWorldMatrix = e.data.worldMatrix;
+            const cameraForward = e.data.cameraForward;
+            const cameraPosition = e.data.cameraPosition;
+            depthMix = e.data.depthMix;
+            if (!positions || !cameraForward) {
+                // Sort request arrived before positions were initialized — return the buffer unchanged so the main thread can unlock _canPostToWorker.
+                self.postMessage({ command: "sorted", depthMix, cameraId, sortRequestId, rangeVersion }, [depthMix.buffer]);
+                return;
+            }
+            // Resolve the active interval set. The main thread always sends an `intervals` message,
+            // but fall back to "all source splats" if a sort somehow arrives before it.
+            const activeIntervals = intervals;
+            let renderSplatCount = positions.length / 4;
+            if (activeIntervals) {
+                renderSplatCount = 0;
+                for (let rangeIndex = 1; rangeIndex < activeIntervals.length; rangeIndex += 2) {
+                    renderSplatCount += activeIntervals[rangeIndex];
+                }
+            }
+            const vertexCountPadded = Math.max((renderSplatCount + 15) & ~0xf, 16);
+            indices = new Uint32Array(depthMix.buffer);
+            floatMix = new Float32Array(depthMix.buffer);
+            // Build the compact list of source-splat indices to sort.
+            if (activeIntervals) {
+                let writeIndex = 0;
+                for (let rangeIndex = 0; rangeIndex < activeIntervals.length; rangeIndex += 2) {
+                    const start = activeIntervals[rangeIndex];
+                    const count = activeIntervals[rangeIndex + 1];
+                    for (let sourceIndex = start; sourceIndex < start + count; sourceIndex++) {
+                        indices[2 * writeIndex++] = sourceIndex;
+                    }
+                }
+                // Pad up to a multiple of 16 with an existing (back-to-front-harmless) source index.
+                for (; writeIndex < vertexCountPadded; writeIndex++) {
+                    indices[2 * writeIndex] = 0;
+                }
+            }
+            else {
+                for (let j = 0; j < vertexCountPadded; j++) {
+                    indices[2 * j] = j;
+                }
+            }
+            // depth = dot(cameraForward, worldPos - cameraPos)
+            const camDot = cameraForward[0] * cameraPosition[0] + cameraForward[1] * cameraPosition[1] + cameraForward[2] * cameraPosition[2];
+            const computeDepthCoeffs = (m) => {
+                return [
+                    cameraForward[0] * m[0] + cameraForward[1] * m[1] + cameraForward[2] * m[2],
+                    cameraForward[0] * m[4] + cameraForward[1] * m[5] + cameraForward[2] * m[6],
+                    cameraForward[0] * m[8] + cameraForward[1] * m[9] + cameraForward[2] * m[10],
+                    cameraForward[0] * m[12] + cameraForward[1] * m[13] + cameraForward[2] * m[14] - camDot,
+                ];
+            };
+            try {
+                if (partMatrices && partIndices) {
+                    // Precompute depth coefficients for each rig node
+                    const depthCoeffs = partMatrices.map((m) => computeDepthCoeffs(m));
+                    // NB: For performance reasons, we assume that part indices are valid
+                    const length = partIndices.length;
+                    for (let j = 0; j < vertexCountPadded; j++) {
+                        const sourceIndex = indices[2 * j];
+                        // NB: We need this 'min' because vertex array is padded, not partIndices
+                        const partIndex = partIndices[Math.min(sourceIndex, length - 1)];
+                        const coeff = depthCoeffs[partIndex];
+                        floatMix[2 * j + 1] =
+                            coeff[0] * positions[4 * sourceIndex + 0] + coeff[1] * positions[4 * sourceIndex + 1] + coeff[2] * positions[4 * sourceIndex + 2] + coeff[3];
+                        // instead of using minus to sort back to front, we use bitwise not operator to invert the order of indices
+                        // might not be faster but a minus sign implies a reference value that may not be enough and will decrease floatting precision
+                        indices[2 * j + 1] = ~indices[2 * j + 1];
+                    }
+                }
+                else {
+                    // Compute depth coefficients from global world matrix
+                    const [a, b, c, d] = computeDepthCoeffs(globalWorldMatrix);
+                    for (let j = 0; j < vertexCountPadded; j++) {
+                        const sourceIndex = indices[2 * j];
+                        floatMix[2 * j + 1] = a * positions[4 * sourceIndex + 0] + b * positions[4 * sourceIndex + 1] + c * positions[4 * sourceIndex + 2] + d;
+                        indices[2 * j + 1] = ~indices[2 * j + 1];
+                    }
+                }
+                depthMix.sort();
+            }
+            catch (sortError) {
+                // Transient data inconsistency (e.g. partIndices/partMatrices mismatch during addPart/removePart rebuild).
+                // Return the buffer unsorted so the main thread can unlock _canPostToWorker and retry next frame.
+                // Logger is unavailable inside the worker — console is the only option.
+                // eslint-disable-next-line no-console
+                console.error("Gaussian splat sort worker encountered an error (will retry next frame):", sortError);
+            }
+            self.postMessage({ command: "sorted", depthMix, cameraId, sortRequestId, rangeVersion }, [depthMix.buffer]);
+        }
+    };
+};
+//# sourceMappingURL=gaussianSplattingSortWorker.js.map

package/Meshes/GaussianSplatting/gaussianSplattingSortWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaussianSplattingSortWorker.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/GaussianSplatting/gaussianSplattingSortWorker.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type Nullable } from \"core/types\";\r\n\r\n/**\r\n * Message commands exchanged with the Gaussian Splatting depth-sort worker. Every message carries a\r\n * `command` field naming the intended work, instead of inferring it from which payload is present.\r\n */\r\nexport const GaussianSplattingSortWorkerCommand = {\r\n    /** Main -> worker: set the source splat centers (stride 4: xyz + 1). */\r\n    POSITIONS: \"positions\",\r\n    /** Main -> worker: set the compound-mesh rig node matrices. */\r\n    PART_MATRICES: \"partMatrices\",\r\n    /** Main -> worker: set the compound-mesh per-splat rig node indices. */\r\n    PART_INDICES: \"partIndices\",\r\n    /** Main -> worker: set the active source-splat ranges (flat [start0, count0, ...]). */\r\n    INTERVALS: \"intervals\",\r\n    /** Main -> worker: sort the active splats for a camera view. */\r\n    SORT: \"sort\",\r\n    /** Worker -> main: a completed sort result. */\r\n    SORTED: \"sorted\",\r\n} as const;\r\n\r\n/**\r\n * Depth-sort web worker body for Gaussian Splatting meshes.\r\n *\r\n * The function is self-contained: it is serialized with `Function.prototype.toString()` and run\r\n * inside a `Blob`-backed `Worker`, so it must not reference anything from its enclosing module\r\n * (including {@link GaussianSplattingSortWorkerCommand} — the command literals are duplicated here).\r\n *\r\n * The intended work for each message is selected explicitly via its `command` field:\r\n * - `positions`    set source splat centers (stride 4: xyz + 1).\r\n * - `partMatrices` set compound-mesh rig node matrices.\r\n * - `partIndices`  set compound-mesh per-splat rig node indices.\r\n * - `intervals`    set active source-splat ranges (flat [start0, count0, ...]); persisted across sorts.\r\n * - `sort`         sort the active splats for `{ worldMatrix, cameraForward, cameraPosition, depthMix,\r\n *                  cameraId, sortRequestId }` and post back a `sorted` result.\r\n *\r\n * @param self - the worker global scope\r\n */\r\nexport const GaussianSplattingSortWorker = function (self: Worker) {\r\n    let positions: Float32Array;\r\n    let depthMix: BigInt64Array;\r\n    let indices: Uint32Array;\r\n    let floatMix: Float32Array;\r\n    let partIndices: Uint8Array;\r\n    let partMatrices: Float32Array[];\r\n    // Active source-splat intervals as flat [start0, count0, start1, count1, ...]. Persisted between\r\n    // sort requests and refreshed by the main thread via the `intervals` message.\r\n    let intervals: Nullable<Uint32Array> = null;\r\n\r\n    self.onmessage = (e: any) => {\r\n        // The intended work is selected explicitly via the message `command` field. These string\r\n        // literals must match GaussianSplattingSortWorkerCommand above (this body is serialized in\r\n        // isolation and cannot reference the shared constant).\r\n        const command = e.data.command;\r\n        if (command === \"positions\") {\r\n            positions = e.data.positions;\r\n        } else if (command === \"partMatrices\") {\r\n            partMatrices = e.data.partMatrices;\r\n        } else if (command === \"partIndices\") {\r\n            partIndices = e.data.partIndices;\r\n        } else if (command === \"intervals\") {\r\n            intervals = e.data.intervals;\r\n        } else if (command === \"sort\") {\r\n            const cameraId = e.data.cameraId;\r\n            const sortRequestId = e.data.sortRequestId;\r\n            const rangeVersion = e.data.rangeVersion;\r\n            const globalWorldMatrix = e.data.worldMatrix;\r\n            const cameraForward = e.data.cameraForward;\r\n            const cameraPosition = e.data.cameraPosition;\r\n\r\n            depthMix = e.data.depthMix;\r\n\r\n            if (!positions || !cameraForward) {\r\n                // Sort request arrived before positions were initialized — return the buffer unchanged so the main thread can unlock _canPostToWorker.\r\n                self.postMessage({ command: \"sorted\", depthMix, cameraId, sortRequestId, rangeVersion }, [depthMix.buffer]);\r\n                return;\r\n            }\r\n\r\n            // Resolve the active interval set. The main thread always sends an `intervals` message,\r\n            // but fall back to \"all source splats\" if a sort somehow arrives before it.\r\n            const activeIntervals = intervals;\r\n            let renderSplatCount = positions.length / 4;\r\n            if (activeIntervals) {\r\n                renderSplatCount = 0;\r\n                for (let rangeIndex = 1; rangeIndex < activeIntervals.length; rangeIndex += 2) {\r\n                    renderSplatCount += activeIntervals[rangeIndex];\r\n                }\r\n            }\r\n            const vertexCountPadded = Math.max((renderSplatCount + 15) & ~0xf, 16);\r\n\r\n            indices = new Uint32Array(depthMix.buffer);\r\n            floatMix = new Float32Array(depthMix.buffer);\r\n\r\n            // Build the compact list of source-splat indices to sort.\r\n            if (activeIntervals) {\r\n                let writeIndex = 0;\r\n                for (let rangeIndex = 0; rangeIndex < activeIntervals.length; rangeIndex += 2) {\r\n                    const start = activeIntervals[rangeIndex];\r\n                    const count = activeIntervals[rangeIndex + 1];\r\n                    for (let sourceIndex = start; sourceIndex < start + count; sourceIndex++) {\r\n                        indices[2 * writeIndex++] = sourceIndex;\r\n                    }\r\n                }\r\n                // Pad up to a multiple of 16 with an existing (back-to-front-harmless) source index.\r\n                for (; writeIndex < vertexCountPadded; writeIndex++) {\r\n                    indices[2 * writeIndex] = 0;\r\n                }\r\n            } else {\r\n                for (let j = 0; j < vertexCountPadded; j++) {\r\n                    indices[2 * j] = j;\r\n                }\r\n            }\r\n\r\n            // depth = dot(cameraForward, worldPos - cameraPos)\r\n            const camDot = cameraForward[0] * cameraPosition[0] + cameraForward[1] * cameraPosition[1] + cameraForward[2] * cameraPosition[2];\r\n\r\n            const computeDepthCoeffs = (m: Float32Array): number[] => {\r\n                return [\r\n                    cameraForward[0] * m[0] + cameraForward[1] * m[1] + cameraForward[2] * m[2],\r\n                    cameraForward[0] * m[4] + cameraForward[1] * m[5] + cameraForward[2] * m[6],\r\n                    cameraForward[0] * m[8] + cameraForward[1] * m[9] + cameraForward[2] * m[10],\r\n                    cameraForward[0] * m[12] + cameraForward[1] * m[13] + cameraForward[2] * m[14] - camDot,\r\n                ];\r\n            };\r\n\r\n            try {\r\n                if (partMatrices && partIndices) {\r\n                    // Precompute depth coefficients for each rig node\r\n                    const depthCoeffs = partMatrices.map((m) => computeDepthCoeffs(m));\r\n\r\n                    // NB: For performance reasons, we assume that part indices are valid\r\n                    const length = partIndices.length;\r\n                    for (let j = 0; j < vertexCountPadded; j++) {\r\n                        const sourceIndex = indices[2 * j];\r\n                        // NB: We need this 'min' because vertex array is padded, not partIndices\r\n                        const partIndex = partIndices[Math.min(sourceIndex, length - 1)];\r\n                        const coeff = depthCoeffs[partIndex];\r\n                        floatMix[2 * j + 1] =\r\n                            coeff[0] * positions[4 * sourceIndex + 0] + coeff[1] * positions[4 * sourceIndex + 1] + coeff[2] * positions[4 * sourceIndex + 2] + coeff[3];\r\n                        // instead of using minus to sort back to front, we use bitwise not operator to invert the order of indices\r\n                        // might not be faster but a minus sign implies a reference value that may not be enough and will decrease floatting precision\r\n                        indices[2 * j + 1] = ~indices[2 * j + 1];\r\n                    }\r\n                } else {\r\n                    // Compute depth coefficients from global world matrix\r\n                    const [a, b, c, d] = computeDepthCoeffs(globalWorldMatrix);\r\n                    for (let j = 0; j < vertexCountPadded; j++) {\r\n                        const sourceIndex = indices[2 * j];\r\n                        floatMix[2 * j + 1] = a * positions[4 * sourceIndex + 0] + b * positions[4 * sourceIndex + 1] + c * positions[4 * sourceIndex + 2] + d;\r\n                        indices[2 * j + 1] = ~indices[2 * j + 1];\r\n                    }\r\n                }\r\n\r\n                depthMix.sort();\r\n            } catch (sortError) {\r\n                // Transient data inconsistency (e.g. partIndices/partMatrices mismatch during addPart/removePart rebuild).\r\n                // Return the buffer unsorted so the main thread can unlock _canPostToWorker and retry next frame.\r\n                // Logger is unavailable inside the worker — console is the only option.\r\n                // eslint-disable-next-line no-console\r\n                console.error(\"Gaussian splat sort worker encountered an error (will retry next frame):\", sortError);\r\n            }\r\n\r\n            self.postMessage({ command: \"sorted\", depthMix, cameraId, sortRequestId, rangeVersion }, [depthMix.buffer]);\r\n        }\r\n    };\r\n};\r\n"]}

package/Meshes/geometry.js

@@ -7,6 +7,7 @@ import { SceneLoaderFlags } from "../Loading/sceneLoaderFlags.js";
 import { BoundingInfo } from "../Culling/boundingInfo.js";
 
 import { Tools } from "../Misc/tools.pure.js";
+import { Logger } from "../Misc/logger.js";
 import { Tags } from "../Misc/tags.js";
 import { extractMinAndMax } from "../Maths/math.functions.js";
 import { EngineStore } from "../Engines/engineStore.js";
@@ -682,23 +683,37 @@ export class Geometry {
             return;
         }
         scene.addPendingData(this);
-        scene._loadFile(this.delayLoadingFile, (data) => {
-            if (!this._delayLoadingFunction) {
-                return;
-            }
-            this._delayLoadingFunction(JSON.parse(data), this);
-            this.delayLoadState = 1;
-            this._delayInfo = [];
-            scene.removePendingData(this);
-            const meshes = this._meshes;
-            const numOfMeshes = meshes.length;
-            for (let index = 0; index < numOfMeshes; index++) {
-                this._applyToMesh(meshes[index]);
+        void (async () => {
+            try {
+                const data = await scene._loadDelayedFileAsync(this.delayLoadingFile, false, true);
+                if (!this._delayLoadingFunction) {
+                    // The geometry was disposed while the load was in flight; still release the pending data so the scene can become ready.
+                    scene.removePendingData(this);
+                    return;
+                }
+                this._delayLoadingFunction(JSON.parse(data), this);
+                this.delayLoadState = 1;
+                this._delayInfo = [];
+                scene.removePendingData(this);
+                const meshes = this._meshes;
+                const numOfMeshes = meshes.length;
+                for (let index = 0; index < numOfMeshes; index++) {
+                    this._applyToMesh(meshes[index]);
+                }
+                if (onLoaded) {
+                    onLoaded();
+                }
             }
-            if (onLoaded) {
-                onLoaded();
+            catch (error) {
+                // Remove the pending data so the scene can still become ready.
+                // The state is intentionally left as LOADING so a persistently failing file is not re-fetched every frame.
+                scene.removePendingData(this);
+                // Don't log when the scene is being disposed: in-flight requests are aborted as part of normal teardown.
+                if (!scene.isDisposed) {
+                    Logger.Error(`Unable to delay load geometry "${this.id}" from "${this.delayLoadingFile}": ${error}`);
+                }
             }
-        }, undefined, true);
+        })();
     }
     /**
      * Invert the geometry to move from a right handed system to a left handed one.