X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Fprogramdata.h;h=3cef2d4c1b5cd921fa75c7f8d6dc449300151909;hb=8f7d5b6460ef68e7316c7f556b7152d9c9f7bfe2;hp=cf642e6141222d3033d80bc6d92e50ff6c99e863;hpb=3cdcc7f689b3868dd275774b9bd9adb5c436f244;p=libs%2Fgl.git

diff --git a/source/programdata.h b/source/programdata.h
index cf642e61..3cef2d4c 100644
--- a/source/programdata.h
+++ b/source/programdata.h
@@ -17,7 +17,13 @@ class Vector3;
 class Vector4;
 
 /**
-Stores uniform variables for a shader program.
+Stores uniform variables for shader programs.  The uniforms are stored in a
+program-independent way, and UniformBlocks are created to match the uniform
+layouts of different programs.  If multiple programs have the same layout, the
+same block is used for them.
+
+The class is optimized for an access pattern where the set of uniforms and
+programs stays constants, with only the values changing.
 */
 class ProgramData
 {
@@ -81,6 +87,8 @@ public:
 	void uniform(const std::string &, const Vector4 &);
 	void uniform(const std::string &, const Color &);
 	void uniform4(const std::string &, const float *);
+	void uniform_matrix2(const std::string &, const float *);
+	void uniform_matrix3(const std::string &, const float *);
 	void uniform_matrix4(const std::string &, const float *);
 	void uniform_matrix4(const std::string &, const Matrix &);
 	void uniform1_array(const std::string &, unsigned, const float *);
@@ -93,9 +101,14 @@ private:
 	void find_uniforms_for_block(Block &, const Program::UniformBlockInfo &) const;
 	UniformBlock *create_block(const Program::UniformBlockInfo &) const;
 	const UniformBlock *get_block(const Program &, const Program::UniformBlockInfo *) const;
+
 public:
-	const UniformBlock *get_block(const Program &, const std::string &) const;
+	/** Returns a UniformBlock matching the program's layout.  If name is empty,
+	uniforms for the default uniform block (outside any uniform block
+	declarations) are returned. */
+	const UniformBlock *get_block(const Program &prog, const std::string &name) const;
 
+	/// Creates blocks for the currently bound program and applies them.
 	void apply() const;
 };