Defines a part of a complete mesh. More...

#include <OgreSubMesh.h>

Inheritance diagram for Ogre::v1::SubMesh:

Public Types
typedef ConstMapIterator< AliasTextureNamePairList >	AliasTextureIterator

typedef MapIterator< VertexBoneAssignmentList >	BoneAssignmentIterator

typedef FastArray< unsigned short >	IndexMap
	Dedicated index map for translate blend index to bone index (only valid if useSharedVertices = false). More...

typedef vector< IndexData * >::type	LODFaceList

typedef multimap< size_t, VertexBoneAssignment >::type	VertexBoneAssignmentList
	Multimap of verex bone assignments (orders by vertex index) More...

Public Member Functions
	SubMesh ()

	~SubMesh ()

void	_compileBoneAssignments (void)
	Must be called once to compile bone assignments into geometry buffer. More...

void	_getRenderOperation (RenderOperation &rend, ushort lodIndex, bool casterPass)
	Returns a RenderOperation structure required to render this mesh. More...

void	addBoneAssignment (const VertexBoneAssignment &vertBoneAssign)
	Assigns a vertex to a bone with a given weight, for skeletal animation. More...

void	addTextureAlias (const String &aliasName, const String &textureName)
	Adds the alias or replaces an existing one and associates the texture name to it. More...

void	arrangeEfficient (bool halfPos, bool halfTexCoords, bool qTangents)

void	clearBoneAssignments (void)
	Removes all bone assignments for this mesh. More...

SubMesh *	clone (const String &newName, Mesh *parentMesh=0)
	Makes a copy of this submesh object and gives it a new name. More...

void	dearrangeToInefficient (void)

void	generateExtremes (size_t count)
	Generate the submesh extremes (. More...

AliasTextureIterator	getAliasTextureIterator (void) const
	Gets an constant iterator to access all texture alias names assigned to this submesh. More...

BoneAssignmentIterator	getBoneAssignmentIterator (void)
	Gets an iterator for access all bone assignments. More...

const VertexBoneAssignmentList &	getBoneAssignments ()
	Gets a const reference to the list of bone assignments. More...

const String &	getMaterialName (void) const

size_t	getTextureAliasCount (void) const
	Gets the number of texture aliases assigned to the sub mesh. More...

bool	getVertexAnimationIncludesNormals () const
	Returns whether animation on dedicated vertex data includes normals. More...

VertexAnimationType	getVertexAnimationType (void) const
	Get the type of any vertex animation used by dedicated geometry. More...

bool	hasTextureAliases (void) const
	returns true if the sub mesh has texture aliases More...

void	importFromV2 (Ogre::SubMesh *subMesh)
	Imports a v2 SubMesh Mesh::importV2. More...

bool	isBuildEdgesEnabled (void) const
	Returns true(by default) if the submesh should be included in the mesh EdgeList, otherwise returns false. More...

bool	isMatInitialised (void) const
	Returns true if a material has been assigned to the submesh, otherwise returns false. 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)

void	removeAllTextureAliases (void)
	removes all texture aliases from the sub mesh More...

void	removeTextureAlias (const String &aliasName)
	Remove a specific texture alias name from the sub mesh. More...

void	setBuildEdgesEnabled (bool b)

void	setMaterialName (const String &matName, const String &groupName=ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME)
	Sets the name of the Material which this SubMesh will use. More...

bool	updateMaterialUsingTextureAliases (void)
	The current material used by the submesh is copied into a new material and the submesh's texture aliases are applied if the current texture alias names match those found in the original material. More...

Public Attributes
IndexMap	blendIndexToBoneIndexMap

vector< Vector3 >::type	extremityPoints
	A list of extreme points on the submesh (optional). More...

IndexData *	indexData [NumVertexPass]
	Face index data. More...

LODFaceList	mLodFaceList [NumVertexPass]

OperationType	operationType
	The render operation type used to render this submesh. More...

Mesh *	parent
	Reference to parent Mesh (not a smart pointer so child does not keep parent alive). More...

uint32	renderOpMeshIndex

bool	useSharedVertices
	Indicates if this submesh shares vertex data with other meshes or whether it has it's own vertices. More...

VertexData *	vertexData [NumVertexPass]
	Dedicated vertex data (only valid if useSharedVertices = false). More...

Friends
class	Mesh

class	MeshSerializerImpl

class	MeshSerializerImpl_v1_1

class	MeshSerializerImpl_v1_2

Detailed Description

Defines a part of a complete mesh.

Remarks: Meshes which make up the definition of a discrete 3D object are made up of potentially multiple parts. This is because different parts of the mesh may use different materials or use different vertex formats, such that a rendering state change is required between them.

: Like the Mesh class, instantiations of 3D objects in the scene share the SubMesh instances, and have the option of overriding their material differences on a per-object basis if required. See the SubEntity class for more information.

Member Typedef Documentation

◆ AliasTextureIterator

typedef ConstMapIterator<AliasTextureNamePairList> Ogre::v1::SubMesh::AliasTextureIterator

◆ BoneAssignmentIterator

typedef MapIterator<VertexBoneAssignmentList> Ogre::v1::SubMesh::BoneAssignmentIterator

◆ IndexMap

typedef FastArray<unsigned short> Ogre::v1::SubMesh::IndexMap

Dedicated index map for translate blend index to bone index (only valid if useSharedVertices = false).

Remarks: This data is completely owned by this submesh.

: We collect actually used bones of all bone assignments, and build the blend index in 'packed' form, then the range of the blend index in vertex data VES_BLEND_INDICES element is continuous, with no gaps. Thus, by minimising the world matrix array constants passing to GPU, we can support more bones for a mesh when hardware skinning is used. The hardware skinning support limit is applied to each set of vertex data in the mesh, in other words, the hardware skinning support limit is applied only to the actually used bones of each SubMeshes, not all bones across the entire Mesh.

: Because the blend index is different to the bone index, therefore, we use the index map to translate the blend index to bone index.

: The use of shared or non-shared index map is determined when model data is converted to the OGRE .mesh format.

◆ LODFaceList

typedef vector<IndexData*>::type Ogre::v1::SubMesh::LODFaceList

◆ VertexBoneAssignmentList

typedef multimap<size_t, VertexBoneAssignment>::type Ogre::v1::SubMesh::VertexBoneAssignmentList

Multimap of verex bone assignments (orders by vertex index)

Constructor & Destructor Documentation

◆ SubMesh()

Ogre::v1::SubMesh::SubMesh ( )

◆ ~SubMesh()

Ogre::v1::SubMesh::~SubMesh ( )

Member Function Documentation

◆ _compileBoneAssignments()

void Ogre::v1::SubMesh::_compileBoneAssignments ( void )

Must be called once to compile bone assignments into geometry buffer.

◆ _getRenderOperation()

void Ogre::v1::SubMesh::_getRenderOperation	(	RenderOperation &	rend,
		ushort	lodIndex,
		bool	casterPass
	)

Returns a RenderOperation structure required to render this mesh.

Parameters

rend	Reference to a RenderOperation structure to populate.
lodIndex	The index of the LOD to use.

◆ addBoneAssignment()

void Ogre::v1::SubMesh::addBoneAssignment ( const VertexBoneAssignment & vertBoneAssign )

Assigns a vertex to a bone with a given weight, for skeletal animation.

Remarks: This method is only valid after calling setSkeletonName. Since this is a one-off process there exists only 'addBoneAssignment' and 'clearBoneAssignments' methods, no 'editBoneAssignment'. You should not need to modify bone assignments during rendering (only the positions of bones) and OGRE reserves the right to do some internal data reformatting of this information, depending on render system requirements.

: This method is for assigning weights to the dedicated geometry of the SubMesh. To assign weights to the shared Mesh geometry, see the equivalent methods on Mesh.

◆ addTextureAlias()

void Ogre::v1::SubMesh::addTextureAlias	(	const String &	aliasName,
		const String &	textureName
	)

Adds the alias or replaces an existing one and associates the texture name to it.

Remarks: The submesh uses the texture alias to replace textures used in the material applied to the submesh.

Parameters

aliasName	is the name of the alias.
textureName	is the name of the texture to be associated with the alias

◆ arrangeEfficient()

void Ogre::v1::SubMesh::arrangeEfficient	(	bool	halfPos,
		bool	halfTexCoords,
		bool	qTangents
	)

◆ clearBoneAssignments()

void Ogre::v1::SubMesh::clearBoneAssignments ( void )

Removes all bone assignments for this mesh.

: This method is for assigning weights to the dedicated geometry of the SubMesh. To assign weights to the shared Mesh geometry, see the equivalent methods on Mesh.

◆ clone()

SubMesh* Ogre::v1::SubMesh::clone	(	const String &	newName,
		Mesh *	parentMesh = `0`
	)

Makes a copy of this submesh object and gives it a new name.

Parameters

newName	The name to give the clone.
parentMesh	Optional mesh to make the parent of the newly created clone. If you leave this blank, the clone will be parented to the same Mesh as the original.

◆ dearrangeToInefficient()

void Ogre::v1::SubMesh::dearrangeToInefficient ( void )

◆ generateExtremes()

void Ogre::v1::SubMesh::generateExtremes ( size_t count )

Generate the submesh extremes (.

See also: extremityPoints).

Parameters

count Number of extreme points to compute for the submesh.

◆ getAliasTextureIterator()

AliasTextureIterator Ogre::v1::SubMesh::getAliasTextureIterator ( void ) const

Gets an constant iterator to access all texture alias names assigned to this submesh.

◆ getBoneAssignmentIterator()

BoneAssignmentIterator Ogre::v1::SubMesh::getBoneAssignmentIterator ( void )

Gets an iterator for access all bone assignments.

Remarks: Only valid if this SubMesh has dedicated geometry.

◆ getBoneAssignments()

const VertexBoneAssignmentList& Ogre::v1::SubMesh::getBoneAssignments ( )

inline

Gets a const reference to the list of bone assignments.

◆ getMaterialName()

const String& Ogre::v1::SubMesh::getMaterialName ( void ) const

◆ getTextureAliasCount()

size_t Ogre::v1::SubMesh::getTextureAliasCount ( void ) const

inline

Gets the number of texture aliases assigned to the sub mesh.

◆ getVertexAnimationIncludesNormals()

bool Ogre::v1::SubMesh::getVertexAnimationIncludesNormals ( ) const

inline

Returns whether animation on dedicated vertex data includes normals.

◆ getVertexAnimationType()

VertexAnimationType Ogre::v1::SubMesh::getVertexAnimationType ( void ) const

Get the type of any vertex animation used by dedicated geometry.

◆ hasTextureAliases()

bool Ogre::v1::SubMesh::hasTextureAliases ( void ) const

inline

returns true if the sub mesh has texture aliases

◆ importFromV2()

void Ogre::v1::SubMesh::importFromV2 ( Ogre::SubMesh * subMesh )

Imports a v2 SubMesh Mesh::importV2.

◆ isBuildEdgesEnabled()

bool Ogre::v1::SubMesh::isBuildEdgesEnabled ( void ) const

inline

Returns true(by default) if the submesh should be included in the mesh EdgeList, otherwise returns false.

◆ isMatInitialised()

bool Ogre::v1::SubMesh::isMatInitialised ( void ) const

Returns true if a material has been assigned to the submesh, otherwise returns false.

◆ 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,
		void *
	)

inlineinherited

◆ operator delete() [3/3]

template<class Alloc >

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

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,
		const char *	file,
		int	line,
		const char *	func
	)

inlineinherited

operator new, with debug line info

◆ operator new() [2/3]

template<class Alloc >

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

inlineinherited

◆ 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,
		const char *	file,
		int	line,
		const char *	func
	)

inlineinherited

array operator new, with debug line info

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

template<class Alloc >

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

inlineinherited

◆ removeAllTextureAliases()

void Ogre::v1::SubMesh::removeAllTextureAliases ( void )

removes all texture aliases from the sub mesh

◆ removeTextureAlias()

void Ogre::v1::SubMesh::removeTextureAlias ( const String & aliasName )

Remove a specific texture alias name from the sub mesh.

Parameters

aliasName is the name of the alias to be removed. If it is not found then it is ignored.

◆ setBuildEdgesEnabled()

void Ogre::v1::SubMesh::setBuildEdgesEnabled ( bool b )

◆ setMaterialName()

void Ogre::v1::SubMesh::setMaterialName	(	const String &	matName,
		const String &	groupName = `ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME`
	)

Sets the name of the Material which this SubMesh will use.

◆ updateMaterialUsingTextureAliases()

bool Ogre::v1::SubMesh::updateMaterialUsingTextureAliases ( void )

The current material used by the submesh is copied into a new material and the submesh's texture aliases are applied if the current texture alias names match those found in the original material.

Remarks: The submesh's texture aliases must be setup prior to calling this method. If a new material has to be created, the subMesh autogenerates the new name. The new name is the old name + "_" + number.

Returns: True if texture aliases were applied and a new material was created.

Friends And Related Function Documentation

◆ Mesh

friend class Mesh

friend

◆ MeshSerializerImpl

friend class MeshSerializerImpl

friend

◆ MeshSerializerImpl_v1_1

friend class MeshSerializerImpl_v1_1

friend

◆ MeshSerializerImpl_v1_2

friend class MeshSerializerImpl_v1_2

friend

Member Data Documentation

◆ blendIndexToBoneIndexMap

IndexMap Ogre::v1::SubMesh::blendIndexToBoneIndexMap

◆ extremityPoints

vector<Vector3>::type Ogre::v1::SubMesh::extremityPoints

A list of extreme points on the submesh (optional).

Remarks: These points are some arbitrary points on the mesh that are used by engine to better sort submeshes by depth. This doesn't matter much for non-transparent submeshes, as Z-buffer takes care of invisible surface culling anyway, but is pretty useful for semi-transparent submeshes because the order in which transparent submeshes must be rendered cannot be always correctly deduced from entity position.

: These points are intelligently chosen from the points that make up the submesh, the criteria for choosing them should be that these points somewhat characterize the submesh outline, e.g. they should not be close to each other, and they should be on the outer hull of the submesh. They can be stored in the .mesh file, or generated at runtime (see generateExtremes ()).

: If this array is empty, submesh sorting is done like in older versions - by comparing the positions of the owning entity.

◆ indexData

IndexData* Ogre::v1::SubMesh::indexData[NumVertexPass]

Face index data.

Referenced by Ogre::Lod0Stripifier::StripLod0Vertices().

◆ mLodFaceList

LODFaceList Ogre::v1::SubMesh::mLodFaceList[NumVertexPass]

Referenced by Ogre::Lod0Stripifier::StripLod0Vertices(), and Ogre::Lod0Stripifier::~Lod0Stripifier().

◆ operationType

OperationType Ogre::v1::SubMesh::operationType

The render operation type used to render this submesh.

◆ parent

Mesh* Ogre::v1::SubMesh::parent

Reference to parent Mesh (not a smart pointer so child does not keep parent alive).

◆ renderOpMeshIndex

uint32 Ogre::v1::SubMesh::renderOpMeshIndex

◆ useSharedVertices

bool Ogre::v1::SubMesh::useSharedVertices

Indicates if this submesh shares vertex data with other meshes or whether it has it's own vertices.

Referenced by Ogre::Lod0Stripifier::StripLod0Vertices(), and Ogre::Lod0Stripifier::~Lod0Stripifier().

◆ vertexData

VertexData* Ogre::v1::SubMesh::vertexData[NumVertexPass]

Dedicated vertex data (only valid if useSharedVertices = false).

[0] is for the regular pass, [1] is for the caster. Note that vertexData[0] = vertexData[1] is possible, but if one submesh has vertexData[0] = vertexData[1], then all submeshes in the mesh must have vertexData[0] = vertexData[1] as well for the sake of simplicity.

Remarks: This data is completely owned by this submesh.

: The use of shared or non-shared buffers is determined when model data is converted to the OGRE .mesh format.

Referenced by Ogre::Lod0Stripifier::StripLod0Vertices(), and Ogre::Lod0Stripifier::~Lod0Stripifier().

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

OgreSubMesh.h

Public Types

Public Member Functions

Public Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ AliasTextureIterator

◆ BoneAssignmentIterator

◆ IndexMap

◆ LODFaceList

◆ VertexBoneAssignmentList

Constructor & Destructor Documentation

◆ SubMesh()

◆ ~SubMesh()

Member Function Documentation

◆ _compileBoneAssignments()

◆ _getRenderOperation()

◆ addBoneAssignment()

◆ addTextureAlias()

◆ arrangeEfficient()

◆ clearBoneAssignments()

◆ clone()

◆ dearrangeToInefficient()

◆ generateExtremes()

◆ getAliasTextureIterator()

◆ getBoneAssignmentIterator()

◆ getBoneAssignments()

◆ getMaterialName()

◆ getTextureAliasCount()

◆ getVertexAnimationIncludesNormals()

◆ getVertexAnimationType()

◆ hasTextureAliases()

◆ importFromV2()

◆ isBuildEdgesEnabled()

◆ isMatInitialised()

◆ 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]

◆ removeAllTextureAliases()

◆ removeTextureAlias()

◆ setBuildEdgesEnabled()

◆ setMaterialName()

◆ updateMaterialUsingTextureAliases()

Friends And Related Function Documentation

◆ Mesh

◆ MeshSerializerImpl

◆ MeshSerializerImpl_v1_1

◆ MeshSerializerImpl_v1_2

Member Data Documentation

◆ blendIndexToBoneIndexMap

◆ extremityPoints

◆ indexData

◆ mLodFaceList

◆ operationType

◆ parent

◆ renderOpMeshIndex

◆ useSharedVertices

◆ vertexData