@plasius/gpu-renderer 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -23,16 +23,39 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
-## [0.2.2] - 2026-06-07
+## [0.2.4] - 2026-06-11
 
 - **Added**
-  - (placeholder)
+  - Added `updateCamera(...)` support for wavefront renderers so validation
+    views can animate camera movement without rebuilding mesh buffers.
+  - Added `gpuParallelism` diagnostics to wavefront frame stats and snapshots so
+    consumers can inspect adapter compute limits, direct workgroups,
+    indirect-dispatch estimates, and whether a frame exposes multi-workgroup GPU
+    parallelism.
+  - Added optional equirectangular `environmentMap` sampling for wavefront
+    tracing so environment misses and surface environment estimates can use a
+    bound radiance texture before falling back to procedural sky/ambient values.
+  - Added default-on `deferredPathResolve` support for wavefront tracing so
+    surface traversal records material responses and terminal source radiance
+    before the output pass resolves the path backward into pixel accumulation.
 
 - **Changed**
-  - (placeholder)
+  - Changed wavefront frame dispatch to split large tile/sample workloads into
+    bounded command submissions instead of encoding an entire high-resolution
+    frame into one command buffer.
+  - Changed display-quality wavefront tracing to require one additional
+    path-vertex storage buffer, raising the trace-stage storage-buffer request
+    from 9 to 10.
+  - Changed wavefront terminal/direct environment estimates to consume
+    `environmentLighting.sunlitBaseline` as a time-of-day daylight floor instead
+    of relying only on restrained ambient colour.
 
 - **Fixed**
-  - (placeholder)
+  - Fixed low-sample wavefront renders so non-emissive surface hits receive a
+    deterministic sky, sun, and portal-light estimate before random continuation.
+  - Reduced deterministic environment fill on direct surface hits so ambient
+    rescue lighting no longer washes dark materials toward the full scene
+    ambient colour.
 
 - **Security**
   - (placeholder)
@@ -326,4 +349,4 @@ All notable changes to this project will be documented in this file.
 [0.1.12]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.12
 [0.1.14]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.14
 [0.2.1]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.1
-[0.2.2]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.2
+[0.2.4]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.4

package/README.md

@@ -196,25 +196,50 @@ tone mapping into the presented `rgba8unorm` output. Filtering in linear
 radiance space lets the denoise pass cross tile boundaries without compressing
 energy/detail before the final resolve. The renderer also stores compact
 emissive-triangle metadata in the existing BVH buffer tail and uses it to guide
-diffuse continuation rays toward finite mesh light geometry without adding a
-ninth trace storage buffer. This is not a separate shadow/direct-light pass: the
-active ray still has to hit emissive geometry or miss into the environment
-before radiance is accumulated. Guided emissive hits carry a bounded estimator
-weight so finite light guidance does not over-expose low-sample renders before
-full material PDFs/MIS are implemented. High-energy samples are clamped in
-linear radiance space to keep low-sample preview output stable while production
-sampling, temporal accumulation, and better material PDFs are hardened.
+diffuse continuation rays toward finite mesh light geometry. This is not a
+separate shadow/direct-light pass: the active ray still has to hit emissive
+geometry or miss into the environment before radiance is committed. Guided
+emissive hits carry a bounded estimator weight so finite light guidance does not
+over-expose low-sample renders before full material PDFs/MIS are implemented.
+High-energy samples are clamped in linear radiance space to keep low-sample
+preview output stable while production sampling, temporal accumulation, and
+better material PDFs are hardened. By default, `deferredPathResolve` records
+per-bounce material responses in a tile-bounded path buffer and records the
+terminal emissive/HDRI/environment source in the final path slot. The output
+pass then resolves that recorded path backward and adds the weighted sample to
+the pixel accumulation, so surface traversal no longer injects broad visible
+ambient/direct environment light before a terminal source is known. Set
+`deferredPathResolve: false` only for legacy forward-accumulation comparison.
+When an `environmentMap` is provided, the wavefront trace shader samples it as
+an equirectangular radiance source for environment misses and uses the same
+mapped radiance for terminal residuals before falling back to static ambient.
+The procedural horizon/zenith/sun model remains the fallback for callers that
+have not supplied an HDRI/radiance texture. `environmentLighting.sunlitBaseline`
+adds a time-of-day daylight floor to terminal and direct environment estimates,
+so bright presets retain colour at the last collision without returning to a
+whitewashed global ambient term.
 For static mesh scenes, the GPU acceleration build is submitted once and then
 reused by subsequent frames. Per-frame tracing writes one dynamic uniform slot
 per tile/sample or post-process pass and batches tile tracing, tile output,
-optional denoise, and presentation into a single command submission. After each
+optional denoise, and presentation into bounded command submissions controlled
+by `maxFramePassesPerSubmission` to keep 4K/high-spp command buffers from
+becoming oversized. `updateCamera(...)` can update the per-frame camera uniforms
+between renders without rebuilding mesh buffers. Frame stats and snapshots expose
+`gpuParallelism` diagnostics with adapter compute limits, configured workgroup
+size, direct compute dispatches, known workgroups/invocations, indirect dispatch
+counts, and upper-bound indirect work estimates. WebGPU does not expose physical
+GPU core counts, so `physicalCoreCount` remains `null`; use
+`exposesMultiWorkgroupParallelism`, `largestDirectWorkgroupsPerDispatch`, and
+`largestEstimatedIndirectWorkgroupsPerDispatch` to confirm the renderer is
+submitting work that can occupy more than one GPU execution unit. After each
 primary-ray or compaction pass, the GPU writes the active-ray workgroup count
 into the counter buffer and the encoder copies it into an indirect-dispatch
 argument buffer. Intersection and surface-resolution passes therefore scale
 with active continuation rays instead of the maximum tile capacity, while still
 avoiding CPU readback between bounces. WebGPU
-still preserves ordering between dependent bounce passes, but the renderer no
-longer forces one CPU queue submission per tile/sample.
+still preserves ordering between dependent bounce passes, but the renderer
+keeps CPU queue submissions bounded rather than forcing one submission per
+tile/sample.
 Environment-light portals can additionally guide and gate sky/HDRI contribution
 through rectangular openings such as windows. `environmentPortalMode: "guide"`
 biases diffuse continuation rays toward configured openings, while