[WIP] Expand shader documentation with feedback and sampling details#1124
Open
anikom15 wants to merge 2 commits intolibretro:masterfrom
Open
[WIP] Expand shader documentation with feedback and sampling details#1124anikom15 wants to merge 2 commits intolibretro:masterfrom
anikom15 wants to merge 2 commits intolibretro:masterfrom
Conversation
Added detailed explanations and examples for shader feedback, texture sampling, and parameter support. Enhanced clarity on shader structure and best practices for multi-pass shaders.
Added detailed explanations for required shader stages, universal and scoped declarations, and provided a comprehensive example of a .slangp preset file. Clarified the usage of #pragma directives and improved the structure of the documentation.
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
1 participant
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.
This is a work-in-progress. Do not merge yet. I just want to get the conversation started and get feedback. Still a lot of work to do. I am updating the shader doc to be more developer-friendly. This is largely based off of my own experience writing my own shaders. There are probably some formatting issues and typos I need to address. It's a big document.
Added detailed explanations and examples for shader feedback, texture sampling, and parameter support. Enhanced clarity on shader structure and best practices for multi-pass shaders. There are a bunch of new examples and a section on Advanced Techniques. Let me know what you think. I am okay with MIT license. It's largely academic after all. Would appreciate having my name on it somewhere however (anikom15 is fine; doesn't need to be my real name).
Also, this document originally started as a speculative 'how should we implement this?' idea sheet and then also morphed into developer doc and sort of user doc. We should focus this to be a developer-focused doc of how the system works now. A lot of that speculative tone was removed, but if there's something we need to adjust further, let me know.