src/glsl/glsl_types.cpp

   1 /*
   2  * Copyright © 2009 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
  21  * DEALINGS IN THE SOFTWARE.
  22  */
  23
  24 #include <stdio.h>
  25 #include <stdlib.h>
  26 #include "main/core.h" /* for Elements */
  27 #include "glsl_symbol_table.h"
  28 #include "glsl_parser_extras.h"
  29 #include "glsl_types.h"
  30 #include "builtin_types.h"
  31 extern "C" {
  32 #include "program/hash_table.h"
  33 }
  34
  35 hash_table *glsl_type::array_types = NULL;
  36 hash_table *glsl_type::record_types = NULL;
  37 void *glsl_type::mem_ctx = NULL;
  38
  39 void
  40 glsl_type::init_ralloc_type_ctx(void)
  41 {
  42    if (glsl_type::mem_ctx == NULL) {
  43       glsl_type::mem_ctx = ralloc_autofree_context();
  44       assert(glsl_type::mem_ctx != NULL);
  45    }
  46 }
  47
  48 glsl_type::glsl_type(GLenum gl_type,
  49                      glsl_base_type base_type, unsigned vector_elements,
  50                      unsigned matrix_columns, const char *name) :
  51    gl_type(gl_type),
  52    base_type(base_type),
  53    sampler_dimensionality(0), sampler_shadow(0), sampler_array(0),
  54    sampler_type(0),
  55    vector_elements(vector_elements), matrix_columns(matrix_columns),
  56    length(0)
  57 {
  58    init_ralloc_type_ctx();
  59    this->name = ralloc_strdup(this->mem_ctx, name);
  60    /* Neither dimension is zero or both dimensions are zero.
  61     */
  62    assert((vector_elements == 0) == (matrix_columns == 0));
  63    memset(& fields, 0, sizeof(fields));
  64 }
  65
  66 glsl_type::glsl_type(GLenum gl_type,
  67                      enum glsl_sampler_dim dim, bool shadow, bool array,
  68                      unsigned type, const char *name) :
  69    gl_type(gl_type),
  70    base_type(GLSL_TYPE_SAMPLER),
  71    sampler_dimensionality(dim), sampler_shadow(shadow),
  72    sampler_array(array), sampler_type(type),
  73    vector_elements(0), matrix_columns(0),
  74    length(0)
  75 {
  76    init_ralloc_type_ctx();
  77    this->name = ralloc_strdup(this->mem_ctx, name);
  78    memset(& fields, 0, sizeof(fields));
  79 }
  80
  81 glsl_type::glsl_type(const glsl_struct_field *fields, unsigned num_fields,
  82                      const char *name) :
  83    base_type(GLSL_TYPE_STRUCT),
  84    sampler_dimensionality(0), sampler_shadow(0), sampler_array(0),
  85    sampler_type(0),
  86    vector_elements(0), matrix_columns(0),
  87    length(num_fields)
  88 {
  89    unsigned int i;
  90
  91    init_ralloc_type_ctx();
  92    this->name = ralloc_strdup(this->mem_ctx, name);
  93    this->fields.structure = ralloc_array(this->mem_ctx,
  94                                          glsl_struct_field, length);
  95    for (i = 0; i < length; i++) {
  96       this->fields.structure[i].type = fields[i].type;
  97       this->fields.structure[i].name = ralloc_strdup(this->fields.structure,
  98                                                      fields[i].name);
  99    }
 100 }
 101
 102 static void
 103 add_types_to_symbol_table(glsl_symbol_table *symtab,
 104                           const struct glsl_type *types,
 105                           unsigned num_types, bool warn)
 106 {
 107    (void) warn;
 108
 109    for (unsigned i = 0; i < num_types; i++) {
 110       symtab->add_type(types[i].name, & types[i]);
 111    }
 112 }
 113
 114 bool
 115 glsl_type::contains_sampler() const
 116 {
 117    if (this->is_array()) {
 118       return this->fields.array->contains_sampler();
 119    } else if (this->is_record()) {
 120       for (unsigned int i = 0; i < this->length; i++) {
 121          if (this->fields.structure[i].type->contains_sampler())
 122             return true;
 123       }
 124       return false;
 125    } else {
 126       return this->is_sampler();
 127    }
 128 }
 129
 130 gl_texture_index
 131 glsl_type::sampler_index() const
 132 {
 133    const glsl_type *const t = (this->is_array()) ? this->fields.array : this;
 134
 135    assert(t->is_sampler());
 136
 137    switch (t->sampler_dimensionality) {
 138    case GLSL_SAMPLER_DIM_1D:
 139       return (t->sampler_array) ? TEXTURE_1D_ARRAY_INDEX : TEXTURE_1D_INDEX;
 140    case GLSL_SAMPLER_DIM_2D:
 141       return (t->sampler_array) ? TEXTURE_2D_ARRAY_INDEX : TEXTURE_2D_INDEX;
 142    case GLSL_SAMPLER_DIM_3D:
 143       return TEXTURE_3D_INDEX;
 144    case GLSL_SAMPLER_DIM_CUBE:
 145       return TEXTURE_CUBE_INDEX;
 146    case GLSL_SAMPLER_DIM_RECT:
 147       return TEXTURE_RECT_INDEX;
 148    case GLSL_SAMPLER_DIM_BUF:
 149       assert(!"FINISHME: Implement ARB_texture_buffer_object");
 150       return TEXTURE_BUFFER_INDEX;
 151    case GLSL_SAMPLER_DIM_EXTERNAL:
 152       return TEXTURE_EXTERNAL_INDEX;
 153    default:
 154       assert(!"Should not get here.");
 155       return TEXTURE_BUFFER_INDEX;
 156    }
 157 }
 158
 159 void
 160 glsl_type::generate_100ES_types(glsl_symbol_table *symtab)
 161 {
 162    add_types_to_symbol_table(symtab, builtin_core_types,
 163                              Elements(builtin_core_types),
 164                              false);
 165    add_types_to_symbol_table(symtab, builtin_structure_types,
 166                              Elements(builtin_structure_types),
 167                              false);
 168    add_types_to_symbol_table(symtab, void_type, 1, false);
 169 }
 170
 171 void
 172 glsl_type::generate_110_types(glsl_symbol_table *symtab)
 173 {
 174    generate_100ES_types(symtab);
 175
 176    add_types_to_symbol_table(symtab, builtin_110_types,
 177                              Elements(builtin_110_types),
 178                              false);
 179    add_types_to_symbol_table(symtab, &_sampler3D_type, 1, false);
 180    add_types_to_symbol_table(symtab, builtin_110_deprecated_structure_types,
 181                              Elements(builtin_110_deprecated_structure_types),
 182                              false);
 183 }
 184
 185
 186 void
 187 glsl_type::generate_120_types(glsl_symbol_table *symtab)
 188 {
 189    generate_110_types(symtab);
 190
 191    add_types_to_symbol_table(symtab, builtin_120_types,
 192                              Elements(builtin_120_types), false);
 193 }
 194
 195
 196 void
 197 glsl_type::generate_130_types(glsl_symbol_table *symtab)
 198 {
 199    generate_120_types(symtab);
 200
 201    add_types_to_symbol_table(symtab, builtin_130_types,
 202                              Elements(builtin_130_types), false);
 203    generate_EXT_texture_array_types(symtab, false);
 204 }
 205
 206
 207 void
 208 glsl_type::generate_ARB_texture_rectangle_types(glsl_symbol_table *symtab,
 209                                                 bool warn)
 210 {
 211    add_types_to_symbol_table(symtab, builtin_ARB_texture_rectangle_types,
 212                              Elements(builtin_ARB_texture_rectangle_types),
 213                              warn);
 214 }
 215
 216
 217 void
 218 glsl_type::generate_EXT_texture_array_types(glsl_symbol_table *symtab,
 219                                             bool warn)
 220 {
 221    add_types_to_symbol_table(symtab, builtin_EXT_texture_array_types,
 222                              Elements(builtin_EXT_texture_array_types),
 223                              warn);
 224 }
 225
 226
 227 void
 228 glsl_type::generate_OES_texture_3D_types(glsl_symbol_table *symtab, bool warn)
 229 {
 230    add_types_to_symbol_table(symtab, &_sampler3D_type, 1, warn);
 231 }
 232
 233
 234 void
 235 glsl_type::generate_OES_EGL_image_external_types(glsl_symbol_table *symtab,
 236                                                  bool warn)
 237 {
 238    add_types_to_symbol_table(symtab, builtin_OES_EGL_image_external_types,
 239                              Elements(builtin_OES_EGL_image_external_types),
 240                              warn);
 241 }
 242
 243 void
 244 _mesa_glsl_initialize_types(struct _mesa_glsl_parse_state *state)
 245 {
 246    switch (state->language_version) {
 247    case 100:
 248       assert(state->es_shader);
 249       glsl_type::generate_100ES_types(state->symbols);
 250       break;
 251    case 110:
 252       glsl_type::generate_110_types(state->symbols);
 253       break;
 254    case 120:
 255       glsl_type::generate_120_types(state->symbols);
 256       break;
 257    case 130:
 258       glsl_type::generate_130_types(state->symbols);
 259       break;
 260    default:
 261       /* error */
 262       break;
 263    }
 264
 265    if (state->ARB_texture_rectangle_enable) {
 266       glsl_type::generate_ARB_texture_rectangle_types(state->symbols,
 267                                            state->ARB_texture_rectangle_warn);
 268    }
 269    if (state->OES_texture_3D_enable && state->language_version == 100) {
 270       glsl_type::generate_OES_texture_3D_types(state->symbols,
 271                                                state->OES_texture_3D_warn);
 272    }
 273
 274    if (state->EXT_texture_array_enable && state->language_version < 130) {
 275       // These are already included in 130; don't create twice.
 276       glsl_type::generate_EXT_texture_array_types(state->symbols,
 277                                        state->EXT_texture_array_warn);
 278    }
 279
 280    /* We cannot check for language_version == 100 here because we need the
 281     * types to support fixed-function program generation.  But this is fine
 282     * since the extension is never enabled for OpenGL contexts.
 283     */
 284    if (state->OES_EGL_image_external_enable) {
 285       glsl_type::generate_OES_EGL_image_external_types(state->symbols,
 286                                                state->OES_EGL_image_external_warn);
 287    }
 288 }
 289
 290
 291 const glsl_type *glsl_type::get_base_type() const
 292 {
 293    switch (base_type) {
 294    case GLSL_TYPE_UINT:
 295       return uint_type;
 296    case GLSL_TYPE_INT:
 297       return int_type;
 298    case GLSL_TYPE_FLOAT:
 299       return float_type;
 300    case GLSL_TYPE_BOOL:
 301       return bool_type;
 302    default:
 303       return error_type;
 304    }
 305 }
 306
 307
 308 const glsl_type *glsl_type::get_scalar_type() const
 309 {
 310    const glsl_type *type = this;
 311
 312    /* Handle arrays */
 313    while (type->base_type == GLSL_TYPE_ARRAY)
 314       type = type->fields.array;
 315
 316    /* Handle vectors and matrices */
 317    switch (type->base_type) {
 318    case GLSL_TYPE_UINT:
 319       return uint_type;
 320    case GLSL_TYPE_INT:
 321       return int_type;
 322    case GLSL_TYPE_FLOAT:
 323       return float_type;
 324    default:
 325       /* Handle everything else */
 326       return type;
 327    }
 328 }
 329
 330
 331 void
 332 _mesa_glsl_release_types(void)
 333 {
 334    if (glsl_type::array_types != NULL) {
 335       hash_table_dtor(glsl_type::array_types);
 336       glsl_type::array_types = NULL;
 337    }
 338
 339    if (glsl_type::record_types != NULL) {
 340       hash_table_dtor(glsl_type::record_types);
 341       glsl_type::record_types = NULL;
 342    }
 343 }
 344
 345
 346 glsl_type::glsl_type(const glsl_type *array, unsigned length) :
 347    base_type(GLSL_TYPE_ARRAY),
 348    sampler_dimensionality(0), sampler_shadow(0), sampler_array(0),
 349    sampler_type(0),
 350    vector_elements(0), matrix_columns(0),
 351    name(NULL), length(length)
 352 {
 353    this->fields.array = array;
 354    /* Inherit the gl type of the base. The GL type is used for
 355     * uniform/statevar handling in Mesa and the arrayness of the type
 356     * is represented by the size rather than the type.
 357     */
 358    this->gl_type = array->gl_type;
 359
 360    /* Allow a maximum of 10 characters for the array size.  This is enough
 361     * for 32-bits of ~0.  The extra 3 are for the '[', ']', and terminating
 362     * NUL.
 363     */
 364    const unsigned name_length = strlen(array->name) + 10 + 3;
 365    char *const n = (char *) ralloc_size(this->mem_ctx, name_length);
 366
 367    if (length == 0)
 368       snprintf(n, name_length, "%s[]", array->name);
 369    else
 370       snprintf(n, name_length, "%s[%u]", array->name, length);
 371
 372    this->name = n;
 373 }
 374
 375
 376 const glsl_type *
 377 glsl_type::get_instance(unsigned base_type, unsigned rows, unsigned columns)
 378 {
 379    if (base_type == GLSL_TYPE_VOID)
 380       return void_type;
 381
 382    if ((rows < 1) || (rows > 4) || (columns < 1) || (columns > 4))
 383       return error_type;
 384
 385    /* Treat GLSL vectors as Nx1 matrices.
 386     */
 387    if (columns == 1) {
 388       switch (base_type) {
 389       case GLSL_TYPE_UINT:
 390          return uint_type + (rows - 1);
 391       case GLSL_TYPE_INT:
 392          return int_type + (rows - 1);
 393       case GLSL_TYPE_FLOAT:
 394          return float_type + (rows - 1);
 395       case GLSL_TYPE_BOOL:
 396          return bool_type + (rows - 1);
 397       default:
 398          return error_type;
 399       }
 400    } else {
 401       if ((base_type != GLSL_TYPE_FLOAT) || (rows == 1))
 402          return error_type;
 403
 404       /* GLSL matrix types are named mat{COLUMNS}x{ROWS}.  Only the following
 405        * combinations are valid:
 406        *
 407        *   1 2 3 4
 408        * 1
 409        * 2   x x x
 410        * 3   x x x
 411        * 4   x x x
 412        */
 413 #define IDX(c,r) (((c-1)*3) + (r-1))
 414
 415       switch (IDX(columns, rows)) {
 416       case IDX(2,2): return mat2_type;
 417       case IDX(2,3): return mat2x3_type;
 418       case IDX(2,4): return mat2x4_type;
 419       case IDX(3,2): return mat3x2_type;
 420       case IDX(3,3): return mat3_type;
 421       case IDX(3,4): return mat3x4_type;
 422       case IDX(4,2): return mat4x2_type;
 423       case IDX(4,3): return mat4x3_type;
 424       case IDX(4,4): return mat4_type;
 425       default: return error_type;
 426       }
 427    }
 428
 429    assert(!"Should not get here.");
 430    return error_type;
 431 }
 432
 433
 434 const glsl_type *
 435 glsl_type::get_array_instance(const glsl_type *base, unsigned array_size)
 436 {
 437
 438    if (array_types == NULL) {
 439       array_types = hash_table_ctor(64, hash_table_string_hash,
 440                                     hash_table_string_compare);
 441    }
 442
 443    /* Generate a name using the base type pointer in the key.  This is
 444     * done because the name of the base type may not be unique across
 445     * shaders.  For example, two shaders may have different record types
 446     * named 'foo'.
 447     */
 448    char key[128];
 449    snprintf(key, sizeof(key), "%p[%u]", (void *) base, array_size);
 450
 451    const glsl_type *t = (glsl_type *) hash_table_find(array_types, key);
 452    if (t == NULL) {
 453       t = new glsl_type(base, array_size);
 454
 455       hash_table_insert(array_types, (void *) t, ralloc_strdup(mem_ctx, key));
 456    }
 457
 458    assert(t->base_type == GLSL_TYPE_ARRAY);
 459    assert(t->length == array_size);
 460    assert(t->fields.array == base);
 461
 462    return t;
 463 }
 464
 465
 466 int
 467 glsl_type::record_key_compare(const void *a, const void *b)
 468 {
 469    const glsl_type *const key1 = (glsl_type *) a;
 470    const glsl_type *const key2 = (glsl_type *) b;
 471
 472    /* Return zero is the types match (there is zero difference) or non-zero
 473     * otherwise.
 474     */
 475    if (strcmp(key1->name, key2->name) != 0)
 476       return 1;
 477
 478    if (key1->length != key2->length)
 479       return 1;
 480
 481    for (unsigned i = 0; i < key1->length; i++) {
 482       if (key1->fields.structure[i].type != key2->fields.structure[i].type)
 483          return 1;
 484       if (strcmp(key1->fields.structure[i].name,
 485                  key2->fields.structure[i].name) != 0)
 486          return 1;
 487    }
 488
 489    return 0;
 490 }
 491
 492
 493 unsigned
 494 glsl_type::record_key_hash(const void *a)
 495 {
 496    const glsl_type *const key = (glsl_type *) a;
 497    char hash_key[128];
 498    unsigned size = 0;
 499
 500    size = snprintf(hash_key, sizeof(hash_key), "%08x", key->length);
 501
 502    for (unsigned i = 0; i < key->length; i++) {
 503       if (size >= sizeof(hash_key))
 504          break;
 505
 506       size += snprintf(& hash_key[size], sizeof(hash_key) - size,
 507                        "%p", (void *) key->fields.structure[i].type);
 508    }
 509
 510    return hash_table_string_hash(& hash_key);
 511 }
 512
 513
 514 const glsl_type *
 515 glsl_type::get_record_instance(const glsl_struct_field *fields,
 516                                unsigned num_fields,
 517                                const char *name)
 518 {
 519    const glsl_type key(fields, num_fields, name);
 520
 521    if (record_types == NULL) {
 522       record_types = hash_table_ctor(64, record_key_hash, record_key_compare);
 523    }
 524
 525    const glsl_type *t = (glsl_type *) hash_table_find(record_types, & key);
 526    if (t == NULL) {
 527       t = new glsl_type(fields, num_fields, name);
 528
 529       hash_table_insert(record_types, (void *) t, t);
 530    }
 531
 532    assert(t->base_type == GLSL_TYPE_STRUCT);
 533    assert(t->length == num_fields);
 534    assert(strcmp(t->name, name) == 0);
 535
 536    return t;
 537 }
 538
 539
 540 const glsl_type *
 541 glsl_type::field_type(const char *name) const
 542 {
 543    if (this->base_type != GLSL_TYPE_STRUCT)
 544       return error_type;
 545
 546    for (unsigned i = 0; i < this->length; i++) {
 547       if (strcmp(name, this->fields.structure[i].name) == 0)
 548          return this->fields.structure[i].type;
 549    }
 550
 551    return error_type;
 552 }
 553
 554
 555 int
 556 glsl_type::field_index(const char *name) const
 557 {
 558    if (this->base_type != GLSL_TYPE_STRUCT)
 559       return -1;
 560
 561    for (unsigned i = 0; i < this->length; i++) {
 562       if (strcmp(name, this->fields.structure[i].name) == 0)
 563          return i;
 564    }
 565
 566    return -1;
 567 }
 568
 569
 570 unsigned
 571 glsl_type::component_slots() const
 572 {
 573    switch (this->base_type) {
 574    case GLSL_TYPE_UINT:
 575    case GLSL_TYPE_INT:
 576    case GLSL_TYPE_FLOAT:
 577    case GLSL_TYPE_BOOL:
 578       return this->components();
 579
 580    case GLSL_TYPE_STRUCT: {
 581       unsigned size = 0;
 582
 583       for (unsigned i = 0; i < this->length; i++)
 584          size += this->fields.structure[i].type->component_slots();
 585
 586       return size;
 587    }
 588
 589    case GLSL_TYPE_ARRAY:
 590       return this->length * this->fields.array->component_slots();
 591
 592    default:
 593       return 0;
 594    }
 595 }
 596
 597 bool
 598 glsl_type::can_implicitly_convert_to(const glsl_type *desired) const
 599 {
 600    if (this == desired)
 601       return true;
 602
 603    /* There is no conversion among matrix types. */
 604    if (this->matrix_columns > 1 || desired->matrix_columns > 1)
 605       return false;
 606
 607    /* int and uint can be converted to float. */
 608    return desired->is_float()
 609           && this->is_integer()
 610           && this->vector_elements == desired->vector_elements;
 611 }