gallium/docs: improve docs for SAMPLE_POS, SAMPLE_INFO, TXQS, MSAA semantics
authorBrian Paul <brianp@vmware.com>
Fri, 26 May 2017 19:56:37 +0000 (13:56 -0600)
committerBrian Paul <brianp@vmware.com>
Fri, 16 Jun 2017 20:07:31 +0000 (14:07 -0600)
commit1c33dc77f7523134d17908e21bfa53e8d14cc67d
tree5f9742a1e689b60635fef1b81d43ac3ada9bec3f
parent005c978c5a674b6118b730763020594e4e898821
gallium/docs: improve docs for SAMPLE_POS, SAMPLE_INFO, TXQS, MSAA semantics

For the SAMPLE_POS and SAMPLE_INFO opcodes, clarify resource vs. render
target queries, range of postion values, swizzling, etc.  We basically
follow the DX10.1 conventions.

For the TXQS opcode and TGSI_SEMANTIC_SAMPLEID, clarify return value
and type.

For the TGSI_SEMANTIC_SAMPLEPOS system value, clarify the range of
positions returned.

v2: use 'undef' for unused vector components.  Use (0.5, 0.5, undef, undef)
for sample pos when MSAA not applicable.

v3: Add note that OPCODE_SAMPLE_INFO, OPCODE_SAMPLE_POS are not used yet
and the information is subject to change.

Reviewed-by: Nicolai Hähnle <nicolai.haehnle@amd.com>
Reviewed-by: Roland Scheidegger <sroland@vmware.com>
src/gallium/docs/source/tgsi.rst