X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Frenderable.h;h=2342ae288cfed9b4d8fa61f25bf932ae47058540;hb=904de4f7fd994886adbd3a6c03bc1b7c14ebc562;hp=78879a3d8030fb15fcd41136c16ec7c831541972;hpb=18878df418035445ba5146fcde3d647d7aa8c054;p=libs%2Fgl.git

diff --git a/source/renderable.h b/source/renderable.h
index 78879a3d..2342ae28 100644
--- a/source/renderable.h
+++ b/source/renderable.h
@@ -12,6 +12,9 @@ class Renderer;
 /**
 Base class for renderable objects.  All Renderables must support rendering with
 a Renderer, and may optionally provide support for standalone rendering.
+
+The render methods take a Tag to identify a render pass.  It is most commonly
+used together with Techniques and Pipelines to implement multipass rendering.
 */
 class Renderable
 {
@@ -20,10 +23,17 @@ protected:
 public:
 	virtual ~Renderable() { }
 
-	/** Returns a key used for grouping Renderables in an InstanceScene. */
+	/** Returns a key used for grouping Renderables in an InstanceScene.  The
+	returned value is treated as opaque. */
 	virtual long get_instance_key() const { return 0; }
 
+	/** Renders the renderable without a renderer.  This can be convenient in
+	some simple cases, but most renderables don't need to implement this
+	method. */
 	virtual void render(const Tag & = Tag()) const;
+
+	/** Renders the renderable.  Implementors should take care to return the
+	renderer to the state it was in, for example by using Renderer::Push. */
 	virtual void render(Renderer &, const Tag & = Tag()) const = 0;
 };