Skip to content

docs(graphics): document transient attachment validation invariants#8918

Merged
mvaligursky merged 1 commit into
mainfrom
mv-transient-attachment-invariants
Jun 17, 2026
Merged

docs(graphics): document transient attachment validation invariants#8918
mvaligursky merged 1 commit into
mainfrom
mv-transient-attachment-invariants

Conversation

@mvaligursky

Copy link
Copy Markdown
Contributor

Adds code comments documenting the WebGPU transient ("memoryless") attachment validation invariants that the engine already satisfies, so future edits don't accidentally break them.

WebGPU 149/150 tightened validation for textures created with the TRANSIENT_ATTACHMENT usage flag. The engine's transient color/depth attachments already comply, but the constraints were implicit. The comments record them at the two texture descriptors in WebgpuRenderTarget:

Changes:

  • Document the three transient-attachment invariants next to the transient depth and color descriptors in webgpu-render-target.js:
    • the texture descriptor must not set viewFormats (must be an empty array);
    • the texture view must not override usage;
    • a transient texture must only ever be a render view, never a resolveTarget.

No functional change — comments only.

@mvaligursky mvaligursky force-pushed the mv-transient-attachment-invariants branch from ba2a581 to 914dd37 Compare June 17, 2026 11:49
@mvaligursky mvaligursky merged commit ca15104 into main Jun 17, 2026
9 checks passed
@mvaligursky mvaligursky deleted the mv-transient-attachment-invariants branch June 17, 2026 11:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant