Performance fix: timing instrumentation

The pre-allocated light buffer (MAX_LIGHTS=256) caused the PBR shader to
loop 256 times per fragment via arrayLength(&light_store), running the
full BRDF+shadow path 256 times instead of ~6 actual lights. This made
the model render pass ~3x slower (6.8ms→22ms in RenderDoc).

Changes:
- Add binding 13 (light_count uniform) to world bind group layout
- Compute active_light_count from LightDescriptorEcs dense.len() each frame
- Write to a static 16-byte UNIFORM|COPY_DST buffer (LIGHT_COUNT_BUF)
- Shader: loop bound changed from arrayLength(&light_store) to light_count
- Shader: add zero-intensity early continue guard (light.color.w == 0.0)
- Also moved global_model_dirty check before realize_models (Fix B1) to
  catch newly-imported models (e.g. DamagedHelmet) whose ModelDirty flag
  is cleared by realize_models before the check runs

Fix shadow texture reallocation wiping cube depth data mid-render 0e7afbe507

On frame 1 (bootstrap), ensure_cubes(2) was called mid-loop when the
second point light was processed, reallocating the cube depth texture
from 1 to 2 cubes. This dropped the first point light's freshly-rendered
cube-0 depth data into the old (dropped) texture, leaving cube 0 as
uninitialized garbage in the new texture. The shader's textureSampleCompare
for that cube returned shadowed (0) for all fragments, making the Room 4
point light contribute nothing — dark room, no shadows.

Changes:
- Pre-compute needed_cubes (count of enabled point lights) and
  needed_layers (spot/directional cascade sum) BEFORE the render loop
- Call ensure_cubes/ensure_layers up-front to final capacity
- Track grew = cubes_grew || layers_grew; when true, force_all_dirty
  makes all lights re-render this frame so no previously-stored depth
  is silently lost after a texture growth realloc
- Remove redundant mid-loop ensure_cubes and post-loop ensure_layers

Fix round-robin starvation: reserve floor budget for proactive shadow refresh

ci/woodpecker/pr/linting Pipeline failed

Details

ci/woodpecker/pr/test unknown status

Details

99208c9a99

The dirty-first pass consumed the entire per-frame budget when lights
were constantly dirty (e.g. the temporary LightAnimator marking Room-1
spot dirty every frame), starving the proactive round-robin refresh.
This meant clean shadow maps were never re-rendered, preventing newly
imported models from ever appearing in shadow maps.

Changes:
- Reserve max(1, budget/2) for round-robin when clean casters exist
  (0 reserve when no clean casters — all budget goes to dirty)
- Dirty lights get up to budget - reserve slots (still priority)
- Round-robin uses the remainder, ensuring proactive refresh runs
  even when some lights are always dirty

perf/timing-instrumentation: CPU section averages + GPU timestamp queries 3469c679b5

- TimingAccumulator prints avg section times every ~1s at INFO level
- GPU timestamps via TIMESTAMP_QUERY_INSIDE_ENCODERS (double-buffered, non-blocking)
- Captures: shadow pass, skybox, main pass boundaries
- Feature gated on adapter support (graceful fallback if unsupported)

Fix timestamp harness: correct buffer usage + non-blocking readback 047f446bea

- wgpu requires MAP_READ buffers to have ONLY MAP_READ | COPY_DST — no
  other flags (including QUERY_RESOLVE). Split into:
  resolve buffer: QUERY_RESOLVE | COPY_SRC
  staging buffers: COPY_DST | MAP_READ (double-buffered)
  copy_buffer_to_buffer bridges them each frame (24 bytes, negligible)
- Replace device.poll(wait_indefinitely) with submission-index-based wait:
  waits only on PREVIOUS frame's tiny resolve, preserves CPU/GPU overlap
- Fix GPU timestamp math: store durations (shadow/skybox+models/total) in ms

Downgrade per-frame stagger log from info! to debug! 1194340b7d

Downgrade stagger log from debug! to trace! (hidden at Debug filter)

ci/woodpecker/pr/linting Pipeline failed

Details

ci/woodpecker/pr/test unknown status

Details

a30f3a8d23

SakulFlee referenced this pull request

2026-08-01 02:07:50 +02:00

Debug: Add performance metrics UI #744

SakulFlee added 1 commit

2026-08-01 02:08:00 +02:00