]> git.tdb.fi Git - libs/gl.git/blobdiff - source/effects/effect.h
Clean up some more unused things
[libs/gl.git] / source / effects / effect.h
index eadb4dc845984a3d8e04d83e93d6a819df81bdf0..ac458361700cf669052ea69039017451f2497e8f 100644 (file)
@@ -9,13 +9,23 @@ namespace Msp {
 namespace GL {
 
 /**
-Effects are used to wrap other renderables and give them additional visual
-properties.  An Effect's render method should set up the necessary state, call
-the wrapped Renderable's render method, and clean up after itself.
+Base class for visual effects.
+
+Effects wrap other renderables and provide additional textures or uniform
+values which can be used by shaders to modify the appearance of the content
+renderable.  Some material properties require certain Effects to be present in
+order to function properly.
+
+If an Effect subclass needs to do any sideband rendering to prepare for a
+frame, that should be done in setup_frame().  The render() function should only
+set up the necessary state and call the content renderable's render() function.
 */
 class Effect: public Renderable
 {
 public:
+       /**
+       Holds the parameters for an Effect.  Used with SequenceTemplate.
+       */
        struct Template
        {
                class Loader: public DataFile::CollectionObjectLoader<Template>
@@ -35,7 +45,7 @@ public:
 
 protected:
        Renderable &renderable;
-       std::set<Tag> enabled_methods;
+       std::vector<Tag> enabled_methods;
 
 protected:
        Effect(Renderable &);
@@ -44,6 +54,7 @@ public:
 
        void enable_for_method(Tag);
        void disable_for_method(Tag);
+       bool is_enabled_for_method(Tag) const;
 
        virtual const Matrix *get_matrix() const { return renderable.get_matrix(); }
        virtual const Geometry::BoundingSphere<float, 3> *get_bounding_sphere() const { return renderable.get_bounding_sphere(); }