X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Fglsl%2Fgenerate.h;h=977ed156f4490ab9e282b328d59c6c88074db3f2;hb=9ec831710f64a62ad5f2e896a55ae82a3519f29e;hp=68816b8b50acec9411ec331e8b866749412bb3d2;hpb=6288c42adde9ee7d39a47de51fa2856cf965dccc;p=libs%2Fgl.git

diff --git a/source/glsl/generate.h b/source/glsl/generate.h
index 68816b8b..977ed156 100644
--- a/source/glsl/generate.h
+++ b/source/glsl/generate.h
@@ -11,6 +11,7 @@ namespace Msp {
 namespace GL {
 namespace SL {
 
+/** Combines multiple declarations of the same identifier into one. */
 class DeclarationCombiner: private TraversingVisitor
 {
 private:
@@ -23,10 +24,13 @@ public:
 
 private:
 	virtual void visit(Block &);
-	virtual void visit(FunctionDeclaration &);
 	virtual void visit(VariableDeclaration &);
+	virtual void visit(FunctionDeclaration &) { }
 };
 
+/** Manipulates specialization constants.  If values are specified, turns
+specialization constants into normal constants.  Without values assigns
+automatic constant_ids to specialization constants. */
 class ConstantSpecializer: private TraversingVisitor
 {
 private:
@@ -41,7 +45,8 @@ private:
 	virtual void visit(VariableDeclaration &);
 };
 
-class BlockResolver: private TraversingVisitor
+/** Forms links between nested blocks in the syntax tree. */
+class BlockHierarchyResolver: private TraversingVisitor
 {
 public:
 	void apply(Stage &s) { s.content.visit(*this); }
@@ -50,11 +55,12 @@ private:
 	virtual void enter(Block &);
 };
 
+/** Resolves variable references.  Variable references which match the name
+of an interface block are turned into interface block references. */
 class VariableResolver: private TraversingVisitor
 {
 private:
 	Stage *stage;
-	Block *builtins;
 	std::map<std::string, VariableDeclaration *> *members;
 	RefPtr<InterfaceBlockReference> iface_ref;
 	std::string block_interface;
@@ -68,8 +74,6 @@ public:
 	void apply(Stage &);
 
 private:
-	Block *next_block(Block &);
-
 	virtual void enter(Block &);
 	virtual void visit(VariableReference &);
 	virtual void visit(InterfaceBlockReference &);
@@ -81,19 +85,29 @@ private:
 	virtual void visit(InterfaceBlock &);
 };
 
+/** Resolves function declarations and calls. */
 class FunctionResolver: private TraversingVisitor
 {
 private:
-	std::map<std::string, std::vector<FunctionDeclaration *> > functions;
+	Stage *stage;
+	std::map<std::string, std::vector<FunctionDeclaration *> > declarations;
 
 public:
-	void apply(Stage &s) { s.content.visit(*this); }
+	void apply(Stage &);
 
 private:
 	virtual void visit(FunctionCall &);
 	virtual void visit(FunctionDeclaration &);
 };
 
+/** Materializes implicitly declared interfaces.
+
+Out variable declarations inside functions are moved to the global scope.
+
+Passthrough statements are processed, generating out variables to match in
+variables and copying values.
+
+Unresolved variables are looked up in the previous stage's out variables. */
 class InterfaceGenerator: private TraversingVisitor
 {
 private:
@@ -127,6 +141,8 @@ private:
 	virtual void visit(Passthrough &);
 };
 
+/** Reorders declarations to ensure that declarations always appear before
+references. */
 class DeclarationReorderer: private TraversingVisitor
 {
 private: