Mesa (master): compiler: Add a note about how num_ssbos works in the program info.

[GitLab Mirror]

Module: Mesa
Branch: master
Commit: 7558b5da13685f701cbe7a9ca804e95e01e38e63
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=7558b5da13685f701cbe7a9ca804e95e01e38e63

Author: Eric Anholt <eric at anholt.net>
Date:   Mon Dec 30 12:01:25 2019 -0800

compiler: Add a note about how num_ssbos works in the program info.

These numbers are always confusing, and it's particularly so for this
field where it has a different meaning in different info structs.

Reviewed-by: Marek Olšák <marek.olsak at amd.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/merge_requests/3240>

---

 src/compiler/shader_info.h | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/compiler/shader_info.h b/src/compiler/shader_info.h
index 7c12dadd1ce..136e71ce234 100644
--- a/src/compiler/shader_info.h
+++ b/src/compiler/shader_info.h
@@ -104,7 +104,11 @@ typedef struct shader_info {
    uint8_t num_ubos;
    /* Number of atomic buffers used by this shader */
    uint8_t num_abos;
-   /* Number of shader storage buffers used by this shader */
+   /* Number of shader storage buffers (max .driver_location + 1) used by this
+    * shader.  In the case of nir_lower_atomics_to_ssbo being used, this will
+    * be the number of actual SSBOs in gl_program->info, and the lowered SSBOs
+    * and atomic counters in nir_shader->info.
+    */
    uint8_t num_ssbos;
    /* Number of images used by this shader */
    uint8_t num_images;