nir: Add test file for vars related passes
[mesa.git] / src / compiler / glsl_types.h
1 /* -*- c++ -*- */
2 /*
3 * Copyright © 2009 Intel Corporation
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
22 * DEALINGS IN THE SOFTWARE.
23 */
24
25 #ifndef GLSL_TYPES_H
26 #define GLSL_TYPES_H
27
28 #include <string.h>
29 #include <assert.h>
30
31 #include "shader_enums.h"
32 #include "blob.h"
33 #include "c11/threads.h"
34
35 #ifdef __cplusplus
36 #include "main/config.h"
37 #endif
38
39 struct glsl_type;
40
41 #ifdef __cplusplus
42 extern "C" {
43 #endif
44
45 struct _mesa_glsl_parse_state;
46 struct glsl_symbol_table;
47
48 extern void
49 _mesa_glsl_initialize_types(struct _mesa_glsl_parse_state *state);
50
51 extern void
52 _mesa_glsl_release_types(void);
53
54 void encode_type_to_blob(struct blob *blob, const struct glsl_type *type);
55
56 const struct glsl_type *decode_type_from_blob(struct blob_reader *blob);
57
58 #ifdef __cplusplus
59 }
60 #endif
61
62 enum glsl_base_type {
63 /* Note: GLSL_TYPE_UINT, GLSL_TYPE_INT, and GLSL_TYPE_FLOAT must be 0, 1,
64 * and 2 so that they will fit in the 2 bits of glsl_type::sampled_type.
65 */
66 GLSL_TYPE_UINT = 0,
67 GLSL_TYPE_INT,
68 GLSL_TYPE_FLOAT,
69 GLSL_TYPE_FLOAT16,
70 GLSL_TYPE_DOUBLE,
71 GLSL_TYPE_UINT8,
72 GLSL_TYPE_INT8,
73 GLSL_TYPE_UINT16,
74 GLSL_TYPE_INT16,
75 GLSL_TYPE_UINT64,
76 GLSL_TYPE_INT64,
77 GLSL_TYPE_BOOL,
78 GLSL_TYPE_SAMPLER,
79 GLSL_TYPE_IMAGE,
80 GLSL_TYPE_ATOMIC_UINT,
81 GLSL_TYPE_STRUCT,
82 GLSL_TYPE_INTERFACE,
83 GLSL_TYPE_ARRAY,
84 GLSL_TYPE_VOID,
85 GLSL_TYPE_SUBROUTINE,
86 GLSL_TYPE_FUNCTION,
87 GLSL_TYPE_ERROR
88 };
89
90 static inline bool glsl_base_type_is_16bit(enum glsl_base_type type)
91 {
92 return type == GLSL_TYPE_FLOAT16 ||
93 type == GLSL_TYPE_UINT16 ||
94 type == GLSL_TYPE_INT16;
95 }
96
97 static inline bool glsl_base_type_is_64bit(enum glsl_base_type type)
98 {
99 return type == GLSL_TYPE_DOUBLE ||
100 type == GLSL_TYPE_UINT64 ||
101 type == GLSL_TYPE_INT64 ||
102 type == GLSL_TYPE_IMAGE ||
103 type == GLSL_TYPE_SAMPLER;
104 }
105
106 static inline bool glsl_base_type_is_integer(enum glsl_base_type type)
107 {
108 return type == GLSL_TYPE_UINT ||
109 type == GLSL_TYPE_INT ||
110 type == GLSL_TYPE_UINT64 ||
111 type == GLSL_TYPE_INT64 ||
112 type == GLSL_TYPE_BOOL ||
113 type == GLSL_TYPE_SAMPLER ||
114 type == GLSL_TYPE_IMAGE;
115 }
116
117 enum glsl_sampler_dim {
118 GLSL_SAMPLER_DIM_1D = 0,
119 GLSL_SAMPLER_DIM_2D,
120 GLSL_SAMPLER_DIM_3D,
121 GLSL_SAMPLER_DIM_CUBE,
122 GLSL_SAMPLER_DIM_RECT,
123 GLSL_SAMPLER_DIM_BUF,
124 GLSL_SAMPLER_DIM_EXTERNAL,
125 GLSL_SAMPLER_DIM_MS,
126 GLSL_SAMPLER_DIM_SUBPASS, /* for vulkan input attachments */
127 GLSL_SAMPLER_DIM_SUBPASS_MS, /* for multisampled vulkan input attachments */
128 };
129
130 enum glsl_matrix_layout {
131 /**
132 * The layout of the matrix is inherited from the object containing the
133 * matrix (the top level structure or the uniform block).
134 */
135 GLSL_MATRIX_LAYOUT_INHERITED,
136
137 /**
138 * Explicit column-major layout
139 *
140 * If a uniform block doesn't have an explicit layout set, it will default
141 * to this layout.
142 */
143 GLSL_MATRIX_LAYOUT_COLUMN_MAJOR,
144
145 /**
146 * Row-major layout
147 */
148 GLSL_MATRIX_LAYOUT_ROW_MAJOR
149 };
150
151 enum {
152 GLSL_PRECISION_NONE = 0,
153 GLSL_PRECISION_HIGH,
154 GLSL_PRECISION_MEDIUM,
155 GLSL_PRECISION_LOW
156 };
157
158 #ifdef __cplusplus
159 #include "GL/gl.h"
160 #include "util/ralloc.h"
161 #include "main/menums.h" /* for gl_texture_index, C++'s enum rules are broken */
162
163 struct glsl_type {
164 GLenum gl_type;
165 glsl_base_type base_type:8;
166
167 glsl_base_type sampled_type:8; /**< Type of data returned using this
168 * sampler or image. Only \c
169 * GLSL_TYPE_FLOAT, \c GLSL_TYPE_INT,
170 * and \c GLSL_TYPE_UINT are valid.
171 */
172
173 unsigned sampler_dimensionality:4; /**< \see glsl_sampler_dim */
174 unsigned sampler_shadow:1;
175 unsigned sampler_array:1;
176 unsigned interface_packing:2;
177 unsigned interface_row_major:1;
178
179 private:
180 glsl_type() : mem_ctx(NULL)
181 {
182 // Dummy constructor, just for the sake of ASSERT_BITFIELD_SIZE.
183 }
184
185 public:
186 /**
187 * \name Vector and matrix element counts
188 *
189 * For scalars, each of these values will be 1. For non-numeric types
190 * these will be 0.
191 */
192 /*@{*/
193 uint8_t vector_elements; /**< 1, 2, 3, or 4 vector elements. */
194 uint8_t matrix_columns; /**< 1, 2, 3, or 4 matrix columns. */
195 /*@}*/
196
197 /**
198 * For \c GLSL_TYPE_ARRAY, this is the length of the array. For
199 * \c GLSL_TYPE_STRUCT or \c GLSL_TYPE_INTERFACE, it is the number of
200 * elements in the structure and the number of values pointed to by
201 * \c fields.structure (below).
202 */
203 unsigned length;
204
205 /**
206 * Name of the data type
207 *
208 * Will never be \c NULL.
209 */
210 const char *name;
211
212 /**
213 * Subtype of composite data types.
214 */
215 union {
216 const struct glsl_type *array; /**< Type of array elements. */
217 struct glsl_function_param *parameters; /**< Parameters to function. */
218 struct glsl_struct_field *structure; /**< List of struct fields. */
219 } fields;
220
221 /**
222 * \name Pointers to various public type singletons
223 */
224 /*@{*/
225 #undef DECL_TYPE
226 #define DECL_TYPE(NAME, ...) \
227 static const glsl_type *const NAME##_type;
228 #undef STRUCT_TYPE
229 #define STRUCT_TYPE(NAME) \
230 static const glsl_type *const struct_##NAME##_type;
231 #include "compiler/builtin_type_macros.h"
232 /*@}*/
233
234 /**
235 * Convenience accessors for vector types (shorter than get_instance()).
236 * @{
237 */
238 static const glsl_type *vec(unsigned components, const glsl_type *const ts[]);
239 static const glsl_type *vec(unsigned components);
240 static const glsl_type *f16vec(unsigned components);
241 static const glsl_type *dvec(unsigned components);
242 static const glsl_type *ivec(unsigned components);
243 static const glsl_type *uvec(unsigned components);
244 static const glsl_type *bvec(unsigned components);
245 static const glsl_type *i64vec(unsigned components);
246 static const glsl_type *u64vec(unsigned components);
247 static const glsl_type *i16vec(unsigned components);
248 static const glsl_type *u16vec(unsigned components);
249 static const glsl_type *i8vec(unsigned components);
250 static const glsl_type *u8vec(unsigned components);
251 /**@}*/
252
253 /**
254 * For numeric and boolean derived types returns the basic scalar type
255 *
256 * If the type is a numeric or boolean scalar, vector, or matrix type,
257 * this function gets the scalar type of the individual components. For
258 * all other types, including arrays of numeric or boolean types, the
259 * error type is returned.
260 */
261 const glsl_type *get_base_type() const;
262
263 /**
264 * Get the basic scalar type which this type aggregates.
265 *
266 * If the type is a numeric or boolean scalar, vector, or matrix, or an
267 * array of any of those, this function gets the scalar type of the
268 * individual components. For structs and arrays of structs, this function
269 * returns the struct type. For samplers and arrays of samplers, this
270 * function returns the sampler type.
271 */
272 const glsl_type *get_scalar_type() const;
273
274 /**
275 * Get the instance of a built-in scalar, vector, or matrix type
276 */
277 static const glsl_type *get_instance(unsigned base_type, unsigned rows,
278 unsigned columns);
279
280 /**
281 * Get the instance of a sampler type
282 */
283 static const glsl_type *get_sampler_instance(enum glsl_sampler_dim dim,
284 bool shadow,
285 bool array,
286 glsl_base_type type);
287
288 static const glsl_type *get_image_instance(enum glsl_sampler_dim dim,
289 bool array, glsl_base_type type);
290
291 /**
292 * Get the instance of an array type
293 */
294 static const glsl_type *get_array_instance(const glsl_type *base,
295 unsigned elements);
296
297 /**
298 * Get the instance of a record type
299 */
300 static const glsl_type *get_record_instance(const glsl_struct_field *fields,
301 unsigned num_fields,
302 const char *name);
303
304 /**
305 * Get the instance of an interface block type
306 */
307 static const glsl_type *get_interface_instance(const glsl_struct_field *fields,
308 unsigned num_fields,
309 enum glsl_interface_packing packing,
310 bool row_major,
311 const char *block_name);
312
313 /**
314 * Get the instance of an subroutine type
315 */
316 static const glsl_type *get_subroutine_instance(const char *subroutine_name);
317
318 /**
319 * Get the instance of a function type
320 */
321 static const glsl_type *get_function_instance(const struct glsl_type *return_type,
322 const glsl_function_param *parameters,
323 unsigned num_params);
324
325 /**
326 * Get the type resulting from a multiplication of \p type_a * \p type_b
327 */
328 static const glsl_type *get_mul_type(const glsl_type *type_a,
329 const glsl_type *type_b);
330
331 /**
332 * Query the total number of scalars that make up a scalar, vector or matrix
333 */
334 unsigned components() const
335 {
336 return vector_elements * matrix_columns;
337 }
338
339 /**
340 * Calculate the number of components slots required to hold this type
341 *
342 * This is used to determine how many uniform or varying locations a type
343 * might occupy.
344 */
345 unsigned component_slots() const;
346
347 /**
348 * Calculate offset between the base location of the struct in
349 * uniform storage and a struct member.
350 * For the initial call, length is the index of the member to find the
351 * offset for.
352 */
353 unsigned record_location_offset(unsigned length) const;
354
355 /**
356 * Calculate the number of unique values from glGetUniformLocation for the
357 * elements of the type.
358 *
359 * This is used to allocate slots in the UniformRemapTable, the amount of
360 * locations may not match with actual used storage space by the driver.
361 */
362 unsigned uniform_locations() const;
363
364 /**
365 * Used to count the number of varyings contained in the type ignoring
366 * innermost array elements.
367 */
368 unsigned varying_count() const;
369
370 /**
371 * Calculate the number of attribute slots required to hold this type
372 *
373 * This implements the language rules of GLSL 1.50 for counting the number
374 * of slots used by a vertex attribute. It also determines the number of
375 * varying slots the type will use up in the absence of varying packing
376 * (and thus, it can be used to measure the number of varying slots used by
377 * the varyings that are generated by lower_packed_varyings).
378 *
379 * For vertex shader attributes - doubles only take one slot.
380 * For inter-shader varyings - dvec3/dvec4 take two slots.
381 */
382 unsigned count_attribute_slots(bool is_vertex_input) const;
383
384 /**
385 * Alignment in bytes of the start of this type in a std140 uniform
386 * block.
387 */
388 unsigned std140_base_alignment(bool row_major) const;
389
390 /** Size in bytes of this type in a std140 uniform block.
391 *
392 * Note that this is not GL_UNIFORM_SIZE (which is the number of
393 * elements in the array)
394 */
395 unsigned std140_size(bool row_major) const;
396
397 /**
398 * Alignment in bytes of the start of this type in a std430 shader
399 * storage block.
400 */
401 unsigned std430_base_alignment(bool row_major) const;
402
403 /**
404 * Calculate array stride in bytes of this type in a std430 shader storage
405 * block.
406 */
407 unsigned std430_array_stride(bool row_major) const;
408
409 /**
410 * Size in bytes of this type in a std430 shader storage block.
411 *
412 * Note that this is not GL_BUFFER_SIZE
413 */
414 unsigned std430_size(bool row_major) const;
415
416 /**
417 * \brief Can this type be implicitly converted to another?
418 *
419 * \return True if the types are identical or if this type can be converted
420 * to \c desired according to Section 4.1.10 of the GLSL spec.
421 *
422 * \verbatim
423 * From page 25 (31 of the pdf) of the GLSL 1.50 spec, Section 4.1.10
424 * Implicit Conversions:
425 *
426 * In some situations, an expression and its type will be implicitly
427 * converted to a different type. The following table shows all allowed
428 * implicit conversions:
429 *
430 * Type of expression | Can be implicitly converted to
431 * --------------------------------------------------
432 * int float
433 * uint
434 *
435 * ivec2 vec2
436 * uvec2
437 *
438 * ivec3 vec3
439 * uvec3
440 *
441 * ivec4 vec4
442 * uvec4
443 *
444 * There are no implicit array or structure conversions. For example,
445 * an array of int cannot be implicitly converted to an array of float.
446 * There are no implicit conversions between signed and unsigned
447 * integers.
448 * \endverbatim
449 */
450 bool can_implicitly_convert_to(const glsl_type *desired,
451 _mesa_glsl_parse_state *state) const;
452
453 /**
454 * Query whether or not a type is a scalar (non-vector and non-matrix).
455 */
456 bool is_scalar() const
457 {
458 return (vector_elements == 1)
459 && (base_type >= GLSL_TYPE_UINT)
460 && (base_type <= GLSL_TYPE_IMAGE);
461 }
462
463 /**
464 * Query whether or not a type is a vector
465 */
466 bool is_vector() const
467 {
468 return (vector_elements > 1)
469 && (matrix_columns == 1)
470 && (base_type >= GLSL_TYPE_UINT)
471 && (base_type <= GLSL_TYPE_BOOL);
472 }
473
474 /**
475 * Query whether or not a type is a matrix
476 */
477 bool is_matrix() const
478 {
479 /* GLSL only has float matrices. */
480 return (matrix_columns > 1) && (base_type == GLSL_TYPE_FLOAT ||
481 base_type == GLSL_TYPE_DOUBLE ||
482 base_type == GLSL_TYPE_FLOAT16);
483 }
484
485 /**
486 * Query whether or not a type is a non-array numeric type
487 */
488 bool is_numeric() const
489 {
490 return (base_type >= GLSL_TYPE_UINT) && (base_type <= GLSL_TYPE_INT64);
491 }
492
493 /**
494 * Query whether or not a type is an integral type
495 */
496 bool is_integer() const
497 {
498 return (base_type == GLSL_TYPE_UINT) || (base_type == GLSL_TYPE_INT);
499 }
500
501 /**
502 * Query whether or not a type is a 64-bit integer.
503 */
504 bool is_integer_64() const
505 {
506 return base_type == GLSL_TYPE_UINT64 || base_type == GLSL_TYPE_INT64;
507 }
508
509 /**
510 * Query whether or not a type is a 32-bit or 64-bit integer
511 */
512 bool is_integer_32_64() const
513 {
514 return is_integer() || is_integer_64();
515 }
516
517 /**
518 * Query whether or not type is an integral type, or for struct and array
519 * types, contains an integral type.
520 */
521 bool contains_integer() const;
522
523 /**
524 * Query whether or not type is a double type, or for struct, interface and
525 * array types, contains a double type.
526 */
527 bool contains_double() const;
528
529 /**
530 * Query whether or not a type is a float type
531 */
532 bool is_float() const
533 {
534 return base_type == GLSL_TYPE_FLOAT;
535 }
536
537 /**
538 * Query whether or not a type is a double type
539 */
540 bool is_double() const
541 {
542 return base_type == GLSL_TYPE_DOUBLE;
543 }
544
545 /**
546 * Query whether a 64-bit type takes two slots.
547 */
548 bool is_dual_slot() const
549 {
550 return is_64bit() && vector_elements > 2;
551 }
552
553 /**
554 * Query whether or not a type is 64-bit
555 */
556 bool is_64bit() const
557 {
558 return glsl_base_type_is_64bit(base_type);
559 }
560
561 /**
562 * Query whether or not a type is 16-bit
563 */
564 bool is_16bit() const
565 {
566 return glsl_base_type_is_16bit(base_type);
567 }
568
569 /**
570 * Query whether or not a type is a non-array boolean type
571 */
572 bool is_boolean() const
573 {
574 return base_type == GLSL_TYPE_BOOL;
575 }
576
577 /**
578 * Query whether or not a type is a sampler
579 */
580 bool is_sampler() const
581 {
582 return base_type == GLSL_TYPE_SAMPLER;
583 }
584
585 /**
586 * Query whether or not type is a sampler, or for struct, interface and
587 * array types, contains a sampler.
588 */
589 bool contains_sampler() const;
590
591 /**
592 * Query whether or not type is an array or for struct, interface and
593 * array types, contains an array.
594 */
595 bool contains_array() const;
596
597 /**
598 * Get the Mesa texture target index for a sampler type.
599 */
600 gl_texture_index sampler_index() const;
601
602 /**
603 * Query whether or not type is an image, or for struct, interface and
604 * array types, contains an image.
605 */
606 bool contains_image() const;
607
608 /**
609 * Query whether or not a type is an image
610 */
611 bool is_image() const
612 {
613 return base_type == GLSL_TYPE_IMAGE;
614 }
615
616 /**
617 * Query whether or not a type is an array
618 */
619 bool is_array() const
620 {
621 return base_type == GLSL_TYPE_ARRAY;
622 }
623
624 bool is_array_of_arrays() const
625 {
626 return is_array() && fields.array->is_array();
627 }
628
629 /**
630 * Query whether or not a type is a record
631 */
632 bool is_record() const
633 {
634 return base_type == GLSL_TYPE_STRUCT;
635 }
636
637 /**
638 * Query whether or not a type is an interface
639 */
640 bool is_interface() const
641 {
642 return base_type == GLSL_TYPE_INTERFACE;
643 }
644
645 /**
646 * Query whether or not a type is the void type singleton.
647 */
648 bool is_void() const
649 {
650 return base_type == GLSL_TYPE_VOID;
651 }
652
653 /**
654 * Query whether or not a type is the error type singleton.
655 */
656 bool is_error() const
657 {
658 return base_type == GLSL_TYPE_ERROR;
659 }
660
661 /**
662 * Query if a type is unnamed/anonymous (named by the parser)
663 */
664
665 bool is_subroutine() const
666 {
667 return base_type == GLSL_TYPE_SUBROUTINE;
668 }
669 bool contains_subroutine() const;
670
671 bool is_anonymous() const
672 {
673 return !strncmp(name, "#anon", 5);
674 }
675
676 /**
677 * Get the type stripped of any arrays
678 *
679 * \return
680 * Pointer to the type of elements of the first non-array type for array
681 * types, or pointer to itself for non-array types.
682 */
683 const glsl_type *without_array() const
684 {
685 const glsl_type *t = this;
686
687 while (t->is_array())
688 t = t->fields.array;
689
690 return t;
691 }
692
693 /**
694 * Return the total number of elements in an array including the elements
695 * in arrays of arrays.
696 */
697 unsigned arrays_of_arrays_size() const
698 {
699 if (!is_array())
700 return 0;
701
702 unsigned size = length;
703 const glsl_type *base_type = fields.array;
704
705 while (base_type->is_array()) {
706 size = size * base_type->length;
707 base_type = base_type->fields.array;
708 }
709 return size;
710 }
711
712 /**
713 * Query whether or not a type is an atomic_uint.
714 */
715 bool is_atomic_uint() const
716 {
717 return base_type == GLSL_TYPE_ATOMIC_UINT;
718 }
719
720 /**
721 * Return the amount of atomic counter storage required for a type.
722 */
723 unsigned atomic_size() const
724 {
725 if (is_atomic_uint())
726 return ATOMIC_COUNTER_SIZE;
727 else if (is_array())
728 return length * fields.array->atomic_size();
729 else
730 return 0;
731 }
732
733 /**
734 * Return whether a type contains any atomic counters.
735 */
736 bool contains_atomic() const
737 {
738 return atomic_size() > 0;
739 }
740
741 /**
742 * Return whether a type contains any opaque types.
743 */
744 bool contains_opaque() const;
745
746 /**
747 * Query the full type of a matrix row
748 *
749 * \return
750 * If the type is not a matrix, \c glsl_type::error_type is returned.
751 * Otherwise a type matching the rows of the matrix is returned.
752 */
753 const glsl_type *row_type() const
754 {
755 return is_matrix()
756 ? get_instance(base_type, matrix_columns, 1)
757 : error_type;
758 }
759
760 /**
761 * Query the full type of a matrix column
762 *
763 * \return
764 * If the type is not a matrix, \c glsl_type::error_type is returned.
765 * Otherwise a type matching the columns of the matrix is returned.
766 */
767 const glsl_type *column_type() const
768 {
769 return is_matrix()
770 ? get_instance(base_type, vector_elements, 1)
771 : error_type;
772 }
773
774 /**
775 * Get the type of a structure field
776 *
777 * \return
778 * Pointer to the type of the named field. If the type is not a structure
779 * or the named field does not exist, \c glsl_type::error_type is returned.
780 */
781 const glsl_type *field_type(const char *name) const;
782
783 /**
784 * Get the location of a field within a record type
785 */
786 int field_index(const char *name) const;
787
788 /**
789 * Query the number of elements in an array type
790 *
791 * \return
792 * The number of elements in the array for array types or -1 for non-array
793 * types. If the number of elements in the array has not yet been declared,
794 * zero is returned.
795 */
796 int array_size() const
797 {
798 return is_array() ? length : -1;
799 }
800
801 /**
802 * Query whether the array size for all dimensions has been declared.
803 */
804 bool is_unsized_array() const
805 {
806 return is_array() && length == 0;
807 }
808
809 /**
810 * Return the number of coordinate components needed for this
811 * sampler or image type.
812 *
813 * This is based purely on the sampler's dimensionality. For example, this
814 * returns 1 for sampler1D, and 3 for sampler2DArray.
815 *
816 * Note that this is often different than actual coordinate type used in
817 * a texturing built-in function, since those pack additional values (such
818 * as the shadow comparator or projector) into the coordinate type.
819 */
820 int coordinate_components() const;
821
822 /**
823 * Compare a record type against another record type.
824 *
825 * This is useful for matching record types declared across shader stages.
826 * The option to not match locations is to deal with places where the
827 * same struct is defined in a block which has a location set on it.
828 */
829 bool record_compare(const glsl_type *b, bool match_locations = true) const;
830
831 /**
832 * Get the type interface packing.
833 */
834 enum glsl_interface_packing get_interface_packing() const
835 {
836 return (enum glsl_interface_packing)interface_packing;
837 }
838
839 /**
840 * Get the type interface packing used internally. For shared and packing
841 * layouts this is implementation defined.
842 */
843 enum glsl_interface_packing get_internal_ifc_packing(bool std430_supported) const
844 {
845 enum glsl_interface_packing packing = this->get_interface_packing();
846 if (packing == GLSL_INTERFACE_PACKING_STD140 ||
847 (!std430_supported &&
848 (packing == GLSL_INTERFACE_PACKING_SHARED ||
849 packing == GLSL_INTERFACE_PACKING_PACKED))) {
850 return GLSL_INTERFACE_PACKING_STD140;
851 } else {
852 assert(packing == GLSL_INTERFACE_PACKING_STD430 ||
853 (std430_supported &&
854 (packing == GLSL_INTERFACE_PACKING_SHARED ||
855 packing == GLSL_INTERFACE_PACKING_PACKED)));
856 return GLSL_INTERFACE_PACKING_STD430;
857 }
858 }
859
860 /**
861 * Check if the type interface is row major
862 */
863 bool get_interface_row_major() const
864 {
865 return (bool) interface_row_major;
866 }
867
868 ~glsl_type();
869
870 private:
871
872 static mtx_t hash_mutex;
873
874 /**
875 * ralloc context for the type itself.
876 */
877 void *mem_ctx;
878
879 /** Constructor for vector and matrix types */
880 glsl_type(GLenum gl_type,
881 glsl_base_type base_type, unsigned vector_elements,
882 unsigned matrix_columns, const char *name);
883
884 /** Constructor for sampler or image types */
885 glsl_type(GLenum gl_type, glsl_base_type base_type,
886 enum glsl_sampler_dim dim, bool shadow, bool array,
887 glsl_base_type type, const char *name);
888
889 /** Constructor for record types */
890 glsl_type(const glsl_struct_field *fields, unsigned num_fields,
891 const char *name);
892
893 /** Constructor for interface types */
894 glsl_type(const glsl_struct_field *fields, unsigned num_fields,
895 enum glsl_interface_packing packing,
896 bool row_major, const char *name);
897
898 /** Constructor for interface types */
899 glsl_type(const glsl_type *return_type,
900 const glsl_function_param *params, unsigned num_params);
901
902 /** Constructor for array types */
903 glsl_type(const glsl_type *array, unsigned length);
904
905 /** Constructor for subroutine types */
906 glsl_type(const char *name);
907
908 /** Hash table containing the known array types. */
909 static struct hash_table *array_types;
910
911 /** Hash table containing the known record types. */
912 static struct hash_table *record_types;
913
914 /** Hash table containing the known interface types. */
915 static struct hash_table *interface_types;
916
917 /** Hash table containing the known subroutine types. */
918 static struct hash_table *subroutine_types;
919
920 /** Hash table containing the known function types. */
921 static struct hash_table *function_types;
922
923 static bool record_key_compare(const void *a, const void *b);
924 static unsigned record_key_hash(const void *key);
925
926 /**
927 * \name Built-in type flyweights
928 */
929 /*@{*/
930 #undef DECL_TYPE
931 #define DECL_TYPE(NAME, ...) static const glsl_type _##NAME##_type;
932 #undef STRUCT_TYPE
933 #define STRUCT_TYPE(NAME) static const glsl_type _struct_##NAME##_type;
934 #include "compiler/builtin_type_macros.h"
935 /*@}*/
936
937 /**
938 * \name Friend functions.
939 *
940 * These functions are friends because they must have C linkage and the
941 * need to call various private methods or access various private static
942 * data.
943 */
944 /*@{*/
945 friend void _mesa_glsl_initialize_types(struct _mesa_glsl_parse_state *);
946 friend void _mesa_glsl_release_types(void);
947 /*@}*/
948 };
949
950 #undef DECL_TYPE
951 #undef STRUCT_TYPE
952 #endif /* __cplusplus */
953
954 struct glsl_struct_field {
955 const struct glsl_type *type;
956 const char *name;
957
958 /**
959 * For interface blocks, gl_varying_slot corresponding to the input/output
960 * if this is a built-in input/output (i.e. a member of the built-in
961 * gl_PerVertex interface block); -1 otherwise.
962 *
963 * Ignored for structs.
964 */
965 int location;
966
967 /**
968 * For interface blocks, members may have an explicit byte offset
969 * specified; -1 otherwise. Also used for xfb_offset layout qualifier.
970 *
971 * Unless used for xfb_offset this field is ignored for structs.
972 */
973 int offset;
974
975 /**
976 * For interface blocks, members may define a transform feedback buffer;
977 * -1 otherwise.
978 */
979 int xfb_buffer;
980
981 /**
982 * For interface blocks, members may define a transform feedback stride;
983 * -1 otherwise.
984 */
985 int xfb_stride;
986
987 /**
988 * For interface blocks, the interpolation mode (as in
989 * ir_variable::interpolation). 0 otherwise.
990 */
991 unsigned interpolation:2;
992
993 /**
994 * For interface blocks, 1 if this variable uses centroid interpolation (as
995 * in ir_variable::centroid). 0 otherwise.
996 */
997 unsigned centroid:1;
998
999 /**
1000 * For interface blocks, 1 if this variable uses sample interpolation (as
1001 * in ir_variable::sample). 0 otherwise.
1002 */
1003 unsigned sample:1;
1004
1005 /**
1006 * Layout of the matrix. Uses glsl_matrix_layout values.
1007 */
1008 unsigned matrix_layout:2;
1009
1010 /**
1011 * For interface blocks, 1 if this variable is a per-patch input or output
1012 * (as in ir_variable::patch). 0 otherwise.
1013 */
1014 unsigned patch:1;
1015
1016 /**
1017 * Precision qualifier
1018 */
1019 unsigned precision:2;
1020
1021 /**
1022 * Memory qualifiers, applicable to buffer variables defined in shader
1023 * storage buffer objects (SSBOs)
1024 */
1025 unsigned memory_read_only:1;
1026 unsigned memory_write_only:1;
1027 unsigned memory_coherent:1;
1028 unsigned memory_volatile:1;
1029 unsigned memory_restrict:1;
1030
1031 /**
1032 * Layout format, applicable to image variables only.
1033 */
1034 unsigned image_format:16;
1035
1036 /**
1037 * Any of the xfb_* qualifiers trigger the shader to be in transform
1038 * feedback mode so we need to keep track of whether the buffer was
1039 * explicitly set or if its just been assigned the default global value.
1040 */
1041 unsigned explicit_xfb_buffer:1;
1042
1043 unsigned implicit_sized_array:1;
1044 #ifdef __cplusplus
1045 glsl_struct_field(const struct glsl_type *_type, const char *_name)
1046 : type(_type), name(_name), location(-1), offset(0), xfb_buffer(0),
1047 xfb_stride(0), interpolation(0), centroid(0),
1048 sample(0), matrix_layout(GLSL_MATRIX_LAYOUT_INHERITED), patch(0),
1049 precision(GLSL_PRECISION_NONE), memory_read_only(0),
1050 memory_write_only(0), memory_coherent(0), memory_volatile(0),
1051 memory_restrict(0), image_format(0), explicit_xfb_buffer(0),
1052 implicit_sized_array(0)
1053 {
1054 /* empty */
1055 }
1056
1057 glsl_struct_field()
1058 : type(NULL), name(NULL), location(0), offset(0), xfb_buffer(0),
1059 xfb_stride(0), interpolation(0), centroid(0),
1060 sample(0), matrix_layout(0), patch(0),
1061 precision(0), memory_read_only(0),
1062 memory_write_only(0), memory_coherent(0), memory_volatile(0),
1063 memory_restrict(0), image_format(0), explicit_xfb_buffer(0),
1064 implicit_sized_array(0)
1065 {
1066 /* empty */
1067 }
1068 #endif
1069 };
1070
1071 struct glsl_function_param {
1072 const struct glsl_type *type;
1073
1074 bool in;
1075 bool out;
1076 };
1077
1078 static inline unsigned int
1079 glsl_align(unsigned int a, unsigned int align)
1080 {
1081 return (a + align - 1) / align * align;
1082 }
1083
1084 #endif /* GLSL_TYPES_H */