src/compiler/shader_info.h

   1 /*
   2  * Copyright © 2016 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21  * IN THE SOFTWARE.
  22  *
  23  */
  24
  25 #ifndef SHADER_INFO_H
  26 #define SHADER_INFO_H
  27
  28 #include "shader_enums.h"
  29 #include <stdint.h>
  30
  31 #ifdef __cplusplus
  32 extern "C" {
  33 #endif
  34
  35 struct spirv_supported_capabilities {
  36    bool address;
  37    bool atomic_storage;
  38    bool descriptor_array_dynamic_indexing;
  39    bool device_group;
  40    bool draw_parameters;
  41    bool float64;
  42    bool geometry_streams;
  43    bool gcn_shader;
  44    bool image_ms_array;
  45    bool image_read_without_format;
  46    bool image_write_without_format;
  47    bool int8;
  48    bool int16;
  49    bool int64;
  50    bool int64_atomics;
  51    bool kernel;
  52    bool min_lod;
  53    bool multiview;
  54    bool physical_storage_buffer_address;
  55    bool post_depth_coverage;
  56    bool runtime_descriptor_array;
  57    bool shader_viewport_index_layer;
  58    bool stencil_export;
  59    bool storage_8bit;
  60    bool storage_16bit;
  61    bool storage_image_ms;
  62    bool subgroup_arithmetic;
  63    bool subgroup_ballot;
  64    bool subgroup_basic;
  65    bool subgroup_quad;
  66    bool subgroup_shuffle;
  67    bool subgroup_vote;
  68    bool tessellation;
  69    bool transform_feedback;
  70    bool trinary_minmax;
  71    bool variable_pointers;
  72 };
  73
  74 typedef struct shader_info {
  75    const char *name;
  76
  77    /* Descriptive name provided by the client; may be NULL */
  78    const char *label;
  79
  80    /** The shader stage, such as MESA_SHADER_VERTEX. */
  81    gl_shader_stage stage;
  82
  83    /** The shader stage in a non SSO linked program that follows this stage,
  84      * such as MESA_SHADER_FRAGMENT.
  85      */
  86    gl_shader_stage next_stage;
  87
  88    /* Number of textures used by this shader */
  89    unsigned num_textures;
  90    /* Number of uniform buffers used by this shader */
  91    unsigned num_ubos;
  92    /* Number of atomic buffers used by this shader */
  93    unsigned num_abos;
  94    /* Number of shader storage buffers used by this shader */
  95    unsigned num_ssbos;
  96    /* Number of images used by this shader */
  97    unsigned num_images;
  98
  99    /* Which inputs are actually read */
 100    uint64_t inputs_read;
 101    /* Which outputs are actually written */
 102    uint64_t outputs_written;
 103    /* Which outputs are actually read */
 104    uint64_t outputs_read;
 105    /* Which system values are actually read */
 106    uint64_t system_values_read;
 107
 108    /* Which patch inputs are actually read */
 109    uint32_t patch_inputs_read;
 110    /* Which patch outputs are actually written */
 111    uint32_t patch_outputs_written;
 112    /* Which patch outputs are read */
 113    uint32_t patch_outputs_read;
 114
 115    /* Whether or not this shader ever uses textureGather() */
 116    bool uses_texture_gather;
 117
 118    /** Bitfield of which textures are used */
 119    uint32_t textures_used;
 120
 121    /** Bitfield of which textures are used by texelFetch() */
 122    uint32_t textures_used_by_txf;
 123
 124    /**
 125     * True if this shader uses the fddx/fddy opcodes.
 126     *
 127     * Note that this does not include the "fine" and "coarse" variants.
 128     */
 129    bool uses_fddx_fddy;
 130
 131    /**
 132     * True if this shader uses 64-bit ALU operations
 133     */
 134    bool uses_64bit;
 135
 136    /* The size of the gl_ClipDistance[] array, if declared. */
 137    unsigned clip_distance_array_size;
 138
 139    /* The size of the gl_CullDistance[] array, if declared. */
 140    unsigned cull_distance_array_size;
 141
 142    /* Whether or not separate shader objects were used */
 143    bool separate_shader;
 144
 145    /** Was this shader linked with any transform feedback varyings? */
 146    bool has_transform_feedback_varyings;
 147
 148    union {
 149       struct {
 150          /* Which inputs are doubles */
 151          uint64_t double_inputs;
 152
 153          /* True if the shader writes position in window space coordinates pre-transform */
 154          bool window_space_position;
 155       } vs;
 156
 157       struct {
 158          /** The number of vertices recieves per input primitive */
 159          unsigned vertices_in;
 160
 161          /** The output primitive type (GL enum value) */
 162          unsigned output_primitive;
 163
 164          /** The input primitive type (GL enum value) */
 165          unsigned input_primitive;
 166
 167          /** The maximum number of vertices the geometry shader might write. */
 168          unsigned vertices_out;
 169
 170          /** 1 .. MAX_GEOMETRY_SHADER_INVOCATIONS */
 171          unsigned invocations;
 172
 173          /** Whether or not this shader uses EndPrimitive */
 174          bool uses_end_primitive;
 175
 176          /** Whether or not this shader uses non-zero streams */
 177          bool uses_streams;
 178       } gs;
 179
 180       struct {
 181          bool uses_discard;
 182
 183          /**
 184           * Whether any inputs are declared with the "sample" qualifier.
 185           */
 186          bool uses_sample_qualifier;
 187
 188          /**
 189           * Whether early fragment tests are enabled as defined by
 190           * ARB_shader_image_load_store.
 191           */
 192          bool early_fragment_tests;
 193
 194          /**
 195           * Defined by INTEL_conservative_rasterization.
 196           */
 197          bool inner_coverage;
 198
 199          bool post_depth_coverage;
 200
 201          /**
 202           * \name ARB_fragment_coord_conventions
 203           * @{
 204           */
 205          bool pixel_center_integer;
 206          bool origin_upper_left;
 207          /*@}*/
 208
 209          bool pixel_interlock_ordered;
 210          bool pixel_interlock_unordered;
 211          bool sample_interlock_ordered;
 212          bool sample_interlock_unordered;
 213
 214          /**
 215           * Flags whether NIR's base types on the FS color outputs should be
 216           * ignored.
 217           *
 218           * GLSL requires that fragment shader output base types match the
 219           * render target's base types for the behavior to be defined.  From
 220           * the GL 4.6 spec:
 221           *
 222           *     "If the values written by the fragment shader do not match the
 223           *      format(s) of the corresponding color buffer(s), the result is
 224           *      undefined."
 225           *
 226           * However, for NIR shaders translated from TGSI, we don't have the
 227           * output types any more, so the driver will need to do whatever
 228           * fixups are necessary to handle effectively untyped data being
 229           * output from the FS.
 230           */
 231          bool untyped_color_outputs;
 232
 233          /** gl_FragDepth layout for ARB_conservative_depth. */
 234          enum gl_frag_depth_layout depth_layout;
 235       } fs;
 236
 237       struct {
 238          unsigned local_size[3];
 239
 240          bool local_size_variable;
 241
 242          /**
 243           * Size of shared variables accessed by the compute shader.
 244           */
 245          unsigned shared_size;
 246
 247
 248          /**
 249           * pointer size is:
 250           *   AddressingModelLogical:    0    (default)
 251           *   AddressingModelPhysical32: 32
 252           *   AddressingModelPhysical64: 64
 253           */
 254          unsigned ptr_size;
 255
 256          /*
 257           * Arrangement of invocations used to calculate derivatives in a compute
 258           * shader.  From NV_compute_shader_derivatives.
 259           */
 260          enum gl_derivative_group derivative_group;
 261       } cs;
 262
 263       /* Applies to both TCS and TES. */
 264       struct {
 265          /** The number of vertices in the TCS output patch. */
 266          unsigned tcs_vertices_out;
 267
 268          uint32_t primitive_mode; /* GL_TRIANGLES, GL_QUADS or GL_ISOLINES */
 269          enum gl_tess_spacing spacing;
 270          /** Is the vertex order counterclockwise? */
 271          bool ccw;
 272          bool point_mode;
 273       } tess;
 274    };
 275 } shader_info;
 276
 277 #ifdef __cplusplus
 278 }
 279 #endif
 280
 281 #endif /* SHADER_INFO_H */