OGRE  2.0
Object-Oriented Graphics Rendering Engine
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Ogre::VertexData Class Reference

Summary class collecting together vertex source information. More...

#include <OgreVertexIndexData.h>

+ Inheritance diagram for Ogre::VertexData:
+ Collaboration diagram for Ogre::VertexData:

Classes

struct  HardwareAnimationData
 Struct used to hold hardware morph / pose vertex data information. More...
 

Public Types

typedef vector
< HardwareAnimationData >
::type 
HardwareAnimationDataList
 

Public Member Functions

 VertexData (HardwareBufferManagerBase *mgr=0)
 Constructor. More...
 
 VertexData (VertexDeclaration *dcl, VertexBufferBinding *bind)
 Constructor. More...
 
 ~VertexData ()
 
ushort allocateHardwareAnimationElements (ushort count, bool animateNormals)
 Allocate elements to serve a holder of morph / pose target data for hardware morphing / pose blending. More...
 
VertexDataclone (bool copyData=true, HardwareBufferManagerBase *mgr=0) const
 Clones this vertex data, potentially including replicating any vertex buffers. More...
 
void closeGapsInBindings (void)
 Remove any gaps in the vertex buffer bindings. More...
 
void convertPackedColour (VertexElementType srcType, VertexElementType destType)
 Convert all packed colour values (VET_COLOUR_*) in buffers used to another type. More...
 
IdType getId () const
 Get the unique id of this object. More...
 
void operator delete (void *ptr)
 
void operator delete (void *ptr, void *)
 
void operator delete (void *ptr, const char *, int, const char *)
 
void operator delete[] (void *ptr)
 
void operator delete[] (void *ptr, const char *, int, const char *)
 
void * operator new (size_t sz, const char *file, int line, const char *func)
 operator new, with debug line info More...
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *ptr)
 placement operator new More...
 
void * operator new[] (size_t sz, const char *file, int line, const char *func)
 array operator new, with debug line info More...
 
void * operator new[] (size_t sz)
 
bool operator() (const IdObject *left, const IdObject *right)
 
bool operator() (const IdObject &left, const IdObject &right)
 
void prepareForShadowVolume (void)
 Modifies the vertex data to be suitable for use for rendering shadow geometry. More...
 
void removeUnusedBuffers (void)
 Remove all vertex buffers that never used by the vertex declaration. More...
 
void reorganiseBuffers (VertexDeclaration *newDeclaration, const BufferUsageList &bufferUsage, HardwareBufferManagerBase *mgr=0)
 Reorganises the data in the vertex buffers according to the new vertex declaration passed in. More...
 
void reorganiseBuffers (VertexDeclaration *newDeclaration, HardwareBufferManagerBase *mgr=0)
 Reorganises the data in the vertex buffers according to the new vertex declaration passed in. More...
 

Public Attributes

HardwareVertexBufferSharedPtr hardwareShadowVolWBuffer
 Additional shadow volume vertex buffer storage. More...
 
HardwareAnimationDataList hwAnimationDataList
 VertexElements used for hardware morph / pose animation. More...
 
size_t hwAnimDataItemsUsed
 Number of hardware animation data items used. More...
 
bool mDeleteDclBinding
 Whether this class should delete the declaration and binding. More...
 
VertexBufferBindingvertexBufferBinding
 The vertex buffer bindings to be used. More...
 
size_t vertexCount
 The number of vertices used in this operation. More...
 
VertexDeclarationvertexDeclaration
 Declaration of the vertex to be used in this operation. More...
 
size_t vertexStart
 The base vertex index to start from. More...
 

Protected Member Functions

void _setId (IdType newId)
 In the rare case our derived class wants to override our Id (normally we don't want that, that's why it's private). More...
 

Private Member Functions

 VertexData (const VertexData &rhs)
 Protected copy constructor, to prevent misuse. More...
 
VertexDataoperator= (const VertexData &rhs)
 Protected operator=, to prevent misuse. More...
 

Private Attributes

HardwareBufferManagerBasemMgr
 

Detailed Description

Summary class collecting together vertex source information.

Definition at line 50 of file OgreVertexIndexData.h.

Member Typedef Documentation

Constructor & Destructor Documentation

Ogre::VertexData::VertexData ( const VertexData rhs)
private

Protected copy constructor, to prevent misuse.

Ogre::VertexData::VertexData ( HardwareBufferManagerBase mgr = 0)

Constructor.

Note
This constructor creates the VertexDeclaration and VertexBufferBinding automatically, and arranges for their deletion afterwards.
Parameters
mgrOptional HardwareBufferManager from which to create resources
Ogre::VertexData::VertexData ( VertexDeclaration dcl,
VertexBufferBinding bind 
)

Constructor.

Note
This constructor receives the VertexDeclaration and VertexBufferBinding from the caller, and as such does not arrange for their deletion afterwards, the caller remains responsible for that.
Parameters
dclThe VertexDeclaration to use
bindThe VertexBufferBinding to use
Ogre::VertexData::~VertexData ( )

Member Function Documentation

void Ogre::IdObject::_setId ( IdType  newId)
inlineprotectedinherited

In the rare case our derived class wants to override our Id (normally we don't want that, that's why it's private).

Definition at line 63 of file OgreId.h.

ushort Ogre::VertexData::allocateHardwareAnimationElements ( ushort  count,
bool  animateNormals 
)

Allocate elements to serve a holder of morph / pose target data for hardware morphing / pose blending.

Remarks
This method will allocate the given number of 3D texture coordinate sets for use as a morph target or target pose offset (3D position). These elements will be saved in hwAnimationDataList. It will also assume that the source of these new elements will be new buffers which are not bound at this time, so will start the sources to 1 higher than the current highest binding source. The caller is expected to bind these new buffers when appropriate. For morph animation the original position buffer will be the 'from' keyframe data, whilst for pose animation it will be the original vertex data. If normals are animated, then twice the number of 3D texture coordinates are required
Returns
The number of sets that were supported
VertexData* Ogre::VertexData::clone ( bool  copyData = true,
HardwareBufferManagerBase mgr = 0 
) const

Clones this vertex data, potentially including replicating any vertex buffers.

Parameters
copyDataWhether to create new vertex buffers too or just reference the existing ones
mgrIf supplied, the buffer manager through which copies should be made
Remarks
The caller is expected to delete the returned pointer when ready
void Ogre::VertexData::closeGapsInBindings ( void  )

Remove any gaps in the vertex buffer bindings.

Remarks
This is useful if you've removed elements and buffers from this vertex data and want to remove any gaps in the vertex buffer bindings. This method is mainly useful when reorganising vertex data manually.
Note
This will cause binding index of the elements in the vertex declaration to be altered to new binding index.
void Ogre::VertexData::convertPackedColour ( VertexElementType  srcType,
VertexElementType  destType 
)

Convert all packed colour values (VET_COLOUR_*) in buffers used to another type.

Parameters
srcTypeThe source colour type to assume if the ambiguous VET_COLOUR is encountered.
destTypeThe destination colour type, must be VET_COLOUR_ABGR or VET_COLOUR_ARGB.
IdType Ogre::IdObject::getId ( ) const
inlineinherited

Get the unique id of this object.

Definition at line 74 of file OgreId.h.

template<class Alloc >
void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr)
inlineinherited

Definition at line 96 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr,
void *   
)
inlineinherited

Definition at line 102 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr,
const char *  ,
int  ,
const char *   
)
inlineinherited

Definition at line 108 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr)
inlineinherited

Definition at line 113 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr,
const char *  ,
int  ,
const char *   
)
inlineinherited

Definition at line 119 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void* Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz,
const char *  file,
int  line,
const char *  func 
)
inlineinherited

operator new, with debug line info

Definition at line 68 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void* Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz)
inlineinherited

Definition at line 73 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void* Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz,
void *  ptr 
)
inlineinherited

placement operator new

Definition at line 79 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz,
const char *  file,
int  line,
const char *  func 
)
inlineinherited

array operator new, with debug line info

Definition at line 86 of file OgreMemoryAllocatedObject.h.

template<class Alloc >
void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz)
inlineinherited

Definition at line 91 of file OgreMemoryAllocatedObject.h.

bool Ogre::IdObject::operator() ( const IdObject left,
const IdObject right 
)
inlineinherited

Definition at line 76 of file OgreId.h.

References Ogre::IdObject::mId.

bool Ogre::IdObject::operator() ( const IdObject left,
const IdObject right 
)
inlineinherited

Definition at line 81 of file OgreId.h.

References Ogre::IdObject::mId.

VertexData& Ogre::VertexData::operator= ( const VertexData rhs)
private

Protected operator=, to prevent misuse.

void Ogre::VertexData::prepareForShadowVolume ( void  )

Modifies the vertex data to be suitable for use for rendering shadow geometry.

Remarks
Preparing vertex data to generate a shadow volume involves firstly ensuring that the vertex buffer containing the positions is a standalone vertex buffer, with no other components in it. This method will therefore break apart any existing vertex buffers if position is sharing a vertex buffer. Secondly, it will double the size of this vertex buffer so that there are 2 copies of the position data for the mesh. The first half is used for the original, and the second half is used for the 'extruded' version. The vertex count used to render will remain the same though, so as not to add any overhead to regular rendering of the object. Both copies of the position are required in one buffer because shadow volumes stretch from the original mesh to the extruded version.
It's important to appreciate that this method can fundamentally change the structure of your vertex buffers, although in reality they will be new buffers. As it happens, if other objects are using the original buffers then they will be unaffected because the reference counting will keep them intact. However, if you have made any assumptions about the structure of the vertex data in the buffers of this object, you may have to rethink them.
void Ogre::VertexData::removeUnusedBuffers ( void  )

Remove all vertex buffers that never used by the vertex declaration.

Remarks
This is useful if you've removed elements from the vertex declaration and want to unreference buffers that never used any more. This method is mainly useful when reorganising vertex data manually.
Note
This also remove any gaps in the vertex buffer bindings.
void Ogre::VertexData::reorganiseBuffers ( VertexDeclaration newDeclaration,
const BufferUsageList bufferUsage,
HardwareBufferManagerBase mgr = 0 
)

Reorganises the data in the vertex buffers according to the new vertex declaration passed in.

Note that new vertex buffers are created and written to, so if the buffers being referenced by this vertex data object are also used by others, then the original buffers will not be damaged by this operation. Once this operation has completed, the new declaration passed in will overwrite the current one.

Parameters
newDeclarationThe vertex declaration which will be used for the reorganised buffer state. Note that the new declaration must not include any elements which do not already exist in the current declaration; you can drop elements by excluding them from the declaration if you wish, however.
bufferUsageVector of usage flags which indicate the usage options for each new vertex buffer created. The indexes of the entries must correspond to the buffer binding values referenced in the declaration.
mgrOptional pointer to the manager to use to create new declarations and buffers etc. If not supplied, the HardwareBufferManager singleton will be used
void Ogre::VertexData::reorganiseBuffers ( VertexDeclaration newDeclaration,
HardwareBufferManagerBase mgr = 0 
)

Reorganises the data in the vertex buffers according to the new vertex declaration passed in.

Note that new vertex buffers are created and written to, so if the buffers being referenced by this vertex data object are also used by others, then the original buffers will not be damaged by this operation. Once this operation has completed, the new declaration passed in will overwrite the current one. This version of the method derives the buffer usages from the existing buffers, by using the 'most flexible' usage from the equivalent sources.

Parameters
newDeclarationThe vertex declaration which will be used for the reorganised buffer state. Note that the new delcaration must not include any elements which do not already exist in the current declaration; you can drop elements by excluding them from the declaration if you wish, however.
mgrOptional pointer to the manager to use to create new declarations and buffers etc. If not supplied, the HardwareBufferManager singleton will be used

Member Data Documentation

HardwareVertexBufferSharedPtr Ogre::VertexData::hardwareShadowVolWBuffer

Additional shadow volume vertex buffer storage.

Remarks
This additional buffer is only used where we have prepared this VertexData for use in shadow volume construction, and where the current render system supports vertex programs. This buffer contains the 'w' vertex position component which will be used by that program to differentiate between extruded and non-extruded vertices. This 'w' component cannot be included in the original position buffer because DirectX does not allow 4-component positions in the fixed-function pipeline, and the original position buffer must still be usable for fixed-function rendering.
Note that we don't store any vertex declaration or vertex buffer binding here because this can be reused in the shadow algorithm.

Definition at line 147 of file OgreVertexIndexData.h.

HardwareAnimationDataList Ogre::VertexData::hwAnimationDataList

VertexElements used for hardware morph / pose animation.

Definition at line 102 of file OgreVertexIndexData.h.

size_t Ogre::VertexData::hwAnimDataItemsUsed

Number of hardware animation data items used.

Definition at line 104 of file OgreVertexIndexData.h.

bool Ogre::VertexData::mDeleteDclBinding

Whether this class should delete the declaration and binding.

Definition at line 87 of file OgreVertexIndexData.h.

HardwareBufferManagerBase* Ogre::VertexData::mMgr
private

Definition at line 58 of file OgreVertexIndexData.h.

VertexBufferBinding* Ogre::VertexData::vertexBufferBinding

The vertex buffer bindings to be used.

Remarks
Note that this is created for you on construction.

Definition at line 85 of file OgreVertexIndexData.h.

size_t Ogre::VertexData::vertexCount

The number of vertices used in this operation.

Definition at line 91 of file OgreVertexIndexData.h.

VertexDeclaration* Ogre::VertexData::vertexDeclaration

Declaration of the vertex to be used in this operation.

Remarks
Note that this is created for you on construction.

Definition at line 81 of file OgreVertexIndexData.h.

size_t Ogre::VertexData::vertexStart

The base vertex index to start from.

Definition at line 89 of file OgreVertexIndexData.h.


The documentation for this class was generated from the following file: