3 This file is part of libmspgl
4 Copyright © 2007-2008, 2010 Mikko Rasa, Mikkosoft Productions
5 Distributed under the LGPL
8 #ifndef MSP_GL_OBJECT_H_
9 #define MSP_GL_OBJECT_H_
13 #include "renderable.h"
14 #include "renderpass.h"
26 Stores a Mesh together with a Technique to determine its appearance.
28 It is possible to use a single Object for rendering multiple identical or
29 similar objects. See class ObjectInstance.
31 class Object: public Renderable
34 std::vector<RefPtr<const Mesh> > meshes;
35 RefPtr<const Technique> technique;
38 class Loader: public DataFile::CollectionObjectLoader<Object>
42 Loader(Object &, Collection &);
49 void mesh(const std::string &);
50 void mesh(unsigned, const std::string &);
52 void technique(const std::string &);
58 void set_mesh(const Mesh *m) { set_mesh(0, m); }
59 void set_mesh(unsigned, const Mesh *);
60 void set_technique(const Technique *);
61 const Technique *get_technique() const { return technique.get(); }
64 Renders the object. A tag can be provided to render a non-default pass.
66 virtual void render(const Tag &tag = Tag()) const;
69 Renders the object with an instance. The instance's hook functions are
70 called before and after drawing the mesh. A tag may also be given to render
73 virtual void render(const ObjectInstance &, const Tag &tag = Tag()) const;
76 Renders multiple instances of the object in one go. This may improve
77 performance, as the object-specific render setup only has to be done once.
78 Each instance's hook functions will be called before and after drawing the
81 template<typename Iter>
82 void render(Iter begin, Iter end, const Tag &tag = Tag()) const
84 const RenderPass *pass = get_pass(tag);
89 for(Iter i=begin; i!=end; ++i)
90 render_instance(**i, tag);
93 const RenderPass *get_pass(const Tag &) const;
94 void render_instance(const ObjectInstance &, const Tag &) const;