3 #include <msp/strings/format.h>
6 #include "programbuilder.h"
8 #include "vertexformat.h"
18 l_* Lighting component
22 tbn_* Tangent-Binormal-Normal space
24 env_* Environment space
25 *_dir Direction vector
27 zzz_* Wildcard space, resolved by the builder
28 All wildcard spaces within an expression must match
30 xxx_yyy_* Matrix that transforms between yyy to xxx
31 The vector is on the side of its designated space, result will be
33 *_matrix A matrix (duh)
34 *_rmatrix A mat4 that works with a row vector
36 rgb_* Color with rgb components only
37 color_* Color with rgba components
40 /* The array are stored in reverse order, so that variables always come after
41 anything that might need them. */
42 const ProgramBuilder::VariableDefinition ProgramBuilder::standard_variables[] =
44 { FRAGMENT, "gl_FragColor", "vec4", "frag_color", "g" },
45 { FRAGMENT, "frag_color", "vec4", "color_base", "!t" },
46 { FRAGMENT, "frag_color", "vec4", "tex_sample", "!l!s!mt" },
47 { FRAGMENT, "frag_color", "vec4", "tex_sample*color_base", "l|s|mt" },
48 { FRAGMENT, "color_base", "vec4", "vec4(1.0)", "!l!s!m" },
49 { FRAGMENT, "color_base", "vec4", "color", "!l!sm" },
50 { FRAGMENT, "color_base", "vec4", "vec4(vec3(l_shadow), 1.0)", "!ls!m" },
51 { FRAGMENT, "color_base", "vec4", "color*vec4(vec3(l_shadow), 1.0)", "!lsm" },
52 { FRAGMENT, "color_base", "vec4", "vec4(rgb_light_env, 1.0)", "l!m" },
53 { FRAGMENT, "color_base", "vec4", "vec4(rgb_light_env, material.diffuse.a)", "lm" },
54 { FRAGMENT, "rgb_light_env", "vec3", "rgb_light_full+reflect_sample.rgb*reflectivity", "e" },
55 { FRAGMENT, "rgb_light_env", "vec3", "rgb_light_full", "!e" },
56 { FRAGMENT, "rgb_light_full", "vec3", "rgb_light_shadow+ambient_product_diffuse.rgb", "m" },
57 { FRAGMENT, "rgb_light_full", "vec3", "rgb_light_shadow", "!m" },
58 { FRAGMENT, "ambient_product_diffuse", "vec4", "gl_FrontLightModelProduct.sceneColor", "g" },
59 { FRAGMENT, "ambient_product_diffuse", "vec4", "ambient_color*material.diffuse", "!g" },
60 { FRAGMENT, "rgb_light_shadow", "vec3", "rgb_light*l_shadow", "s" },
61 { FRAGMENT, "rgb_light_shadow", "vec3", "rgb_light", "!s" },
62 { FRAGMENT, "rgb_light", "vec3", "vec3(l_diffuse)", "!m!p" },
63 { FRAGMENT, "rgb_light", "vec3", "vec3(l_diffuse+l_specular)", "!mp" },
64 { FRAGMENT, "rgb_light", "vec3", "l_diffuse*light_product_diffuse.rgb", "m!p" },
65 { FRAGMENT, "rgb_light", "vec3", "l_diffuse*light_product_diffuse.rgb+l_specular*light_product_specular.rgb", "mp" },
66 { FRAGMENT, "light_product_diffuse", "vec4", "gl_FrontLightProduct[0].diffuse", "g" },
67 { FRAGMENT, "light_product_diffuse", "vec4", "light_sources[0].diffuse*material.diffuse", "!g" },
68 { FRAGMENT, "light_product_specular", "vec4", "gl_FrontLightProduct[0].specular", "g" },
69 { FRAGMENT, "light_product_specular", "vec4", "light_sources[0].specular*material.specular", "!g" },
70 { FRAGMENT, "reflect_sample", "vec4", "textureCube(environment, env_reflect_dir)", 0 },
71 { FRAGMENT, "env_reflect_dir", "vec3", "env_eye_matrix*eye_reflect_dir", 0 },
72 { FRAGMENT, "eye_reflect_dir", "vec3", "eye_tbn_matrix*tbn_reflect_dir", "n" },
73 { FRAGMENT, "zzz_reflect_dir", "vec3", "reflect(zzz_incident_dir, n_zzz_normal)", 0 },
74 { FRAGMENT, "l_shadow", "float", "mix(1.0, shadow_sample, shadow_darkness)", 0 },
75 { FRAGMENT, "shadow_sample", "float", "shadow2D(shadow, shd_vertex).r", 0 },
76 { FRAGMENT, "l_diffuse", "float", "max(dot(n_zzz_normal, n_zzz_light_dir), 0.0)", 0 },
77 { FRAGMENT, "l_specular", "float", "pow(max(dot(n_zzz_half_vec, n_zzz_normal), 0.0), material.shininess)", 0 },
78 { FRAGMENT, "n_zzz_half_vec", "vec3", "normalize(zzz_light_dir-zzz_incident_dir)", 0 },
79 { FRAGMENT, "n_zzz_light_dir", "vec3", "normalize(zzz_light_dir)", 0 },
80 { FRAGMENT, "n_tbn_normal", "vec3", "normal_sample*2.0-1.0", "n" },
81 { FRAGMENT, "n_eye_normal", "vec3", "normalize(eye_normal)", "!n" },
82 { FRAGMENT, "normal_sample", "vec3", "texture2D(normalmap, texture_coord).xyz", 0 },
83 { FRAGMENT, "tex_sample", "vec4", "texture2D(texture, texture_coord)", 0 },
85 { VERTEX, "gl_Position", "vec4", "projection_matrix*eye_vertex", 0 },
86 { VERTEX, "shd_vertex", "vec3", "vec3(dot(eye_vertex, gl_EyePlaneS[shadow_unit]), dot(eye_vertex, gl_EyePlaneT[shadow_unit]), dot(eye_vertex, gl_EyePlaneR[shadow_unit]))", "g" },
87 { VERTEX, "shd_vertex", "vec3", "(shd_eye_matrix*eye_vertex).xyz", "!g" },
88 { VERTEX, "tbn_light_dir", "vec3", "eye_light_dir*eye_tbn_matrix", 0 },
89 { VERTEX, "eye_light_dir", "vec3", "normalize(eye_light_position.xyz-eye_vertex.xyz*eye_light_position.w)", 0 },
90 { VERTEX, "eye_light_position", "vec4", "light_sources[0].position", 0 },
91 { VERTEX, "tbn_incident_dir", "vec3", "eye_incident_dir*eye_tbn_matrix", 0 },
92 { VERTEX, "eye_incident_dir", "vec3", "normalize(eye_vertex.xyz)", 0 },
93 { VERTEX, "eye_tbn_matrix", "mat3", "mat3(eye_tangent, eye_binormal, eye_normal)", 0 },
94 { VERTEX, "eye_vertex", "vec4", "eye_obj_matrix*vertex", 0 },
95 { VERTEX, "eye_normal", "vec3", "eye_obj_normal_matrix*normal", 0 },
96 { VERTEX, "eye_tangent", "vec3", "eye_obj_normal_matrix*tangent", 0 },
97 { VERTEX, "eye_binormal", "vec3", "eye_obj_normal_matrix*binormal", 0 },
98 { VERTEX, "texture_coord", "vec2", "texcoord.xy", 0 },
100 { ATTRIBUTE, "vertex", "vec4", "gl_Vertex", 0 },
101 { ATTRIBUTE, "texcoord", "vec4", "gl_MultiTexCoord0", 0 },
102 { ATTRIBUTE, "color", "vec4", "gl_Color", 0 },
103 { ATTRIBUTE, "normal", "vec3", "gl_Normal", 0 },
104 { ATTRIBUTE, "tangent", "vec3", 0, 0 },
105 { ATTRIBUTE, "binormal", "vec3", 0, 0 },
107 { UNIFORM, "shadow_unit", "int", 0, 0 },
108 { UNIFORM, "texture", "sampler2D", 0, 0 },
109 { UNIFORM, "shadow", "sampler2DShadow", 0, 0 },
110 { UNIFORM, "shadow_darkness", "float", 0, 0 },
111 { UNIFORM, "normalmap", "sampler2D", 0, 0 },
112 { UNIFORM, "environment", "samplerCube", 0, 0 },
113 { UNIFORM, "env_eye_matrix", "mat3", 0, 0 },
114 { UNIFORM, "reflectivity", "float", 0, 0 },
115 { UNIFORM, "eye_obj_matrix", "mat4", "gl_ModelViewMatrix", 0 },
116 { UNIFORM, "eye_obj_normal_matrix", "mat3", "gl_NormalMatrix", 0 },
117 { UNIFORM, "projection_matrix", "mat4", "gl_ProjectionMatrix", 0 },
118 { UNIFORM, "shd_eye_matrix", "mat4", 0, 0 },
119 { UNIFORM, "light_sources", "struct { vec4 position; vec4 diffuse; vec4 specular; } %s[2]", "gl_LightSource", 0 },
120 { UNIFORM, "ambient_color", "vec4", 0, 0 },
121 { UNIFORM, "material", "struct { vec4 ambient; vec4 diffuse; vec4 specular; float shininess; }", "gl_FrontMaterial", 0 },
124 { NO_SCOPE, 0, 0, 0, 0 }
127 ProgramBuilder::ProgramBuilder(const StandardFeatures &f):
129 feature_flags(features.create_flags()),
132 if(!features.custom.empty())
134 const char *whitespace = " \t\n";
135 string::size_type start = 0;
138 start = features.custom.find_first_not_of(whitespace, start);
139 if(start==string::npos)
142 string::size_type semicolon = features.custom.find(';', start);
148 else if(semicolon==string::npos)
149 throw invalid_variable_definition(features.custom.substr(start));
151 string::size_type equals = features.custom.find('=', start);
153 equals = string::npos;
155 VariableDefinition var;
156 string::size_type decl_end = min(equals, semicolon);
157 for(unsigned i=0;; ++i)
159 string::size_type word_end = features.custom.find_first_of(whitespace, start);
160 word_end = min(word_end, decl_end);
161 features.custom[word_end] = 0;
163 const char *word = &features.custom[start];
166 if(!strcmp(word, "uniform"))
168 else if(!strcmp(word, "attribute"))
169 var.scope = ATTRIBUTE;
170 else if(!strcmp(word, "vertex"))
172 else if(!strcmp(word, "fragment"))
173 var.scope = FRAGMENT;
175 throw invalid_variable_definition(word);
182 start = features.custom.find_first_not_of(whitespace, word_end+1);
187 if(equals!=string::npos)
189 start = features.custom.find_first_not_of(whitespace, equals+1);
191 throw invalid_variable_definition("no expression");
192 features.custom[semicolon] = 0;
193 var.expression = &features.custom[start];
199 for(const VariableDefinition *j=standard_variables; j->name; ++j)
200 if(!strcmp(var.name, j->name))
203 custom_variables.push_front(var);
210 void ProgramBuilder::set_optimize(bool o)
215 Program *ProgramBuilder::create_program() const
217 Program *prog = new Program;
222 void ProgramBuilder::add_shaders(Program &prog) const
224 list<ShaderVariable> variables;
225 list<ShaderVariable *> resolved_vars;
227 variables.push_front(ShaderVariable("gl_Position"));
228 variables.push_front(ShaderVariable(features.legacy ? "gl_FragColor" : "frag_color"));
230 list<VariableDefinition>::const_iterator next_custom = custom_variables.begin();
231 for(const VariableDefinition *i=standard_variables; i->name; )
233 const VariableDefinition *def = 0;
234 if(next_custom!=custom_variables.end() && (!strcmp(next_custom->name, i->name) || !next_custom->flags))
244 // Skip over anything that isn't used with the supplied flags
245 if(def->flags && !evaluate_flags(def->flags))
249 // See if this variable can satisfy any unresolved variables
250 ShaderVariable *last_resolved = 0;
251 for(list<ShaderVariable>::iterator j=variables.begin(); j!=variables.end(); ++j)
256 if(!name_match(def->name, j->resolved_name.c_str()))
261 /* We've already resolved a non-fuzzy variable in this iteration.
262 If there are multiple variables that can be resolved, they refer
263 to the same variable. */
264 j->resolve(*last_resolved);
269 resolved_vars.push_front(&*j);
276 vector<string> identifiers = extract_identifiers(def->expression);
277 for(vector<string>::const_iterator k=identifiers.begin(); k!=identifiers.end(); ++k)
279 // Use an existing variable if possible, but only if it's not fuzzy
280 ShaderVariable *var = 0;
281 for(list<ShaderVariable>::iterator l=variables.begin(); (!var && l!=variables.end()); ++l)
282 if(!l->fuzzy_space && l->resolved_name==*k)
287 variables.push_back(ShaderVariable(*k));
288 var = &variables.back();
290 j->add_reference(*var);
295 for(list<ShaderVariable *>::const_iterator i=resolved_vars.begin(); i!=resolved_vars.end(); ++i)
296 (*i)->check_inline(features.legacy, !optimize);
298 prog.attach_shader_owned(new VertexShader(create_source(resolved_vars, VERTEX)));
299 prog.attach_shader_owned(new FragmentShader(create_source(resolved_vars, FRAGMENT)));
303 prog.bind_fragment_data(0, "frag_color");
304 prog.bind_attribute(VERTEX4, "vertex");
305 if(features.lighting)
306 prog.bind_attribute(NORMAL3, "normal");
307 else if(features.material)
308 prog.bind_attribute(COLOR4_FLOAT, "color");
309 if(features.texture || features.normalmap)
310 prog.bind_attribute(TEXCOORD4, "texcoord");
312 if(features.normalmap)
314 prog.bind_attribute(get_component_type(TANGENT3), "tangent");
315 prog.bind_attribute(get_component_type(BINORMAL3), "binormal");
319 string ProgramBuilder::create_source(const list<ShaderVariable *> &variables, VariableScope scope) const
324 source += "#version 130\n";
326 for(list<ShaderVariable *>::const_iterator i=variables.begin(); i!=variables.end(); ++i)
327 if((*i)->variable->scope==UNIFORM && (*i)->is_referenced_from(scope) && !(*i)->inlined)
329 if(strchr((*i)->variable->type, '%'))
330 source += format("uniform %s;\n", format((*i)->variable->type, (*i)->resolved_name));
332 source += format("uniform %s %s;\n", (*i)->variable->type, (*i)->resolved_name);
337 const char *qualifier = (features.legacy ? "attribute" : "in");
338 for(list<ShaderVariable *>::const_iterator i=variables.begin(); i!=variables.end(); ++i)
339 if((*i)->variable->scope==ATTRIBUTE && !(*i)->inlined)
340 source += format("%s %s %s;\n", qualifier, (*i)->variable->type, (*i)->resolved_name);
343 /* Any variables defined in vertex scope but referenced from fragment scope
344 should be exported as varyings over the interface. */
345 list<ShaderVariable *> varyings;
346 for(list<ShaderVariable *>::const_iterator i=variables.begin(); i!=variables.end(); ++i)
347 if(((*i)->variable->scope==VERTEX || (*i)->variable->scope==ATTRIBUTE) && (*i)->is_referenced_from(FRAGMENT))
349 varyings.push_back(*i);
350 const char *qualifier;
352 qualifier = (scope==VERTEX ? "out" : "in");
354 qualifier = "varying";
355 source += format("%s %s v_%s;\n", qualifier, (*i)->variable->type, (*i)->resolved_name);
358 for(list<ShaderVariable *>::const_iterator i=variables.begin(); i!=variables.end(); ++i)
359 if((*i)->referenced_by.empty() && (*i)->resolved_name.compare(0, 3, "gl_"))
360 source += format("out %s %s;\n", (*i)->variable->type, (*i)->resolved_name);
362 source += "void main()\n{\n";
364 for(list<ShaderVariable *>::const_iterator i=variables.begin(); i!=variables.end(); ++i)
365 if((*i)->variable->scope==scope && !(*i)->inlined)
368 if(!(*i)->referenced_by.empty())
370 source += (*i)->variable->type;
373 source += format("%s = %s;\n", (*i)->resolved_name, (*i)->get_expression());
378 for(list<ShaderVariable *>::const_iterator i=varyings.begin(); i!=varyings.end(); ++i)
381 source += format("\tv_%s = %s;\n", (*i)->resolved_name, (*i)->get_expression());
383 source += format("\tv_%s = %s;\n", (*i)->resolved_name, (*i)->resolved_name);
392 bool ProgramBuilder::evaluate_flags(const char *flags) const
399 for(const char *i=flags; *i; ++i)
401 if(*i>='a' && *i<='z')
403 bool found = (feature_flags.find(*i)!=string::npos);
405 cond = (cond || found);
407 cond = (cond && !found);
409 cond = (cond && found);
419 ProgramBuilder::MatchLevel ProgramBuilder::name_match(const char *n1, const char *n2, const char **space)
426 if(*n1==*n2 || *n1=='z' || *n2=='z')
430 int side = (*n1=='z' ? 1 : 2);
443 else if(i>=zzz+3 || side!=zside)
453 return (!*n1 && !*n2) ? zzz>=0 ? FUZZY : EXACT : NO_MATCH;
456 bool ProgramBuilder::parse_identifier(const char *ptr, unsigned &start, unsigned &length)
460 for(const char *i=ptr;; ++i)
466 if(isalpha(*i) || *i=='_')
481 if(!isalnum(*i) && *i!='_')
483 length = i-(ptr+start);
490 vector<string> ProgramBuilder::extract_identifiers(const char *expression)
492 vector<string> result;
493 const char *ptr = expression;
496 while(parse_identifier(ptr, start, length))
498 result.push_back(string(ptr+start, length));
504 string ProgramBuilder::replace_identifiers(const char *expression, const map<string, string> &replace_map)
507 const char *ptr = expression;
510 while(parse_identifier(ptr, start, length))
512 result.append(ptr, start);
513 string identifier(ptr+start, length);
514 map<string, string>::const_iterator i = replace_map.find(identifier);
515 if(i!=replace_map.end())
518 result += identifier;
526 ProgramBuilder::StandardFeatures::StandardFeatures():
534 legacy(!(get_glsl_version()>=Version(1, 30)))
537 string ProgramBuilder::StandardFeatures::create_flags() const
563 ProgramBuilder::ShaderVariable::ShaderVariable(const std::string &n):
567 fuzzy_space(name.find("zzz")!=string::npos),
572 void ProgramBuilder::ShaderVariable::resolve(const VariableDefinition &var)
575 const char *space = 0;
576 if(name_match(var.name, resolved_name.c_str(), &space)==FUZZY)
577 resolve_space(string(space, 3));
581 void ProgramBuilder::ShaderVariable::resolve(ShaderVariable &var)
583 for(list<ShaderVariable *>::iterator i=referenced_by.begin(); i!=referenced_by.end(); ++i)
584 (*i)->update_reference(*this, var);
585 var.referenced_by.insert(var.referenced_by.end(), referenced_by.begin(), referenced_by.end());
588 void ProgramBuilder::ShaderVariable::resolve_space(const string &space)
592 resolved_space = space;
594 string::size_type zzz = resolved_name.find("zzz");
595 resolved_name.replace(zzz, 3, resolved_space);
598 // Resolving the space could have affected other variables that use this one
599 for(list<ShaderVariable *>::iterator i=referenced_by.begin(); i!=referenced_by.end(); ++i)
600 (*i)->resolve_space(space);
603 for(list<ShaderVariable *>::iterator i=referenced_vars.begin(); i!=referenced_vars.end(); ++i)
604 if((*i)->fuzzy_space)
605 (*i)->resolve_space(space);
608 void ProgramBuilder::ShaderVariable::add_reference(ShaderVariable &var)
610 referenced_vars.push_back(&var);
611 var.referenced_by.push_back(this);
612 if(var.fuzzy_space && !resolved_space.empty())
613 var.resolve_space(resolved_space);
616 void ProgramBuilder::ShaderVariable::update_reference(ShaderVariable &from, ShaderVariable &to)
618 replace(referenced_vars.begin(), referenced_vars.end(), &from, &to);
619 replace(referenced_by.begin(), referenced_by.end(), &from, &to);
620 if(from.fuzzy_space && !to.fuzzy_space && !to.resolved_space.empty())
621 resolve_space(to.resolved_space);
624 void ProgramBuilder::ShaderVariable::check_inline(bool allow_legacy, bool trivial_only)
626 if(variable->expression)
628 if(!allow_legacy && !strncmp(variable->expression, "gl_", 3))
631 // Never inline goal variables
632 unsigned total_refs = referenced_by.size();
636 // Inline an expression consisting of a single identifier
637 unsigned start, length;
638 if(parse_identifier(variable->expression, start, length))
639 if(start==0 && variable->expression[length]==0)
648 unsigned in_scope_refs = 0;
649 for(list<ShaderVariable *>::const_iterator i=referenced_by.begin(); i!=referenced_by.end(); ++i)
650 if((*i)->variable->scope==variable->scope)
653 /* Inline if there's only one ref, or if all refs are in other scopes.
654 In the latter case, the actual inlining will happen in the interface
655 variable assignment. */
656 if(total_refs==1 || in_scope_refs==0)
660 for(const char *c=variable->expression; (!inline_parens && *c); ++c)
666 else if(level==0 && !isalnum(*c) && *c!='_' && *c!='.')
667 inline_parens = true;
673 bool ProgramBuilder::ShaderVariable::is_referenced_from(VariableScope scope) const
675 for(list<ShaderVariable *>::const_iterator i=referenced_by.begin(); i!=referenced_by.end(); ++i)
676 if((*i)->variable->scope==scope)
681 string ProgramBuilder::ShaderVariable::get_expression() const
683 map<string, string> replace_map;
684 for(list<ShaderVariable *>::const_iterator i=referenced_vars.begin(); i!=referenced_vars.end(); ++i)
687 string replacement = (*i)->resolved_name;
688 if(variable->scope==FRAGMENT && ((*i)->variable->scope==VERTEX || (*i)->variable->scope==ATTRIBUTE))
689 replacement = "v_"+replacement;
690 else if((*i)->inlined)
692 replacement = (*i)->get_expression();
693 if((*i)->inline_parens)
694 replacement = "("+replacement+")";
696 if(replacement!=(*i)->name)
697 replace_map[(*i)->name] = replacement;
700 if(replace_map.empty())
701 return variable->expression;
703 return replace_identifiers(variable->expression, replace_map);
707 ProgramBuilder::StandardFeatures::Loader::Loader(StandardFeatures &f):
708 DataFile::ObjectLoader<StandardFeatures>(f)
710 add("custom", &StandardFeatures::custom);
711 add("lighting", &StandardFeatures::lighting);
712 add("material", &StandardFeatures::material);
713 add("normalmap", &StandardFeatures::normalmap);
714 add("reflection", &StandardFeatures::reflection);
715 add("shadow", &StandardFeatures::shadow);
716 add("specular", &StandardFeatures::specular);
717 add("texture", &StandardFeatures::texture);