Lots of comment updates

[libs/gl.git] / source / renderer.h

diff --git a/source/renderer.h b/source/renderer.h
index 866881c7b66aeebb8b913c43af4ee14b357c1885..dd54ca1691dfaf49233608ff85f2ff5de9e69440 100644 (file)
--- a/source/renderer.h
+++ b/source/renderer.h
@@ -24,7 +24,9 @@ particular, Objects and Scenes) can by rendered without a Renderer, using one
 will often be more efficient.  This is especially true for ObjectInstances.
 
 The Renderer works by deferring GL state changes until something is actually
-being drawn.  This avoids many unnecessary GL calls. */
+being drawn.  This avoids many unnecessary GL calls if consecutive renderables
+use the same resources.
+*/
 class Renderer
 {
 public:
@@ -70,6 +72,7 @@ private:
        const VertexArray *vertex_array;
        bool vertex_array_changed;
        const Buffer *element_buffer;
+       bool shdata_changed;
 
 public:
        Renderer(const Camera *);
@@ -91,7 +94,9 @@ public:
        void push_state();
        void pop_state();
 
-       /** Prepares for temporarily bypassing the Renderer. */
+       /** Prepares for temporarily bypassing the Renderer by synchronizing the
+       current state with GL.  No additional call is necessary to resume using the
+       Renderer. */
        void escape();
 
        void draw(const Batch &);