@displayxr/inline3d 1.13.0 → 1.13.1

package/CHANGELOG.md

@@ -5,6 +5,24 @@ entry points (`.`, `./three`) are frozen for 1.x, while the **scene subpaths** (
 `./splat`, `./model`) are a preview tier whose options may change in any release. Entries below say
 which tier they touch, because that is what tells you whether an upgrade can move your pixels.
 
+## 1.13.1 — 2026-09-24
+
+Touches the **preview tier** (`./splat`, `engine: 'playcanvas'` only). No pixel change.
+
+### Fixed
+
+- **An asset kept re-rendering its work buffer, and re-sorting, every frame after any entity-scope
+  effect had ended**: the `wavefront` and `flip` transitions, a load-time `reveal`, a `setSource`
+  `reveal`, and `playEffect`/`setEffect` with `scope: 'entity'`. The effects runner ended an effect
+  with `workBufferUpdate = ONCE`. The engine's placement setter treats ONCE as a one-shot re-render
+  and never leaves ALWAYS, so the photo shown after a wavefront paid a full work-buffer copy, a CPU
+  sort and a 4.7 MB order-texture upload every frame until the next swap. Removal now sets AUTO,
+  then ONCE, for one clean re-render. Measured on an M1 (headless Chrome, 1,179,648 gaussians,
+  steady state after a `wavefront`, 3 runs): sorts went from 60/s (every frame) to 0. Main-thread
+  frame time at 4× CPU throttling went from 1.9–2.1 ms to 0.2–0.7 ms. GPU-synced frame time at 1×
+  went from 16.0 ms to 14.4–14.6 ms, the same as after a `crossfade` (14.3–14.7 ms), which never
+  had the bug.
+
 ## 1.13.0 — 2026-09-24
 
 Touches the **preview tier** (`./splat`, `engine: 'playcanvas'` only), additively. A page that

package/js/inline3d-playcanvas-engine.js

@@ -57,6 +57,7 @@ export {
   RenderTarget,
   FILTER_NEAREST,
   // splats
+  WORKBUFFER_UPDATE_AUTO,
   WORKBUFFER_UPDATE_ALWAYS,
   WORKBUFFER_UPDATE_ONCE,
   // tone mapping (TONE_MAPPINGS)

package/js/inline3d-splat-effects.js

@@ -1052,7 +1052,13 @@ export class SplatEffects {
       if ('workBufferUpdate' in g) g.workBufferUpdate = pc.WORKBUFFER_UPDATE_ALWAYS ?? 2;
     } else {
       g.setWorkBufferModifier?.(null);
-      if ('workBufferUpdate' in g) g.workBufferUpdate = pc.WORKBUFFER_UPDATE_ONCE ?? 1;
+      if ('workBufferUpdate' in g) {
+        // AUTO first: the engine's placement setter treats ONCE as a one-shot re-render and never
+        // leaves ALWAYS, so ONCE alone kept the asset re-rendering its work buffer (and re-sorting)
+        // every frame after its effect had ended.
+        g.workBufferUpdate = pc.WORKBUFFER_UPDATE_AUTO ?? 0;
+        g.workBufferUpdate = pc.WORKBUFFER_UPDATE_ONCE ?? 1;
+      }
       this.scopes.delete(key);
       this._installed.delete(key);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displayxr/inline3d",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Turn any HTML <canvas> into a glasses-free-3D window on a DisplayXR display, inside an ordinary web page. Dependency-free; progressive enhancement (falls back to plain 2D everywhere else).",
   "type": "module",
   "types": "./index.d.ts",