Lots of comment updates

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

diff --git a/source/object.h b/source/object.h
index 7a40a40ba24bc71ff40af47c46af642a229e0249..8a707665c8871132e4c555f8a9fc88b5108a10c6 100644 (file)
--- a/source/object.h
+++ b/source/object.h
@@ -1,15 +1,10 @@
-/* $Id$
-
-This file is part of libmspgl
-Copyright © 2007  Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
-
 #ifndef MSP_GL_OBJECT_H_
 #define MSP_GL_OBJECT_H_
 
 #include <vector>
-#include <msp/datafile/collection.h>
+#include "bindable.h"
+#include "renderable.h"
+#include "renderpass.h"
 
 namespace Msp {
 namespace GL {
@@ -17,69 +12,62 @@ namespace GL {
 class Material;
 class Mesh;
 class ObjectInstance;
-class Program;
-class ProgramData;
+class Technique;
 class Texture;
 
 /**
-Stores data for a complete 3D object.  This includes a mesh, a shader and data
-for it and a number of textures.  Only the mesh is mandatory, other components
-are optional.
+Combines a Mesh with a Technique to give it an appearance.  The Technique will
+define which render passes the Object supports.
 
-See also class ObjectInstance.
+In many cases, it's desirable to include multiple copies of an Object in a
+Scene, with different model matrices.  ObjectInstances can be used to alter the
+rendering of an object on a per-instance basis.
 */
-class Object
+class Object: public Renderable
 {
-private:
-       Mesh *mesh;
-       std::vector<Texture *> textures;
-       Program *shprog;
-       ProgramData *shdata;
-       Material *material;
-
 public:
-       class Loader: public DataFile::Loader
+       class Loader: public DataFile::CollectionObjectLoader<Object>
        {
        public:
-               typedef DataFile::Collection Collection;
-
-       protected:
-               Object &obj;
-               Collection &coll;
-       private:
-               std::vector<std::string> textures;
-       
-       public:
+               Loader(Object &);
                Loader(Object &, Collection &);
-               ~Loader();
+       private:
+               void init();
 
-               Object &get_object() const { return obj; }
-               Collection &get_collection() const { return coll; }
        private:
-               void shader(const std::string &);
-               void texture(const std::string &);
+               void mesh_inline();
+               void mesh_inline_lod(unsigned);
+               void mesh(const std::string &);
+               void mesh_lod(unsigned, const std::string &);
+               void technique_inline();
+               void technique(const std::string &);
        };
 
+private:
+       std::vector<RefPtr<const Mesh> > meshes;
+       RefPtr<const Technique> technique;
+
+public:
        Object();
+       Object(const Mesh *, const Technique *);
        ~Object();
 
-       Program *get_shader() const { return shprog; }
+       void set_mesh(const Mesh *m) { set_mesh(0, m); }
+       void set_mesh(unsigned, const Mesh *);
+       const Mesh *get_mesh(unsigned = 0) const;
+       void set_technique(const Technique *);
+       const Technique *get_technique() const { return technique.get(); }
+
+       virtual void render(const Tag &tag = Tag()) const;
+
+       virtual void render(Renderer &, const Tag & = Tag()) const;
 
-       /**
-       Renders the object.  If an ObjectInstance is provided, its hook functions
-       are called.
-       */
-       void render(const ObjectInstance * =0) const;
+       /** Renders an instance of the object.  The instance's hook functions are
+       called before and after drawing the mesh. */
+       virtual void render(Renderer &, const ObjectInstance &, const Tag & = Tag()) const;
 
-       /**
-       Renders multiple instances of the object in one go.  This may be a
-       performance improvement, as the object-specific render setup only has to be
-       done once.
-       */
-       void render(const std::list<const ObjectInstance *> &) const;
 private:
-       void setup_render() const;
-       void finish_render() const;
+       const RenderPass *get_pass(const Tag &) const;
 };
 
 } // namespace GL