@displayxr/inline3d 1.25.0 → 1.25.1

package/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.25.1 — 2026-09-25
+
+Touches the **preview tier** (`./splat`, `engine: 'playcanvas'` only). Additive; nothing changes
+for a page that does not call it.
+
+- **`handle.setRenderScale(s)`** changes the per-eye buffer scale (the `renderScale` option) live,
+  in (0, 4], and resizes the backing store on the next animation frame; **`handle.renderScale`**
+  reads it back. For an app whose screens differ: full resolution where the splat is hidden and
+  only stage quads draw, a lower scale where a large splat is on screen. Replaces poking the
+  viewer's internal field.
+
 ## 1.25.0 — 2026-09-25
 
 Touches the **preview tier** (a new subpath, `./player`) and the **core** (`.`, frozen tier): new

package/js/inline3d-splat-playcanvas.js

@@ -2981,6 +2981,9 @@ export function attachPlayCanvasSplat(out, wall, canvas, src, opts, pending = []
   let cancelPendingVideo = null;
   let warnedAutoplayMuted = false;
 
+  // The current per-eye buffer scale (the `renderScale` option, or the last setRenderScale). A
+  // real accessor: Object.assign below would copy a getter's value once.
+  Object.defineProperty(out, 'renderScale', { get: () => viewer.renderScale, enumerable: true, configurable: true });
   Object.assign(out, {
     backend: 'playcanvas',
     engine: null, // { app, root, camera } once the engine has booted — see below
@@ -3065,6 +3068,21 @@ export function attachPlayCanvasSplat(out, wall, canvas, src, opts, pending = []
       layerRigs().set(layer, r.rig, r.opts);
       return out;
     },
+    /**
+     * Change the per-eye buffer scale live (the `renderScale` option): e.g. full resolution on a
+     * screen that hides the splat and draws only stage quads, 0.6 elsewhere. The backing store is
+     * resized on the next animation frame (never mid-frame). Returns the handle.
+     */
+    setRenderScale(s) {
+      if (typeof s !== 'number' || !Number.isFinite(s) || s <= 0 || s > 4) {
+        throw new RangeError('@displayxr/inline3d/splat: setRenderScale takes a number in (0, 4].');
+      }
+      if (viewer.renderScale !== s) {
+        viewer.renderScale = s;
+        viewer._scheduleResize();
+      }
+      return out;
+    },
     /** Change the layer rig's tile-wide options live (no layer change): merge, `null` clears. */
     setLayerRigOptions(o = {}) {
       layerRigs().setOptions(validateLayerRigOptions(o, 'setLayerRigOptions'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displayxr/inline3d",
-  "version": "1.25.0",
+  "version": "1.25.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",

package/splat.d.ts

@@ -994,6 +994,14 @@ export interface SplatHandle {
    * `?dxrdiag=nolayerrig`. Callable before `ready`. docs/proposals/layer-display-rig.md.
    */
   setLayerRig(layer: string | number | { id: number }, rig: 'display' | 'camera', opts?: SplatLayerRigOptions): SplatHandle;
+  /**
+   * `engine: 'playcanvas'` only. Change the per-eye buffer scale live (the `renderScale` option),
+   * in (0, 4]; the backing store is resized on the next animation frame. Throws a RangeError
+   * otherwise.
+   */
+  setRenderScale(scale: number): SplatHandle;
+  /** `engine: 'playcanvas'` only. The current per-eye buffer scale. */
+  readonly renderScale: number;
   /** `engine: 'playcanvas'` only. Change the layer rig's tile-wide options live (merge; `null` clears). */
   setLayerRigOptions(opts: SplatLayerRigOptions): SplatHandle;
   /**