MIRA
DynamicRenderable.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012 by
3  * MetraLabs GmbH (MLAB), GERMANY
4  * and
5  * Neuroinformatics and Cognitive Robotics Labs (NICR) at TU Ilmenau, GERMANY
6  * All rights reserved.
7  *
8  * Contact: info@mira-project.org
9  *
10  * Commercial Usage:
11  * Licensees holding valid commercial licenses may use this file in
12  * accordance with the commercial license agreement provided with the
13  * software or, alternatively, in accordance with the terms contained in
14  * a written agreement between you and MLAB or NICR.
15  *
16  * GNU General Public License Usage:
17  * Alternatively, this file may be used under the terms of the GNU
18  * General Public License version 3.0 as published by the Free Software
19  * Foundation and appearing in the file LICENSE.GPL3 included in the
20  * packaging of this file. Please review the following information to
21  * ensure the GNU General Public License version 3.0 requirements will be
22  * met: http://www.gnu.org/copyleft/gpl.html.
23  * Alternatively you may (at your option) use any later version of the GNU
24  * General Public License if such license has been publicly approved by
25  * MLAB and NICR (or its successors, if any).
26  *
27  * IN NO EVENT SHALL "MLAB" OR "NICR" BE LIABLE TO ANY PARTY FOR DIRECT,
28  * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF
29  * THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF "MLAB" OR
30  * "NICR" HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  * "MLAB" AND "NICR" SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING,
33  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
34  * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
35  * ON AN "AS IS" BASIS, AND "MLAB" AND "NICR" HAVE NO OBLIGATION TO
36  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR MODIFICATIONS.
37  */
38 
47 #ifndef _MIRA_DYNAMICRENDERABLE_H_
48 #define _MIRA_DYNAMICRENDERABLE_H_
49 
50 #ifndef Q_MOC_RUN
51 #include <OGRE/OgreSimpleRenderable.h>
52 #endif
53 
54 #include <utils/EnumToFlags.h>
55 
56 namespace mira {
57 
59 
76 class DynamicRenderable : public Ogre::SimpleRenderable
77 {
78 public:
80  virtual ~DynamicRenderable();
81 
92  void initialize(Ogre::RenderOperation::OperationType operationType,
93  const Ogre::VertexDeclaration& vertexDecl, bool useIndices);
94 
96  void setOperationType(Ogre::RenderOperation::OperationType operationType);
97 
105  void enableIndexBuffer(bool enable=true);
106 
107 
111  enum Flags
112  {
113  NONE = 0,
115  };
117 
131  void prepareBuffers(size_t vertexCount, size_t indexCount=0,
132  Flags flags = NONE,
133  Ogre::HardwareBuffer::Usage usage=Ogre::HardwareBuffer::HBU_DYNAMIC_WRITE_ONLY);
134 
142  void updateVertexCount(size_t vertexCount);
143 
145  Ogre::HardwareVertexBufferSharedPtr getVertexBuffer(unsigned short index = 0);
146 
148  Ogre::HardwareIndexBufferSharedPtr getIndexBuffer();
149 
150 
151 public:
152 
154  virtual Ogre::Real getBoundingRadius(void) const;
156  virtual Ogre::Real getSquaredViewDepth(const Ogre::Camera* cam) const;
157 
158 #if OGRE_VERSION < 0x11000
159  // workaround for buggy implementation not respecting mRenderQueuePriority,
160  // fixed in OGRE 1.10
161 public:
162 
163  virtual void _updateRenderQueue(Ogre::RenderQueue* queue) {
164  queue->addRenderable( this, mRenderQueueID, mRenderQueuePriority);
165  }
166 #endif
167 
168 protected:
173 };
174 
176 
177 }
178 
179 #endif
Definition: DynamicRenderable.h:113
virtual void _updateRenderQueue(Ogre::RenderQueue *queue)
Definition: DynamicRenderable.h:163
Macros for generating logical operators for using enum values as flags.
Flags
Flags that can be specified in prepareHardwareBuffers().
Definition: DynamicRenderable.h:111
specialize cv::DataType for our ImgPixel and inherit from cv::DataType<Vec>
Definition: IOService.h:67
Ogre::HardwareIndexBufferSharedPtr getIndexBuffer()
Gets the index buffer of this renderable (or NULL, if no index buffer was created) ...
size_t mIndexBufferCapacity
Maximum capacity of the currently allocated index buffer.
Definition: DynamicRenderable.h:172
Abstract base class for renderables based on dynamically growing vertex and index buffers...
Definition: DynamicRenderable.h:76
create a 32bit index buffer instead of 16bit
Definition: DynamicRenderable.h:114
Ogre::HardwareVertexBufferSharedPtr getVertexBuffer(unsigned short index=0)
Gets the vertex buffer bound to the given source index.
virtual Ogre::Real getSquaredViewDepth(const Ogre::Camera *cam) const
Implementation of Ogre::SimpleRenderable.
void setOperationType(Ogre::RenderOperation::OperationType operationType)
Allows to change the operation type after calling initialize.
size_t mVertexBufferCapacity
Maximum capacity of the currently allocated vertex buffer.
Definition: DynamicRenderable.h:170
void initialize(Ogre::RenderOperation::OperationType operationType, const Ogre::VertexDeclaration &vertexDecl, bool useIndices)
Initializes the dynamic renderable.
virtual Ogre::Real getBoundingRadius(void) const
Implementation of Ogre::SimpleRenderable.
void enableIndexBuffer(bool enable=true)
Allows to enable/disable the index buffer, after initialize() was already called. ...
void prepareBuffers(size_t vertexCount, size_t indexCount=0, Flags flags=NONE, Ogre::HardwareBuffer::Usage usage=Ogre::HardwareBuffer::HBU_DYNAMIC_WRITE_ONLY)
Prepares the hardware buffers for the requested vertex and index counts.
void updateVertexCount(size_t vertexCount)
Update the count of vertices actually filled into the buffer.