Document simplified compute shaders; add Compute Shaders Advanced page#1004
Open
mvaligursky wants to merge 1 commit into
Open
Document simplified compute shaders; add Compute Shaders Advanced page#1004mvaligursky wants to merge 1 commit into
mvaligursky wants to merge 1 commit into
Conversation
Stage 2 of the WGSL docs restructure. Now that compute shaders support automatic bind-group reflection, the Compute Shaders page leads with the simplified syntax (matching vertex/fragment), and manual bind-group control moves to a dedicated Compute Shaders Advanced page. - WGSL Reflection: generalized to vertex/fragment/compute; added a Storage Textures section. - Compute Shaders: rewritten simplified-only (no computeBindGroupFormat, loose uniforms, simplified indirect-dispatch), added a dispatch-must-run-in-frame note, examples reordered. - Compute Shaders Advanced (new): manual computeBindGroupFormat / computeUniformBufferFormats, explicit @group/@binding, the reflected-vs-manual mixing rule, and a note that manual bind groups remain fully supported. - Japanese pages reconciled to match the new structure (new wgsl-capabilities, wgsl-vertex-fragment-shaders, compute-shaders-advanced), reusing existing translations and updating moved-anchor links.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stage 2 of the WGSL docs restructure (Stage 1 split the old WGSL Specifics page into WGSL Reflection, WGSL Capabilities, and WGSL Vertex and Fragment Shaders). Now that compute shaders support automatic bind-group reflection, the Compute Shaders page leads with the simplified syntax — matching how vertex/fragment shaders are documented — and manual bind-group control moves to a dedicated Compute Shaders Advanced page.
Changes:
computeBindGroupFormat, loose uniforms, simplified indirect-dispatch snippet, a note thatcomputeDispatchmust run inside the render frame, and examples reordered (simplified first).computeBindGroupFormat/computeUniformBufferFormats, explicit@group/@binding, the rule for mixing reflected and manual resources (reflected → group 1 when a manual format is supplied, else group 0), and a note that manual bind groups remain fully supported (migrate at your leisure).Compute Shaders Advancedadded afterCompute Shaders.wgsl-capabilities,wgsl-vertex-fragment-shaders, andcompute-shaders-advanced(reusing existing translations), trimmed/generalized the JA reflection page, rewrote the JA compute page, and fixed moved-anchor links.Notes for reviewers: