workinf_Blender_Wasm/docs/status/M11-03.md

M11-03 Status

status: done task: Explicit Three WebGL2 and WebGPU light, shadow-map and texture budgets updated: 2026-08-16 America/New_York

Scope

Schema 1 PBRRenderBudget freezes separate THREE_WEBGL2 and THREE_WEBGPU product ceilings. WebGL2 reserves two built-in lights and one built-in shadow map inside totals of 16 lights and four 1024-square shadow maps. The WebGPU contract uses 64 lights and eight 2048-square maps. Runtime device limits may only lower these ceilings.

The shared planner deterministically retains light nodes in SceneIR order, retains a bounded shadow-capable prefix and reports every dropped identity with stable GPU_LIGHT_BUDGET_EXCEEDED/GPU_SHADOW_BUDGET_EXCEEDED issues. Main-thread and Offscreen production viewports publish the same report on the canvas.

Texture planning covers asset count, maximum dimension, aggregate compressed payload and decoded RGBA GPU bytes before hash/decode/allocation. An over-budget batch leaves the previous texture set alive. This task defines the WebGPU budget contract but does not claim that the still-unbundled Three WebGPU renderer is available.

Evidence

• WEB_TEST_PORT=5548 npm --prefix web run test:render-resource-budget: unit 3/3 and Chromium 3/3. Both production viewports requested 20 lights, rendered 14, dropped six, rendered three of 14 requested scene shadow maps and blocked 11; with reserved resources, the main Three scene contained exactly 16 lights and four shadow maps.
• A 257-asset batch was rejected before decode in both viewports. A separate browser case first decoded a valid PNG, rejected a 257-asset follow-up (258 including the retained asset), and proved the original texture object/hash remained installed.
• M11-02 field roundtrip remained 1/1. Real 4K (64 MiB decoded) and 8K (256 MiB decoded) texture performance cases passed; packed raster main/Offscreen passed 2/2.
• Full unit was 159/159. Typecheck, lint, production build (75 modules), local runtime dependency checks and git diff --check passed.

Implementation Hashes

• Budget protocol: d7784690358e38b71c6ad3ccc5baf82869d897714d5257f219bbd00dc7e7b0f7
• PBR adapter: 934874434afa6778eaf783c78650ad221a428352741f3ff7173cb3c17a0c3c14
• Texture store: 0f18f3bcf04c5c99175d4cac8bbf1bc028fc54d635701fb6a92791e06c335fb6
• Main viewport: dcb502ca892fd5431cbf1a13823aec5d83a2aa0a1b40487cb66fa630c6e461b3
• Offscreen Worker: c95bce10f0bd73591f002c21415bfbc6f709ecbe61e97a3b5b05bcec2b0e0bef
• Unit: 4bde90788bbf9a94317d83bd398acd321bbcf4e53e26bf40165a889bacff03a2
• Chromium spec: 90834dfff09e61a2d32732d3a8f0db4b9c71414ac4991412d93d322119ef2de7
• Golden: c312bf5ed8415ad51e5cccb3a2653f65cd9fee46488be2f860e6a5a8d5a7901d
• Package: c718983c3f3a552f4c68d9390376777e45a3f23e6999afd5cb4ddc786a12a278

Rollback

Remove the render-budget protocol, planner integration, canvas reports, unit/E2E/ golden/package command and this status file; restore the former fixed 1024 shadow configuration and per-asset-only texture checks, then restore M11 to 2/14.