rig-play 1.8.2 → 1.9.0

package/README.md

@@ -38,7 +38,21 @@ links to either earlier name keep working.
 
 ### Measured
 
-Measured on the 0.x line, on the spineboy exports it then played (PoC, Apple silicon —
+**The element mode's mesh backend is `'webgl'` by default since 1.9 (#109)**, read off
+macOS Safari on 2026-10-13 (1.8.2, gallery rig `look-packed`: 4 meshes, 464
+triangles, `sweep`; the demo's stats line after a 30 s settle; the Mac was also
+serving the builds, so absolute fps is low and only the comparison is the point —
+readings verbatim on #25):
+
+| macOS Safari | 1 rig | 10 rigs (4,640 triangles) |
+| --- | --: | --: |
+| canvas2d mesh backend | 21–26 fps | 2–3 fps |
+| webgl mesh backend | 60 fps | 58 fps |
+
+Nothing is claimed here for mobile browsers: no phone or tablet has been measured
+on the 1.x line.
+
+The numbers below are older: measured on the 0.x line, on the spineboy exports it then played (PoC, Apple silicon —
 headless and on-device numbers are labeled, they do **not** substitute for each other).
 The renderer tiers they describe carried over; they have not been re-measured since the
 player moved to rigc's model (#60):
@@ -150,8 +164,8 @@ default stays `dom`.
   37 fps, meshed ×10 = 3–4 fps with JS flat at ~4–5 ms — put the real cost in the
   GPU process: Safari antialiases canvas2d **clip paths**, so the per-triangle clip
   mapping pays a per-triangle AA-mask tax (the same AA that caused the seam cracks)
-- ✅ Optional WebGL blit backend for the mesh tier: `renderer.meshBackend =
-  'webgl'` (default stays `'canvas2d'`). All dirty meshes are shelf-packed into
+- ✅ WebGL blit backend for the mesh tier, the default since 1.9 (#109;
+  `renderer.meshBackend = 'canvas2d'` keeps the 2d raster). All dirty meshes are shelf-packed into
   **one shared offscreen WebGL context** (module-level — browsers cap contexts at
   ~16), drawn as textured triangles with premultiplied alpha, then rect-blitted
   onto the same per-part canvases with an unclipped `drawImage` — cheap on Safari.
@@ -586,9 +600,10 @@ onto shared pages instead. Both play here, unchanged:
   (Σ width × height), computed on demand. This is what `pixelRatio` moves
   quadratically, and the cheapest way to see an oversampling stage; the demo
   prints it in the stats line as `backing N Mpx`.
-- `renderer.meshBackend` — `'canvas2d'` (default) or `'webgl'`; same output, but
-  heavy deforming scenes on Safari want `'webgl'` (see Measured above). Falls back
-  to canvas2d automatically when WebGL is unavailable. Switching re-rasters every
+- `renderer.meshBackend` — `'webgl'` (default since 1.9) or `'canvas2d'`; same
+  output, and on macOS Safari webgl holds 58–60 fps where canvas2d reads 2–26
+  (see Measured above). Falls back to canvas2d automatically when WebGL is
+  unavailable or the shared context is lost; `meshBackendActive` says which drew. Switching re-rasters every
   mesh once (no reallocation), so it is fine to expose as a user setting.
 - `renderer.triangleExpand` — how far (canvas px) each triangle edge's clip is
   moved outward to close antialiased mesh seams (default 0.5). Also re-rasters every mesh once when changed.
@@ -643,6 +658,30 @@ on-device (Chromium, dpr 2, stage under `scale(0.25)`, ~2.2 M CSS px on screen):
 | 92 meshes | `devicePixelRatio` (2) | 141.1 Mpx | 36–39 |
 | 92 meshes | `dpr × zoom` (0.5) | 9.1 Mpx | 60–61 |
 
+## Coming from 1.8: meshes draw through WebGL by default
+
+From 1.9 the element mode rasterizes its meshes through the one shared WebGL
+context unless told otherwise (`DomRenderer.meshBackend` defaults to `'webgl'`,
+#109). The picture is the same within the parity suite's bounds, the API is
+unchanged, and canvas2d is still drawn wherever WebGL is unavailable or the
+context is lost. What a caller can notice:
+
+- The page holds one more WebGL context (one for every mesh of every player, not
+  one per player). A page already near the browser's cap of about 16 live
+  contexts can lose its oldest one when this one is created.
+- `meshBackendActive` reads `'webgl'` where it read `'canvas2d'`.
+- Frame cost moves from the page to the GPU blit (see *Measured*).
+
+To keep 1.8's raster, set it back, up front or on a live player:
+
+```ts
+const player = new RigPlayer(root, assets, { meshBackend: 'canvas2d' });
+// or, on a renderer you hold:
+renderer.meshBackend = 'canvas2d';
+```
+
+The canvas mode was already webgl by default and does not change.
+
 ## Coming from spine-html 0.8
 
 This is not a drop-in upgrade. 0.8 drew a Spine export (`.json` or `.skel`, plus its
@@ -695,7 +734,7 @@ name, and unloading is still elements first, bitmaps second.
 | `renderer.pixelRatio` | `player.renderer.pixelRatio` | On both renderers. Carried over when `player.mode` changes. |
 | `renderer.syncPixelRatio()` | `player.renderer.syncPixelRatio()` | On both renderers, the same meaning and the same deadband (since 1.3.0; before it, DOM mode only). |
 | `renderer.meshBackingPixels` | `DomRenderer.meshBackingPixels` | DOM mode only. |
-| `renderer.meshBackend`, `meshBackendActive`, type `MeshBackend` | `DomRenderer.meshBackend`, `meshBackendActive`, type `MeshBackend` | Same values (`'canvas2d'` default, `'webgl'`). Also settable up front as `RigPlayerOptions.meshBackend`. |
+| `renderer.meshBackend`, `meshBackendActive`, type `MeshBackend` | `DomRenderer.meshBackend`, `meshBackendActive`, type `MeshBackend` | Same values; the default is `'webgl'` since 1.9 (`'canvas2d'` before). Also settable up front as `RigPlayerOptions.meshBackend`. |
 | `renderer.triangleExpand` | `DomRenderer.triangleExpand` | Same default (0.5). |
 | `renderer.clipping` | `player.renderer.clipping` | On both renderers. Carried over when `player.mode` changes. |
 | `clipCount`, `clipSkipCount`, `clipWriteCount` | same names on `DomRenderer` | `clipSkipCount` counts less than it did: a second clip met while one is in force, and a clip on an inactive bone, no longer reach the frame, so they are not counted. |

package/dist/DomRenderer.d.ts

@@ -97,9 +97,9 @@ export declare class DomRenderer {
      */
     pixelRatio: number;
     /**
-     * Rasterizer for the mesh (deform) tier. 'canvas2d' (default) maps each
-     * triangle with clip+transform+drawImage directly on the per-part canvas.
-     * 'webgl' rasterizes every dirty mesh into one shared offscreen WebGL
+     * Rasterizer for the mesh (deform) tier. 'canvas2d' maps each triangle
+     * with clip+transform+drawImage directly on the per-part canvas. 'webgl'
+     * (default) rasterizes every dirty mesh into one shared offscreen WebGL
      * canvas and rect-blits each mesh back onto its per-part canvas — the DOM
      * structure and all element-level behavior (z-index interleave, tint
      * filter, mix-blend-mode, dirty-skip) are identical, only the raster step
@@ -108,7 +108,8 @@ export declare class DomRenderer {
      * process that rAF-limits heavy scenes; GL rasterizes shared edges
      * seamlessly (no clip, no crack overdraw) and the blit is an unclipped
      * rect copy. Falls back to 'canvas2d' when WebGL is unavailable or the
-     * shared context is lost — see meshBackendActive.
+     * shared context is lost — see meshBackendActive. The default since 1.9
+     * (#109); before it, 'canvas2d'. Set 'canvas2d' to keep the 2d raster.
      */
     meshBackend: MeshBackend;
     /** Backend that actually rasterized the mesh tier during the last render(). */

package/dist/DomRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DomRenderer.d.ts","sourceRoot":"","sources":["../src/DomRenderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DomRenderer.d.ts","sourceRoot":"","sources":["../src/DomRenderer.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6974,9 +6974,9 @@ class DomRenderer {
    */
   pixelRatio = typeof devicePixelRatio === "number" ? devicePixelRatio : 1;
   /**
-   * Rasterizer for the mesh (deform) tier. 'canvas2d' (default) maps each
-   * triangle with clip+transform+drawImage directly on the per-part canvas.
-   * 'webgl' rasterizes every dirty mesh into one shared offscreen WebGL
+   * Rasterizer for the mesh (deform) tier. 'canvas2d' maps each triangle
+   * with clip+transform+drawImage directly on the per-part canvas. 'webgl'
+   * (default) rasterizes every dirty mesh into one shared offscreen WebGL
    * canvas and rect-blits each mesh back onto its per-part canvas — the DOM
    * structure and all element-level behavior (z-index interleave, tint
    * filter, mix-blend-mode, dirty-skip) are identical, only the raster step
@@ -6985,11 +6985,12 @@ class DomRenderer {
    * process that rAF-limits heavy scenes; GL rasterizes shared edges
    * seamlessly (no clip, no crack overdraw) and the blit is an unclipped
    * rect copy. Falls back to 'canvas2d' when WebGL is unavailable or the
-   * shared context is lost — see meshBackendActive.
+   * shared context is lost — see meshBackendActive. The default since 1.9
+   * (#109); before it, 'canvas2d'. Set 'canvas2d' to keep the 2d raster.
    */
-  meshBackend = "canvas2d";
+  meshBackend = "webgl";
   /** Backend that actually rasterized the mesh tier during the last render(). */
-  meshBackendActive = "canvas2d";
+  meshBackendActive = "webgl";
   views = /* @__PURE__ */ new Map();
   /** Counts render() calls: the stamp a view drawn this frame carries (`SlotView.drawnIn`). */
   frameNumber = 0;