X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Fobject.h;h=7820d29c366df0b1392471c3e8220ce7f8fe728d;hb=0119ca4f792dc761e5248b76de71f2844c0e3997;hp=69759c80a7fde69b7ffe9ccc2a35abb064a758fa;hpb=1e974e526806cf1dd5f65b146dfbbb5bf4d7c19b;p=libs%2Fgl.git

diff --git a/source/object.h b/source/object.h
index 69759c80..7820d29c 100644
--- a/source/object.h
+++ b/source/object.h
@@ -16,10 +16,12 @@ class Technique;
 class Texture;
 
 /**
-Stores a Mesh together with a Technique to determine its appearance.
+Combines a Mesh with a Technique to give it an appearance.  The Technique will
+define which render passes the Object supports.
 
-It is possible to use a single Object for rendering multiple identical or
-similar objects.  See class ObjectInstance.
+In many cases, it's desirable to include multiple copies of an Object in a
+Scene, with different model matrices.  ObjectInstances can be used to alter the
+rendering of an object on a per-instance basis.
 */
 class Object: public Renderable
 {
@@ -56,20 +58,18 @@ public:
 	void set_technique(const Technique *);
 	const Technique *get_technique() const { return technique.get(); }
 
-	/**
-	Renders the object.  A tag can be provided to render a non-default pass.
-	*/
 	virtual void render(const Tag &tag = Tag()) const;
 
 	virtual void render(Renderer &, const Tag & = Tag()) const;
 
-	/**
-	Renders the object with an instance.  The instance's hook functions are
-	called before and after drawing the mesh.  A tag may also be given to render
-	a non-default pass.
-	*/
+	/** Renders an instance of the object.  The instance's hook functions are
+	called before and after drawing the mesh. */
 	virtual void render(Renderer &, const ObjectInstance &, const Tag & = Tag()) const;
 
+protected:
+	virtual void setup_render(Renderer &, const Tag &) const { }
+	virtual void finish_render(Renderer &, const Tag &) const { }
+
 private:
 	const RenderPass *get_pass(const Tag &) const;
 };