Lots of comment updates

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

diff --git a/source/pipeline.h b/source/pipeline.h
index 011a96bba5e37d6ca1bd056bfe1cede1c047cb03..f8fdb5450b18d42eb621ff0fb80141918b9ecbc8 100644 (file)
--- a/source/pipeline.h
+++ b/source/pipeline.h
@@ -3,7 +3,10 @@
 
 #include <map>
 #include <set>
+#include "framebuffer.h"
 #include "renderable.h"
+#include "renderbuffer.h"
+#include "texture2d.h"
 
 namespace Msp {
 namespace GL {
@@ -11,24 +14,46 @@ namespace GL {
 class Blend;
 class Camera;
 class DepthTest;
-class Framebuffer;
 class Lighting;
 class PostProcessor;
-class Renderbuffer;
-class Texture2D;
 
+/**
+Encapsulates all of the information used to produce a complete image in the
+framebuffer.  This is the highest level rendering class, combining Renderables
+with a camera, lights and some other influential objects.
+
+A Pipeline is also a Renderable itself.  Externally, it only exposes the
+default pass.  Internally, it can hold any number of passes, which are invoked
+in sequence when rendering the default pass is requested.  Each pass can have a
+Lighting, a DepthTest and a Blend to control how it is rendered.
+
+A Pipeline's render method should normally be called without a Renderer; it
+will create one itself, using the camera specified for the Pipeline.  If a
+Renderer is passed, its camera will be used instead.
+
+Renderables are rendered in the order they were added to the Pipeline.  While
+it's possible to remove renderables as well, using a Scene is recommended if
+frequent add/remove operations are needed.
+
+Pipelines may have post-processors to apply full-screen effects. Framebuffer
+objects are automatically used to pass render results to the post-processors.
+High dynamic range and multisample rendering can also be used.
+*/
 class Pipeline: public Renderable
 {
 public:
        class Pass
        {
        private:
+               Tag tag;
                const Lighting *lighting;
                const DepthTest *depth_test;
                const Blend *blend;
 
        public:
-               Pass();
+               Pass(const Tag &);
+
+               const Tag &get_tag() const { return tag; }
 
                void set_lighting(const Lighting *);
                void set_depth_test(const DepthTest *);
@@ -47,10 +72,27 @@ private:
                Slot(const Renderable *);
        };
 
-       typedef std::map<Tag, Pass> PassMap;
+       struct RenderTarget
+       {
+               Framebuffer fbo;
+               Texture2D color;
+               Texture2D depth;
+
+               RenderTarget(unsigned, unsigned, PixelFormat);
+       };
+
+       struct MultisampleTarget
+       {
+               Framebuffer fbo;
+               Renderbuffer color;
+               Renderbuffer depth;
+
+               MultisampleTarget(unsigned, unsigned, unsigned, PixelFormat);
+       };
+
+       typedef std::list<Pass> PassList;
 
-       PassMap passes;
-       std::vector<Tag> pass_order;
+       PassList passes;
        const Camera *camera;
        std::vector<Slot> renderables;
        std::vector<PostProcessor *> postproc;
@@ -58,12 +100,8 @@ private:
        unsigned height;
        bool hdr;
        unsigned samples;
-       Framebuffer *fbo;
-       Texture2D *color_buf;
-       Texture2D *depth_buf;
-       Framebuffer *fbo_ms;
-       Renderbuffer *color_buf_ms;
-       Renderbuffer *depth_buf_ms;
+       RenderTarget *target[2];
+       MultisampleTarget *target_ms;
 
 public:
        Pipeline(unsigned, unsigned, bool = false);
@@ -74,19 +112,17 @@ public:
        void set_camera(const Camera *);
 
        Pass &add_pass(const Tag &tag);
-       Pass &get_pass(const Tag &tag);
-       const Pass &get_pass(const Tag &tag) const;
 
        void add_renderable(const Renderable &);
        void add_renderable_for_pass(const Renderable &, const Tag &);
        void remove_renderable(const Renderable &);
        void add_postprocessor(PostProcessor &);
 
+       virtual void render(const Tag &tag = Tag()) const;
        virtual void render(Renderer &, const Tag &tag = Tag()) const;
-       void render_all() const;
 
 private:
-       void create_fbos();
+       void create_targets(bool);
 };
 
 } // namespace GL