@onerjs/core 8.52.9 → 8.53.2

package/Meshes/GaussianSplatting/gaussianSplattingMeshBase.pure.js

@@ -187,6 +187,59 @@ var PLYValue;
     PLYValue[PLYValue["SH_71"] = 111] = "SH_71";
     PLYValue[PLYValue["UNDEFINED"] = 112] = "UNDEFINED";
 })(PLYValue || (PLYValue = {}));
+function _AcquireGsInterFrameYield(engine) {
+    // Browser-only optimization: wraps the global requestAnimationFrame, which
+    // doesn't exist on Babylon Native. Skip it there so the engine uses its
+    // default frame scheduling.
+    if (IsNative) {
+        return;
+    }
+    const existing = engine.customAnimationFrameRequester;
+    if (existing?._gsInterFrameYield) {
+        existing._refCount++;
+        return;
+    }
+    if (existing) {
+        // Slot is owned by another requester. Don't interfere.
+        return;
+    }
+    let _timeoutId = 0;
+    let _innerRafId = 0;
+    const wrapper = {
+        _gsInterFrameYield: true,
+        _refCount: 1,
+        requestAnimationFrame: (callback) => {
+            // Insert a setTimeout(0) to yield to the regular task queue (worker
+            // postMessage results, input events) before scheduling the next animation
+            // frame. Without this, a continuous rAF loop at high refresh rates leaves
+            // almost no time for regular tasks, starving worker messages for hundreds of ms.
+            _timeoutId = setTimeout(() => {
+                _innerRafId = requestAnimationFrame(callback);
+            }, 0);
+            return _timeoutId;
+        },
+        cancelAnimationFrame: (_id) => {
+            clearTimeout(_timeoutId);
+            if (_innerRafId > 0) {
+                cancelAnimationFrame(_innerRafId);
+            }
+            _timeoutId = 0;
+            _innerRafId = 0;
+        },
+    };
+    engine.customAnimationFrameRequester = wrapper;
+}
+// Counterpart to _AcquireGsInterFrameYield. Call once per mesh on dispose.
+function _ReleaseGsInterFrameYield(engine) {
+    const existing = engine.customAnimationFrameRequester;
+    if (!existing?._gsInterFrameYield) {
+        return;
+    }
+    existing._refCount--;
+    if (existing._refCount === 0) {
+        engine.customAnimationFrameRequester = null;
+    }
+}
 /**
  * Base class for Gaussian Splatting meshes. Contains all single-cloud rendering logic.
  * @internal Use GaussianSplattingMesh instead; this class is an internal implementation detail.
@@ -587,6 +640,7 @@ export class GaussianSplattingMeshBase extends Mesh {
         this.setEnabled(false);
         // webGL2 and webGPU support for RG texture with float16 is fine. not webGL1
         this._useRGBACovariants = !this.getEngine().isWebGPU && this.getEngine().version === 1.0;
+        _AcquireGsInterFrameYield(this.getEngine());
         this._keepInRam = keepInRam;
         if (url) {
             this._loadingPromise = this.loadFileAsync(url);
@@ -1693,6 +1747,7 @@ export class GaussianSplattingMeshBase extends Mesh {
         // Note: _splatsData and _shData are intentionally kept alive after dispose.
         // They can still be used as runtime source buffers by a compound mesh that retained
         // this mesh's data before disposal.
+        _ReleaseGsInterFrameYield(this.getEngine());
         this._worker?.terminate();
         this._worker = null;
         this.onPartCountChangedObservable.clear();