Specialisation of VertexDeclaration for OpenGL ES 2 Vertex Array Object usage. More...

#include <OgreGLES2VertexDeclaration.h>

Inheritance diagram for Ogre::v1::GLES2VertexDeclaration:

Public Types
typedef list< VertexElement >::type	VertexElementList
	Defines the list of vertex elements that makes up this declaration. More...

Public Member Functions
	GLES2VertexDeclaration ()

	~GLES2VertexDeclaration ()

uint16	_getInputLayoutId (void) const

bool	_isInputLayoutDirty (void) const

void	_setInputLayoutId (uint8 layoutId)

virtual const VertexElement &	addElement (unsigned short source, size_t offset, VertexElementType theType, VertexElementSemantic semantic, unsigned short index=0)
	Adds a new VertexElement to this declaration. More...

void	bind (void)

virtual VertexDeclaration *	clone (HardwareBufferManagerBase *mgr=0) const
	Clones this declaration. More...

void	closeGapsInSource (void)
	Remove any gaps in the source buffer list used by this declaration. More...

void	convertFromV2 (const VertexElement2Vec &v2Decl)

void	convertFromV2 (const VertexElement2VecVec &v2Decl)

VertexElement2VecVec	convertToV2 (void)

virtual const VertexElement *	findElementBySemantic (VertexElementSemantic sem, unsigned short index=0) const
	Finds a VertexElement with the given semantic, and index if there is more than one element with the same semantic. More...

virtual VertexElementList	findElementsBySource (unsigned short source) const
	Based on the current elements, gets the size of the vertex for a given buffer source. More...

VertexDeclaration *	getAutoOrganisedDeclaration (bool skeletalAnimation, bool vertexAnimation, bool vertexAnimationNormals) const
	Generates a new VertexDeclaration for optimal usage based on the current vertex declaration, which can be used with VertexData::reorganiseBuffers later if you wish, or simply used as a template. More...

const VertexElement *	getElement (unsigned short index) const
	Get a single element. More...

size_t	getElementCount (void) const
	Get the number of elements in the declaration. More...

const VertexElementList &	getElements (void) const
	Gets read-only access to the list of vertex elements. More...

uint8	getInputLayoutId (void) const

unsigned short	getMaxSource (void) const
	Gets the index of the highest source value referenced by this declaration. More...

virtual unsigned short	getNextFreeTextureCoordinate () const
	Return the index of the next free texture coordinate set which may be added to this declaration. More...

virtual size_t	getVertexSize (unsigned short source) const
	Gets the vertex size defined by this declaration for a given source. More...

virtual const VertexElement &	insertElement (unsigned short atPosition, unsigned short source, size_t offset, VertexElementType theType, VertexElementSemantic semantic, unsigned short index=0)
	Inserts a new VertexElement at a given position in this declaration. More...

bool	isInitialised (void)

bool	isSortedForV2 (void) const

virtual void	modifyElement (unsigned short elem_index, unsigned short source, size_t offset, VertexElementType theType, VertexElementSemantic semantic, unsigned short index=0)
	Modify an element in-place, params as addElement. More...

void	operator delete (void *ptr)

void	operator delete (void ptr, const char , int, const char *)

void	operator delete (void ptr, void )

void	operator delete[] (void *ptr)

void	operator delete[] (void ptr, const char , int, const char *)

void *	operator new (size_t sz)

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 *ptr)
	placement operator new More...

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info More...

bool	operator!= (const VertexDeclaration &rhs) const

bool	operator== (const VertexDeclaration &rhs) const

virtual void	removeAllElements (void)
	Remove all elements. More...

virtual void	removeElement (unsigned short elem_index)
	Remove the element at the given index from this declaration. More...

virtual void	removeElement (VertexElementSemantic semantic, unsigned short index=0)
	Remove the element with the given semantic and usage index. More...

void	setInitialised (bool flag)

void	sort (void)
	Sorts the elements in this list to be compatible with the maximum number of rendering APIs / graphics cards. More...

void	sortForV2 (void)

Static Public Member Functions
static bool	vertexElementLess (const VertexElement &e1, const VertexElement &e2)
	Sort routine for vertex elements. More...

static bool	vertexElementLessForV2 (const VertexElement &e1, const VertexElement &e2)

Detailed Description

Specialisation of VertexDeclaration for OpenGL ES 2 Vertex Array Object usage.

Member Typedef Documentation

◆ VertexElementList

typedef list<VertexElement>::type Ogre::v1::VertexDeclaration::VertexElementList

inherited

Defines the list of vertex elements that makes up this declaration.

Constructor & Destructor Documentation

◆ GLES2VertexDeclaration()

Ogre::v1::GLES2VertexDeclaration::GLES2VertexDeclaration ( )

◆ ~GLES2VertexDeclaration()

Ogre::v1::GLES2VertexDeclaration::~GLES2VertexDeclaration ( )

Member Function Documentation

◆ _getInputLayoutId()

uint16 Ogre::v1::VertexDeclaration::_getInputLayoutId ( void ) const

inherited

◆ _isInputLayoutDirty()

bool Ogre::v1::VertexDeclaration::_isInputLayoutDirty ( void ) const

inherited

◆ _setInputLayoutId()

void Ogre::v1::VertexDeclaration::_setInputLayoutId ( uint8 layoutId )

inherited

◆ addElement()

virtual const VertexElement& Ogre::v1::VertexDeclaration::addElement	(	unsigned short	source,
		size_t	offset,
		VertexElementType	theType,
		VertexElementSemantic	semantic,
		unsigned short	index = `0`
	)

virtualinherited

Adds a new VertexElement to this declaration.

Remarks: This method adds a single element (positions, normals etc) to the end of the vertex declaration. Please read the information in VertexDeclaration about the importance of ordering and structure for compatibility with older D3D drivers.

Parameters

source	The binding index of HardwareVertexBuffer which will provide the source for this element. See VertexBufferBinding for full information.
offset	The offset in bytes where this element is located in the buffer
theType	The data format of the element (3 floats, a colour etc)
semantic	The meaning of the data (position, normal, diffuse colour etc)
index	Optional index for multi-input elements like texture coordinates

Returns: A reference to the VertexElement added.

◆ bind()

void Ogre::v1::GLES2VertexDeclaration::bind ( void )

◆ clone()

virtual VertexDeclaration* Ogre::v1::VertexDeclaration::clone ( HardwareBufferManagerBase * mgr = 0 ) const

virtualinherited

Clones this declaration.

Parameters

mgr	Optional HardwareBufferManager to use for creating the clone (if null, use the current default).

◆ closeGapsInSource()

void Ogre::v1::VertexDeclaration::closeGapsInSource ( void )

inherited

Remove any gaps in the source buffer list used by this declaration.

Remarks: This is useful if you've modified a declaration and want to remove any gaps in the list of buffers being used. Note, however, that if this declaration is already being used with a VertexBufferBinding, you will need to alter that too. This method is mainly useful when reorganising buffers based on an altered declaration.

Note: This will cause the vertex declaration to be re-sorted.

◆ convertFromV2() [1/2]

void Ogre::v1::VertexDeclaration::convertFromV2 ( const VertexElement2Vec & v2Decl )

inherited

◆ convertFromV2() [2/2]

void Ogre::v1::VertexDeclaration::convertFromV2 ( const VertexElement2VecVec & v2Decl )

inherited

◆ convertToV2()

VertexElement2VecVec Ogre::v1::VertexDeclaration::convertToV2 ( void )

inherited

◆ findElementBySemantic()

virtual const VertexElement* Ogre::v1::VertexDeclaration::findElementBySemantic	(	VertexElementSemantic	sem,
		unsigned short	index = `0`
	)		const

virtualinherited

Finds a VertexElement with the given semantic, and index if there is more than one element with the same semantic.

Remarks: If the element is not found, this method returns null.

◆ findElementsBySource()

virtual VertexElementList Ogre::v1::VertexDeclaration::findElementsBySource ( unsigned short source ) const

virtualinherited

Based on the current elements, gets the size of the vertex for a given buffer source.

Parameters

source The buffer binding index for which to get the vertex size. Gets a list of elements which use a given source.

Remarks: Note that the list of elements is returned by value therefore is separate from the declaration as soon as this method returns.

◆ getAutoOrganisedDeclaration()

VertexDeclaration* Ogre::v1::VertexDeclaration::getAutoOrganisedDeclaration	(	bool	skeletalAnimation,
		bool	vertexAnimation,
		bool	vertexAnimationNormals
	)		const

inherited

Generates a new VertexDeclaration for optimal usage based on the current vertex declaration, which can be used with VertexData::reorganiseBuffers later if you wish, or simply used as a template.

Remarks: Different buffer organisations and buffer usages will be returned depending on the parameters passed to this method.

Parameters

skeletalAnimation	Whether this vertex data is going to be skeletally animated
vertexAnimation	Whether this vertex data is going to be vertex animated
vertexAnimationNormals	Whether vertex data animation is going to include normals animation

◆ getElement()

const VertexElement* Ogre::v1::VertexDeclaration::getElement ( unsigned short index ) const

inherited

Get a single element.

◆ getElementCount()

size_t Ogre::v1::VertexDeclaration::getElementCount ( void ) const

inlineinherited

Get the number of elements in the declaration.

◆ getElements()

const VertexElementList& Ogre::v1::VertexDeclaration::getElements ( void ) const

inherited

Gets read-only access to the list of vertex elements.

◆ getInputLayoutId()

uint8 Ogre::v1::VertexDeclaration::getInputLayoutId ( void ) const

inherited

◆ getMaxSource()

unsigned short Ogre::v1::VertexDeclaration::getMaxSource ( void ) const

inherited

Gets the index of the highest source value referenced by this declaration.

◆ getNextFreeTextureCoordinate()

virtual unsigned short Ogre::v1::VertexDeclaration::getNextFreeTextureCoordinate ( ) const

virtualinherited

Return the index of the next free texture coordinate set which may be added to this declaration.

◆ getVertexSize()

virtual size_t Ogre::v1::VertexDeclaration::getVertexSize ( unsigned short source ) const

virtualinherited

Gets the vertex size defined by this declaration for a given source.

◆ insertElement()

virtual const VertexElement& Ogre::v1::VertexDeclaration::insertElement	(	unsigned short	atPosition,
		unsigned short	source,
		size_t	offset,
		VertexElementType	theType,
		VertexElementSemantic	semantic,
		unsigned short	index = `0`
	)

virtualinherited

Inserts a new VertexElement at a given position in this declaration.

Remarks: This method adds a single element (positions, normals etc) at a given position in this vertex declaration. Please read the information in VertexDeclaration about the importance of ordering and structure for compatibility with older D3D drivers.

Parameters

source	The binding index of HardwareVertexBuffer which will provide the source for this element. See VertexBufferBinding for full information.
offset	The offset in bytes where this element is located in the buffer
theType	The data format of the element (3 floats, a colour etc)
semantic	The meaning of the data (position, normal, diffuse colour etc)
index	Optional index for multi-input elements like texture coordinates

Returns: A reference to the VertexElement added.

◆ isInitialised()

bool Ogre::v1::GLES2VertexDeclaration::isInitialised ( void )

inline

◆ isSortedForV2()

bool Ogre::v1::VertexDeclaration::isSortedForV2 ( void ) const

inherited

◆ modifyElement()

virtual void Ogre::v1::VertexDeclaration::modifyElement	(	unsigned short	elem_index,
		unsigned short	source,
		size_t	offset,
		VertexElementType	theType,
		VertexElementSemantic	semantic,
		unsigned short	index = `0`
	)

virtualinherited

Modify an element in-place, params as addElement.

Remarks: Please read the information in VertexDeclaration about the importance of ordering and structure for compatibility with older D3D drivers.

◆ operator delete() [1/3]

template<class Alloc >

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

inlineinherited

◆ operator delete() [2/3]

template<class Alloc >

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

inlineinherited

◆ operator delete() [3/3]

template<class Alloc >

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

inlineinherited

◆ operator delete[]() [1/2]

template<class Alloc >

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

inlineinherited

◆ operator delete[]() [2/2]

template<class Alloc >

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

inlineinherited

◆ operator new() [1/3]

template<class Alloc >

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

inlineinherited

◆ operator new() [2/3]

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

◆ operator new() [3/3]

template<class Alloc >

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

inlineinherited

placement operator new

◆ operator new[]() [1/2]

template<class Alloc >

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

inlineinherited

◆ operator new[]() [2/2]

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

◆ operator!=()

bool Ogre::v1::VertexDeclaration::operator!= ( const VertexDeclaration & rhs ) const

inlineinherited

◆ operator==()

bool Ogre::v1::VertexDeclaration::operator== ( const VertexDeclaration & rhs ) const

inlineinherited

◆ removeAllElements()

virtual void Ogre::v1::VertexDeclaration::removeAllElements ( void )

virtualinherited

Remove all elements.

◆ removeElement() [1/2]

virtual void Ogre::v1::VertexDeclaration::removeElement ( unsigned short elem_index )

virtualinherited

Remove the element at the given index from this declaration.

◆ removeElement() [2/2]

virtual void Ogre::v1::VertexDeclaration::removeElement	(	VertexElementSemantic	semantic,
		unsigned short	index = `0`
	)

virtualinherited

Remove the element with the given semantic and usage index.

Remarks: In this case 'index' means the usage index for repeating elements such as texture coordinates. For other elements this will always be 0 and does not refer to the index in the vector.

◆ setInitialised()

void Ogre::v1::GLES2VertexDeclaration::setInitialised ( bool flag )

inline

◆ sort()

void Ogre::v1::VertexDeclaration::sort ( void )

inherited

Sorts the elements in this list to be compatible with the maximum number of rendering APIs / graphics cards.

Remarks: Older graphics cards require vertex data to be presented in a more rigid way, as defined in the main documentation for this class. As well as the ordering being important, where shared source buffers are used, the declaration must list all the elements for each source in turn.

◆ sortForV2()

void Ogre::v1::VertexDeclaration::sortForV2 ( void )

inherited

◆ vertexElementLess()

static bool Ogre::v1::VertexDeclaration::vertexElementLess	(	const VertexElement &	e1,
		const VertexElement &	e2
	)

staticinherited

Sort routine for vertex elements.

◆ vertexElementLessForV2()

static bool Ogre::v1::VertexDeclaration::vertexElementLessForV2	(	const VertexElement &	e1,
		const VertexElement &	e2
	)

staticinherited

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

OgreGLES2VertexDeclaration.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ VertexElementList

Constructor & Destructor Documentation

◆ GLES2VertexDeclaration()

◆ ~GLES2VertexDeclaration()

Member Function Documentation

◆ _getInputLayoutId()

◆ _isInputLayoutDirty()

◆ _setInputLayoutId()

◆ addElement()

◆ bind()

◆ clone()

◆ closeGapsInSource()

◆ convertFromV2() [1/2]

◆ convertFromV2() [2/2]

◆ convertToV2()

◆ findElementBySemantic()

◆ findElementsBySource()

◆ getAutoOrganisedDeclaration()

◆ getElement()

◆ getElementCount()

◆ getElements()

◆ getInputLayoutId()

◆ getMaxSource()

◆ getNextFreeTextureCoordinate()

◆ getVertexSize()

◆ insertElement()

◆ isInitialised()

◆ isSortedForV2()

◆ modifyElement()

◆ operator delete() [1/3]

◆ operator delete() [2/3]

◆ operator delete() [3/3]

◆ operator delete[]() [1/2]

◆ operator delete[]() [2/2]

◆ operator new() [1/3]

◆ operator new() [2/3]

◆ operator new() [3/3]

◆ operator new[]() [1/2]

◆ operator new[]() [2/2]

◆ operator!=()

◆ operator==()

◆ removeAllElements()

◆ removeElement() [1/2]

◆ removeElement() [2/2]

◆ setInitialised()

◆ sort()

◆ sortForV2()

◆ vertexElementLess()

◆ vertexElementLessForV2()