From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 21:33:14 +0200 Subject: Adding upstream version 115.7.0esr. Signed-off-by: Daniel Baumann --- gfx/wr/glsl-to-cxx/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 gfx/wr/glsl-to-cxx/README.md (limited to 'gfx/wr/glsl-to-cxx/README.md') diff --git a/gfx/wr/glsl-to-cxx/README.md b/gfx/wr/glsl-to-cxx/README.md new file mode 100644 index 0000000000..54dcbc7d61 --- /dev/null +++ b/gfx/wr/glsl-to-cxx/README.md @@ -0,0 +1,21 @@ +A GLSL to C++ translator. + +Translates GLSL to vectorized C++. Intended for use with WebRender software backend. + +Architecture +------------ +GLSL code is parsed by the glsl crate. In hir.rs we traverse the resulting AST +and build a higher level representation by doing type checking and name +resolution. The resulting hir tree is traversed by lib.rs to output C++ code. + +The generated C++ code is 4x wider then the original glsl. i.e. a glsl 'float' +becomes a C++ 'Float' which is represented by a xmm register (a vector of 4 floats). +Likewise, a vec4 becomes a struct of 4 'Float's for a total of 4 xmm registers and +16 floating point values. + +Vector branching is flattened to non-branching code that unconditionally runs both +sides of the branch and combines the results with a mask based on the condition. + +The compiler also supports scalarization. Values that are known to be the same +across all vector lanes are translated to scalars instead of vectors. Branches on +scalars are translated as actual branches. -- cgit v1.2.3