2 * Copyright © 2008, 2009 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.
29 #include "main/core.h" /* for struct gl_context */
30 #include "main/context.h"
31 #include "main/shaderobj.h"
36 #include "glsl_parser_extras.h"
37 #include "glsl_parser.h"
38 #include "ir_optimization.h"
39 #include "loop_analysis.h"
42 * Format a short human-readable description of the given GLSL version.
45 glsl_compute_version_string(void *mem_ctx
, bool is_es
, unsigned version
)
47 return ralloc_asprintf(mem_ctx
, "GLSL%s %d.%02d", is_es
? " ES" : "",
48 version
/ 100, version
% 100);
52 static unsigned known_desktop_glsl_versions
[] =
53 { 110, 120, 130, 140, 150, 330, 400, 410, 420, 430 };
56 _mesa_glsl_parse_state::_mesa_glsl_parse_state(struct gl_context
*_ctx
,
57 GLenum target
, void *mem_ctx
)
58 : ctx(_ctx
), switch_state()
61 case GL_VERTEX_SHADER
: this->target
= vertex_shader
; break;
62 case GL_FRAGMENT_SHADER
: this->target
= fragment_shader
; break;
63 case GL_GEOMETRY_SHADER
: this->target
= geometry_shader
; break;
67 this->translation_unit
.make_empty();
68 this->symbols
= new(mem_ctx
) glsl_symbol_table
;
70 this->num_uniform_blocks
= 0;
71 this->uniform_block_array_size
= 0;
72 this->uniform_blocks
= NULL
;
74 this->info_log
= ralloc_strdup(mem_ctx
, "");
76 this->loop_nesting_ast
= NULL
;
78 this->struct_specifier_depth
= 0;
79 this->num_builtins_to_link
= 0;
81 /* Set default language version and extensions */
82 this->language_version
= ctx
->Const
.ForceGLSLVersion
?
83 ctx
->Const
.ForceGLSLVersion
: 110;
84 this->es_shader
= false;
85 this->ARB_texture_rectangle_enable
= true;
87 /* OpenGL ES 2.0 has different defaults from desktop GL. */
88 if (ctx
->API
== API_OPENGLES2
) {
89 this->language_version
= 100;
90 this->es_shader
= true;
91 this->ARB_texture_rectangle_enable
= false;
94 this->extensions
= &ctx
->Extensions
;
96 this->Const
.MaxLights
= ctx
->Const
.MaxLights
;
97 this->Const
.MaxClipPlanes
= ctx
->Const
.MaxClipPlanes
;
98 this->Const
.MaxTextureUnits
= ctx
->Const
.MaxTextureUnits
;
99 this->Const
.MaxTextureCoords
= ctx
->Const
.MaxTextureCoordUnits
;
100 this->Const
.MaxVertexAttribs
= ctx
->Const
.VertexProgram
.MaxAttribs
;
101 this->Const
.MaxVertexUniformComponents
= ctx
->Const
.VertexProgram
.MaxUniformComponents
;
102 this->Const
.MaxVertexTextureImageUnits
= ctx
->Const
.VertexProgram
.MaxTextureImageUnits
;
103 this->Const
.MaxCombinedTextureImageUnits
= ctx
->Const
.MaxCombinedTextureImageUnits
;
104 this->Const
.MaxTextureImageUnits
= ctx
->Const
.FragmentProgram
.MaxTextureImageUnits
;
105 this->Const
.MaxFragmentUniformComponents
= ctx
->Const
.FragmentProgram
.MaxUniformComponents
;
106 this->Const
.MinProgramTexelOffset
= ctx
->Const
.MinProgramTexelOffset
;
107 this->Const
.MaxProgramTexelOffset
= ctx
->Const
.MaxProgramTexelOffset
;
109 this->Const
.MaxDrawBuffers
= ctx
->Const
.MaxDrawBuffers
;
112 this->Const
.MaxVertexOutputComponents
= ctx
->Const
.VertexProgram
.MaxOutputComponents
;
113 this->Const
.MaxGeometryInputComponents
= ctx
->Const
.GeometryProgram
.MaxInputComponents
;
114 this->Const
.MaxGeometryOutputComponents
= ctx
->Const
.GeometryProgram
.MaxOutputComponents
;
115 this->Const
.MaxFragmentInputComponents
= ctx
->Const
.FragmentProgram
.MaxInputComponents
;
116 this->Const
.MaxGeometryTextureImageUnits
= ctx
->Const
.GeometryProgram
.MaxTextureImageUnits
;
117 this->Const
.MaxGeometryOutputVertices
= ctx
->Const
.MaxGeometryOutputVertices
;
118 this->Const
.MaxGeometryTotalOutputComponents
= ctx
->Const
.MaxGeometryTotalOutputComponents
;
119 this->Const
.MaxGeometryUniformComponents
= ctx
->Const
.GeometryProgram
.MaxUniformComponents
;
121 this->current_function
= NULL
;
122 this->toplevel_ir
= NULL
;
123 this->found_return
= false;
124 this->all_invariant
= false;
125 this->user_structures
= NULL
;
126 this->num_user_structures
= 0;
128 /* Populate the list of supported GLSL versions */
129 /* FINISHME: Once the OpenGL 3.0 'forward compatible' context or
130 * the OpenGL 3.2 Core context is supported, this logic will need
131 * change. Older versions of GLSL are no longer supported
132 * outside the compatibility contexts of 3.x.
134 this->num_supported_versions
= 0;
135 if (_mesa_is_desktop_gl(ctx
)) {
136 for (unsigned i
= 0; i
< ARRAY_SIZE(known_desktop_glsl_versions
); i
++) {
137 if (known_desktop_glsl_versions
[i
] <= ctx
->Const
.GLSLVersion
) {
138 this->supported_versions
[this->num_supported_versions
].ver
139 = known_desktop_glsl_versions
[i
];
140 this->supported_versions
[this->num_supported_versions
].es
= false;
141 this->num_supported_versions
++;
145 if (ctx
->API
== API_OPENGLES2
|| ctx
->Extensions
.ARB_ES2_compatibility
) {
146 this->supported_versions
[this->num_supported_versions
].ver
= 100;
147 this->supported_versions
[this->num_supported_versions
].es
= true;
148 this->num_supported_versions
++;
150 if (_mesa_is_gles3(ctx
) || ctx
->Extensions
.ARB_ES3_compatibility
) {
151 this->supported_versions
[this->num_supported_versions
].ver
= 300;
152 this->supported_versions
[this->num_supported_versions
].es
= true;
153 this->num_supported_versions
++;
155 assert(this->num_supported_versions
156 <= ARRAY_SIZE(this->supported_versions
));
158 /* Create a string for use in error messages to tell the user which GLSL
159 * versions are supported.
161 char *supported
= ralloc_strdup(this, "");
162 for (unsigned i
= 0; i
< this->num_supported_versions
; i
++) {
163 unsigned ver
= this->supported_versions
[i
].ver
;
164 const char *const prefix
= (i
== 0)
166 : ((i
== this->num_supported_versions
- 1) ? ", and " : ", ");
167 const char *const suffix
= (this->supported_versions
[i
].es
) ? " ES" : "";
169 ralloc_asprintf_append(& supported
, "%s%u.%02u%s",
171 ver
/ 100, ver
% 100,
175 this->supported_version_string
= supported
;
177 if (ctx
->Const
.ForceGLSLExtensionsWarn
)
178 _mesa_glsl_process_extension("all", NULL
, "warn", NULL
, this);
180 this->default_uniform_qualifier
= new(this) ast_type_qualifier();
181 this->default_uniform_qualifier
->flags
.q
.shared
= 1;
182 this->default_uniform_qualifier
->flags
.q
.column_major
= 1;
184 this->gs_input_prim_type_specified
= false;
185 this->gs_input_prim_type
= GL_POINTS
;
186 this->gs_input_size
= 0;
187 this->out_qualifier
= new(this) ast_type_qualifier();
191 * Determine whether the current GLSL version is sufficiently high to support
192 * a certain feature, and generate an error message if it isn't.
194 * \param required_glsl_version and \c required_glsl_es_version are
195 * interpreted as they are in _mesa_glsl_parse_state::is_version().
197 * \param locp is the parser location where the error should be reported.
199 * \param fmt (and additional arguments) constitute a printf-style error
200 * message to report if the version check fails. Information about the
201 * current and required GLSL versions will be appended. So, for example, if
202 * the GLSL version being compiled is 1.20, and check_version(130, 300, locp,
203 * "foo unsupported") is called, the error message will be "foo unsupported in
204 * GLSL 1.20 (GLSL 1.30 or GLSL 3.00 ES required)".
207 _mesa_glsl_parse_state::check_version(unsigned required_glsl_version
,
208 unsigned required_glsl_es_version
,
209 YYLTYPE
*locp
, const char *fmt
, ...)
211 if (this->is_version(required_glsl_version
, required_glsl_es_version
))
216 char *problem
= ralloc_vasprintf(this, fmt
, args
);
218 const char *glsl_version_string
219 = glsl_compute_version_string(this, false, required_glsl_version
);
220 const char *glsl_es_version_string
221 = glsl_compute_version_string(this, true, required_glsl_es_version
);
222 const char *requirement_string
= "";
223 if (required_glsl_version
&& required_glsl_es_version
) {
224 requirement_string
= ralloc_asprintf(this, " (%s or %s required)",
226 glsl_es_version_string
);
227 } else if (required_glsl_version
) {
228 requirement_string
= ralloc_asprintf(this, " (%s required)",
229 glsl_version_string
);
230 } else if (required_glsl_es_version
) {
231 requirement_string
= ralloc_asprintf(this, " (%s required)",
232 glsl_es_version_string
);
234 _mesa_glsl_error(locp
, this, "%s in %s%s",
235 problem
, this->get_version_string(),
242 * Process a GLSL #version directive.
244 * \param version is the integer that follows the #version token.
246 * \param ident is a string identifier that follows the integer, if any is
247 * present. Otherwise NULL.
250 _mesa_glsl_parse_state::process_version_directive(YYLTYPE
*locp
, int version
,
253 bool es_token_present
= false;
255 if (strcmp(ident
, "es") == 0) {
256 es_token_present
= true;
257 } else if (version
>= 150) {
258 if (strcmp(ident
, "core") == 0) {
259 /* Accept the token. There's no need to record that this is
260 * a core profile shader since that's the only profile we support.
262 } else if (strcmp(ident
, "compatibility") == 0) {
263 _mesa_glsl_error(locp
, this,
264 "the compatibility profile is not supported");
266 _mesa_glsl_error(locp
, this,
267 "\"%s\" is not a valid shading language profile; "
268 "if present, it must be \"core\"", ident
);
271 _mesa_glsl_error(locp
, this,
272 "illegal text following version number");
276 this->es_shader
= es_token_present
;
277 if (version
== 100) {
278 if (es_token_present
) {
279 _mesa_glsl_error(locp
, this,
280 "GLSL 1.00 ES should be selected using "
283 this->es_shader
= true;
287 this->language_version
= version
;
289 bool supported
= false;
290 for (unsigned i
= 0; i
< this->num_supported_versions
; i
++) {
291 if (this->supported_versions
[i
].ver
== (unsigned) version
292 && this->supported_versions
[i
].es
== this->es_shader
) {
299 _mesa_glsl_error(locp
, this, "%s is not supported. "
300 "Supported versions are: %s",
301 this->get_version_string(),
302 this->supported_version_string
);
304 /* On exit, the language_version must be set to a valid value.
305 * Later calls to _mesa_glsl_initialize_types will misbehave if
306 * the version is invalid.
308 switch (this->ctx
->API
) {
309 case API_OPENGL_COMPAT
:
310 case API_OPENGL_CORE
:
311 this->language_version
= this->ctx
->Const
.GLSLVersion
;
315 assert(!"Should not get here.");
319 this->language_version
= 100;
328 * The most common use of _mesa_glsl_shader_target_name(), which is
329 * shared with C code in Mesa core to translate a GLenum to a short
330 * shader stage name in debug printouts.
332 * It recognizes the PROGRAM variants of the names so it can be used
333 * with a struct gl_program->Target, not just a struct
337 _mesa_glsl_shader_target_name(GLenum type
)
340 case GL_VERTEX_SHADER
:
341 case GL_VERTEX_PROGRAM_ARB
:
343 case GL_FRAGMENT_SHADER
:
344 case GL_FRAGMENT_PROGRAM_ARB
:
346 case GL_GEOMETRY_SHADER
:
349 assert(!"Should not get here.");
357 * Overloaded C++ variant usable within the compiler for translating
358 * our internal enum into short stage names.
361 _mesa_glsl_shader_target_name(enum _mesa_glsl_parser_targets target
)
364 case vertex_shader
: return "vertex";
365 case fragment_shader
: return "fragment";
366 case geometry_shader
: return "geometry";
369 assert(!"Should not get here.");
373 /* This helper function will append the given message to the shader's
374 info log and report it via GL_ARB_debug_output. Per that extension,
375 'type' is one of the enum values classifying the message, and
376 'id' is the implementation-defined ID of the given message. */
378 _mesa_glsl_msg(const YYLTYPE
*locp
, _mesa_glsl_parse_state
*state
,
379 GLenum type
, const char *fmt
, va_list ap
)
381 bool error
= (type
== MESA_DEBUG_TYPE_ERROR
);
384 assert(state
->info_log
!= NULL
);
386 /* Get the offset that the new message will be written to. */
387 int msg_offset
= strlen(state
->info_log
);
389 ralloc_asprintf_append(&state
->info_log
, "%u:%u(%u): %s: ",
393 error
? "error" : "warning");
394 ralloc_vasprintf_append(&state
->info_log
, fmt
, ap
);
396 const char *const msg
= &state
->info_log
[msg_offset
];
397 struct gl_context
*ctx
= state
->ctx
;
399 /* Report the error via GL_ARB_debug_output. */
400 _mesa_shader_debug(ctx
, type
, &msg_id
, msg
, strlen(msg
));
402 ralloc_strcat(&state
->info_log
, "\n");
406 _mesa_glsl_error(YYLTYPE
*locp
, _mesa_glsl_parse_state
*state
,
407 const char *fmt
, ...)
414 _mesa_glsl_msg(locp
, state
, MESA_DEBUG_TYPE_ERROR
, fmt
, ap
);
420 _mesa_glsl_warning(const YYLTYPE
*locp
, _mesa_glsl_parse_state
*state
,
421 const char *fmt
, ...)
426 _mesa_glsl_msg(locp
, state
, MESA_DEBUG_TYPE_OTHER
, fmt
, ap
);
432 * Enum representing the possible behaviors that can be specified in
433 * an #extension directive.
443 * Element type for _mesa_glsl_supported_extensions
445 struct _mesa_glsl_extension
{
447 * Name of the extension when referred to in a GLSL extension
452 /** True if this extension is available to desktop GL shaders */
455 /** True if this extension is available to GLES shaders */
459 * Flag in the gl_extensions struct indicating whether this
460 * extension is supported by the driver, or
461 * &gl_extensions::dummy_true if supported by all drivers.
463 * Note: the type (GLboolean gl_extensions::*) is a "pointer to
464 * member" type, the type-safe alternative to the "offsetof" macro.
467 * - foo bar::* p declares p to be an "offset" to a field of type
468 * foo that exists within struct bar
469 * - &bar::baz computes the "offset" of field baz within struct bar
470 * - x.*p accesses the field of x that exists at "offset" p
471 * - x->*p is equivalent to (*x).*p
473 const GLboolean
gl_extensions::* supported_flag
;
476 * Flag in the _mesa_glsl_parse_state struct that should be set
477 * when this extension is enabled.
479 * See note in _mesa_glsl_extension::supported_flag about "pointer
482 bool _mesa_glsl_parse_state::* enable_flag
;
485 * Flag in the _mesa_glsl_parse_state struct that should be set
486 * when the shader requests "warn" behavior for this extension.
488 * See note in _mesa_glsl_extension::supported_flag about "pointer
491 bool _mesa_glsl_parse_state::* warn_flag
;
494 bool compatible_with_state(const _mesa_glsl_parse_state
*state
) const;
495 void set_flags(_mesa_glsl_parse_state
*state
, ext_behavior behavior
) const;
498 #define EXT(NAME, GL, ES, SUPPORTED_FLAG) \
499 { "GL_" #NAME, GL, ES, &gl_extensions::SUPPORTED_FLAG, \
500 &_mesa_glsl_parse_state::NAME##_enable, \
501 &_mesa_glsl_parse_state::NAME##_warn }
504 * Table of extensions that can be enabled/disabled within a shader,
505 * and the conditions under which they are supported.
507 static const _mesa_glsl_extension _mesa_glsl_supported_extensions
[] = {
508 /* API availability */
509 /* name GL ES supported flag */
510 EXT(ARB_conservative_depth
, true, false, ARB_conservative_depth
),
511 EXT(ARB_draw_buffers
, true, false, dummy_true
),
512 EXT(ARB_draw_instanced
, true, false, ARB_draw_instanced
),
513 EXT(ARB_explicit_attrib_location
, true, false, ARB_explicit_attrib_location
),
514 EXT(ARB_fragment_coord_conventions
, true, false, ARB_fragment_coord_conventions
),
515 EXT(ARB_texture_rectangle
, true, false, dummy_true
),
516 EXT(EXT_texture_array
, true, false, EXT_texture_array
),
517 EXT(ARB_shader_texture_lod
, true, false, ARB_shader_texture_lod
),
518 EXT(ARB_shader_stencil_export
, true, false, ARB_shader_stencil_export
),
519 EXT(AMD_conservative_depth
, true, false, ARB_conservative_depth
),
520 EXT(AMD_shader_stencil_export
, true, false, ARB_shader_stencil_export
),
521 EXT(OES_texture_3D
, false, true, EXT_texture3D
),
522 EXT(OES_EGL_image_external
, false, true, OES_EGL_image_external
),
523 EXT(ARB_shader_bit_encoding
, true, false, ARB_shader_bit_encoding
),
524 EXT(ARB_uniform_buffer_object
, true, false, ARB_uniform_buffer_object
),
525 EXT(OES_standard_derivatives
, false, true, OES_standard_derivatives
),
526 EXT(ARB_texture_cube_map_array
, true, false, ARB_texture_cube_map_array
),
527 EXT(ARB_shading_language_packing
, true, false, ARB_shading_language_packing
),
528 EXT(ARB_shading_language_420pack
, true, false, ARB_shading_language_420pack
),
529 EXT(ARB_texture_multisample
, true, false, ARB_texture_multisample
),
530 EXT(ARB_texture_query_levels
, true, false, ARB_texture_query_levels
),
531 EXT(ARB_texture_query_lod
, true, false, ARB_texture_query_lod
),
532 EXT(ARB_gpu_shader5
, true, false, ARB_gpu_shader5
),
533 EXT(AMD_vertex_shader_layer
, true, false, AMD_vertex_shader_layer
),
534 EXT(EXT_shader_integer_mix
, true, true, EXT_shader_integer_mix
),
535 EXT(ARB_texture_gather
, true, false, ARB_texture_gather
),
536 EXT(ARB_shader_atomic_counters
, true, false, ARB_shader_atomic_counters
),
543 * Determine whether a given extension is compatible with the target,
544 * API, and extension information in the current parser state.
546 bool _mesa_glsl_extension::compatible_with_state(const _mesa_glsl_parse_state
*
549 /* Check that this extension matches whether we are compiling
550 * for desktop GL or GLES.
552 if (state
->es_shader
) {
553 if (!this->avail_in_ES
) return false;
555 if (!this->avail_in_GL
) return false;
558 /* Check that this extension is supported by the OpenGL
561 * Note: the ->* operator indexes into state->extensions by the
562 * offset this->supported_flag. See
563 * _mesa_glsl_extension::supported_flag for more info.
565 return state
->extensions
->*(this->supported_flag
);
569 * Set the appropriate flags in the parser state to establish the
570 * given behavior for this extension.
572 void _mesa_glsl_extension::set_flags(_mesa_glsl_parse_state
*state
,
573 ext_behavior behavior
) const
575 /* Note: the ->* operator indexes into state by the
576 * offsets this->enable_flag and this->warn_flag. See
577 * _mesa_glsl_extension::supported_flag for more info.
579 state
->*(this->enable_flag
) = (behavior
!= extension_disable
);
580 state
->*(this->warn_flag
) = (behavior
== extension_warn
);
584 * Find an extension by name in _mesa_glsl_supported_extensions. If
585 * the name is not found, return NULL.
587 static const _mesa_glsl_extension
*find_extension(const char *name
)
589 for (unsigned i
= 0; i
< Elements(_mesa_glsl_supported_extensions
); ++i
) {
590 if (strcmp(name
, _mesa_glsl_supported_extensions
[i
].name
) == 0) {
591 return &_mesa_glsl_supported_extensions
[i
];
599 _mesa_glsl_process_extension(const char *name
, YYLTYPE
*name_locp
,
600 const char *behavior_string
, YYLTYPE
*behavior_locp
,
601 _mesa_glsl_parse_state
*state
)
603 ext_behavior behavior
;
604 if (strcmp(behavior_string
, "warn") == 0) {
605 behavior
= extension_warn
;
606 } else if (strcmp(behavior_string
, "require") == 0) {
607 behavior
= extension_require
;
608 } else if (strcmp(behavior_string
, "enable") == 0) {
609 behavior
= extension_enable
;
610 } else if (strcmp(behavior_string
, "disable") == 0) {
611 behavior
= extension_disable
;
613 _mesa_glsl_error(behavior_locp
, state
,
614 "unknown extension behavior `%s'",
619 if (strcmp(name
, "all") == 0) {
620 if ((behavior
== extension_enable
) || (behavior
== extension_require
)) {
621 _mesa_glsl_error(name_locp
, state
, "cannot %s all extensions",
622 (behavior
== extension_enable
)
623 ? "enable" : "require");
627 i
< Elements(_mesa_glsl_supported_extensions
); ++i
) {
628 const _mesa_glsl_extension
*extension
629 = &_mesa_glsl_supported_extensions
[i
];
630 if (extension
->compatible_with_state(state
)) {
631 _mesa_glsl_supported_extensions
[i
].set_flags(state
, behavior
);
636 const _mesa_glsl_extension
*extension
= find_extension(name
);
637 if (extension
&& extension
->compatible_with_state(state
)) {
638 extension
->set_flags(state
, behavior
);
640 static const char *const fmt
= "extension `%s' unsupported in %s shader";
642 if (behavior
== extension_require
) {
643 _mesa_glsl_error(name_locp
, state
, fmt
,
644 name
, _mesa_glsl_shader_target_name(state
->target
));
647 _mesa_glsl_warning(name_locp
, state
, fmt
,
648 name
, _mesa_glsl_shader_target_name(state
->target
));
658 * Returns the name of the type of a column of a matrix. E.g.,
664 _mesa_ast_get_matrix_column_type_name(const char *matrix_type_name
)
666 static const char *vec_name
[] = { "vec2", "vec3", "vec4" };
668 /* The number of elements in a row of a matrix is specified by the last
669 * character of the matrix type name.
671 long rows
= strtol(matrix_type_name
+ strlen(matrix_type_name
) - 1,
673 return vec_name
[rows
- 2];
677 * Recurses through <type> and <expr> if <expr> is an aggregate initializer
678 * and sets <expr>'s <constructor_type> field to <type>. Gives later functions
679 * (process_array_constructor, et al) sufficient information to do type
682 * Operates on assignments involving an aggregate initializer. E.g.,
684 * vec4 pos = {1.0, -1.0, 0.0, 1.0};
686 * or more ridiculously,
699 * {1.0, 2.0, 3.0, 4.0}, // a[0].v[0]
700 * {5.0, 6.0, 7.0, 8.0} // a[0].v[1]
705 * {1.0, 2.0, 3.0, 4.0}, // a[1].v[0]
706 * {5.0, 6.0, 7.0, 8.0} // a[1].v[1]
712 * {1.0, 2.0, 3.0, 4.0}, // b.v[0]
713 * {5.0, 6.0, 7.0, 8.0} // b.v[1]
719 * This pass is necessary because the right-hand side of <type> e = { ... }
720 * doesn't contain sufficient information to determine if the types match.
723 _mesa_ast_set_aggregate_type(const ast_type_specifier
*type
,
724 ast_expression
*expr
,
725 _mesa_glsl_parse_state
*state
)
728 ast_aggregate_initializer
*ai
= (ast_aggregate_initializer
*)expr
;
729 ai
->constructor_type
= (ast_type_specifier
*)type
;
731 bool is_declaration
= ai
->constructor_type
->structure
!= NULL
;
732 if (!is_declaration
) {
733 /* Look up <type> name in the symbol table to see if it's a struct. */
734 const ast_type_specifier
*struct_type
=
735 state
->symbols
->get_type_ast(type
->type_name
);
736 ai
->constructor_type
->structure
=
737 struct_type
? new(ctx
) ast_struct_specifier(*struct_type
->structure
)
741 /* If the aggregate is an array, recursively set its elements' types. */
742 if (type
->is_array
) {
743 /* We want to set the element type which is not an array itself, so make
744 * a copy of the array type and set its is_array field to false.
746 * E.g., if <type> if struct S[2] we want to set each element's type to
749 * FINISHME: Update when ARB_array_of_arrays is supported.
751 const ast_type_specifier
*non_array_type
=
752 new(ctx
) ast_type_specifier(type
, false, NULL
);
754 for (exec_node
*expr_node
= ai
->expressions
.head
;
755 !expr_node
->is_tail_sentinel();
756 expr_node
= expr_node
->next
) {
757 ast_expression
*expr
= exec_node_data(ast_expression
, expr_node
,
760 if (expr
->oper
== ast_aggregate
)
761 _mesa_ast_set_aggregate_type(non_array_type
, expr
, state
);
764 /* If the aggregate is a struct, recursively set its fields' types. */
765 } else if (ai
->constructor_type
->structure
) {
766 ai
->constructor_type
->structure
->is_declaration
= is_declaration
;
767 exec_node
*expr_node
= ai
->expressions
.head
;
769 /* Iterate through the struct's fields' declarations. E.g., iterate from
770 * "float a, b" to "int c" in the struct below.
777 for (exec_node
*decl_list_node
=
778 ai
->constructor_type
->structure
->declarations
.head
;
779 !decl_list_node
->is_tail_sentinel();
780 decl_list_node
= decl_list_node
->next
) {
781 ast_declarator_list
*decl_list
= exec_node_data(ast_declarator_list
,
782 decl_list_node
, link
);
784 for (exec_node
*decl_node
= decl_list
->declarations
.head
;
785 !decl_node
->is_tail_sentinel() && !expr_node
->is_tail_sentinel();
786 decl_node
= decl_node
->next
, expr_node
= expr_node
->next
) {
787 ast_declaration
*decl
= exec_node_data(ast_declaration
, decl_node
,
789 ast_expression
*expr
= exec_node_data(ast_expression
, expr_node
,
792 bool is_array
= decl_list
->type
->specifier
->is_array
;
793 ast_expression
*array_size
= decl_list
->type
->specifier
->array_size
;
795 /* Recognize variable declarations with the bracketed size attached
796 * to the type rather than the variable name as arrays. E.g.,
801 * are both arrays, but <a>'s array_size is decl->array_size, while
802 * <b>'s array_size is decl_list->type->specifier->array_size.
805 /* FINISHME: Update when ARB_array_of_arrays is supported. */
806 is_array
= decl
->is_array
;
807 array_size
= decl
->array_size
;
810 /* Declaration shadows the <type> parameter. */
811 ast_type_specifier
*type
=
812 new(ctx
) ast_type_specifier(decl_list
->type
->specifier
,
813 is_array
, array_size
);
815 if (expr
->oper
== ast_aggregate
)
816 _mesa_ast_set_aggregate_type(type
, expr
, state
);
820 /* If the aggregate is a matrix, set its columns' types. */
822 const glsl_type
*const constructor_type
=
823 ai
->constructor_type
->glsl_type(&name
, state
);
825 if (constructor_type
->is_matrix()) {
826 for (exec_node
*expr_node
= ai
->expressions
.head
;
827 !expr_node
->is_tail_sentinel();
828 expr_node
= expr_node
->next
) {
829 ast_expression
*expr
= exec_node_data(ast_expression
, expr_node
,
832 /* Declaration shadows the <type> parameter. */
833 ast_type_specifier
*type
= new(ctx
)
834 ast_type_specifier(_mesa_ast_get_matrix_column_type_name(name
));
836 if (expr
->oper
== ast_aggregate
)
837 _mesa_ast_set_aggregate_type(type
, expr
, state
);
845 _mesa_ast_type_qualifier_print(const struct ast_type_qualifier
*q
)
847 if (q
->flags
.q
.constant
)
850 if (q
->flags
.q
.invariant
)
851 printf("invariant ");
853 if (q
->flags
.q
.attribute
)
854 printf("attribute ");
856 if (q
->flags
.q
.varying
)
859 if (q
->flags
.q
.in
&& q
->flags
.q
.out
)
869 if (q
->flags
.q
.centroid
)
871 if (q
->flags
.q
.uniform
)
873 if (q
->flags
.q
.smooth
)
877 if (q
->flags
.q
.noperspective
)
878 printf("noperspective ");
883 ast_node::print(void) const
885 printf("unhandled node ");
889 ast_node::ast_node(void)
891 this->location
.source
= 0;
892 this->location
.line
= 0;
893 this->location
.column
= 0;
898 ast_opt_array_size_print(bool is_array
, const ast_expression
*array_size
)
912 ast_compound_statement::print(void) const
916 foreach_list_const(n
, &this->statements
) {
917 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
925 ast_compound_statement::ast_compound_statement(int new_scope
,
926 ast_node
*statements
)
928 this->new_scope
= new_scope
;
930 if (statements
!= NULL
) {
931 this->statements
.push_degenerate_list_at_head(&statements
->link
);
937 ast_expression::print(void) const
951 subexpressions
[0]->print();
952 printf("%s ", operator_string(oper
));
953 subexpressions
[1]->print();
956 case ast_field_selection
:
957 subexpressions
[0]->print();
958 printf(". %s ", primary_expression
.identifier
);
967 printf("%s ", operator_string(oper
));
968 subexpressions
[0]->print();
973 subexpressions
[0]->print();
974 printf("%s ", operator_string(oper
));
977 case ast_conditional
:
978 subexpressions
[0]->print();
980 subexpressions
[1]->print();
982 subexpressions
[2]->print();
985 case ast_array_index
:
986 subexpressions
[0]->print();
988 subexpressions
[1]->print();
992 case ast_function_call
: {
993 subexpressions
[0]->print();
996 foreach_list_const (n
, &this->expressions
) {
997 if (n
!= this->expressions
.get_head())
1000 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1008 case ast_identifier
:
1009 printf("%s ", primary_expression
.identifier
);
1012 case ast_int_constant
:
1013 printf("%d ", primary_expression
.int_constant
);
1016 case ast_uint_constant
:
1017 printf("%u ", primary_expression
.uint_constant
);
1020 case ast_float_constant
:
1021 printf("%f ", primary_expression
.float_constant
);
1024 case ast_bool_constant
:
1026 primary_expression
.bool_constant
1027 ? "true" : "false");
1030 case ast_sequence
: {
1032 foreach_list_const(n
, & this->expressions
) {
1033 if (n
!= this->expressions
.get_head())
1036 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1043 case ast_aggregate
: {
1045 foreach_list_const(n
, & this->expressions
) {
1046 if (n
!= this->expressions
.get_head())
1049 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1062 ast_expression::ast_expression(int oper
,
1063 ast_expression
*ex0
,
1064 ast_expression
*ex1
,
1065 ast_expression
*ex2
) :
1066 primary_expression()
1068 this->oper
= ast_operators(oper
);
1069 this->subexpressions
[0] = ex0
;
1070 this->subexpressions
[1] = ex1
;
1071 this->subexpressions
[2] = ex2
;
1072 this->non_lvalue_description
= NULL
;
1077 ast_expression_statement::print(void) const
1080 expression
->print();
1086 ast_expression_statement::ast_expression_statement(ast_expression
*ex
) :
1094 ast_function::print(void) const
1096 return_type
->print();
1097 printf(" %s (", identifier
);
1099 foreach_list_const(n
, & this->parameters
) {
1100 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1108 ast_function::ast_function(void)
1109 : return_type(NULL
), identifier(NULL
), is_definition(false),
1117 ast_fully_specified_type::print(void) const
1119 _mesa_ast_type_qualifier_print(& qualifier
);
1125 ast_parameter_declarator::print(void) const
1129 printf("%s ", identifier
);
1130 ast_opt_array_size_print(is_array
, array_size
);
1135 ast_function_definition::print(void) const
1143 ast_declaration::print(void) const
1145 printf("%s ", identifier
);
1146 ast_opt_array_size_print(is_array
, array_size
);
1150 initializer
->print();
1155 ast_declaration::ast_declaration(const char *identifier
, bool is_array
,
1156 ast_expression
*array_size
,
1157 ast_expression
*initializer
)
1159 this->identifier
= identifier
;
1160 this->is_array
= is_array
;
1161 this->array_size
= array_size
;
1162 this->initializer
= initializer
;
1167 ast_declarator_list::print(void) const
1169 assert(type
|| invariant
);
1174 printf("invariant ");
1176 foreach_list_const (ptr
, & this->declarations
) {
1177 if (ptr
!= this->declarations
.get_head())
1180 ast_node
*ast
= exec_node_data(ast_node
, ptr
, link
);
1188 ast_declarator_list::ast_declarator_list(ast_fully_specified_type
*type
)
1191 this->invariant
= false;
1195 ast_jump_statement::print(void) const
1199 printf("continue; ");
1206 if (opt_return_value
)
1207 opt_return_value
->print();
1212 printf("discard; ");
1218 ast_jump_statement::ast_jump_statement(int mode
, ast_expression
*return_value
)
1219 : opt_return_value(NULL
)
1221 this->mode
= ast_jump_modes(mode
);
1223 if (mode
== ast_return
)
1224 opt_return_value
= return_value
;
1229 ast_selection_statement::print(void) const
1235 then_statement
->print();
1237 if (else_statement
) {
1239 else_statement
->print();
1245 ast_selection_statement::ast_selection_statement(ast_expression
*condition
,
1246 ast_node
*then_statement
,
1247 ast_node
*else_statement
)
1249 this->condition
= condition
;
1250 this->then_statement
= then_statement
;
1251 this->else_statement
= else_statement
;
1256 ast_switch_statement::print(void) const
1258 printf("switch ( ");
1259 test_expression
->print();
1266 ast_switch_statement::ast_switch_statement(ast_expression
*test_expression
,
1269 this->test_expression
= test_expression
;
1275 ast_switch_body::print(void) const
1278 if (stmts
!= NULL
) {
1285 ast_switch_body::ast_switch_body(ast_case_statement_list
*stmts
)
1287 this->stmts
= stmts
;
1291 void ast_case_label::print(void) const
1293 if (test_value
!= NULL
) {
1295 test_value
->print();
1298 printf("default: ");
1303 ast_case_label::ast_case_label(ast_expression
*test_value
)
1305 this->test_value
= test_value
;
1309 void ast_case_label_list::print(void) const
1311 foreach_list_const(n
, & this->labels
) {
1312 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1319 ast_case_label_list::ast_case_label_list(void)
1324 void ast_case_statement::print(void) const
1327 foreach_list_const(n
, & this->stmts
) {
1328 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1335 ast_case_statement::ast_case_statement(ast_case_label_list
*labels
)
1337 this->labels
= labels
;
1341 void ast_case_statement_list::print(void) const
1343 foreach_list_const(n
, & this->cases
) {
1344 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1350 ast_case_statement_list::ast_case_statement_list(void)
1356 ast_iteration_statement::print(void) const
1362 init_statement
->print();
1369 if (rest_expression
)
1370 rest_expression
->print();
1396 ast_iteration_statement::ast_iteration_statement(int mode
,
1398 ast_node
*condition
,
1399 ast_expression
*rest_expression
,
1402 this->mode
= ast_iteration_modes(mode
);
1403 this->init_statement
= init
;
1404 this->condition
= condition
;
1405 this->rest_expression
= rest_expression
;
1411 ast_struct_specifier::print(void) const
1413 printf("struct %s { ", name
);
1414 foreach_list_const(n
, &this->declarations
) {
1415 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1422 ast_struct_specifier::ast_struct_specifier(const char *identifier
,
1423 ast_declarator_list
*declarator_list
)
1425 if (identifier
== NULL
) {
1426 static unsigned anon_count
= 1;
1427 identifier
= ralloc_asprintf(this, "#anon_struct_%04x", anon_count
);
1431 this->declarations
.push_degenerate_list_at_head(&declarator_list
->link
);
1432 is_declaration
= true;
1436 set_shader_inout_layout(struct gl_shader
*shader
,
1437 struct _mesa_glsl_parse_state
*state
)
1439 if (shader
->Type
!= GL_GEOMETRY_SHADER
) {
1440 /* Should have been prevented by the parser. */
1441 assert(!state
->gs_input_prim_type_specified
);
1442 assert(!state
->out_qualifier
->flags
.i
);
1446 shader
->Geom
.VerticesOut
= 0;
1447 if (state
->out_qualifier
->flags
.q
.max_vertices
)
1448 shader
->Geom
.VerticesOut
= state
->out_qualifier
->max_vertices
;
1450 if (state
->gs_input_prim_type_specified
) {
1451 shader
->Geom
.InputType
= state
->gs_input_prim_type
;
1453 shader
->Geom
.InputType
= PRIM_UNKNOWN
;
1456 if (state
->out_qualifier
->flags
.q
.prim_type
) {
1457 shader
->Geom
.OutputType
= state
->out_qualifier
->prim_type
;
1459 shader
->Geom
.OutputType
= PRIM_UNKNOWN
;
1466 _mesa_glsl_compile_shader(struct gl_context
*ctx
, struct gl_shader
*shader
,
1467 bool dump_ast
, bool dump_hir
)
1469 struct _mesa_glsl_parse_state
*state
=
1470 new(shader
) _mesa_glsl_parse_state(ctx
, shader
->Type
, shader
);
1471 const char *source
= shader
->Source
;
1473 state
->error
= glcpp_preprocess(state
, &source
, &state
->info_log
,
1474 &ctx
->Extensions
, ctx
);
1476 if (!state
->error
) {
1477 _mesa_glsl_lexer_ctor(state
, source
);
1478 _mesa_glsl_parse(state
);
1479 _mesa_glsl_lexer_dtor(state
);
1483 foreach_list_const(n
, &state
->translation_unit
) {
1484 ast_node
*ast
= exec_node_data(ast_node
, n
, link
);
1490 ralloc_free(shader
->ir
);
1491 shader
->ir
= new(shader
) exec_list
;
1492 if (!state
->error
&& !state
->translation_unit
.is_empty())
1493 _mesa_ast_to_hir(shader
->ir
, state
);
1495 if (!state
->error
) {
1496 validate_ir_tree(shader
->ir
);
1498 /* Print out the unoptimized IR. */
1500 _mesa_print_ir(shader
->ir
, state
);
1505 if (!state
->error
&& !shader
->ir
->is_empty()) {
1506 struct gl_shader_compiler_options
*options
=
1507 &ctx
->ShaderCompilerOptions
[_mesa_shader_type_to_index(shader
->Type
)];
1509 /* Do some optimization at compile time to reduce shader IR size
1510 * and reduce later work if the same shader is linked multiple times
1512 while (do_common_optimization(shader
->ir
, false, false, 32, options
))
1515 validate_ir_tree(shader
->ir
);
1518 if (shader
->InfoLog
)
1519 ralloc_free(shader
->InfoLog
);
1521 shader
->symbols
= state
->symbols
;
1522 shader
->CompileStatus
= !state
->error
;
1523 shader
->InfoLog
= state
->info_log
;
1524 shader
->Version
= state
->language_version
;
1525 shader
->InfoLog
= state
->info_log
;
1526 shader
->IsES
= state
->es_shader
;
1528 memcpy(shader
->builtins_to_link
, state
->builtins_to_link
,
1529 sizeof(shader
->builtins_to_link
[0]) * state
->num_builtins_to_link
);
1530 shader
->num_builtins_to_link
= state
->num_builtins_to_link
;
1532 if (shader
->UniformBlocks
)
1533 ralloc_free(shader
->UniformBlocks
);
1534 shader
->NumUniformBlocks
= state
->num_uniform_blocks
;
1535 shader
->UniformBlocks
= state
->uniform_blocks
;
1536 ralloc_steal(shader
, shader
->UniformBlocks
);
1539 set_shader_inout_layout(shader
, state
);
1541 /* Retain any live IR, but trash the rest. */
1542 reparent_ir(shader
->ir
, shader
->ir
);
1549 * Do the set of common optimizations passes
1551 * \param ir List of instructions to be optimized
1552 * \param linked Is the shader linked? This enables
1553 * optimizations passes that remove code at
1554 * global scope and could cause linking to
1556 * \param uniform_locations_assigned Have locations already been assigned for
1557 * uniforms? This prevents the declarations
1558 * of unused uniforms from being removed.
1559 * The setting of this flag only matters if
1560 * \c linked is \c true.
1561 * \param max_unroll_iterations Maximum number of loop iterations to be
1562 * unrolled. Setting to 0 disables loop
1564 * \param options The driver's preferred shader options.
1567 do_common_optimization(exec_list
*ir
, bool linked
,
1568 bool uniform_locations_assigned
,
1569 unsigned max_unroll_iterations
,
1570 const struct gl_shader_compiler_options
*options
)
1572 GLboolean progress
= GL_FALSE
;
1574 progress
= lower_instructions(ir
, SUB_TO_ADD_NEG
) || progress
;
1577 progress
= do_function_inlining(ir
) || progress
;
1578 progress
= do_dead_functions(ir
) || progress
;
1579 progress
= do_structure_splitting(ir
) || progress
;
1581 progress
= do_if_simplification(ir
) || progress
;
1582 progress
= opt_flatten_nested_if_blocks(ir
) || progress
;
1583 progress
= do_copy_propagation(ir
) || progress
;
1584 progress
= do_copy_propagation_elements(ir
) || progress
;
1586 if (options
->PreferDP4
&& !linked
)
1587 progress
= opt_flip_matrices(ir
) || progress
;
1590 progress
= do_dead_code(ir
, uniform_locations_assigned
) || progress
;
1592 progress
= do_dead_code_unlinked(ir
) || progress
;
1593 progress
= do_dead_code_local(ir
) || progress
;
1594 progress
= do_tree_grafting(ir
) || progress
;
1595 progress
= do_constant_propagation(ir
) || progress
;
1597 progress
= do_constant_variable(ir
) || progress
;
1599 progress
= do_constant_variable_unlinked(ir
) || progress
;
1600 progress
= do_constant_folding(ir
) || progress
;
1601 progress
= do_algebraic(ir
) || progress
;
1602 progress
= do_lower_jumps(ir
) || progress
;
1603 progress
= do_vec_index_to_swizzle(ir
) || progress
;
1604 progress
= lower_vector_insert(ir
, false) || progress
;
1605 progress
= do_swizzle_swizzle(ir
) || progress
;
1606 progress
= do_noop_swizzle(ir
) || progress
;
1608 progress
= optimize_split_arrays(ir
, linked
) || progress
;
1609 progress
= optimize_redundant_jumps(ir
) || progress
;
1611 loop_state
*ls
= analyze_loop_variables(ir
);
1612 if (ls
->loop_found
) {
1613 progress
= set_loop_controls(ir
, ls
) || progress
;
1614 progress
= unroll_loops(ir
, ls
, max_unroll_iterations
) || progress
;
1624 * To be called at GL teardown time, this frees compiler datastructures.
1626 * After calling this, any previously compiled shaders and shader
1627 * programs would be invalid. So this should happen at approximately
1631 _mesa_destroy_shader_compiler(void)
1633 _mesa_destroy_shader_compiler_caches();
1635 _mesa_glsl_release_types();
1639 * Releases compiler caches to trade off performance for memory.
1641 * Intended to be used with glReleaseShaderCompiler().
1644 _mesa_destroy_shader_compiler_caches(void)
1646 _mesa_glsl_release_builtin_functions();