1/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
3 * This library is open source and may be redistributed and/or modified under
4 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
5 * (at your option) any later version. The full license is in LICENSE file
6 * included with this distribution, and on the openscenegraph.org website.
8 * This library is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * OpenSceneGraph Public License for more details.
14#ifndef OSGUTIL_RENDERBIN
15#define OSGUTIL_RENDERBIN 1
17#include <osgUtil/StateGraph>
28 * RenderBin base class. Renderbin contains geometries to be rendered as a group,
29 * renderbins are rendered once each. They can improve efficiency or
30 * use different rendering algorithms.
31 * A renderBin can contain further renderBins producing a tree hierarchy of renderBins.
33class OSGUTIL_EXPORT RenderBin : public osg::Object
37 typedef std::vector<RenderLeaf*> RenderLeafList;
38 typedef std::vector<StateGraph*> StateGraphList;
39 typedef std::map< int, osg::ref_ptr<RenderBin> > RenderBinList;
44 SORT_BY_STATE_THEN_FRONT_TO_BACK,
51 static RenderBin* createRenderBin(const std::string& binName);
52 static RenderBin* getRenderBinPrototype(const std::string& binName);
53 static void addRenderBinPrototype(const std::string& binName,RenderBin* proto);
54 static void removeRenderBinPrototype(RenderBin* proto);
56 static void setDefaultRenderBinSortMode(SortMode mode);
57 static SortMode getDefaultRenderBinSortMode();
63 RenderBin(SortMode mode);
65 /** Copy constructor using CopyOp to manage deep vs shallow copy.*/
66 RenderBin(const RenderBin& rhs,const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY);
68 virtual osg::Object* cloneType() const { return new RenderBin(); }
69 virtual osg::Object* clone(const osg::CopyOp& copyop) const { return new RenderBin(*this,copyop); } // note only implements a clone of type.
70 virtual bool isSameKindAs(const osg::Object* obj) const { return dynamic_cast<const RenderBin*>(obj)!=0L; }
71 virtual const char* libraryName() const { return "osgUtil"; }
72 virtual const char* className() const { return "RenderBin"; }
76 void setStateGraph(StateGraph* sg) { _rootStateGraph = sg; }
77 StateGraph* getStateGraph() { return _rootStateGraph.get(); }
79 void setStateSet(osg::StateSet* stateset) { _stateset = stateset; }
80 osg::StateSet* getStateSet() { return _stateset.get(); }
81 const osg::StateSet* getStateSet() const { return _stateset.get(); }
84 RenderBin* getParent() { return _parent; }
85 const RenderBin* getParent() const { return _parent; }
87 RenderStage* getStage() { return _stage; }
88 const RenderStage* getStage() const { return _stage; }
90 int getBinNum() const { return _binNum; }
92 StateGraphList& getStateGraphList() { return _stateGraphList; }
93 const StateGraphList& getStateGraphList() const { return _stateGraphList; }
95 RenderBinList& getRenderBinList() { return _bins; }
96 const RenderBinList& getRenderBinList() const { return _bins; }
98 RenderLeafList& getRenderLeafList() { return _renderLeafList; }
99 const RenderLeafList& getRenderLeafList() const { return _renderLeafList; }
102 RenderBin* find_or_insert(int binNum,const std::string& binName);
104 void addStateGraph(StateGraph* rg)
106 _stateGraphList.push_back(rg);
111 virtual void sortImplementation();
113 void setSortMode(SortMode mode);
114 SortMode getSortMode() const { return _sortMode; }
116 virtual void sortByState();
117 virtual void sortByStateThenFrontToBack();
118 virtual void sortFrontToBack();
119 virtual void sortBackToFront();
120 virtual void sortTraversalOrder();
122 struct SortCallback : public osg::Referenced
124 virtual void sortImplementation(RenderBin*) = 0;
127 void setSortCallback(SortCallback* sortCallback) { _sortCallback = sortCallback; }
128 SortCallback* getSortCallback() { return _sortCallback.get(); }
129 const SortCallback* getSortCallback() const { return _sortCallback.get(); }
133 virtual void draw(osg::RenderInfo& renderInfo,RenderLeaf*& previous);
135 virtual void drawImplementation(osg::RenderInfo& renderInfo,RenderLeaf*& previous);
137 struct DrawCallback : public osg::Referenced
139 virtual void drawImplementation(RenderBin* bin,osg::RenderInfo& renderInfo,RenderLeaf*& previous) = 0;
142 void setDrawCallback(DrawCallback* drawCallback) { _drawCallback = drawCallback; }
143 DrawCallback* getDrawCallback() { return _drawCallback.get(); }
144 const DrawCallback* getDrawCallback() const { return _drawCallback.get(); }
146 /** Extract stats for current draw list. */
147 bool getStats(Statistics& primStats) const;
149 /** Compute the number of dynamic RenderLeaves.*/
150 virtual unsigned int computeNumberOfDynamicRenderLeaves() const;
152 void copyLeavesFromStateGraphListToRenderLeafList();
154 /** If State is non-zero, this function releases any associated OpenGL objects for
155 * the specified graphics context. Otherwise, releases OpenGL objexts
156 * for all graphics contexts. */
157 virtual void releaseGLObjects(osg::State* state= 0) const;
161 virtual ~RenderBin();
163 osg::ref_ptr<StateGraph> _rootStateGraph;
169 StateGraphList _stateGraphList;
170 RenderLeafList _renderLeafList;
174 osg::ref_ptr<SortCallback> _sortCallback;
176 osg::ref_ptr<DrawCallback> _drawCallback;
178 osg::ref_ptr<osg::StateSet> _stateset;