Mesa (master): gallium/docs: clarify TGSI_SEMANTIC_SAMPLEMASK, again
Brian Paul
brianp at kemper.freedesktop.org
Tue Jun 13 14:05:05 UTC 2017
Module: Mesa
Branch: master
Commit: def8d1d23f5b6cf289e9247a41cc902113831a67
URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=def8d1d23f5b6cf289e9247a41cc902113831a67
Author: Brian Paul <brianp at vmware.com>
Date: Mon Jun 12 11:33:30 2017 -0600
gallium/docs: clarify TGSI_SEMANTIC_SAMPLEMASK, again
I've since discovered the fragment shader sample mask system value (which
corresponds to gl_SampleMaskIn).
v2: It's a system value, not a shader input.
Reviewed-by: Nicolai Hähnle <nicolai.haehnle at amd.com>
---
src/gallium/docs/source/tgsi.rst | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/src/gallium/docs/source/tgsi.rst b/src/gallium/docs/source/tgsi.rst
index 7fb963fde5..c65d721dec 100644
--- a/src/gallium/docs/source/tgsi.rst
+++ b/src/gallium/docs/source/tgsi.rst
@@ -3297,10 +3297,17 @@ and Y values are used.
TGSI_SEMANTIC_SAMPLEMASK
""""""""""""""""""""""""
-For fragment shaders, this semantic label indicates that an output contains
-the sample mask used to disable further sample processing. The output's
-type is uint[4] but only the X component is used (i.e. gl_SampleMask[0]).
-Each bit corresponds to one sample position (up to 32x MSAA is supported).
+For fragment shaders, this semantic label can be applied to either a
+shader system value input or output.
+
+For a system value, the sample mask indicates the set of samples covered by
+the current primitive. If MSAA is not enabled, the value is (1, 0, 0, 0).
+
+For an output, the sample mask is used to disable further sample processing.
+
+For both, the register type is uint[4] but only the X component is used
+(i.e. gl_SampleMask[0]). Each bit corresponds to one sample position (up
+to 32x MSAA is supported).
TGSI_SEMANTIC_INVOCATIONID
""""""""""""""""""""""""""
More information about the mesa-commit
mailing list