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:
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 &);