2 * Copyright © 2010 Intel Corporation
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:
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
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.
26 * Convert abstract syntax to to high-level intermediate reprensentation (HIR).
28 * During the conversion to HIR, the majority of the symantic checking is
29 * preformed on the program. This includes:
31 * * Symbol table management
35 * The majority of this work could be done during parsing, and the parser could
36 * probably generate HIR directly. However, this results in frequent changes
37 * to the parser code. Since we do not assume that every system this complier
38 * is built on will have Flex and Bison installed, we have to store the code
39 * generated by these tools in our version control system. In other parts of
40 * the system we've seen problems where a parser was changed but the generated
41 * code was not committed, merge conflicts where created because two developers
42 * had slightly different versions of Bison installed, etc.
44 * I have also noticed that running Bison generated parsers in GDB is very
45 * irritating. When you get a segfault on '$$ = $1->foo', you can't very
46 * well 'print $1' in GDB.
48 * As a result, my preference is to put as little C code as possible in the
49 * parser (and lexer) sources.
52 #include "main/core.h" /* for struct gl_extensions */
53 #include "glsl_symbol_table.h"
54 #include "glsl_parser_extras.h"
56 #include "glsl_types.h"
60 _mesa_ast_to_hir(exec_list *instructions, struct _mesa_glsl_parse_state *state)
62 _mesa_glsl_initialize_variables(instructions, state);
63 _mesa_glsl_initialize_functions(state);
65 state->symbols->language_version = state->language_version;
67 state->current_function = NULL;
69 /* Section 4.2 of the GLSL 1.20 specification states:
70 * "The built-in functions are scoped in a scope outside the global scope
71 * users declare global variables in. That is, a shader's global scope,
72 * available for user-defined functions and global variables, is nested
73 * inside the scope containing the built-in functions."
75 * Since built-in functions like ftransform() access built-in variables,
76 * it follows that those must be in the outer scope as well.
78 * We push scope here to create this nesting effect...but don't pop.
79 * This way, a shader's globals are still in the symbol table for use
82 state->symbols->push_scope();
84 foreach_list_typed (ast_node, ast, link, & state->translation_unit)
85 ast->hir(instructions, state);
90 * If a conversion is available, convert one operand to a different type
92 * The \c from \c ir_rvalue is converted "in place".
94 * \param to Type that the operand it to be converted to
95 * \param from Operand that is being converted
96 * \param state GLSL compiler state
99 * If a conversion is possible (or unnecessary), \c true is returned.
100 * Otherwise \c false is returned.
103 apply_implicit_conversion(const glsl_type *to, ir_rvalue * &from,
104 struct _mesa_glsl_parse_state *state)
107 if (to->base_type == from->type->base_type)
110 /* This conversion was added in GLSL 1.20. If the compilation mode is
111 * GLSL 1.10, the conversion is skipped.
113 if (state->language_version < 120)
116 /* From page 27 (page 33 of the PDF) of the GLSL 1.50 spec:
118 * "There are no implicit array or structure conversions. For
119 * example, an array of int cannot be implicitly converted to an
120 * array of float. There are no implicit conversions between
121 * signed and unsigned integers."
123 /* FINISHME: The above comment is partially a lie. There is int/uint
124 * FINISHME: conversion for immediate constants.
126 if (!to->is_float() || !from->type->is_numeric())
129 /* Convert to a floating point type with the same number of components
130 * as the original type - i.e. int to float, not int to vec4.
132 to = glsl_type::get_instance(GLSL_TYPE_FLOAT, from->type->vector_elements,
133 from->type->matrix_columns);
135 switch (from->type->base_type) {
137 from = new(ctx) ir_expression(ir_unop_i2f, to, from, NULL);
140 from = new(ctx) ir_expression(ir_unop_u2f, to, from, NULL);
143 from = new(ctx) ir_expression(ir_unop_b2f, to, from, NULL);
153 static const struct glsl_type *
154 arithmetic_result_type(ir_rvalue * &value_a, ir_rvalue * &value_b,
156 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
158 const glsl_type *type_a = value_a->type;
159 const glsl_type *type_b = value_b->type;
161 /* From GLSL 1.50 spec, page 56:
163 * "The arithmetic binary operators add (+), subtract (-),
164 * multiply (*), and divide (/) operate on integer and
165 * floating-point scalars, vectors, and matrices."
167 if (!type_a->is_numeric() || !type_b->is_numeric()) {
168 _mesa_glsl_error(loc, state,
169 "Operands to arithmetic operators must be numeric");
170 return glsl_type::error_type;
174 /* "If one operand is floating-point based and the other is
175 * not, then the conversions from Section 4.1.10 "Implicit
176 * Conversions" are applied to the non-floating-point-based operand."
178 if (!apply_implicit_conversion(type_a, value_b, state)
179 && !apply_implicit_conversion(type_b, value_a, state)) {
180 _mesa_glsl_error(loc, state,
181 "Could not implicitly convert operands to "
182 "arithmetic operator");
183 return glsl_type::error_type;
185 type_a = value_a->type;
186 type_b = value_b->type;
188 /* "If the operands are integer types, they must both be signed or
191 * From this rule and the preceeding conversion it can be inferred that
192 * both types must be GLSL_TYPE_FLOAT, or GLSL_TYPE_UINT, or GLSL_TYPE_INT.
193 * The is_numeric check above already filtered out the case where either
194 * type is not one of these, so now the base types need only be tested for
197 if (type_a->base_type != type_b->base_type) {
198 _mesa_glsl_error(loc, state,
199 "base type mismatch for arithmetic operator");
200 return glsl_type::error_type;
203 /* "All arithmetic binary operators result in the same fundamental type
204 * (signed integer, unsigned integer, or floating-point) as the
205 * operands they operate on, after operand type conversion. After
206 * conversion, the following cases are valid
208 * * The two operands are scalars. In this case the operation is
209 * applied, resulting in a scalar."
211 if (type_a->is_scalar() && type_b->is_scalar())
214 /* "* One operand is a scalar, and the other is a vector or matrix.
215 * In this case, the scalar operation is applied independently to each
216 * component of the vector or matrix, resulting in the same size
219 if (type_a->is_scalar()) {
220 if (!type_b->is_scalar())
222 } else if (type_b->is_scalar()) {
226 /* All of the combinations of <scalar, scalar>, <vector, scalar>,
227 * <scalar, vector>, <scalar, matrix>, and <matrix, scalar> have been
230 assert(!type_a->is_scalar());
231 assert(!type_b->is_scalar());
233 /* "* The two operands are vectors of the same size. In this case, the
234 * operation is done component-wise resulting in the same size
237 if (type_a->is_vector() && type_b->is_vector()) {
238 if (type_a == type_b) {
241 _mesa_glsl_error(loc, state,
242 "vector size mismatch for arithmetic operator");
243 return glsl_type::error_type;
247 /* All of the combinations of <scalar, scalar>, <vector, scalar>,
248 * <scalar, vector>, <scalar, matrix>, <matrix, scalar>, and
249 * <vector, vector> have been handled. At least one of the operands must
250 * be matrix. Further, since there are no integer matrix types, the base
251 * type of both operands must be float.
253 assert(type_a->is_matrix() || type_b->is_matrix());
254 assert(type_a->base_type == GLSL_TYPE_FLOAT);
255 assert(type_b->base_type == GLSL_TYPE_FLOAT);
257 /* "* The operator is add (+), subtract (-), or divide (/), and the
258 * operands are matrices with the same number of rows and the same
259 * number of columns. In this case, the operation is done component-
260 * wise resulting in the same size matrix."
261 * * The operator is multiply (*), where both operands are matrices or
262 * one operand is a vector and the other a matrix. A right vector
263 * operand is treated as a column vector and a left vector operand as a
264 * row vector. In all these cases, it is required that the number of
265 * columns of the left operand is equal to the number of rows of the
266 * right operand. Then, the multiply (*) operation does a linear
267 * algebraic multiply, yielding an object that has the same number of
268 * rows as the left operand and the same number of columns as the right
269 * operand. Section 5.10 "Vector and Matrix Operations" explains in
270 * more detail how vectors and matrices are operated on."
273 if (type_a == type_b)
276 if (type_a->is_matrix() && type_b->is_matrix()) {
277 /* Matrix multiply. The columns of A must match the rows of B. Given
278 * the other previously tested constraints, this means the vector type
279 * of a row from A must be the same as the vector type of a column from
282 if (type_a->row_type() == type_b->column_type()) {
283 /* The resulting matrix has the number of columns of matrix B and
284 * the number of rows of matrix A. We get the row count of A by
285 * looking at the size of a vector that makes up a column. The
286 * transpose (size of a row) is done for B.
288 const glsl_type *const type =
289 glsl_type::get_instance(type_a->base_type,
290 type_a->column_type()->vector_elements,
291 type_b->row_type()->vector_elements);
292 assert(type != glsl_type::error_type);
296 } else if (type_a->is_matrix()) {
297 /* A is a matrix and B is a column vector. Columns of A must match
298 * rows of B. Given the other previously tested constraints, this
299 * means the vector type of a row from A must be the same as the
300 * vector the type of B.
302 if (type_a->row_type() == type_b) {
303 /* The resulting vector has a number of elements equal to
304 * the number of rows of matrix A. */
305 const glsl_type *const type =
306 glsl_type::get_instance(type_a->base_type,
307 type_a->column_type()->vector_elements,
309 assert(type != glsl_type::error_type);
314 assert(type_b->is_matrix());
316 /* A is a row vector and B is a matrix. Columns of A must match rows
317 * of B. Given the other previously tested constraints, this means
318 * the type of A must be the same as the vector type of a column from
321 if (type_a == type_b->column_type()) {
322 /* The resulting vector has a number of elements equal to
323 * the number of columns of matrix B. */
324 const glsl_type *const type =
325 glsl_type::get_instance(type_a->base_type,
326 type_b->row_type()->vector_elements,
328 assert(type != glsl_type::error_type);
334 _mesa_glsl_error(loc, state, "size mismatch for matrix multiplication");
335 return glsl_type::error_type;
339 /* "All other cases are illegal."
341 _mesa_glsl_error(loc, state, "type mismatch");
342 return glsl_type::error_type;
346 static const struct glsl_type *
347 unary_arithmetic_result_type(const struct glsl_type *type,
348 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
350 /* From GLSL 1.50 spec, page 57:
352 * "The arithmetic unary operators negate (-), post- and pre-increment
353 * and decrement (-- and ++) operate on integer or floating-point
354 * values (including vectors and matrices). All unary operators work
355 * component-wise on their operands. These result with the same type
358 if (!type->is_numeric()) {
359 _mesa_glsl_error(loc, state,
360 "Operands to arithmetic operators must be numeric");
361 return glsl_type::error_type;
368 * \brief Return the result type of a bit-logic operation.
370 * If the given types to the bit-logic operator are invalid, return
371 * glsl_type::error_type.
373 * \param type_a Type of LHS of bit-logic op
374 * \param type_b Type of RHS of bit-logic op
376 static const struct glsl_type *
377 bit_logic_result_type(const struct glsl_type *type_a,
378 const struct glsl_type *type_b,
380 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
382 if (state->language_version < 130) {
383 _mesa_glsl_error(loc, state, "bit operations require GLSL 1.30");
384 return glsl_type::error_type;
387 /* From page 50 (page 56 of PDF) of GLSL 1.30 spec:
389 * "The bitwise operators and (&), exclusive-or (^), and inclusive-or
390 * (|). The operands must be of type signed or unsigned integers or
393 if (!type_a->is_integer()) {
394 _mesa_glsl_error(loc, state, "LHS of `%s' must be an integer",
395 ast_expression::operator_string(op));
396 return glsl_type::error_type;
398 if (!type_b->is_integer()) {
399 _mesa_glsl_error(loc, state, "RHS of `%s' must be an integer",
400 ast_expression::operator_string(op));
401 return glsl_type::error_type;
404 /* "The fundamental types of the operands (signed or unsigned) must
407 if (type_a->base_type != type_b->base_type) {
408 _mesa_glsl_error(loc, state, "operands of `%s' must have the same "
409 "base type", ast_expression::operator_string(op));
410 return glsl_type::error_type;
413 /* "The operands cannot be vectors of differing size." */
414 if (type_a->is_vector() &&
415 type_b->is_vector() &&
416 type_a->vector_elements != type_b->vector_elements) {
417 _mesa_glsl_error(loc, state, "operands of `%s' cannot be vectors of "
418 "different sizes", ast_expression::operator_string(op));
419 return glsl_type::error_type;
422 /* "If one operand is a scalar and the other a vector, the scalar is
423 * applied component-wise to the vector, resulting in the same type as
424 * the vector. The fundamental types of the operands [...] will be the
425 * resulting fundamental type."
427 if (type_a->is_scalar())
433 static const struct glsl_type *
434 modulus_result_type(const struct glsl_type *type_a,
435 const struct glsl_type *type_b,
436 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
438 if (state->language_version < 130) {
439 _mesa_glsl_error(loc, state,
440 "operator '%%' is reserved in %s",
441 state->version_string);
442 return glsl_type::error_type;
445 /* From GLSL 1.50 spec, page 56:
446 * "The operator modulus (%) operates on signed or unsigned integers or
447 * integer vectors. The operand types must both be signed or both be
450 if (!type_a->is_integer() || !type_b->is_integer()
451 || (type_a->base_type != type_b->base_type)) {
452 _mesa_glsl_error(loc, state, "type mismatch");
453 return glsl_type::error_type;
456 /* "The operands cannot be vectors of differing size. If one operand is
457 * a scalar and the other vector, then the scalar is applied component-
458 * wise to the vector, resulting in the same type as the vector. If both
459 * are vectors of the same size, the result is computed component-wise."
461 if (type_a->is_vector()) {
462 if (!type_b->is_vector()
463 || (type_a->vector_elements == type_b->vector_elements))
468 /* "The operator modulus (%) is not defined for any other data types
469 * (non-integer types)."
471 _mesa_glsl_error(loc, state, "type mismatch");
472 return glsl_type::error_type;
476 static const struct glsl_type *
477 relational_result_type(ir_rvalue * &value_a, ir_rvalue * &value_b,
478 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
480 const glsl_type *type_a = value_a->type;
481 const glsl_type *type_b = value_b->type;
483 /* From GLSL 1.50 spec, page 56:
484 * "The relational operators greater than (>), less than (<), greater
485 * than or equal (>=), and less than or equal (<=) operate only on
486 * scalar integer and scalar floating-point expressions."
488 if (!type_a->is_numeric()
489 || !type_b->is_numeric()
490 || !type_a->is_scalar()
491 || !type_b->is_scalar()) {
492 _mesa_glsl_error(loc, state,
493 "Operands to relational operators must be scalar and "
495 return glsl_type::error_type;
498 /* "Either the operands' types must match, or the conversions from
499 * Section 4.1.10 "Implicit Conversions" will be applied to the integer
500 * operand, after which the types must match."
502 if (!apply_implicit_conversion(type_a, value_b, state)
503 && !apply_implicit_conversion(type_b, value_a, state)) {
504 _mesa_glsl_error(loc, state,
505 "Could not implicitly convert operands to "
506 "relational operator");
507 return glsl_type::error_type;
509 type_a = value_a->type;
510 type_b = value_b->type;
512 if (type_a->base_type != type_b->base_type) {
513 _mesa_glsl_error(loc, state, "base type mismatch");
514 return glsl_type::error_type;
517 /* "The result is scalar Boolean."
519 return glsl_type::bool_type;
523 * \brief Return the result type of a bit-shift operation.
525 * If the given types to the bit-shift operator are invalid, return
526 * glsl_type::error_type.
528 * \param type_a Type of LHS of bit-shift op
529 * \param type_b Type of RHS of bit-shift op
531 static const struct glsl_type *
532 shift_result_type(const struct glsl_type *type_a,
533 const struct glsl_type *type_b,
535 struct _mesa_glsl_parse_state *state, YYLTYPE *loc)
537 if (state->language_version < 130) {
538 _mesa_glsl_error(loc, state, "bit operations require GLSL 1.30");
539 return glsl_type::error_type;
542 /* From page 50 (page 56 of the PDF) of the GLSL 1.30 spec:
544 * "The shift operators (<<) and (>>). For both operators, the operands
545 * must be signed or unsigned integers or integer vectors. One operand
546 * can be signed while the other is unsigned."
548 if (!type_a->is_integer()) {
549 _mesa_glsl_error(loc, state, "LHS of operator %s must be an integer or "
550 "integer vector", ast_expression::operator_string(op));
551 return glsl_type::error_type;
554 if (!type_b->is_integer()) {
555 _mesa_glsl_error(loc, state, "RHS of operator %s must be an integer or "
556 "integer vector", ast_expression::operator_string(op));
557 return glsl_type::error_type;
560 /* "If the first operand is a scalar, the second operand has to be
563 if (type_a->is_scalar() && !type_b->is_scalar()) {
564 _mesa_glsl_error(loc, state, "If the first operand of %s is scalar, the "
565 "second must be scalar as well",
566 ast_expression::operator_string(op));
567 return glsl_type::error_type;
570 /* If both operands are vectors, check that they have same number of
573 if (type_a->is_vector() &&
574 type_b->is_vector() &&
575 type_a->vector_elements != type_b->vector_elements) {
576 _mesa_glsl_error(loc, state, "Vector operands to operator %s must "
577 "have same number of elements",
578 ast_expression::operator_string(op));
579 return glsl_type::error_type;
582 /* "In all cases, the resulting type will be the same type as the left
589 * Validates that a value can be assigned to a location with a specified type
591 * Validates that \c rhs can be assigned to some location. If the types are
592 * not an exact match but an automatic conversion is possible, \c rhs will be
596 * \c NULL if \c rhs cannot be assigned to a location with type \c lhs_type.
597 * Otherwise the actual RHS to be assigned will be returned. This may be
598 * \c rhs, or it may be \c rhs after some type conversion.
601 * In addition to being used for assignments, this function is used to
602 * type-check return values.
605 validate_assignment(struct _mesa_glsl_parse_state *state,
606 const glsl_type *lhs_type, ir_rvalue *rhs,
609 /* If there is already some error in the RHS, just return it. Anything
610 * else will lead to an avalanche of error message back to the user.
612 if (rhs->type->is_error())
615 /* If the types are identical, the assignment can trivially proceed.
617 if (rhs->type == lhs_type)
620 /* If the array element types are the same and the size of the LHS is zero,
621 * the assignment is okay for initializers embedded in variable
624 * Note: Whole-array assignments are not permitted in GLSL 1.10, but this
625 * is handled by ir_dereference::is_lvalue.
627 if (is_initializer && lhs_type->is_array() && rhs->type->is_array()
628 && (lhs_type->element_type() == rhs->type->element_type())
629 && (lhs_type->array_size() == 0)) {
633 /* Check for implicit conversion in GLSL 1.20 */
634 if (apply_implicit_conversion(lhs_type, rhs, state)) {
635 if (rhs->type == lhs_type)
643 do_assignment(exec_list *instructions, struct _mesa_glsl_parse_state *state,
644 ir_rvalue *lhs, ir_rvalue *rhs, bool is_initializer,
648 bool error_emitted = (lhs->type->is_error() || rhs->type->is_error());
650 if (!error_emitted) {
651 if (lhs->variable_referenced() != NULL
652 && lhs->variable_referenced()->read_only) {
653 _mesa_glsl_error(&lhs_loc, state,
654 "assignment to read-only variable '%s'",
655 lhs->variable_referenced()->name);
656 error_emitted = true;
658 } else if (!lhs->is_lvalue()) {
659 _mesa_glsl_error(& lhs_loc, state, "non-lvalue in assignment");
660 error_emitted = true;
663 if (state->es_shader && lhs->type->is_array()) {
664 _mesa_glsl_error(&lhs_loc, state, "whole array assignment is not "
665 "allowed in GLSL ES 1.00.");
666 error_emitted = true;
671 validate_assignment(state, lhs->type, rhs, is_initializer);
672 if (new_rhs == NULL) {
673 _mesa_glsl_error(& lhs_loc, state, "type mismatch");
677 /* If the LHS array was not declared with a size, it takes it size from
678 * the RHS. If the LHS is an l-value and a whole array, it must be a
679 * dereference of a variable. Any other case would require that the LHS
680 * is either not an l-value or not a whole array.
682 if (lhs->type->array_size() == 0) {
683 ir_dereference *const d = lhs->as_dereference();
687 ir_variable *const var = d->variable_referenced();
691 if (var->max_array_access >= unsigned(rhs->type->array_size())) {
692 /* FINISHME: This should actually log the location of the RHS. */
693 _mesa_glsl_error(& lhs_loc, state, "array size must be > %u due to "
695 var->max_array_access);
698 var->type = glsl_type::get_array_instance(lhs->type->element_type(),
699 rhs->type->array_size());
704 /* Most callers of do_assignment (assign, add_assign, pre_inc/dec,
705 * but not post_inc) need the converted assigned value as an rvalue
706 * to handle things like:
710 * So we always just store the computed value being assigned to a
711 * temporary and return a deref of that temporary. If the rvalue
712 * ends up not being used, the temp will get copy-propagated out.
714 ir_variable *var = new(ctx) ir_variable(rhs->type, "assignment_tmp",
716 ir_dereference_variable *deref_var = new(ctx) ir_dereference_variable(var);
717 instructions->push_tail(var);
718 instructions->push_tail(new(ctx) ir_assignment(deref_var,
721 deref_var = new(ctx) ir_dereference_variable(var);
724 instructions->push_tail(new(ctx) ir_assignment(lhs, deref_var, NULL));
726 return new(ctx) ir_dereference_variable(var);
730 get_lvalue_copy(exec_list *instructions, ir_rvalue *lvalue)
732 void *ctx = ralloc_parent(lvalue);
735 var = new(ctx) ir_variable(lvalue->type, "_post_incdec_tmp",
737 instructions->push_tail(var);
738 var->mode = ir_var_auto;
740 instructions->push_tail(new(ctx) ir_assignment(new(ctx) ir_dereference_variable(var),
743 /* Once we've created this temporary, mark it read only so it's no
744 * longer considered an lvalue.
746 var->read_only = true;
748 return new(ctx) ir_dereference_variable(var);
753 ast_node::hir(exec_list *instructions,
754 struct _mesa_glsl_parse_state *state)
763 mark_whole_array_access(ir_rvalue *access)
765 ir_dereference_variable *deref = access->as_dereference_variable();
768 deref->var->max_array_access = deref->type->length - 1;
773 do_comparison(void *mem_ctx, int operation, ir_rvalue *op0, ir_rvalue *op1)
776 ir_rvalue *cmp = NULL;
778 if (operation == ir_binop_all_equal)
779 join_op = ir_binop_logic_and;
781 join_op = ir_binop_logic_or;
783 switch (op0->type->base_type) {
784 case GLSL_TYPE_FLOAT:
788 return new(mem_ctx) ir_expression(operation, op0, op1);
790 case GLSL_TYPE_ARRAY: {
791 for (unsigned int i = 0; i < op0->type->length; i++) {
792 ir_rvalue *e0, *e1, *result;
794 e0 = new(mem_ctx) ir_dereference_array(op0->clone(mem_ctx, NULL),
795 new(mem_ctx) ir_constant(i));
796 e1 = new(mem_ctx) ir_dereference_array(op1->clone(mem_ctx, NULL),
797 new(mem_ctx) ir_constant(i));
798 result = do_comparison(mem_ctx, operation, e0, e1);
801 cmp = new(mem_ctx) ir_expression(join_op, cmp, result);
807 mark_whole_array_access(op0);
808 mark_whole_array_access(op1);
812 case GLSL_TYPE_STRUCT: {
813 for (unsigned int i = 0; i < op0->type->length; i++) {
814 ir_rvalue *e0, *e1, *result;
815 const char *field_name = op0->type->fields.structure[i].name;
817 e0 = new(mem_ctx) ir_dereference_record(op0->clone(mem_ctx, NULL),
819 e1 = new(mem_ctx) ir_dereference_record(op1->clone(mem_ctx, NULL),
821 result = do_comparison(mem_ctx, operation, e0, e1);
824 cmp = new(mem_ctx) ir_expression(join_op, cmp, result);
832 case GLSL_TYPE_ERROR:
834 case GLSL_TYPE_SAMPLER:
835 /* I assume a comparison of a struct containing a sampler just
836 * ignores the sampler present in the type.
841 assert(!"Should not get here.");
846 cmp = new(mem_ctx) ir_constant(true);
851 /* For logical operations, we want to ensure that the operands are
852 * scalar booleans. If it isn't, emit an error and return a constant
853 * boolean to avoid triggering cascading error messages.
856 get_scalar_boolean_operand(exec_list *instructions,
857 struct _mesa_glsl_parse_state *state,
858 ast_expression *parent_expr,
860 const char *operand_name,
863 ast_expression *expr = parent_expr->subexpressions[operand];
865 ir_rvalue *val = expr->hir(instructions, state);
867 if (val->type->is_boolean() && val->type->is_scalar())
870 if (!*error_emitted) {
871 YYLTYPE loc = expr->get_location();
872 _mesa_glsl_error(&loc, state, "%s of `%s' must be scalar boolean",
874 parent_expr->operator_string(parent_expr->oper));
875 *error_emitted = true;
878 return new(ctx) ir_constant(true);
882 ast_expression::hir(exec_list *instructions,
883 struct _mesa_glsl_parse_state *state)
886 static const int operations[AST_NUM_OPERATORS] = {
887 -1, /* ast_assign doesn't convert to ir_expression. */
888 -1, /* ast_plus doesn't convert to ir_expression. */
912 /* Note: The following block of expression types actually convert
913 * to multiple IR instructions.
915 ir_binop_mul, /* ast_mul_assign */
916 ir_binop_div, /* ast_div_assign */
917 ir_binop_mod, /* ast_mod_assign */
918 ir_binop_add, /* ast_add_assign */
919 ir_binop_sub, /* ast_sub_assign */
920 ir_binop_lshift, /* ast_ls_assign */
921 ir_binop_rshift, /* ast_rs_assign */
922 ir_binop_bit_and, /* ast_and_assign */
923 ir_binop_bit_xor, /* ast_xor_assign */
924 ir_binop_bit_or, /* ast_or_assign */
926 -1, /* ast_conditional doesn't convert to ir_expression. */
927 ir_binop_add, /* ast_pre_inc. */
928 ir_binop_sub, /* ast_pre_dec. */
929 ir_binop_add, /* ast_post_inc. */
930 ir_binop_sub, /* ast_post_dec. */
931 -1, /* ast_field_selection doesn't conv to ir_expression. */
932 -1, /* ast_array_index doesn't convert to ir_expression. */
933 -1, /* ast_function_call doesn't conv to ir_expression. */
934 -1, /* ast_identifier doesn't convert to ir_expression. */
935 -1, /* ast_int_constant doesn't convert to ir_expression. */
936 -1, /* ast_uint_constant doesn't conv to ir_expression. */
937 -1, /* ast_float_constant doesn't conv to ir_expression. */
938 -1, /* ast_bool_constant doesn't conv to ir_expression. */
939 -1, /* ast_sequence doesn't convert to ir_expression. */
941 ir_rvalue *result = NULL;
943 const struct glsl_type *type = glsl_type::error_type;
944 bool error_emitted = false;
947 loc = this->get_location();
949 switch (this->oper) {
951 op[0] = this->subexpressions[0]->hir(instructions, state);
952 op[1] = this->subexpressions[1]->hir(instructions, state);
954 result = do_assignment(instructions, state, op[0], op[1], false,
955 this->subexpressions[0]->get_location());
956 error_emitted = result->type->is_error();
962 op[0] = this->subexpressions[0]->hir(instructions, state);
964 type = unary_arithmetic_result_type(op[0]->type, state, & loc);
966 error_emitted = type->is_error();
972 op[0] = this->subexpressions[0]->hir(instructions, state);
974 type = unary_arithmetic_result_type(op[0]->type, state, & loc);
976 error_emitted = type->is_error();
978 result = new(ctx) ir_expression(operations[this->oper], type,
986 op[0] = this->subexpressions[0]->hir(instructions, state);
987 op[1] = this->subexpressions[1]->hir(instructions, state);
989 type = arithmetic_result_type(op[0], op[1],
990 (this->oper == ast_mul),
992 error_emitted = type->is_error();
994 result = new(ctx) ir_expression(operations[this->oper], type,
999 op[0] = this->subexpressions[0]->hir(instructions, state);
1000 op[1] = this->subexpressions[1]->hir(instructions, state);
1002 type = modulus_result_type(op[0]->type, op[1]->type, state, & loc);
1004 assert(operations[this->oper] == ir_binop_mod);
1006 result = new(ctx) ir_expression(operations[this->oper], type,
1008 error_emitted = type->is_error();
1013 if (state->language_version < 130) {
1014 _mesa_glsl_error(&loc, state, "operator %s requires GLSL 1.30",
1015 operator_string(this->oper));
1016 error_emitted = true;
1019 op[0] = this->subexpressions[0]->hir(instructions, state);
1020 op[1] = this->subexpressions[1]->hir(instructions, state);
1021 type = shift_result_type(op[0]->type, op[1]->type, this->oper, state,
1023 result = new(ctx) ir_expression(operations[this->oper], type,
1025 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1032 op[0] = this->subexpressions[0]->hir(instructions, state);
1033 op[1] = this->subexpressions[1]->hir(instructions, state);
1035 type = relational_result_type(op[0], op[1], state, & loc);
1037 /* The relational operators must either generate an error or result
1038 * in a scalar boolean. See page 57 of the GLSL 1.50 spec.
1040 assert(type->is_error()
1041 || ((type->base_type == GLSL_TYPE_BOOL)
1042 && type->is_scalar()));
1044 result = new(ctx) ir_expression(operations[this->oper], type,
1046 error_emitted = type->is_error();
1051 op[0] = this->subexpressions[0]->hir(instructions, state);
1052 op[1] = this->subexpressions[1]->hir(instructions, state);
1054 /* From page 58 (page 64 of the PDF) of the GLSL 1.50 spec:
1056 * "The equality operators equal (==), and not equal (!=)
1057 * operate on all types. They result in a scalar Boolean. If
1058 * the operand types do not match, then there must be a
1059 * conversion from Section 4.1.10 "Implicit Conversions"
1060 * applied to one operand that can make them match, in which
1061 * case this conversion is done."
1063 if ((!apply_implicit_conversion(op[0]->type, op[1], state)
1064 && !apply_implicit_conversion(op[1]->type, op[0], state))
1065 || (op[0]->type != op[1]->type)) {
1066 _mesa_glsl_error(& loc, state, "operands of `%s' must have the same "
1067 "type", (this->oper == ast_equal) ? "==" : "!=");
1068 error_emitted = true;
1069 } else if ((state->language_version <= 110)
1070 && (op[0]->type->is_array() || op[1]->type->is_array())) {
1071 _mesa_glsl_error(& loc, state, "array comparisons forbidden in "
1073 error_emitted = true;
1076 if (error_emitted) {
1077 result = new(ctx) ir_constant(false);
1079 result = do_comparison(ctx, operations[this->oper], op[0], op[1]);
1080 assert(result->type == glsl_type::bool_type);
1081 type = glsl_type::bool_type;
1089 op[0] = this->subexpressions[0]->hir(instructions, state);
1090 op[1] = this->subexpressions[1]->hir(instructions, state);
1091 type = bit_logic_result_type(op[0]->type, op[1]->type, this->oper,
1093 result = new(ctx) ir_expression(operations[this->oper], type,
1095 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1099 op[0] = this->subexpressions[0]->hir(instructions, state);
1101 if (state->language_version < 130) {
1102 _mesa_glsl_error(&loc, state, "bit-wise operations require GLSL 1.30");
1103 error_emitted = true;
1106 if (!op[0]->type->is_integer()) {
1107 _mesa_glsl_error(&loc, state, "operand of `~' must be an integer");
1108 error_emitted = true;
1112 result = new(ctx) ir_expression(ir_unop_bit_not, type, op[0], NULL);
1115 case ast_logic_and: {
1116 exec_list rhs_instructions;
1117 op[0] = get_scalar_boolean_operand(instructions, state, this, 0,
1118 "LHS", &error_emitted);
1119 op[1] = get_scalar_boolean_operand(&rhs_instructions, state, this, 1,
1120 "RHS", &error_emitted);
1122 ir_constant *op0_const = op[0]->constant_expression_value();
1124 if (op0_const->value.b[0]) {
1125 instructions->append_list(&rhs_instructions);
1130 type = glsl_type::bool_type;
1132 ir_variable *const tmp = new(ctx) ir_variable(glsl_type::bool_type,
1135 instructions->push_tail(tmp);
1137 ir_if *const stmt = new(ctx) ir_if(op[0]);
1138 instructions->push_tail(stmt);
1140 stmt->then_instructions.append_list(&rhs_instructions);
1141 ir_dereference *const then_deref = new(ctx) ir_dereference_variable(tmp);
1142 ir_assignment *const then_assign =
1143 new(ctx) ir_assignment(then_deref, op[1], NULL);
1144 stmt->then_instructions.push_tail(then_assign);
1146 ir_dereference *const else_deref = new(ctx) ir_dereference_variable(tmp);
1147 ir_assignment *const else_assign =
1148 new(ctx) ir_assignment(else_deref, new(ctx) ir_constant(false), NULL);
1149 stmt->else_instructions.push_tail(else_assign);
1151 result = new(ctx) ir_dereference_variable(tmp);
1157 case ast_logic_or: {
1158 exec_list rhs_instructions;
1159 op[0] = get_scalar_boolean_operand(instructions, state, this, 0,
1160 "LHS", &error_emitted);
1161 op[1] = get_scalar_boolean_operand(&rhs_instructions, state, this, 1,
1162 "RHS", &error_emitted);
1164 ir_constant *op0_const = op[0]->constant_expression_value();
1166 if (op0_const->value.b[0]) {
1171 type = glsl_type::bool_type;
1173 ir_variable *const tmp = new(ctx) ir_variable(glsl_type::bool_type,
1176 instructions->push_tail(tmp);
1178 ir_if *const stmt = new(ctx) ir_if(op[0]);
1179 instructions->push_tail(stmt);
1181 ir_dereference *const then_deref = new(ctx) ir_dereference_variable(tmp);
1182 ir_assignment *const then_assign =
1183 new(ctx) ir_assignment(then_deref, new(ctx) ir_constant(true), NULL);
1184 stmt->then_instructions.push_tail(then_assign);
1186 stmt->else_instructions.append_list(&rhs_instructions);
1187 ir_dereference *const else_deref = new(ctx) ir_dereference_variable(tmp);
1188 ir_assignment *const else_assign =
1189 new(ctx) ir_assignment(else_deref, op[1], NULL);
1190 stmt->else_instructions.push_tail(else_assign);
1192 result = new(ctx) ir_dereference_variable(tmp);
1199 /* From page 33 (page 39 of the PDF) of the GLSL 1.10 spec:
1201 * "The logical binary operators and (&&), or ( | | ), and
1202 * exclusive or (^^). They operate only on two Boolean
1203 * expressions and result in a Boolean expression."
1205 op[0] = get_scalar_boolean_operand(instructions, state, this, 0, "LHS",
1207 op[1] = get_scalar_boolean_operand(instructions, state, this, 1, "RHS",
1210 result = new(ctx) ir_expression(operations[this->oper], glsl_type::bool_type,
1212 type = glsl_type::bool_type;
1216 op[0] = get_scalar_boolean_operand(instructions, state, this, 0,
1217 "operand", &error_emitted);
1219 result = new(ctx) ir_expression(operations[this->oper], glsl_type::bool_type,
1221 type = glsl_type::bool_type;
1224 case ast_mul_assign:
1225 case ast_div_assign:
1226 case ast_add_assign:
1227 case ast_sub_assign: {
1228 op[0] = this->subexpressions[0]->hir(instructions, state);
1229 op[1] = this->subexpressions[1]->hir(instructions, state);
1231 type = arithmetic_result_type(op[0], op[1],
1232 (this->oper == ast_mul_assign),
1235 ir_rvalue *temp_rhs = new(ctx) ir_expression(operations[this->oper], type,
1238 result = do_assignment(instructions, state,
1239 op[0]->clone(ctx, NULL), temp_rhs, false,
1240 this->subexpressions[0]->get_location());
1241 type = result->type;
1242 error_emitted = (op[0]->type->is_error());
1244 /* GLSL 1.10 does not allow array assignment. However, we don't have to
1245 * explicitly test for this because none of the binary expression
1246 * operators allow array operands either.
1252 case ast_mod_assign: {
1253 op[0] = this->subexpressions[0]->hir(instructions, state);
1254 op[1] = this->subexpressions[1]->hir(instructions, state);
1256 type = modulus_result_type(op[0]->type, op[1]->type, state, & loc);
1258 assert(operations[this->oper] == ir_binop_mod);
1260 ir_rvalue *temp_rhs;
1261 temp_rhs = new(ctx) ir_expression(operations[this->oper], type,
1264 result = do_assignment(instructions, state,
1265 op[0]->clone(ctx, NULL), temp_rhs, false,
1266 this->subexpressions[0]->get_location());
1267 type = result->type;
1268 error_emitted = type->is_error();
1273 case ast_rs_assign: {
1274 op[0] = this->subexpressions[0]->hir(instructions, state);
1275 op[1] = this->subexpressions[1]->hir(instructions, state);
1276 type = shift_result_type(op[0]->type, op[1]->type, this->oper, state,
1278 ir_rvalue *temp_rhs = new(ctx) ir_expression(operations[this->oper],
1279 type, op[0], op[1]);
1280 result = do_assignment(instructions, state, op[0]->clone(ctx, NULL),
1282 this->subexpressions[0]->get_location());
1283 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1287 case ast_and_assign:
1288 case ast_xor_assign:
1289 case ast_or_assign: {
1290 op[0] = this->subexpressions[0]->hir(instructions, state);
1291 op[1] = this->subexpressions[1]->hir(instructions, state);
1292 type = bit_logic_result_type(op[0]->type, op[1]->type, this->oper,
1294 ir_rvalue *temp_rhs = new(ctx) ir_expression(operations[this->oper],
1295 type, op[0], op[1]);
1296 result = do_assignment(instructions, state, op[0]->clone(ctx, NULL),
1298 this->subexpressions[0]->get_location());
1299 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1303 case ast_conditional: {
1304 /* From page 59 (page 65 of the PDF) of the GLSL 1.50 spec:
1306 * "The ternary selection operator (?:). It operates on three
1307 * expressions (exp1 ? exp2 : exp3). This operator evaluates the
1308 * first expression, which must result in a scalar Boolean."
1310 op[0] = get_scalar_boolean_operand(instructions, state, this, 0,
1311 "condition", &error_emitted);
1313 /* The :? operator is implemented by generating an anonymous temporary
1314 * followed by an if-statement. The last instruction in each branch of
1315 * the if-statement assigns a value to the anonymous temporary. This
1316 * temporary is the r-value of the expression.
1318 exec_list then_instructions;
1319 exec_list else_instructions;
1321 op[1] = this->subexpressions[1]->hir(&then_instructions, state);
1322 op[2] = this->subexpressions[2]->hir(&else_instructions, state);
1324 /* From page 59 (page 65 of the PDF) of the GLSL 1.50 spec:
1326 * "The second and third expressions can be any type, as
1327 * long their types match, or there is a conversion in
1328 * Section 4.1.10 "Implicit Conversions" that can be applied
1329 * to one of the expressions to make their types match. This
1330 * resulting matching type is the type of the entire
1333 if ((!apply_implicit_conversion(op[1]->type, op[2], state)
1334 && !apply_implicit_conversion(op[2]->type, op[1], state))
1335 || (op[1]->type != op[2]->type)) {
1336 YYLTYPE loc = this->subexpressions[1]->get_location();
1338 _mesa_glsl_error(& loc, state, "Second and third operands of ?: "
1339 "operator must have matching types.");
1340 error_emitted = true;
1341 type = glsl_type::error_type;
1346 /* From page 33 (page 39 of the PDF) of the GLSL 1.10 spec:
1348 * "The second and third expressions must be the same type, but can
1349 * be of any type other than an array."
1351 if ((state->language_version <= 110) && type->is_array()) {
1352 _mesa_glsl_error(& loc, state, "Second and third operands of ?: "
1353 "operator must not be arrays.");
1354 error_emitted = true;
1357 ir_constant *cond_val = op[0]->constant_expression_value();
1358 ir_constant *then_val = op[1]->constant_expression_value();
1359 ir_constant *else_val = op[2]->constant_expression_value();
1361 if (then_instructions.is_empty()
1362 && else_instructions.is_empty()
1363 && (cond_val != NULL) && (then_val != NULL) && (else_val != NULL)) {
1364 result = (cond_val->value.b[0]) ? then_val : else_val;
1366 ir_variable *const tmp =
1367 new(ctx) ir_variable(type, "conditional_tmp", ir_var_temporary);
1368 instructions->push_tail(tmp);
1370 ir_if *const stmt = new(ctx) ir_if(op[0]);
1371 instructions->push_tail(stmt);
1373 then_instructions.move_nodes_to(& stmt->then_instructions);
1374 ir_dereference *const then_deref =
1375 new(ctx) ir_dereference_variable(tmp);
1376 ir_assignment *const then_assign =
1377 new(ctx) ir_assignment(then_deref, op[1], NULL);
1378 stmt->then_instructions.push_tail(then_assign);
1380 else_instructions.move_nodes_to(& stmt->else_instructions);
1381 ir_dereference *const else_deref =
1382 new(ctx) ir_dereference_variable(tmp);
1383 ir_assignment *const else_assign =
1384 new(ctx) ir_assignment(else_deref, op[2], NULL);
1385 stmt->else_instructions.push_tail(else_assign);
1387 result = new(ctx) ir_dereference_variable(tmp);
1394 op[0] = this->subexpressions[0]->hir(instructions, state);
1395 if (op[0]->type->base_type == GLSL_TYPE_FLOAT)
1396 op[1] = new(ctx) ir_constant(1.0f);
1398 op[1] = new(ctx) ir_constant(1);
1400 type = arithmetic_result_type(op[0], op[1], false, state, & loc);
1402 ir_rvalue *temp_rhs;
1403 temp_rhs = new(ctx) ir_expression(operations[this->oper], type,
1406 result = do_assignment(instructions, state,
1407 op[0]->clone(ctx, NULL), temp_rhs, false,
1408 this->subexpressions[0]->get_location());
1409 type = result->type;
1410 error_emitted = op[0]->type->is_error();
1415 case ast_post_dec: {
1416 op[0] = this->subexpressions[0]->hir(instructions, state);
1417 if (op[0]->type->base_type == GLSL_TYPE_FLOAT)
1418 op[1] = new(ctx) ir_constant(1.0f);
1420 op[1] = new(ctx) ir_constant(1);
1422 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1424 type = arithmetic_result_type(op[0], op[1], false, state, & loc);
1426 ir_rvalue *temp_rhs;
1427 temp_rhs = new(ctx) ir_expression(operations[this->oper], type,
1430 /* Get a temporary of a copy of the lvalue before it's modified.
1431 * This may get thrown away later.
1433 result = get_lvalue_copy(instructions, op[0]->clone(ctx, NULL));
1435 (void)do_assignment(instructions, state,
1436 op[0]->clone(ctx, NULL), temp_rhs, false,
1437 this->subexpressions[0]->get_location());
1439 type = result->type;
1440 error_emitted = op[0]->type->is_error();
1444 case ast_field_selection:
1445 result = _mesa_ast_field_selection_to_hir(this, instructions, state);
1446 type = result->type;
1449 case ast_array_index: {
1450 YYLTYPE index_loc = subexpressions[1]->get_location();
1452 op[0] = subexpressions[0]->hir(instructions, state);
1453 op[1] = subexpressions[1]->hir(instructions, state);
1455 error_emitted = op[0]->type->is_error() || op[1]->type->is_error();
1457 ir_rvalue *const array = op[0];
1459 result = new(ctx) ir_dereference_array(op[0], op[1]);
1461 /* Do not use op[0] after this point. Use array.
1469 if (!array->type->is_array()
1470 && !array->type->is_matrix()
1471 && !array->type->is_vector()) {
1472 _mesa_glsl_error(& index_loc, state,
1473 "cannot dereference non-array / non-matrix / "
1475 error_emitted = true;
1478 if (!op[1]->type->is_integer()) {
1479 _mesa_glsl_error(& index_loc, state,
1480 "array index must be integer type");
1481 error_emitted = true;
1482 } else if (!op[1]->type->is_scalar()) {
1483 _mesa_glsl_error(& index_loc, state,
1484 "array index must be scalar");
1485 error_emitted = true;
1488 /* If the array index is a constant expression and the array has a
1489 * declared size, ensure that the access is in-bounds. If the array
1490 * index is not a constant expression, ensure that the array has a
1493 ir_constant *const const_index = op[1]->constant_expression_value();
1494 if (const_index != NULL) {
1495 const int idx = const_index->value.i[0];
1496 const char *type_name;
1499 if (array->type->is_matrix()) {
1500 type_name = "matrix";
1501 } else if (array->type->is_vector()) {
1502 type_name = "vector";
1504 type_name = "array";
1507 /* From page 24 (page 30 of the PDF) of the GLSL 1.50 spec:
1509 * "It is illegal to declare an array with a size, and then
1510 * later (in the same shader) index the same array with an
1511 * integral constant expression greater than or equal to the
1512 * declared size. It is also illegal to index an array with a
1513 * negative constant expression."
1515 if (array->type->is_matrix()) {
1516 if (array->type->row_type()->vector_elements <= idx) {
1517 bound = array->type->row_type()->vector_elements;
1519 } else if (array->type->is_vector()) {
1520 if (array->type->vector_elements <= idx) {
1521 bound = array->type->vector_elements;
1524 if ((array->type->array_size() > 0)
1525 && (array->type->array_size() <= idx)) {
1526 bound = array->type->array_size();
1531 _mesa_glsl_error(& loc, state, "%s index must be < %u",
1533 error_emitted = true;
1534 } else if (idx < 0) {
1535 _mesa_glsl_error(& loc, state, "%s index must be >= 0",
1537 error_emitted = true;
1540 if (array->type->is_array()) {
1541 /* If the array is a variable dereference, it dereferences the
1542 * whole array, by definition. Use this to get the variable.
1544 * FINISHME: Should some methods for getting / setting / testing
1545 * FINISHME: array access limits be added to ir_dereference?
1547 ir_variable *const v = array->whole_variable_referenced();
1548 if ((v != NULL) && (unsigned(idx) > v->max_array_access))
1549 v->max_array_access = idx;
1551 } else if (array->type->array_size() == 0) {
1552 _mesa_glsl_error(&loc, state, "unsized array index must be constant");
1554 if (array->type->is_array()) {
1555 /* whole_variable_referenced can return NULL if the array is a
1556 * member of a structure. In this case it is safe to not update
1557 * the max_array_access field because it is never used for fields
1560 ir_variable *v = array->whole_variable_referenced();
1562 v->max_array_access = array->type->array_size() - 1;
1566 /* From page 23 (29 of the PDF) of the GLSL 1.30 spec:
1568 * "Samplers aggregated into arrays within a shader (using square
1569 * brackets [ ]) can only be indexed with integral constant
1570 * expressions [...]."
1572 * This restriction was added in GLSL 1.30. Shaders using earlier version
1573 * of the language should not be rejected by the compiler front-end for
1574 * using this construct. This allows useful things such as using a loop
1575 * counter as the index to an array of samplers. If the loop in unrolled,
1576 * the code should compile correctly. Instead, emit a warning.
1578 if (array->type->is_array() &&
1579 array->type->element_type()->is_sampler() &&
1580 const_index == NULL) {
1582 if (state->language_version == 100) {
1583 _mesa_glsl_warning(&loc, state,
1584 "sampler arrays indexed with non-constant "
1585 "expressions is optional in GLSL ES 1.00");
1586 } else if (state->language_version < 130) {
1587 _mesa_glsl_warning(&loc, state,
1588 "sampler arrays indexed with non-constant "
1589 "expressions is forbidden in GLSL 1.30 and "
1592 _mesa_glsl_error(&loc, state,
1593 "sampler arrays indexed with non-constant "
1594 "expressions is forbidden in GLSL 1.30 and "
1596 error_emitted = true;
1601 result->type = glsl_type::error_type;
1603 type = result->type;
1607 case ast_function_call:
1608 /* Should *NEVER* get here. ast_function_call should always be handled
1609 * by ast_function_expression::hir.
1614 case ast_identifier: {
1615 /* ast_identifier can appear several places in a full abstract syntax
1616 * tree. This particular use must be at location specified in the grammar
1617 * as 'variable_identifier'.
1620 state->symbols->get_variable(this->primary_expression.identifier);
1622 result = new(ctx) ir_dereference_variable(var);
1626 type = result->type;
1628 _mesa_glsl_error(& loc, state, "`%s' undeclared",
1629 this->primary_expression.identifier);
1631 error_emitted = true;
1636 case ast_int_constant:
1637 type = glsl_type::int_type;
1638 result = new(ctx) ir_constant(this->primary_expression.int_constant);
1641 case ast_uint_constant:
1642 type = glsl_type::uint_type;
1643 result = new(ctx) ir_constant(this->primary_expression.uint_constant);
1646 case ast_float_constant:
1647 type = glsl_type::float_type;
1648 result = new(ctx) ir_constant(this->primary_expression.float_constant);
1651 case ast_bool_constant:
1652 type = glsl_type::bool_type;
1653 result = new(ctx) ir_constant(bool(this->primary_expression.bool_constant));
1656 case ast_sequence: {
1657 /* It should not be possible to generate a sequence in the AST without
1658 * any expressions in it.
1660 assert(!this->expressions.is_empty());
1662 /* The r-value of a sequence is the last expression in the sequence. If
1663 * the other expressions in the sequence do not have side-effects (and
1664 * therefore add instructions to the instruction list), they get dropped
1667 foreach_list_typed (ast_node, ast, link, &this->expressions)
1668 result = ast->hir(instructions, state);
1670 type = result->type;
1672 /* Any errors should have already been emitted in the loop above.
1674 error_emitted = true;
1679 if (type->is_error() && !error_emitted)
1680 _mesa_glsl_error(& loc, state, "type mismatch");
1687 ast_expression_statement::hir(exec_list *instructions,
1688 struct _mesa_glsl_parse_state *state)
1690 /* It is possible to have expression statements that don't have an
1691 * expression. This is the solitary semicolon:
1693 * for (i = 0; i < 5; i++)
1696 * In this case the expression will be NULL. Test for NULL and don't do
1697 * anything in that case.
1699 if (expression != NULL)
1700 expression->hir(instructions, state);
1702 /* Statements do not have r-values.
1709 ast_compound_statement::hir(exec_list *instructions,
1710 struct _mesa_glsl_parse_state *state)
1713 state->symbols->push_scope();
1715 foreach_list_typed (ast_node, ast, link, &this->statements)
1716 ast->hir(instructions, state);
1719 state->symbols->pop_scope();
1721 /* Compound statements do not have r-values.
1727 static const glsl_type *
1728 process_array_type(YYLTYPE *loc, const glsl_type *base, ast_node *array_size,
1729 struct _mesa_glsl_parse_state *state)
1731 unsigned length = 0;
1733 /* FINISHME: Reject delcarations of multidimensional arrays. */
1735 if (array_size != NULL) {
1736 exec_list dummy_instructions;
1737 ir_rvalue *const ir = array_size->hir(& dummy_instructions, state);
1738 YYLTYPE loc = array_size->get_location();
1740 /* FINISHME: Verify that the grammar forbids side-effects in array
1741 * FINISHME: sizes. i.e., 'vec4 [x = 12] data'
1743 assert(dummy_instructions.is_empty());
1746 if (!ir->type->is_integer()) {
1747 _mesa_glsl_error(& loc, state, "array size must be integer type");
1748 } else if (!ir->type->is_scalar()) {
1749 _mesa_glsl_error(& loc, state, "array size must be scalar type");
1751 ir_constant *const size = ir->constant_expression_value();
1754 _mesa_glsl_error(& loc, state, "array size must be a "
1755 "constant valued expression");
1756 } else if (size->value.i[0] <= 0) {
1757 _mesa_glsl_error(& loc, state, "array size must be > 0");
1759 assert(size->type == ir->type);
1760 length = size->value.u[0];
1764 } else if (state->es_shader) {
1765 /* Section 10.17 of the GLSL ES 1.00 specification states that unsized
1766 * array declarations have been removed from the language.
1768 _mesa_glsl_error(loc, state, "unsized array declarations are not "
1769 "allowed in GLSL ES 1.00.");
1772 return glsl_type::get_array_instance(base, length);
1777 ast_type_specifier::glsl_type(const char **name,
1778 struct _mesa_glsl_parse_state *state) const
1780 const struct glsl_type *type;
1782 type = state->symbols->get_type(this->type_name);
1783 *name = this->type_name;
1785 if (this->is_array) {
1786 YYLTYPE loc = this->get_location();
1787 type = process_array_type(&loc, type, this->array_size, state);
1795 apply_type_qualifier_to_variable(const struct ast_type_qualifier *qual,
1797 struct _mesa_glsl_parse_state *state,
1800 if (qual->flags.q.invariant) {
1802 _mesa_glsl_error(loc, state,
1803 "variable `%s' may not be redeclared "
1804 "`invariant' after being used",
1811 if (qual->flags.q.constant || qual->flags.q.attribute
1812 || qual->flags.q.uniform
1813 || (qual->flags.q.varying && (state->target == fragment_shader)))
1816 if (qual->flags.q.centroid)
1819 if (qual->flags.q.attribute && state->target != vertex_shader) {
1820 var->type = glsl_type::error_type;
1821 _mesa_glsl_error(loc, state,
1822 "`attribute' variables may not be declared in the "
1824 _mesa_glsl_shader_target_name(state->target));
1827 /* From page 25 (page 31 of the PDF) of the GLSL 1.10 spec:
1829 * "The varying qualifier can be used only with the data types
1830 * float, vec2, vec3, vec4, mat2, mat3, and mat4, or arrays of
1833 if (qual->flags.q.varying) {
1834 const glsl_type *non_array_type;
1836 if (var->type && var->type->is_array())
1837 non_array_type = var->type->fields.array;
1839 non_array_type = var->type;
1841 if (non_array_type && non_array_type->base_type != GLSL_TYPE_FLOAT) {
1842 var->type = glsl_type::error_type;
1843 _mesa_glsl_error(loc, state,
1844 "varying variables must be of base type float");
1848 /* If there is no qualifier that changes the mode of the variable, leave
1849 * the setting alone.
1851 if (qual->flags.q.in && qual->flags.q.out)
1852 var->mode = ir_var_inout;
1853 else if (qual->flags.q.attribute || qual->flags.q.in
1854 || (qual->flags.q.varying && (state->target == fragment_shader)))
1855 var->mode = ir_var_in;
1856 else if (qual->flags.q.out
1857 || (qual->flags.q.varying && (state->target == vertex_shader)))
1858 var->mode = ir_var_out;
1859 else if (qual->flags.q.uniform)
1860 var->mode = ir_var_uniform;
1862 if (state->all_invariant && (state->current_function == NULL)) {
1863 switch (state->target) {
1865 if (var->mode == ir_var_out)
1866 var->invariant = true;
1868 case geometry_shader:
1869 if ((var->mode == ir_var_in) || (var->mode == ir_var_out))
1870 var->invariant = true;
1872 case fragment_shader:
1873 if (var->mode == ir_var_in)
1874 var->invariant = true;
1879 if (qual->flags.q.flat)
1880 var->interpolation = ir_var_flat;
1881 else if (qual->flags.q.noperspective)
1882 var->interpolation = ir_var_noperspective;
1884 var->interpolation = ir_var_smooth;
1886 var->pixel_center_integer = qual->flags.q.pixel_center_integer;
1887 var->origin_upper_left = qual->flags.q.origin_upper_left;
1888 if ((qual->flags.q.origin_upper_left || qual->flags.q.pixel_center_integer)
1889 && (strcmp(var->name, "gl_FragCoord") != 0)) {
1890 const char *const qual_string = (qual->flags.q.origin_upper_left)
1891 ? "origin_upper_left" : "pixel_center_integer";
1893 _mesa_glsl_error(loc, state,
1894 "layout qualifier `%s' can only be applied to "
1895 "fragment shader input `gl_FragCoord'",
1899 if (qual->flags.q.explicit_location) {
1900 const bool global_scope = (state->current_function == NULL);
1902 const char *string = "";
1904 /* In the vertex shader only shader inputs can be given explicit
1907 * In the fragment shader only shader outputs can be given explicit
1910 switch (state->target) {
1912 if (!global_scope || (var->mode != ir_var_in)) {
1918 case geometry_shader:
1919 _mesa_glsl_error(loc, state,
1920 "geometry shader variables cannot be given "
1921 "explicit locations\n");
1924 case fragment_shader:
1925 if (!global_scope || (var->mode != ir_var_in)) {
1933 _mesa_glsl_error(loc, state,
1934 "only %s shader %s variables can be given an "
1935 "explicit location\n",
1936 _mesa_glsl_shader_target_name(state->target),
1939 var->explicit_location = true;
1941 /* This bit of silliness is needed because invalid explicit locations
1942 * are supposed to be flagged during linking. Small negative values
1943 * biased by VERT_ATTRIB_GENERIC0 or FRAG_RESULT_DATA0 could alias
1944 * built-in values (e.g., -16+VERT_ATTRIB_GENERIC0 = VERT_ATTRIB_POS).
1945 * The linker needs to be able to differentiate these cases. This
1946 * ensures that negative values stay negative.
1948 if (qual->location >= 0) {
1949 var->location = (state->target == vertex_shader)
1950 ? (qual->location + VERT_ATTRIB_GENERIC0)
1951 : (qual->location + FRAG_RESULT_DATA0);
1953 var->location = qual->location;
1958 /* Does the declaration use the 'layout' keyword?
1960 const bool uses_layout = qual->flags.q.pixel_center_integer
1961 || qual->flags.q.origin_upper_left
1962 || qual->flags.q.explicit_location;
1964 /* Does the declaration use the deprecated 'attribute' or 'varying'
1967 const bool uses_deprecated_qualifier = qual->flags.q.attribute
1968 || qual->flags.q.varying;
1970 /* Is the 'layout' keyword used with parameters that allow relaxed checking.
1971 * Many implementations of GL_ARB_fragment_coord_conventions_enable and some
1972 * implementations (only Mesa?) GL_ARB_explicit_attrib_location_enable
1973 * allowed the layout qualifier to be used with 'varying' and 'attribute'.
1974 * These extensions and all following extensions that add the 'layout'
1975 * keyword have been modified to require the use of 'in' or 'out'.
1977 * The following extension do not allow the deprecated keywords:
1979 * GL_AMD_conservative_depth
1980 * GL_ARB_gpu_shader5
1981 * GL_ARB_separate_shader_objects
1982 * GL_ARB_tesselation_shader
1983 * GL_ARB_transform_feedback3
1984 * GL_ARB_uniform_buffer_object
1986 * It is unknown whether GL_EXT_shader_image_load_store or GL_NV_gpu_shader5
1987 * allow layout with the deprecated keywords.
1989 const bool relaxed_layout_qualifier_checking =
1990 state->ARB_fragment_coord_conventions_enable;
1992 if (uses_layout && uses_deprecated_qualifier) {
1993 if (relaxed_layout_qualifier_checking) {
1994 _mesa_glsl_warning(loc, state,
1995 "`layout' qualifier may not be used with "
1996 "`attribute' or `varying'");
1998 _mesa_glsl_error(loc, state,
1999 "`layout' qualifier may not be used with "
2000 "`attribute' or `varying'");
2004 /* Layout qualifiers for gl_FragDepth, which are enabled by extension
2005 * AMD_conservative_depth.
2007 int depth_layout_count = qual->flags.q.depth_any
2008 + qual->flags.q.depth_greater
2009 + qual->flags.q.depth_less
2010 + qual->flags.q.depth_unchanged;
2011 if (depth_layout_count > 0
2012 && !state->AMD_conservative_depth_enable) {
2013 _mesa_glsl_error(loc, state,
2014 "extension GL_AMD_conservative_depth must be enabled "
2015 "to use depth layout qualifiers");
2016 } else if (depth_layout_count > 0
2017 && strcmp(var->name, "gl_FragDepth") != 0) {
2018 _mesa_glsl_error(loc, state,
2019 "depth layout qualifiers can be applied only to "
2021 } else if (depth_layout_count > 1
2022 && strcmp(var->name, "gl_FragDepth") == 0) {
2023 _mesa_glsl_error(loc, state,
2024 "at most one depth layout qualifier can be applied to "
2027 if (qual->flags.q.depth_any)
2028 var->depth_layout = ir_depth_layout_any;
2029 else if (qual->flags.q.depth_greater)
2030 var->depth_layout = ir_depth_layout_greater;
2031 else if (qual->flags.q.depth_less)
2032 var->depth_layout = ir_depth_layout_less;
2033 else if (qual->flags.q.depth_unchanged)
2034 var->depth_layout = ir_depth_layout_unchanged;
2036 var->depth_layout = ir_depth_layout_none;
2038 if (var->type->is_array() && state->language_version != 110) {
2039 var->array_lvalue = true;
2044 * Get the variable that is being redeclared by this declaration
2046 * Semantic checks to verify the validity of the redeclaration are also
2047 * performed. If semantic checks fail, compilation error will be emitted via
2048 * \c _mesa_glsl_error, but a non-\c NULL pointer will still be returned.
2051 * A pointer to an existing variable in the current scope if the declaration
2052 * is a redeclaration, \c NULL otherwise.
2055 get_variable_being_redeclared(ir_variable *var, ast_declaration *decl,
2056 struct _mesa_glsl_parse_state *state)
2058 /* Check if this declaration is actually a re-declaration, either to
2059 * resize an array or add qualifiers to an existing variable.
2061 * This is allowed for variables in the current scope, or when at
2062 * global scope (for built-ins in the implicit outer scope).
2064 ir_variable *earlier = state->symbols->get_variable(decl->identifier);
2065 if (earlier == NULL ||
2066 (state->current_function != NULL &&
2067 !state->symbols->name_declared_this_scope(decl->identifier))) {
2072 YYLTYPE loc = decl->get_location();
2074 /* From page 24 (page 30 of the PDF) of the GLSL 1.50 spec,
2076 * "It is legal to declare an array without a size and then
2077 * later re-declare the same name as an array of the same
2078 * type and specify a size."
2080 if ((earlier->type->array_size() == 0)
2081 && var->type->is_array()
2082 && (var->type->element_type() == earlier->type->element_type())) {
2083 /* FINISHME: This doesn't match the qualifiers on the two
2084 * FINISHME: declarations. It's not 100% clear whether this is
2085 * FINISHME: required or not.
2088 /* From page 54 (page 60 of the PDF) of the GLSL 1.20 spec:
2090 * "The size [of gl_TexCoord] can be at most
2091 * gl_MaxTextureCoords."
2093 const unsigned size = unsigned(var->type->array_size());
2094 if ((strcmp("gl_TexCoord", var->name) == 0)
2095 && (size > state->Const.MaxTextureCoords)) {
2096 _mesa_glsl_error(& loc, state, "`gl_TexCoord' array size cannot "
2097 "be larger than gl_MaxTextureCoords (%u)\n",
2098 state->Const.MaxTextureCoords);
2099 } else if ((size > 0) && (size <= earlier->max_array_access)) {
2100 _mesa_glsl_error(& loc, state, "array size must be > %u due to "
2102 earlier->max_array_access);
2105 earlier->type = var->type;
2108 } else if (state->ARB_fragment_coord_conventions_enable
2109 && strcmp(var->name, "gl_FragCoord") == 0
2110 && earlier->type == var->type
2111 && earlier->mode == var->mode) {
2112 /* Allow redeclaration of gl_FragCoord for ARB_fcc layout
2115 earlier->origin_upper_left = var->origin_upper_left;
2116 earlier->pixel_center_integer = var->pixel_center_integer;
2118 /* According to section 4.3.7 of the GLSL 1.30 spec,
2119 * the following built-in varaibles can be redeclared with an
2120 * interpolation qualifier:
2123 * * gl_FrontSecondaryColor
2124 * * gl_BackSecondaryColor
2126 * * gl_SecondaryColor
2128 } else if (state->language_version >= 130
2129 && (strcmp(var->name, "gl_FrontColor") == 0
2130 || strcmp(var->name, "gl_BackColor") == 0
2131 || strcmp(var->name, "gl_FrontSecondaryColor") == 0
2132 || strcmp(var->name, "gl_BackSecondaryColor") == 0
2133 || strcmp(var->name, "gl_Color") == 0
2134 || strcmp(var->name, "gl_SecondaryColor") == 0)
2135 && earlier->type == var->type
2136 && earlier->mode == var->mode) {
2137 earlier->interpolation = var->interpolation;
2139 /* Layout qualifiers for gl_FragDepth. */
2140 } else if (state->AMD_conservative_depth_enable
2141 && strcmp(var->name, "gl_FragDepth") == 0
2142 && earlier->type == var->type
2143 && earlier->mode == var->mode) {
2145 /** From the AMD_conservative_depth spec:
2146 * Within any shader, the first redeclarations of gl_FragDepth
2147 * must appear before any use of gl_FragDepth.
2149 if (earlier->used) {
2150 _mesa_glsl_error(&loc, state,
2151 "the first redeclaration of gl_FragDepth "
2152 "must appear before any use of gl_FragDepth");
2155 /* Prevent inconsistent redeclaration of depth layout qualifier. */
2156 if (earlier->depth_layout != ir_depth_layout_none
2157 && earlier->depth_layout != var->depth_layout) {
2158 _mesa_glsl_error(&loc, state,
2159 "gl_FragDepth: depth layout is declared here "
2160 "as '%s, but it was previously declared as "
2162 depth_layout_string(var->depth_layout),
2163 depth_layout_string(earlier->depth_layout));
2166 earlier->depth_layout = var->depth_layout;
2169 _mesa_glsl_error(&loc, state, "`%s' redeclared", decl->identifier);
2176 * Generate the IR for an initializer in a variable declaration
2179 process_initializer(ir_variable *var, ast_declaration *decl,
2180 ast_fully_specified_type *type,
2181 exec_list *initializer_instructions,
2182 struct _mesa_glsl_parse_state *state)
2184 ir_rvalue *result = NULL;
2186 YYLTYPE initializer_loc = decl->initializer->get_location();
2188 /* From page 24 (page 30 of the PDF) of the GLSL 1.10 spec:
2190 * "All uniform variables are read-only and are initialized either
2191 * directly by an application via API commands, or indirectly by
2194 if ((state->language_version <= 110)
2195 && (var->mode == ir_var_uniform)) {
2196 _mesa_glsl_error(& initializer_loc, state,
2197 "cannot initialize uniforms in GLSL 1.10");
2200 if (var->type->is_sampler()) {
2201 _mesa_glsl_error(& initializer_loc, state,
2202 "cannot initialize samplers");
2205 if ((var->mode == ir_var_in) && (state->current_function == NULL)) {
2206 _mesa_glsl_error(& initializer_loc, state,
2207 "cannot initialize %s shader input / %s",
2208 _mesa_glsl_shader_target_name(state->target),
2209 (state->target == vertex_shader)
2210 ? "attribute" : "varying");
2213 ir_dereference *const lhs = new(state) ir_dereference_variable(var);
2214 ir_rvalue *rhs = decl->initializer->hir(initializer_instructions,
2217 /* Calculate the constant value if this is a const or uniform
2220 if (type->qualifier.flags.q.constant
2221 || type->qualifier.flags.q.uniform) {
2222 ir_rvalue *new_rhs = validate_assignment(state, var->type, rhs, true);
2223 if (new_rhs != NULL) {
2226 ir_constant *constant_value = rhs->constant_expression_value();
2227 if (!constant_value) {
2228 _mesa_glsl_error(& initializer_loc, state,
2229 "initializer of %s variable `%s' must be a "
2230 "constant expression",
2231 (type->qualifier.flags.q.constant)
2232 ? "const" : "uniform",
2234 if (var->type->is_numeric()) {
2235 /* Reduce cascading errors. */
2236 var->constant_value = ir_constant::zero(state, var->type);
2239 rhs = constant_value;
2240 var->constant_value = constant_value;
2243 _mesa_glsl_error(&initializer_loc, state,
2244 "initializer of type %s cannot be assigned to "
2245 "variable of type %s",
2246 rhs->type->name, var->type->name);
2247 if (var->type->is_numeric()) {
2248 /* Reduce cascading errors. */
2249 var->constant_value = ir_constant::zero(state, var->type);
2254 if (rhs && !rhs->type->is_error()) {
2255 bool temp = var->read_only;
2256 if (type->qualifier.flags.q.constant)
2257 var->read_only = false;
2259 /* Never emit code to initialize a uniform.
2261 const glsl_type *initializer_type;
2262 if (!type->qualifier.flags.q.uniform) {
2263 result = do_assignment(initializer_instructions, state,
2265 type->get_location());
2266 initializer_type = result->type;
2268 initializer_type = rhs->type;
2270 /* If the declared variable is an unsized array, it must inherrit
2271 * its full type from the initializer. A declaration such as
2273 * uniform float a[] = float[](1.0, 2.0, 3.0, 3.0);
2277 * uniform float a[4] = float[](1.0, 2.0, 3.0, 3.0);
2279 * The assignment generated in the if-statement (below) will also
2280 * automatically handle this case for non-uniforms.
2282 * If the declared variable is not an array, the types must
2283 * already match exactly. As a result, the type assignment
2284 * here can be done unconditionally. For non-uniforms the call
2285 * to do_assignment can change the type of the initializer (via
2286 * the implicit conversion rules). For uniforms the initializer
2287 * must be a constant expression, and the type of that expression
2288 * was validated above.
2290 var->type = initializer_type;
2292 var->read_only = temp;
2299 ast_declarator_list::hir(exec_list *instructions,
2300 struct _mesa_glsl_parse_state *state)
2303 const struct glsl_type *decl_type;
2304 const char *type_name = NULL;
2305 ir_rvalue *result = NULL;
2306 YYLTYPE loc = this->get_location();
2308 /* From page 46 (page 52 of the PDF) of the GLSL 1.50 spec:
2310 * "To ensure that a particular output variable is invariant, it is
2311 * necessary to use the invariant qualifier. It can either be used to
2312 * qualify a previously declared variable as being invariant
2314 * invariant gl_Position; // make existing gl_Position be invariant"
2316 * In these cases the parser will set the 'invariant' flag in the declarator
2317 * list, and the type will be NULL.
2319 if (this->invariant) {
2320 assert(this->type == NULL);
2322 if (state->current_function != NULL) {
2323 _mesa_glsl_error(& loc, state,
2324 "All uses of `invariant' keyword must be at global "
2328 foreach_list_typed (ast_declaration, decl, link, &this->declarations) {
2329 assert(!decl->is_array);
2330 assert(decl->array_size == NULL);
2331 assert(decl->initializer == NULL);
2333 ir_variable *const earlier =
2334 state->symbols->get_variable(decl->identifier);
2335 if (earlier == NULL) {
2336 _mesa_glsl_error(& loc, state,
2337 "Undeclared variable `%s' cannot be marked "
2338 "invariant\n", decl->identifier);
2339 } else if ((state->target == vertex_shader)
2340 && (earlier->mode != ir_var_out)) {
2341 _mesa_glsl_error(& loc, state,
2342 "`%s' cannot be marked invariant, vertex shader "
2343 "outputs only\n", decl->identifier);
2344 } else if ((state->target == fragment_shader)
2345 && (earlier->mode != ir_var_in)) {
2346 _mesa_glsl_error(& loc, state,
2347 "`%s' cannot be marked invariant, fragment shader "
2348 "inputs only\n", decl->identifier);
2349 } else if (earlier->used) {
2350 _mesa_glsl_error(& loc, state,
2351 "variable `%s' may not be redeclared "
2352 "`invariant' after being used",
2355 earlier->invariant = true;
2359 /* Invariant redeclarations do not have r-values.
2364 assert(this->type != NULL);
2365 assert(!this->invariant);
2367 /* The type specifier may contain a structure definition. Process that
2368 * before any of the variable declarations.
2370 (void) this->type->specifier->hir(instructions, state);
2372 decl_type = this->type->specifier->glsl_type(& type_name, state);
2373 if (this->declarations.is_empty()) {
2374 /* The only valid case where the declaration list can be empty is when
2375 * the declaration is setting the default precision of a built-in type
2376 * (e.g., 'precision highp vec4;').
2379 if (decl_type != NULL) {
2381 _mesa_glsl_error(& loc, state, "incomplete declaration");
2385 foreach_list_typed (ast_declaration, decl, link, &this->declarations) {
2386 const struct glsl_type *var_type;
2389 /* FINISHME: Emit a warning if a variable declaration shadows a
2390 * FINISHME: declaration at a higher scope.
2393 if ((decl_type == NULL) || decl_type->is_void()) {
2394 if (type_name != NULL) {
2395 _mesa_glsl_error(& loc, state,
2396 "invalid type `%s' in declaration of `%s'",
2397 type_name, decl->identifier);
2399 _mesa_glsl_error(& loc, state,
2400 "invalid type in declaration of `%s'",
2406 if (decl->is_array) {
2407 var_type = process_array_type(&loc, decl_type, decl->array_size,
2410 var_type = decl_type;
2413 var = new(ctx) ir_variable(var_type, decl->identifier, ir_var_auto);
2415 /* From page 22 (page 28 of the PDF) of the GLSL 1.10 specification;
2417 * "Global variables can only use the qualifiers const,
2418 * attribute, uni form, or varying. Only one may be
2421 * Local variables can only use the qualifier const."
2423 * This is relaxed in GLSL 1.30. It is also relaxed by any extension
2424 * that adds the 'layout' keyword.
2426 if ((state->language_version < 130)
2427 && !state->ARB_explicit_attrib_location_enable
2428 && !state->ARB_fragment_coord_conventions_enable) {
2429 if (this->type->qualifier.flags.q.out) {
2430 _mesa_glsl_error(& loc, state,
2431 "`out' qualifier in declaration of `%s' "
2432 "only valid for function parameters in %s.",
2433 decl->identifier, state->version_string);
2435 if (this->type->qualifier.flags.q.in) {
2436 _mesa_glsl_error(& loc, state,
2437 "`in' qualifier in declaration of `%s' "
2438 "only valid for function parameters in %s.",
2439 decl->identifier, state->version_string);
2441 /* FINISHME: Test for other invalid qualifiers. */
2444 apply_type_qualifier_to_variable(& this->type->qualifier, var, state,
2447 if (this->type->qualifier.flags.q.invariant) {
2448 if ((state->target == vertex_shader) && !(var->mode == ir_var_out ||
2449 var->mode == ir_var_inout)) {
2450 /* FINISHME: Note that this doesn't work for invariant on
2451 * a function signature outval
2453 _mesa_glsl_error(& loc, state,
2454 "`%s' cannot be marked invariant, vertex shader "
2455 "outputs only\n", var->name);
2456 } else if ((state->target == fragment_shader) &&
2457 !(var->mode == ir_var_in || var->mode == ir_var_inout)) {
2458 /* FINISHME: Note that this doesn't work for invariant on
2459 * a function signature inval
2461 _mesa_glsl_error(& loc, state,
2462 "`%s' cannot be marked invariant, fragment shader "
2463 "inputs only\n", var->name);
2467 if (state->current_function != NULL) {
2468 const char *mode = NULL;
2469 const char *extra = "";
2471 /* There is no need to check for 'inout' here because the parser will
2472 * only allow that in function parameter lists.
2474 if (this->type->qualifier.flags.q.attribute) {
2476 } else if (this->type->qualifier.flags.q.uniform) {
2478 } else if (this->type->qualifier.flags.q.varying) {
2480 } else if (this->type->qualifier.flags.q.in) {
2482 extra = " or in function parameter list";
2483 } else if (this->type->qualifier.flags.q.out) {
2485 extra = " or in function parameter list";
2489 _mesa_glsl_error(& loc, state,
2490 "%s variable `%s' must be declared at "
2492 mode, var->name, extra);
2494 } else if (var->mode == ir_var_in) {
2495 var->read_only = true;
2497 if (state->target == vertex_shader) {
2498 bool error_emitted = false;
2500 /* From page 31 (page 37 of the PDF) of the GLSL 1.50 spec:
2502 * "Vertex shader inputs can only be float, floating-point
2503 * vectors, matrices, signed and unsigned integers and integer
2504 * vectors. Vertex shader inputs can also form arrays of these
2505 * types, but not structures."
2507 * From page 31 (page 27 of the PDF) of the GLSL 1.30 spec:
2509 * "Vertex shader inputs can only be float, floating-point
2510 * vectors, matrices, signed and unsigned integers and integer
2511 * vectors. They cannot be arrays or structures."
2513 * From page 23 (page 29 of the PDF) of the GLSL 1.20 spec:
2515 * "The attribute qualifier can be used only with float,
2516 * floating-point vectors, and matrices. Attribute variables
2517 * cannot be declared as arrays or structures."
2519 const glsl_type *check_type = var->type->is_array()
2520 ? var->type->fields.array : var->type;
2522 switch (check_type->base_type) {
2523 case GLSL_TYPE_FLOAT:
2525 case GLSL_TYPE_UINT:
2527 if (state->language_version > 120)
2531 _mesa_glsl_error(& loc, state,
2532 "vertex shader input / attribute cannot have "
2534 var->type->is_array() ? "array of " : "",
2536 error_emitted = true;
2539 if (!error_emitted && (state->language_version <= 130)
2540 && var->type->is_array()) {
2541 _mesa_glsl_error(& loc, state,
2542 "vertex shader input / attribute cannot have "
2544 error_emitted = true;
2549 /* Integer vertex outputs must be qualified with 'flat'.
2551 * From section 4.3.6 of the GLSL 1.30 spec:
2552 * "If a vertex output is a signed or unsigned integer or integer
2553 * vector, then it must be qualified with the interpolation qualifier
2556 if (state->language_version >= 130
2557 && state->target == vertex_shader
2558 && state->current_function == NULL
2559 && var->type->is_integer()
2560 && var->mode == ir_var_out
2561 && var->interpolation != ir_var_flat) {
2563 _mesa_glsl_error(&loc, state, "If a vertex output is an integer, "
2564 "then it must be qualified with 'flat'");
2568 /* Interpolation qualifiers cannot be applied to 'centroid' and
2569 * 'centroid varying'.
2571 * From page 29 (page 35 of the PDF) of the GLSL 1.30 spec:
2572 * "interpolation qualifiers may only precede the qualifiers in,
2573 * centroid in, out, or centroid out in a declaration. They do not apply
2574 * to the deprecated storage qualifiers varying or centroid varying."
2576 if (state->language_version >= 130
2577 && this->type->qualifier.has_interpolation()
2578 && this->type->qualifier.flags.q.varying) {
2580 const char *i = this->type->qualifier.interpolation_string();
2583 if (this->type->qualifier.flags.q.centroid)
2584 s = "centroid varying";
2588 _mesa_glsl_error(&loc, state,
2589 "qualifier '%s' cannot be applied to the "
2590 "deprecated storage qualifier '%s'", i, s);
2594 /* Interpolation qualifiers can only apply to vertex shader outputs and
2595 * fragment shader inputs.
2597 * From page 29 (page 35 of the PDF) of the GLSL 1.30 spec:
2598 * "Outputs from a vertex shader (out) and inputs to a fragment
2599 * shader (in) can be further qualified with one or more of these
2600 * interpolation qualifiers"
2602 if (state->language_version >= 130
2603 && this->type->qualifier.has_interpolation()) {
2605 const char *i = this->type->qualifier.interpolation_string();
2608 switch (state->target) {
2610 if (this->type->qualifier.flags.q.in) {
2611 _mesa_glsl_error(&loc, state,
2612 "qualifier '%s' cannot be applied to vertex "
2613 "shader inputs", i);
2616 case fragment_shader:
2617 if (this->type->qualifier.flags.q.out) {
2618 _mesa_glsl_error(&loc, state,
2619 "qualifier '%s' cannot be applied to fragment "
2620 "shader outputs", i);
2629 /* From section 4.3.4 of the GLSL 1.30 spec:
2630 * "It is an error to use centroid in in a vertex shader."
2632 if (state->language_version >= 130
2633 && this->type->qualifier.flags.q.centroid
2634 && this->type->qualifier.flags.q.in
2635 && state->target == vertex_shader) {
2637 _mesa_glsl_error(&loc, state,
2638 "'centroid in' cannot be used in a vertex shader");
2642 /* Precision qualifiers exists only in GLSL versions 1.00 and >= 1.30.
2644 if (this->type->specifier->precision != ast_precision_none
2645 && state->language_version != 100
2646 && state->language_version < 130) {
2648 _mesa_glsl_error(&loc, state,
2649 "precision qualifiers are supported only in GLSL ES "
2650 "1.00, and GLSL 1.30 and later");
2654 /* Precision qualifiers only apply to floating point and integer types.
2656 * From section 4.5.2 of the GLSL 1.30 spec:
2657 * "Any floating point or any integer declaration can have the type
2658 * preceded by one of these precision qualifiers [...] Literal
2659 * constants do not have precision qualifiers. Neither do Boolean
2662 * In GLSL ES, sampler types are also allowed.
2664 * From page 87 of the GLSL ES spec:
2665 * "RESOLUTION: Allow sampler types to take a precision qualifier."
2667 if (this->type->specifier->precision != ast_precision_none
2668 && !var->type->is_float()
2669 && !var->type->is_integer()
2670 && !(var->type->is_sampler() && state->es_shader)
2671 && !(var->type->is_array()
2672 && (var->type->fields.array->is_float()
2673 || var->type->fields.array->is_integer()))) {
2675 _mesa_glsl_error(&loc, state,
2676 "precision qualifiers apply only to floating point"
2677 "%s types", state->es_shader ? ", integer, and sampler"
2681 /* Process the initializer and add its instructions to a temporary
2682 * list. This list will be added to the instruction stream (below) after
2683 * the declaration is added. This is done because in some cases (such as
2684 * redeclarations) the declaration may not actually be added to the
2685 * instruction stream.
2687 exec_list initializer_instructions;
2688 ir_variable *earlier = get_variable_being_redeclared(var, decl, state);
2690 if (decl->initializer != NULL) {
2691 result = process_initializer((earlier == NULL) ? var : earlier,
2693 &initializer_instructions, state);
2696 /* From page 23 (page 29 of the PDF) of the GLSL 1.10 spec:
2698 * "It is an error to write to a const variable outside of
2699 * its declaration, so they must be initialized when
2702 if (this->type->qualifier.flags.q.constant && decl->initializer == NULL) {
2703 _mesa_glsl_error(& loc, state,
2704 "const declaration of `%s' must be initialized",
2708 /* If the declaration is not a redeclaration, there are a few additional
2709 * semantic checks that must be applied. In addition, variable that was
2710 * created for the declaration should be added to the IR stream.
2712 if (earlier == NULL) {
2713 /* From page 15 (page 21 of the PDF) of the GLSL 1.10 spec,
2715 * "Identifiers starting with "gl_" are reserved for use by
2716 * OpenGL, and may not be declared in a shader as either a
2717 * variable or a function."
2719 if (strncmp(decl->identifier, "gl_", 3) == 0)
2720 _mesa_glsl_error(& loc, state,
2721 "identifier `%s' uses reserved `gl_' prefix",
2724 /* Add the variable to the symbol table. Note that the initializer's
2725 * IR was already processed earlier (though it hasn't been emitted
2726 * yet), without the variable in scope.
2728 * This differs from most C-like languages, but it follows the GLSL
2729 * specification. From page 28 (page 34 of the PDF) of the GLSL 1.50
2732 * "Within a declaration, the scope of a name starts immediately
2733 * after the initializer if present or immediately after the name
2734 * being declared if not."
2736 if (!state->symbols->add_variable(var)) {
2737 YYLTYPE loc = this->get_location();
2738 _mesa_glsl_error(&loc, state, "name `%s' already taken in the "
2739 "current scope", decl->identifier);
2743 /* Push the variable declaration to the top. It means that all the
2744 * variable declarations will appear in a funny last-to-first order,
2745 * but otherwise we run into trouble if a function is prototyped, a
2746 * global var is decled, then the function is defined with usage of
2747 * the global var. See glslparsertest's CorrectModule.frag.
2749 instructions->push_head(var);
2752 instructions->append_list(&initializer_instructions);
2756 /* Generally, variable declarations do not have r-values. However,
2757 * one is used for the declaration in
2759 * while (bool b = some_condition()) {
2763 * so we return the rvalue from the last seen declaration here.
2770 ast_parameter_declarator::hir(exec_list *instructions,
2771 struct _mesa_glsl_parse_state *state)
2774 const struct glsl_type *type;
2775 const char *name = NULL;
2776 YYLTYPE loc = this->get_location();
2778 type = this->type->specifier->glsl_type(& name, state);
2782 _mesa_glsl_error(& loc, state,
2783 "invalid type `%s' in declaration of `%s'",
2784 name, this->identifier);
2786 _mesa_glsl_error(& loc, state,
2787 "invalid type in declaration of `%s'",
2791 type = glsl_type::error_type;
2794 /* From page 62 (page 68 of the PDF) of the GLSL 1.50 spec:
2796 * "Functions that accept no input arguments need not use void in the
2797 * argument list because prototypes (or definitions) are required and
2798 * therefore there is no ambiguity when an empty argument list "( )" is
2799 * declared. The idiom "(void)" as a parameter list is provided for
2802 * Placing this check here prevents a void parameter being set up
2803 * for a function, which avoids tripping up checks for main taking
2804 * parameters and lookups of an unnamed symbol.
2806 if (type->is_void()) {
2807 if (this->identifier != NULL)
2808 _mesa_glsl_error(& loc, state,
2809 "named parameter cannot have type `void'");
2815 if (formal_parameter && (this->identifier == NULL)) {
2816 _mesa_glsl_error(& loc, state, "formal parameter lacks a name");
2820 /* This only handles "vec4 foo[..]". The earlier specifier->glsl_type(...)
2821 * call already handled the "vec4[..] foo" case.
2823 if (this->is_array) {
2824 type = process_array_type(&loc, type, this->array_size, state);
2827 if (type->array_size() == 0) {
2828 _mesa_glsl_error(&loc, state, "arrays passed as parameters must have "
2829 "a declared size.");
2830 type = glsl_type::error_type;
2834 ir_variable *var = new(ctx) ir_variable(type, this->identifier, ir_var_in);
2836 /* Apply any specified qualifiers to the parameter declaration. Note that
2837 * for function parameters the default mode is 'in'.
2839 apply_type_qualifier_to_variable(& this->type->qualifier, var, state, & loc);
2841 instructions->push_tail(var);
2843 /* Parameter declarations do not have r-values.
2850 ast_parameter_declarator::parameters_to_hir(exec_list *ast_parameters,
2852 exec_list *ir_parameters,
2853 _mesa_glsl_parse_state *state)
2855 ast_parameter_declarator *void_param = NULL;
2858 foreach_list_typed (ast_parameter_declarator, param, link, ast_parameters) {
2859 param->formal_parameter = formal;
2860 param->hir(ir_parameters, state);
2868 if ((void_param != NULL) && (count > 1)) {
2869 YYLTYPE loc = void_param->get_location();
2871 _mesa_glsl_error(& loc, state,
2872 "`void' parameter must be only parameter");
2878 emit_function(_mesa_glsl_parse_state *state, exec_list *instructions,
2881 /* Emit the new function header */
2882 if (state->current_function == NULL) {
2883 instructions->push_tail(f);
2885 /* IR invariants disallow function declarations or definitions nested
2886 * within other function definitions. Insert the new ir_function
2887 * block in the instruction sequence before the ir_function block
2888 * containing the current ir_function_signature.
2890 ir_function *const curr =
2891 const_cast<ir_function *>(state->current_function->function());
2893 curr->insert_before(f);
2899 ast_function::hir(exec_list *instructions,
2900 struct _mesa_glsl_parse_state *state)
2903 ir_function *f = NULL;
2904 ir_function_signature *sig = NULL;
2905 exec_list hir_parameters;
2907 const char *const name = identifier;
2909 /* From page 21 (page 27 of the PDF) of the GLSL 1.20 spec,
2911 * "Function declarations (prototypes) cannot occur inside of functions;
2912 * they must be at global scope, or for the built-in functions, outside
2913 * the global scope."
2915 * From page 27 (page 33 of the PDF) of the GLSL ES 1.00.16 spec,
2917 * "User defined functions may only be defined within the global scope."
2919 * Note that this language does not appear in GLSL 1.10.
2921 if ((state->current_function != NULL) && (state->language_version != 110)) {
2922 YYLTYPE loc = this->get_location();
2923 _mesa_glsl_error(&loc, state,
2924 "declaration of function `%s' not allowed within "
2925 "function body", name);
2928 /* From page 15 (page 21 of the PDF) of the GLSL 1.10 spec,
2930 * "Identifiers starting with "gl_" are reserved for use by
2931 * OpenGL, and may not be declared in a shader as either a
2932 * variable or a function."
2934 if (strncmp(name, "gl_", 3) == 0) {
2935 YYLTYPE loc = this->get_location();
2936 _mesa_glsl_error(&loc, state,
2937 "identifier `%s' uses reserved `gl_' prefix", name);
2940 /* Convert the list of function parameters to HIR now so that they can be
2941 * used below to compare this function's signature with previously seen
2942 * signatures for functions with the same name.
2944 ast_parameter_declarator::parameters_to_hir(& this->parameters,
2946 & hir_parameters, state);
2948 const char *return_type_name;
2949 const glsl_type *return_type =
2950 this->return_type->specifier->glsl_type(& return_type_name, state);
2953 YYLTYPE loc = this->get_location();
2954 _mesa_glsl_error(&loc, state,
2955 "function `%s' has undeclared return type `%s'",
2956 name, return_type_name);
2957 return_type = glsl_type::error_type;
2960 /* From page 56 (page 62 of the PDF) of the GLSL 1.30 spec:
2961 * "No qualifier is allowed on the return type of a function."
2963 if (this->return_type->has_qualifiers()) {
2964 YYLTYPE loc = this->get_location();
2965 _mesa_glsl_error(& loc, state,
2966 "function `%s' return type has qualifiers", name);
2969 /* Verify that this function's signature either doesn't match a previously
2970 * seen signature for a function with the same name, or, if a match is found,
2971 * that the previously seen signature does not have an associated definition.
2973 f = state->symbols->get_function(name);
2974 if (f != NULL && (state->es_shader || f->has_user_signature())) {
2975 sig = f->exact_matching_signature(&hir_parameters);
2977 const char *badvar = sig->qualifiers_match(&hir_parameters);
2978 if (badvar != NULL) {
2979 YYLTYPE loc = this->get_location();
2981 _mesa_glsl_error(&loc, state, "function `%s' parameter `%s' "
2982 "qualifiers don't match prototype", name, badvar);
2985 if (sig->return_type != return_type) {
2986 YYLTYPE loc = this->get_location();
2988 _mesa_glsl_error(&loc, state, "function `%s' return type doesn't "
2989 "match prototype", name);
2992 if (is_definition && sig->is_defined) {
2993 YYLTYPE loc = this->get_location();
2995 _mesa_glsl_error(& loc, state, "function `%s' redefined", name);
2999 f = new(ctx) ir_function(name);
3000 if (!state->symbols->add_function(f)) {
3001 /* This function name shadows a non-function use of the same name. */
3002 YYLTYPE loc = this->get_location();
3004 _mesa_glsl_error(&loc, state, "function name `%s' conflicts with "
3005 "non-function", name);
3009 emit_function(state, instructions, f);
3012 /* Verify the return type of main() */
3013 if (strcmp(name, "main") == 0) {
3014 if (! return_type->is_void()) {
3015 YYLTYPE loc = this->get_location();
3017 _mesa_glsl_error(& loc, state, "main() must return void");
3020 if (!hir_parameters.is_empty()) {
3021 YYLTYPE loc = this->get_location();
3023 _mesa_glsl_error(& loc, state, "main() must not take any parameters");
3027 /* Finish storing the information about this new function in its signature.
3030 sig = new(ctx) ir_function_signature(return_type);
3031 f->add_signature(sig);
3034 sig->replace_parameters(&hir_parameters);
3037 /* Function declarations (prototypes) do not have r-values.
3044 ast_function_definition::hir(exec_list *instructions,
3045 struct _mesa_glsl_parse_state *state)
3047 prototype->is_definition = true;
3048 prototype->hir(instructions, state);
3050 ir_function_signature *signature = prototype->signature;
3051 if (signature == NULL)
3054 assert(state->current_function == NULL);
3055 state->current_function = signature;
3056 state->found_return = false;
3058 /* Duplicate parameters declared in the prototype as concrete variables.
3059 * Add these to the symbol table.
3061 state->symbols->push_scope();
3062 foreach_iter(exec_list_iterator, iter, signature->parameters) {
3063 ir_variable *const var = ((ir_instruction *) iter.get())->as_variable();
3065 assert(var != NULL);
3067 /* The only way a parameter would "exist" is if two parameters have
3070 if (state->symbols->name_declared_this_scope(var->name)) {
3071 YYLTYPE loc = this->get_location();
3073 _mesa_glsl_error(& loc, state, "parameter `%s' redeclared", var->name);
3075 state->symbols->add_variable(var);
3079 /* Convert the body of the function to HIR. */
3080 this->body->hir(&signature->body, state);
3081 signature->is_defined = true;
3083 state->symbols->pop_scope();
3085 assert(state->current_function == signature);
3086 state->current_function = NULL;
3088 if (!signature->return_type->is_void() && !state->found_return) {
3089 YYLTYPE loc = this->get_location();
3090 _mesa_glsl_error(& loc, state, "function `%s' has non-void return type "
3091 "%s, but no return statement",
3092 signature->function_name(),
3093 signature->return_type->name);
3096 /* Function definitions do not have r-values.
3103 ast_jump_statement::hir(exec_list *instructions,
3104 struct _mesa_glsl_parse_state *state)
3111 assert(state->current_function);
3113 if (opt_return_value) {
3114 ir_rvalue *const ret = opt_return_value->hir(instructions, state);
3116 /* The value of the return type can be NULL if the shader says
3117 * 'return foo();' and foo() is a function that returns void.
3119 * NOTE: The GLSL spec doesn't say that this is an error. The type
3120 * of the return value is void. If the return type of the function is
3121 * also void, then this should compile without error. Seriously.
3123 const glsl_type *const ret_type =
3124 (ret == NULL) ? glsl_type::void_type : ret->type;
3126 /* Implicit conversions are not allowed for return values. */
3127 if (state->current_function->return_type != ret_type) {
3128 YYLTYPE loc = this->get_location();
3130 _mesa_glsl_error(& loc, state,
3131 "`return' with wrong type %s, in function `%s' "
3134 state->current_function->function_name(),
3135 state->current_function->return_type->name);
3138 inst = new(ctx) ir_return(ret);
3140 if (state->current_function->return_type->base_type !=
3142 YYLTYPE loc = this->get_location();
3144 _mesa_glsl_error(& loc, state,
3145 "`return' with no value, in function %s returning "
3147 state->current_function->function_name());
3149 inst = new(ctx) ir_return;
3152 state->found_return = true;
3153 instructions->push_tail(inst);
3158 if (state->target != fragment_shader) {
3159 YYLTYPE loc = this->get_location();
3161 _mesa_glsl_error(& loc, state,
3162 "`discard' may only appear in a fragment shader");
3164 instructions->push_tail(new(ctx) ir_discard);
3169 /* FINISHME: Handle switch-statements. They cannot contain 'continue',
3170 * FINISHME: and they use a different IR instruction for 'break'.
3172 /* FINISHME: Correctly handle the nesting. If a switch-statement is
3173 * FINISHME: inside a loop, a 'continue' is valid and will bind to the
3176 if (state->loop_or_switch_nesting == NULL) {
3177 YYLTYPE loc = this->get_location();
3179 _mesa_glsl_error(& loc, state,
3180 "`%s' may only appear in a loop",
3181 (mode == ast_break) ? "break" : "continue");
3183 ir_loop *const loop = state->loop_or_switch_nesting->as_loop();
3185 /* Inline the for loop expression again, since we don't know
3186 * where near the end of the loop body the normal copy of it
3187 * is going to be placed.
3189 if (mode == ast_continue &&
3190 state->loop_or_switch_nesting_ast->rest_expression) {
3191 state->loop_or_switch_nesting_ast->rest_expression->hir(instructions,
3196 ir_loop_jump *const jump =
3197 new(ctx) ir_loop_jump((mode == ast_break)
3198 ? ir_loop_jump::jump_break
3199 : ir_loop_jump::jump_continue);
3200 instructions->push_tail(jump);
3207 /* Jump instructions do not have r-values.
3214 ast_selection_statement::hir(exec_list *instructions,
3215 struct _mesa_glsl_parse_state *state)
3219 ir_rvalue *const condition = this->condition->hir(instructions, state);
3221 /* From page 66 (page 72 of the PDF) of the GLSL 1.50 spec:
3223 * "Any expression whose type evaluates to a Boolean can be used as the
3224 * conditional expression bool-expression. Vector types are not accepted
3225 * as the expression to if."
3227 * The checks are separated so that higher quality diagnostics can be
3228 * generated for cases where both rules are violated.
3230 if (!condition->type->is_boolean() || !condition->type->is_scalar()) {
3231 YYLTYPE loc = this->condition->get_location();
3233 _mesa_glsl_error(& loc, state, "if-statement condition must be scalar "
3237 ir_if *const stmt = new(ctx) ir_if(condition);
3239 if (then_statement != NULL) {
3240 state->symbols->push_scope();
3241 then_statement->hir(& stmt->then_instructions, state);
3242 state->symbols->pop_scope();
3245 if (else_statement != NULL) {
3246 state->symbols->push_scope();
3247 else_statement->hir(& stmt->else_instructions, state);
3248 state->symbols->pop_scope();
3251 instructions->push_tail(stmt);
3253 /* if-statements do not have r-values.
3260 ast_iteration_statement::condition_to_hir(ir_loop *stmt,
3261 struct _mesa_glsl_parse_state *state)
3265 if (condition != NULL) {
3266 ir_rvalue *const cond =
3267 condition->hir(& stmt->body_instructions, state);
3270 || !cond->type->is_boolean() || !cond->type->is_scalar()) {
3271 YYLTYPE loc = condition->get_location();
3273 _mesa_glsl_error(& loc, state,
3274 "loop condition must be scalar boolean");
3276 /* As the first code in the loop body, generate a block that looks
3277 * like 'if (!condition) break;' as the loop termination condition.
3279 ir_rvalue *const not_cond =
3280 new(ctx) ir_expression(ir_unop_logic_not, glsl_type::bool_type, cond,
3283 ir_if *const if_stmt = new(ctx) ir_if(not_cond);
3285 ir_jump *const break_stmt =
3286 new(ctx) ir_loop_jump(ir_loop_jump::jump_break);
3288 if_stmt->then_instructions.push_tail(break_stmt);
3289 stmt->body_instructions.push_tail(if_stmt);
3296 ast_iteration_statement::hir(exec_list *instructions,
3297 struct _mesa_glsl_parse_state *state)
3301 /* For-loops and while-loops start a new scope, but do-while loops do not.
3303 if (mode != ast_do_while)
3304 state->symbols->push_scope();
3306 if (init_statement != NULL)
3307 init_statement->hir(instructions, state);
3309 ir_loop *const stmt = new(ctx) ir_loop();
3310 instructions->push_tail(stmt);
3312 /* Track the current loop and / or switch-statement nesting.
3314 ir_instruction *const nesting = state->loop_or_switch_nesting;
3315 ast_iteration_statement *nesting_ast = state->loop_or_switch_nesting_ast;
3317 state->loop_or_switch_nesting = stmt;
3318 state->loop_or_switch_nesting_ast = this;
3320 if (mode != ast_do_while)
3321 condition_to_hir(stmt, state);
3324 body->hir(& stmt->body_instructions, state);
3326 if (rest_expression != NULL)
3327 rest_expression->hir(& stmt->body_instructions, state);
3329 if (mode == ast_do_while)
3330 condition_to_hir(stmt, state);
3332 if (mode != ast_do_while)
3333 state->symbols->pop_scope();
3335 /* Restore previous nesting before returning.
3337 state->loop_or_switch_nesting = nesting;
3338 state->loop_or_switch_nesting_ast = nesting_ast;
3340 /* Loops do not have r-values.
3347 ast_type_specifier::hir(exec_list *instructions,
3348 struct _mesa_glsl_parse_state *state)
3350 if (!this->is_precision_statement && this->structure == NULL)
3353 YYLTYPE loc = this->get_location();
3355 if (this->precision != ast_precision_none
3356 && state->language_version != 100
3357 && state->language_version < 130) {
3358 _mesa_glsl_error(&loc, state,
3359 "precision qualifiers exist only in "
3360 "GLSL ES 1.00, and GLSL 1.30 and later");
3363 if (this->precision != ast_precision_none
3364 && this->structure != NULL) {
3365 _mesa_glsl_error(&loc, state,
3366 "precision qualifiers do not apply to structures");
3370 /* If this is a precision statement, check that the type to which it is
3371 * applied is either float or int.
3373 * From section 4.5.3 of the GLSL 1.30 spec:
3374 * "The precision statement
3375 * precision precision-qualifier type;
3376 * can be used to establish a default precision qualifier. The type
3377 * field can be either int or float [...]. Any other types or
3378 * qualifiers will result in an error.
3380 if (this->is_precision_statement) {
3381 assert(this->precision != ast_precision_none);
3382 assert(this->structure == NULL); /* The check for structures was
3383 * performed above. */
3384 if (this->is_array) {
3385 _mesa_glsl_error(&loc, state,
3386 "default precision statements do not apply to "
3390 if (this->type_specifier != ast_float
3391 && this->type_specifier != ast_int) {
3392 _mesa_glsl_error(&loc, state,
3393 "default precision statements apply only to types "
3398 /* FINISHME: Translate precision statements into IR. */
3402 if (this->structure != NULL)
3403 return this->structure->hir(instructions, state);
3410 ast_struct_specifier::hir(exec_list *instructions,
3411 struct _mesa_glsl_parse_state *state)
3413 unsigned decl_count = 0;
3415 /* Make an initial pass over the list of structure fields to determine how
3416 * many there are. Each element in this list is an ast_declarator_list.
3417 * This means that we actually need to count the number of elements in the
3418 * 'declarations' list in each of the elements.
3420 foreach_list_typed (ast_declarator_list, decl_list, link,
3421 &this->declarations) {
3422 foreach_list_const (decl_ptr, & decl_list->declarations) {
3427 /* Allocate storage for the structure fields and process the field
3428 * declarations. As the declarations are processed, try to also convert
3429 * the types to HIR. This ensures that structure definitions embedded in
3430 * other structure definitions are processed.
3432 glsl_struct_field *const fields = ralloc_array(state, glsl_struct_field,
3436 foreach_list_typed (ast_declarator_list, decl_list, link,
3437 &this->declarations) {
3438 const char *type_name;
3440 decl_list->type->specifier->hir(instructions, state);
3442 /* Section 10.9 of the GLSL ES 1.00 specification states that
3443 * embedded structure definitions have been removed from the language.
3445 if (state->es_shader && decl_list->type->specifier->structure != NULL) {
3446 YYLTYPE loc = this->get_location();
3447 _mesa_glsl_error(&loc, state, "Embedded structure definitions are "
3448 "not allowed in GLSL ES 1.00.");
3451 const glsl_type *decl_type =
3452 decl_list->type->specifier->glsl_type(& type_name, state);
3454 foreach_list_typed (ast_declaration, decl, link,
3455 &decl_list->declarations) {
3456 const struct glsl_type *field_type = decl_type;
3457 if (decl->is_array) {
3458 YYLTYPE loc = decl->get_location();
3459 field_type = process_array_type(&loc, decl_type, decl->array_size,
3462 fields[i].type = (field_type != NULL)
3463 ? field_type : glsl_type::error_type;
3464 fields[i].name = decl->identifier;
3469 assert(i == decl_count);
3471 const glsl_type *t =
3472 glsl_type::get_record_instance(fields, decl_count, this->name);
3474 YYLTYPE loc = this->get_location();
3475 if (!state->symbols->add_type(name, t)) {
3476 _mesa_glsl_error(& loc, state, "struct `%s' previously defined", name);
3478 const glsl_type **s = reralloc(state, state->user_structures,
3480 state->num_user_structures + 1);
3482 s[state->num_user_structures] = t;
3483 state->user_structures = s;
3484 state->num_user_structures++;
3488 /* Structure type definitions do not have r-values.