@onerjs/core 8.55.8 → 8.56.1

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

@@ -81,7 +81,8 @@ declare enum PLYType {
     UINT = 2,
     DOUBLE = 3,
     UCHAR = 4,
-    UNDEFINED = 5
+    USHORT = 5,
+    UNDEFINED = 6
 }
 /**
  * Usage types of the PLY values

package/Meshes/GaussianSplatting/gaussianSplattingMeshBase.pure.js

@@ -10,7 +10,7 @@ import { RawTexture } from "../../Materials/Textures/rawTexture.js";
 import { MultiRenderTarget } from "../../Materials/Textures/multiRenderTarget.pure.js";
 import { Color4 } from "../../Maths/math.color.pure.js";
 
-import { ToHalfFloat } from "../../Misc/textureTools.js";
+import { FromHalfFloat, ToHalfFloat } from "../../Misc/textureTools.js";
 import { Scalar } from "../../Maths/math.scalar.js";
 import { runCoroutineSync, runCoroutineAsync, createYieldingScheduler } from "../../Misc/coroutine.js";
 import { EngineStore } from "../../Engines/engineStore.js";
@@ -69,7 +69,8 @@ var PLYType;
     PLYType[PLYType["UINT"] = 2] = "UINT";
     PLYType[PLYType["DOUBLE"] = 3] = "DOUBLE";
     PLYType[PLYType["UCHAR"] = 4] = "UCHAR";
-    PLYType[PLYType["UNDEFINED"] = 5] = "UNDEFINED";
+    PLYType[PLYType["USHORT"] = 5] = "USHORT";
+    PLYType[PLYType["UNDEFINED"] = 6] = "UNDEFINED";
 })(PLYType || (PLYType = {}));
 /**
  * Usage types of the PLY values
@@ -908,41 +909,46 @@ export class GaussianSplattingMeshBase extends Mesh {
             this._postToWorker(true);
             return false;
         }
-        // Before the first successful render, apply strict sort-state checks to ensure
-        // the first rendered frame uses correct splat ordering. Once the mesh has been
-        // rendered at least once, skip these checks — the render loop will continuously
-        // re-sort as the camera/world changes via _postToWorker() in render().
+        // Before the first successful render, require an applied index buffer. A pending refresh can
+        // use the latest completed buffer, otherwise a transform changed every frame would starve the
+        // first render. Once rendered, the render loop continuously re-sorts as the camera/world changes.
         if (!this._hasRenderedOnce && !this._disableDepthSort) {
             const cameras = this._scene.activeCameras?.length ? this._scene.activeCameras : [this._scene.activeCamera];
+            const canRenderWithPendingRefresh = this._scene._isInRenderingMeshEvaluation() && cameras.filter((camera) => camera !== null).length === 1;
             const worldMatrix = this.computeWorldMatrix(true);
-            let anyDirty = false;
+            let sortBufferMissing = false;
+            let sortRefreshPending = false;
+            let worldMatrixDirty = false;
             for (const camera of cameras) {
                 if (!camera) {
                     continue;
                 }
                 const cameraViewInfo = this._cameraViewInfos.get(camera.uniqueId);
-                if (!cameraViewInfo || !cameraViewInfo.splatIndexBufferSet) {
-                    anyDirty = true;
+                if (!cameraViewInfo || !cameraViewInfo.splatIndexBufferSet || cameraViewInfo.sortAppliedId === 0) {
+                    sortBufferMissing = true;
                     continue;
                 }
-                // Wait for the most recently requested sort to be applied so that the splat indices
-                // match the latest world/camera state.
                 if (cameraViewInfo.sortAppliedId !== cameraViewInfo.sortRequestId) {
-                    anyDirty = true;
+                    sortRefreshPending = true;
                     continue;
                 }
-                // If world matrix drifted (user applied transforms after load), re-sort before first render.
+                // If world matrix drifted (user applied transforms after load), request an updated sort.
                 // Camera drift is intentionally excluded here: checking camera movement would cause isReady()
                 // to return false indefinitely while the camera is moving. The render loop handles camera
                 // re-sorting continuously via _postToWorker() in render().
                 if (this._isSortStateDirty(cameraViewInfo, worldMatrix, camera, true)) {
-                    anyDirty = true;
+                    worldMatrixDirty = true;
                 }
             }
-            if (anyDirty) {
+            if (sortBufferMissing || sortRefreshPending || worldMatrixDirty) {
                 // Try to post any pending sort so subsequent polling iterations make progress.
                 this._postToWorker(true);
-                return false;
+                // A single-camera scene may use its latest completed sort while a transform refresh is
+                // pending, which prevents continuously changing transforms from starving the first render.
+                // Multi-camera scenes must wait because each viewport needs its own refreshed ordering.
+                if (sortBufferMissing || !canRenderWithPendingRefresh) {
+                    return false;
+                }
             }
         }
         // Attach the splat geometry to the GS top mesh so that the shadow generator (which renders
@@ -1089,10 +1095,15 @@ export class GaussianSplattingMeshBase extends Mesh {
                 this._cameraViewInfos.set(cameraId, newViewInfos);
             }
         });
-        // sort view infos: cameras without an initial splat-index buffer come first so they don't get starved
+        // Sort view infos: cameras without a completed initial sort come first so they don't get starved
         // by a `forced` re-sort of an already-initialized camera (which would consume `_canPostToWorker`).
+        // A camera can already have the shared index buffer bound when another camera's first sort resizes it,
+        // so splatIndexBufferSet alone does not mean this camera has received its own sorted result.
         // Among initialized cameras, the least recently updated comes first.
         activeViewInfos.sort((a, b) => {
+            if ((a.sortAppliedId === 0) !== (b.sortAppliedId === 0)) {
+                return a.sortAppliedId === 0 ? -1 : 1;
+            }
             if (a.splatIndexBufferSet !== b.splatIndexBufferSet) {
                 return a.splatIndexBufferSet ? 1 : -1;
             }
@@ -1223,8 +1234,11 @@ export class GaussianSplattingMeshBase extends Mesh {
                 return 3 /* PLYType.DOUBLE */;
             case "uchar":
                 return 4 /* PLYType.UCHAR */;
+            case "ushort":
+            case "uint16":
+                return 5 /* PLYType.USHORT */;
         }
-        return 5 /* PLYType.UNDEFINED */;
+        return 6 /* PLYType.UNDEFINED */;
     }
     static _ValueNameToEnum(name) {
         switch (name) {
@@ -1487,6 +1501,7 @@ export class GaussianSplattingMeshBase extends Mesh {
             float: 4,
             short: 2,
             ushort: 2,
+            uint16: 2,
             uchar: 1,
             list: 0,
         };
@@ -1703,6 +1718,9 @@ export class GaussianSplattingMeshBase extends Mesh {
                 case 4 /* PLYType.UCHAR */:
                     value = dataView.getUint8(offset.value + property.offset);
                     break;
+                case 5 /* PLYType.USHORT */:
+                    value = FromHalfFloat(dataView.getUint16(offset.value + property.offset, true));
+                    break;
                 default:
                     continue;
             }