reze-engine 0.50.2 → 0.50.4

package/dist/shaders/passes/trails.js

@@ -5,6 +5,7 @@ import { anchorAliasWgsl, ribbonSlotWgsl } from "../anchor-table";
 import { midiApi } from "../midi-api";
 import { CAST_API } from "../cast-api";
 import { clockApi, EFFECT_MATH_API, PARTICLE_STRUCT_WGSL, trailSlotsApi, viewportApi } from "./hosted-api";
+import { sceneIdFieldWgsl, sceneIdPadWgsl } from "./scene-contract";
 /**
  * Sub-segments drawn between each pair of recorded samples.
  *
@@ -74,7 +75,14 @@ struct CameraU {
 }
 struct TrailU {
   time: f32,
-  _pad0: f32,
+  // How many subjects the cast ACTUALLY holds this frame, not the four the
+  // layout has room for. The instance count is sized by this on the CPU and
+  // decoded by it here, and the two must use the same number or the flattened
+  // [ribbon][subject][segment] index lands on the wrong ribbon. It is a uniform
+  // rather than the RZ_SUBJECTS constant precisely because it changes when a
+  // model is added or removed, and recompiling every trail shader for that
+  // would be absurd.
+  subjects: f32,
   _pad1: f32,
   _pad2: f32,
 }
@@ -195,11 +203,14 @@ fn vs(@builtin(vertex_index) vi: u32, @builtin(instance_index) ii: u32) -> VSOut
   let rest = ii / subs;
   let seg = k / SUB;
   let sub = k % SUB;
-  let subject = i32(rest % u32(RZ_SUBJECTS));
+  // The LIVE subject count, floored at one so a cast that is momentarily empty
+  // divides by something. See TrailU.subjects.
+  let live = max(1u, u32(tu.subjects));
+  let subject = i32(rest % live);
   // Instance index counts RIBBONS; the cast buffer is addressed by anchor slot.
   // One ribbon per trailed anchor, so these are the same number only when every
   // anchor is trailed — _rzRibbonSlot is what bridges them.
-  let ribbon = i32(rest / u32(RZ_SUBJECTS));
+  let ribbon = i32(rest / live);
   let slot = _rzRibbonSlot(ribbon);
 
   let n = rzTrailCount(subject, slot);
@@ -293,9 +304,23 @@ fn vs(@builtin(vertex_index) vi: u32, @builtin(instance_index) ii: u32) -> VSOut
   if (dot(perpA, perpB) < 0.0) { perpB = -perpB; }
   let clipP = select(clipA, clipB, atEnd);
   let perp = select(perpA, perpB, atEnd);
-  // trailWidth speaks PIXELS, like the original's constants; rzViewportHeight()
-  // lets the effect scale them to the frame.
-  let wPx = max(0.0, trailWidth(u, age));
+  // trailWidth speaks WORLD UNITS — the model's units, not the screen's.
+  //
+  // It spoke pixels, like the fullscreen original's constants, and that made
+  // the ribbon a screen ornament: zoom out and it grew relative to the hand
+  // that drew it, zoom in and it thinned to a thread. A ribbon is a thing in
+  // the scene, so its width belongs in the scene's units and should foreshorten
+  // like everything else.
+  //
+  // The EXTRUSION stays in 2D pixel space untouched — every 3D-extrusion
+  // artefact this ribbon ever had (fold-over wedges, bowties, twisted quads) is
+  // recorded above, and none of it comes back. Only the width's SOURCE changes:
+  // a world length L perpendicular to view at depth w projects to
+  // L * proj[1][1] / w in NDC y, so half the frame height converts it to the
+  // pixels the 2D offset wants. Per vertex, so a ribbon receding along its own
+  // length tapers with distance exactly as geometry would.
+  let wWorld = max(0.0, trailWidth(u, age));
+  let wPx = wWorld * cam.proj[1][1] * (H * 0.5) / max(clipP.w, 0.01);
   let ndc = clipP.xy / clipP.w + perp * (c.y * wPx) / toPx;
   out.clip = vec4f(ndc * clipP.w, clipP.z, clipP.w);
   out.slot = u32(slot);
@@ -315,7 +340,10 @@ struct TrailFSOut {
   // The scene's aux target: (bloom mask, coverage). Writing mask 1 is what
   // makes a ribbon BLOOM — it is light, and the gate is what says so.
   @location(1) aux: vec4f,
-}
+  // Declared whenever the pass carries the attachment, and padded rather than
+  // written: a ribbon is not a thing you would address by id, so its pipeline
+  // takes this target at writeMask 0. Declared anyway — see sceneFsOutWgsl.
+${sceneIdFieldWgsl()}}
 
 @fragment
 fn fs(in: VSOut) -> TrailFSOut {
@@ -334,7 +362,7 @@ fn fs(in: VSOut) -> TrailFSOut {
   // mapper is what keeps the sum from clipping.
   o.color = vec4f(c.rgb, c.a);
   o.aux = vec4f(${src.bloom ? "1.0" : "0.0"}, 1.0, 0.0, c.a);
-  return o;
+${sceneIdPadWgsl("o")}  return o;
 }
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.50.2",
+  "version": "0.50.4",
   "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -41,4 +41,4 @@
     "@types/node": "^20",
     "typescript": "^5"
   }
-}
+}