From fcf83dbf9effab3bd98bad2b83b2468b7eb05cfd Mon Sep 17 00:00:00 2001 From: Tim Foley Date: Fri, 9 Jun 2017 11:34:21 -0700 Subject: Initial import of code. --- tests/bindings/README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 tests/bindings/README.md (limited to 'tests/bindings/README.md') diff --git a/tests/bindings/README.md b/tests/bindings/README.md new file mode 100644 index 000000000..ccc9fecb9 --- /dev/null +++ b/tests/bindings/README.md @@ -0,0 +1,29 @@ +Binding Generation Tests +======================== + +These tests ensure that the compiler can correctly add explicit binding information (e.g., HLSL `register` semantics) to code that does not originally have them. + +Example +------- + +Given code like: + + Texture2D ta; + Texture2D tb; + +We expect to produce output like: + + Texture2D ta : register(t0); + Texture2D tb : register(t1); + +The resulting code guarantees that `tb` will always be assigned to the same location, regardless of how these values are (or are not) used in later shader code. + +Methodology +----------- + +These tests currently rely on the ability to run the same HLSL code through the Spire compiler driver and execute either Spire, or HLSL. We write an example like the above by wrapping explicit `register` semantics in a macro: + + Texture2D ta R(: register(t0)); + Texture2D tb R(: register(t1)); + +In the HLSL case, these annotations will manually place things where we want them, while in the Spire case, we define the macro to have an empty expansion, so that the annotations express our expectation for what the compiler will auto-generate. \ No newline at end of file -- cgit v1.2.3