This reference page is linked to from the following overview topics: Geometry, Customizing the FBX SDK, Meshes, Materials and Textures, Nodes and the Scene Graph, Meshes, Supported Scene Elements, FBX SDK 2014, Using Python FBX with Eclipse, Instancing - Sharing a Mesh, Merging Two Scenes, Feature-Oriented Programs, Materials, Differences between FBX SDK and Python FBX, FBX Objects, FBX Nodes, List of Python Fbx classes, Connections, FBX Node Attributes, Layered Textures.

#include <fbxmesh.h>

Class Description

A mesh is a geometry made of polygons.

The class can define a geometry with as many n-sided polygons as needed. Users can freely mix triangles, quadrilaterals, and other polygons. Since the mesh-related terminology of the FBX SDK differs a little from the known standards, here are our definitions:

A control point is an XYZ coordinate, it is synonym of vertex.
A polygon vertex is an index to a control point (the same control point can be referenced by multiple polygon vertices).
A polygon is a group of polygon vertices. The minimum valid number of polygon vertices to define a polygon is 3.

Methods to initialize, set and access control points are provided in the FbxGeometryBase class.

Examples:: Common/GeometryUtility.cxx, ExportDocument/main.cxx, ExportScene03/main.cxx, ExportScene03/MyKFbxMesh.h, ImportScene/DisplayMesh.cxx, Instances/main.cxx, Layers/main.cxx, Normals/main.cxx, ProceduralTexture/main.cxx, SwitchBinding/main.cxx, UI_Examples/CubeCreator/SDK_Utility.cxx, UI_Examples/CubeCreator/SDK_Utility.h, UserProperties/main.cxx, UVSample/main.cxx, ViewScene/DrawScene.cxx, ViewScene/SceneCache.cxx, ViewScene/SceneCache.h, and ViewScene/SceneContext.cxx.

Definition at line 32 of file fbxmesh.h.

Inheritance diagram for FbxMesh:

List of all members.

Classes
struct	ComponentMap
class	DuplicateVertex
	Internal structure used to keep the duplicate vertex information. More...
struct	EdgeLookupDef
struct	PolygonDef
struct	PolygonIndexDef
struct	SplitEdgeData
struct	V2PVMap
class	VertexNormalInfo
	Internal structure used to compute the normals on a mesh. More...
Public Member Functions
virtual FbxNodeAttribute::EType	GetAttributeType () const
	Return the type of node attribute.
void	ReservePolygonCount (int pCount)
	Reserve memory in the polygon array to hold the specified number of polygons.
void	ReservePolygonVertexCount (int pCount)
	Reserve memory in the polygon vertex array to hold the specified number of polygon vertices.
bool	GetTextureUV (FbxLayerElementArrayTemplate< FbxVector2 > **pLockableArray, FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse) const
bool	GetMaterialIndices (FbxLayerElementArrayTemplate< int > **pLockableArray) const
bool	GetTextureIndices (FbxLayerElementArrayTemplate< int > **pLockableArray, FbxLayerElement::EType pTextureType) const
virtual FbxObject &	Copy (const FbxObject &pObject)
	Copy an object content into this object.
void	ComputeComponentMaps (ComponentMap &pEdgeToPolyMap, ComponentMap &pPolyToEdgeMap)
Public Attributes
FbxArray< PolygonDef >	mPolygons
FbxArray< int >	mPolygonVertices
FbxArray< int >	mEdgeArray
Protected Member Functions
virtual void	Construct (const FbxMesh *pFrom)
virtual void	Destruct (bool pRecursive)
	Optional destructor override, automatically called by default destructor.
void	InitTextureIndices (FbxLayerElementTexture *pLayerElementTexture, FbxLayerElement::EMappingMode pMappingMode)
void	RemoveTextureIndex (FbxLayerElementTexture *pLayerElementTextures, int pPolygonIndex, int pOffset)
void	RemoveUVIndex (FbxLayerElementUV *pLayerElementUV, int pPolygonIndex, int pOffset)
bool	GetBadPolyIndices (FbxArray< int > &pArrayBadPolyIndices, bool pCheckOne) const
int	FindPolygonIndex (int pEdgeIndex)
void	PolySetTexture (FbxLayer *pLayer, int pTextureIndex, FbxLayerElement::EType pTextureType)
template<class T >
bool	GetPolygonVertexLayerElementIndex (const FbxLayerElementTemplate< T > *pLayerElement, int pPolyIndex, int pVertexIndex, int &pIndex) const
template<class T >
bool	GetPolygonVertexLayerElementValue (const FbxLayerElementTemplate< T > *pLayerElement, int pPolyIndex, int pVertexIndex, T &pValue, bool pAllowUnmapped) const
Static Protected Member Functions
static int	PolygonIndexCompare (const void p1, const void p2)
Protected Attributes
ESmoothness	mSmoothness
int	mPreviewDivisionLevels
int	mRenderDivisionLevels
bool	mDisplaySubdivisions
EBoundaryRule	mBoundaryRule
bool	mPreserveBorders
bool	mPreserveHardEdges
bool	mPropagateEdgeHardness
struct FbxMesh::V2PVMap	mV2PVMap
struct FbxMesh::EdgeLookupDef	mPVEndFlags
Friends
class	FbxGeometryConverter
Polygon Management
void	BeginPolygon (int pMaterial=-1, int pTexture=-1, int pGroup=-1, bool pLegacy=true)
	Begins the process of adding a polygon to the mesh.
void	BeginPolygonExt (int pMaterial, int *pTextures)
	Begin writing a polygon.
void	AddPolygon (int pIndex, int pTextureUVIndex=-1)
	Add a polygon vertex to the current polygon.
void	EndPolygon ()
	End writing a polygon, it should be called after adding one polygon.
int	GetPolygonCount () const
	Get the polygon count of this mesh.
int	GetPolygonSize (int pPolygonIndex) const
	Get the number of polygon vertices in a polygon.
int	GetPolygonGroup (int pPolygonIndex) const
	Get the current group ID of the specified polygon.
void	SetPolygonGroup (int pPolygonIndex, int pGroup) const
	Assign the specified polygon a group ID.
int	GetPolygonVertex (int pPolygonIndex, int pPositionInPolygon) const
	Get a polygon vertex (i.e: an index to a control point).
bool	GetPolygonVertexNormal (int pPolyIndex, int pVertexIndex, FbxVector4 &pNormal) const
	Get the normal associated with the specified polygon vertex.
bool	GetPolygonVertexNormals (FbxArray< FbxVector4 > &pNormals) const
	Get the normals associated with the mesh for every polygon vertex.
bool	GetPolygonVertexUV (int pPolyIndex, int pVertexIndex, const char *pUVSetName, FbxVector2 &pUV, bool &pUnmapped) const
	Get the UV associated with the specified polygon vertex.
bool	GetPolygonVertexUVs (const char pUVSetName, FbxArray< FbxVector2 > &pUVs, FbxArray< int > pUnmappedUVId=NULL) const
	Get the UVs associated with the mesh for every polygon vertex.
int *	GetPolygonVertices () const
	Get the array of polygon vertices (i.e: indices to the control points).
int	GetPolygonVertexCount () const
	Gets the number of polygon vertices in the mesh.
int	GetPolygonVertexIndex (int pPolygonIndex) const
	Gets the start index into the array returned by GetPolygonVertices() for the given polygon.
int	RemovePolygon (int pPolygonIndex)
	Remove the specified polygon from the mesh.
int	RemoveDuplicatedEdges (FbxArray< int > &pEdgeIndexList)
	Remove the duplicated edges from the mesh.
Texture UV Utility Functions.
The methods found in this section are utility functions used to handle UV coordinates quickly. Internally, they refer to `FbxLayer` and `FbxLayerElementUV` methods to do the job. Except for the GetAllChannelUV(int pLayer), all the methods are implicitly working on Layer 0. Use the `FbxLayer` methods to have access to the other layers.
void	InitTextureUV (int pCount, FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Init texture UV coordinates.
void	AddTextureUV (FbxVector2 pUV, FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Add texture UV coordinates.
int	GetTextureUVCount (FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Get the number of texture UV coordinates.
int	GetUVLayerCount () const
	Get the number of layer containing at least one channel UVMap.
FbxArray< FbxLayerElement::EType >	GetAllChannelUV (int pLayer)
	Fills an array describing, for the given layer, which texture channel have UVs associated to it.
Material, Texture and UV Indices Utility Functions.
The methods found in this section are utility functions used to handle Material, Texture and UV indices quickly. Internally, they refer to `FbxLayer` and `FbxLayerElementUV` methods to do the job. These functions are only working on Layer 0. Use the `FbxLayer` methods directly to access other layers.
void	InitMaterialIndices (FbxLayerElement::EMappingMode pMappingMode)
	Initialize material indices.
void	InitTextureIndices (FbxLayerElement::EMappingMode pMappingMode, FbxLayerElement::EType pTextureType)
	Initialize texture indices.
void	InitTextureUVIndices (FbxLayerElement::EMappingMode pMappingMode, FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Initialize texture UV indices.
int	GetTextureUVIndex (int pPolygonIndex, int pPositionInPolygon, FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Get a texture UV index associated with a polygon vertex (i.e: an index to a control point).
void	SetTextureUVIndex (int pPolygonIndex, int pPositionInPolygon, int pIndex, FbxLayerElement::EType pTypeIdentifier)
	Set a texture UV index associated with a polygon vertex (i.e: an index to a control point).
Utility functions
void	Reset ()
	Reset the mesh to default values.
void	ComputeVertexNormals (bool pCW=false)
	Compute the vertex normals on the mesh.
bool	CheckIfVertexNormalsCCW ()
	Compares the normals calculated by doing cross-products between the polygon vertex and by the ones stored in the normal array.
bool	CheckSamePointTwice () const
	Verify if the mesh has polygons that are defined on the same point more than once.
int	RemoveBadPolygons ()
	Remove bad polygons from a mesh.
Point Splitting/Merging utility functions
bool	SplitPoints (FbxLayerElement::EType pTypeIdentifier=FbxLayerElement::eTextureDiffuse)
	Split points.
bool	BuildMergeList (FbxArray< int > &pMergeList, bool pExport=false)
	Insert the new indexes of the object that have to be merged.
void	MergePointsForPolygonVerteNormals (FbxArray< int > &pMergeList)
	Merge the points specified in the list.
Edge management functions
/** Automatically generate edge data for the mesh. Clears all previously stored edge information
void	BuildMeshEdgeArray ()
int	GetMeshEdgeCount () const
	Query the number of edges defined on this mesh.
int	GetMeshEdgeIndex (int pStartVertexIndex, int pEndVertexIndex, bool &pReversed, int pExistedEdgeCount=-1)
	Get the index for the edge between the given vertices.
void	BeginGetMeshEdgeIndexForPolygon ()
	Use this method before calling GetMeshEdgeIndexForPolygon if making several calls to that method.
void	EndGetMeshEdgeIndexForPolygon ()
	Use this method after calling GetMeshEdgeIndexForPolygon if making several calls to that method.
int	GetMeshEdgeIndexForPolygon (int pPolygon, int pPositionInPolygon)
	Get the index for the specific edge of pPolygon.
void	GetMeshEdgeVertices (int pEdgeIndex, int &pStartVertexIndex, int &pEndVertexIndex) const
	Get the vertices for the given edge.
void	BeginGetMeshEdgeVertices ()
	Use this method before calling GetMeshEdgeVertices if making several calls to that method.
void	EndGetMeshEdgeVertices ()
	Use this method after calling GetMeshEdgeVertices if making several calls to that method.
void	SetMeshEdgeCount (int pEdgeCount)
	Presets the number edge data elements.
void	SetMeshEdge (int pEdgeIndex, int pValue)
	Sets element in edge array to specific value.
int	AddMeshEdgeIndex (int pStartVertexIndex, int pEndVertexIndex, bool pCheckForDuplicates)
	Add an edge with the given start/end points.
int	SetMeshEdgeIndex (int pEdgeIndex, int pStartVertexIndex, int pEndVertexIndex, bool pCheckForDuplicates, int pExistedEdgeCount=-1)
	Set the index for the edge with the given start/end points.
void	BeginAddMeshEdgeIndex ()
	Call this before calling AddMeshEdgeIndex or SetMeshEdgeIndex to increase performance.
void	EndAddMeshEdgeIndex ()
	After calling AddMeshEdgeIndex or SetMeshEdgeIndex, EndAddMeshEdgeIndex should be called.
int	AddMeshEdgeIndexForPolygon (int pPolygonIndex, int pPositionInPolygon)
	Adds an edge for the specified polygon, and edge number within the polygon.
bool	SetMeshEdgeIndex (int pEdgeIndex, int pPolygonIndex, int pPositionInPolygon)
	Sets the specified edge to the specified polygon's edge.
bool	IsTriangleMesh () const
	Determines if the mesh is composed entirely of triangles.
Crease utility functions
double	GetEdgeCreaseInfo (int pEdgeIndex)
	Get crease weight by edge index.
bool	GetEdgeCreaseInfoArray (FbxLayerElementArrayTemplate< double > **pCreaseArray)
	Get crease edge array.
double	GetVertexCreaseInfo (int pVertexIndex)
	Get crease weight by vertex index.
bool	GetVertexCreaseInfoArray (FbxLayerElementArrayTemplate< double > **pCreaseArray)
	Get vertex crease array.
bool	SetEdgeCreaseInfo (int pEdgeIndex, double pWeight)
	Set crease weight by edge index.
bool	SetEdgeCreaseInfoArray (FbxArray< double > *pWeightArray)
	Set crease weight data array.
bool	SetVertexCreaseInfo (int pVertexIndex, double pWeight)
	Set crease weight by vertex index.
bool	SetVertexCreaseInfoArray (FbxArray< double > *pWeightArray)
	Set crease weight data array.
Smooth mesh preview utility functions
enum	ESmoothness { eHull, eRough, eMedium, eFine }
	Display Smoothness. More...
enum	EBoundaryRule { eLegacy, eCreaseAll, eCreaseEdge }
	the boundary rule. More...
FbxMesh::ESmoothness	GetMeshSmoothness () const
	Get display smoothness from mesh.
void	SetMeshSmoothness (FbxMesh::ESmoothness pSmoothness)
	Set the mesh display smoothness mode.
int	GetMeshPreviewDivisionLevels () const
	Get preview subdivision levels from mesh.
void	SetMeshPreviewDivisionLevels (int pPreviewDivisionLevels)
	Set mesh preview subdivision levels.
int	GetMeshRenderDivisionLevels () const
	Get render subdivision levels from mesh.
void	SetMeshRenderDivisionLevels (int pRenderDivisionLevels)
	Set mesh render subdivision levels.
bool	GetDisplaySubdivisions () const
	Query whether to display subdivisions isolines on mesh.
void	SetDisplaySubdivisions (bool pDisplySubdivisions)
	Set the DisplySubdivisions state.
EBoundaryRule	GetBoundaryRule () const
	Get BoundaryRule from mesh.
void	SetBoundaryRule (EBoundaryRule pBoundaryRule)
	Set BoundaryRule for this mesh.
bool	GetPreserveBorders () const
	Query whether to preserve borders when preview smooth mesh is enabled.
void	SetPreserveBorders (bool pPreserveBorders)
	Set the state of the PreserveBorders flag.
bool	GetPreserveHardEdges () const
	Query whether to preserve hard edges when preview smooth mesh.
void	SetPreserveHardEdges (bool pPreserveHardEdges)
	Set the state of the PreserveHardEdges flag.
bool	GetPropagateEdgeHardness () const
	Query whether to PropagateEdgeHardness when preview smooth mesh.
void	SetPropagateEdgeHardness (bool pPropagateEdgeHardness)
	Set state of the PropagateEdgeHardness flag.
Geometry hole management utility functions
bool	GetPolyHoleInfo (int pFaceIndex)
	Get hole flag by face index (an index to a polygon).
bool	GetPolyHoleInfoArray (FbxLayerElementArrayTemplate< bool > **pHoleArray)
	Get hole flags Array.
bool	SetPolyHoleInfo (int pFaceIndex, bool pIsHole)
	Sets the flag indicating whether the face represents a hole or not.
bool	SetPolyHoleInfoArray (FbxArray< bool > *pHoleArray)
	Set hole flags array.
Tangents data management utility functions
bool	GenerateTangentsData (const char *pUVSetName=NULL, bool pOverwrite=false)
	Generate tangents data for UVSet with specific name.
bool	GenerateTangentsData (int pUVSetLayerIndex, bool pOverwrite=false)
	Generate tangents data for UVSet in specific layer.
bool	GenerateTangentsDataForAllUVSets (bool pOverwrite=false)
	Generate tangents data for all UVSets in all layers.

eHull	Default value, not active "smooth mesh preview". Search for all occurrences
eRough	Not active "smooth mesh preview". Search for all occurrences
eMedium	Both display cage and smooth mesh. Search for all occurrences
eFine	Display smooth mesh. Search for all occurrences

eLegacy	Default value. Search for all occurrences
eCreaseAll	Used for hard corner. Search for all occurrences
eCreaseEdge	Used for round corner. Search for all occurrences

void BeginPolygon	(	int	pMaterial = `-1`,
		int	pTexture = `-1`,
		int	pGroup = `-1`,
		bool	pLegacy = `true`
	)

pMaterial	Index of material to assign to this polygon if material mapping type is eByPolygon. Otherwise it must be `-1`.
pTexture	Index of texture to assign to this polygon if texture mapping type is eByPolygon. Otherwise it must be `-1`.
pGroup	Group index assigned to polygon.
pLegacy	When set to `true`, automatically create a LayerElement of type Texture; This was the default behavior of earlier versions of the FBX SDK. Since version 2010, the textures are connected to the material object.

pMaterial	Index of material to assign to this polygon if material mapping type is eByPolygon. Otherwise it must be `-1`.
pTextures	Array of index of texture (by texture type) to assign to this polygon if texture mapping type is eByPolygon. Otherwise it must be an array of `-1`. This array is expected to be of size: FbxLayerElement::sTypeTextureCount. If one texture type is not used, the corresponding entry must be left at `-1`.

pIndex	Index in the table of the control points.
pTextureUVIndex	Index of texture UV coordinates to assign to this polygon if texture UV mapping type is eByPolygonVertex. Otherwise it must be `-1`.

void SetPolygonGroup	(	int	pPolygonIndex,
		int	pGroup
	)		const `[inline]`

pPolygonIndex	Index of the polygon.
pGroup	Group index assigned to the polygon.

int GetPolygonVertex	(	int	pPolygonIndex,
		int	pPositionInPolygon
	)		const `[inline]`

pPolygonIndex	Index of queried polygon. The valid range for this parameter is 0 to `FbxMesh::GetPolygonCount()`.
pPositionInPolygon	Position of polygon vertex in indexed polygon. The valid range for this parameter is 0 to `FbxMesh::GetPolygonSize(pPolygonIndex)`.

pCount	Number of texture UV elements.
pTypeIdentifier	Specifies which texture channel this UV refers to.

bool GetPolygonVertexNormal	(	int	pPolyIndex,
		int	pVertexIndex,
		FbxVector4 &	pNormal
	)		const

pPolyIndex	Index of the polygon.
pVertexIndex	Index of the vertex in the polygon.
pNormal	The returned normal.

bool GetPolygonVertexUV	(	int	pPolyIndex,
		int	pVertexIndex,
		const char *	pUVSetName,
		FbxVector2 &	pUV,
		bool &	pUnmapped
	)		const

bool GetPolygonVertexUVs	(	const char *	pUVSetName,
		FbxArray< FbxVector2 > &	pUVs,
		FbxArray< int > *	pUnmappedUVId = `NULL`
	)		const

pUVSetName	The name of the UV set that contains the UVs.
pUVs	The returned UVs.
pUnmappedUVId	If specified, this array will be filled with the indices of the UVs that are not associated to a polygon vertex and thus, have an undefined value. If the array as a size of 0, then all the polygon vertices have an associated UV coordinate and the `pUVs` array can be used as is. Otherwise, the calling application may be required to process the invalid UV coordinates to avoid inconsistent results. It is strongly suggested to use the FbxLayerElementUV's Direct and Indexed arrays directly (specially if the calling application supports indirection of the UVs).

void InitTextureUV	(	int	pCount,
		FbxLayerElement::EType	pTypeIdentifier = `FbxLayerElement::eTextureDiffuse`
	)

void AddTextureUV	(	FbxVector2	pUV,
		FbxLayerElement::EType	pTypeIdentifier = `FbxLayerElement::eTextureDiffuse`
	)

pUV	Texture UV coordinates, ranging between `0` and `1`.
pTypeIdentifier	Specifies which texture channel this UV refers to.

void InitTextureIndices	(	FbxLayerElement::EMappingMode	pMappingMode,
		FbxLayerElement::EType	pTextureType
	)

void InitTextureUVIndices	(	FbxLayerElement::EMappingMode	pMappingMode,
		FbxLayerElement::EType	pTypeIdentifier = `FbxLayerElement::eTextureDiffuse`
	)

Class Description

Classes

Public Member Functions

Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Friends

Polygon Management

Texture UV Utility Functions.

Material, Texture and UV Indices Utility Functions.

Utility functions

Point Splitting/Merging utility functions

Edge management functions

Crease utility functions

Smooth mesh preview utility functions

Geometry hole management utility functions

Tangents data management utility functions

Member Enumeration Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation

int GetTextureUVIndex	(	int	pPolygonIndex,
		int	pPositionInPolygon,
		FbxLayerElement::EType	pTypeIdentifier = `FbxLayerElement::eTextureDiffuse`
	)

pPolygonIndex	Index of polygon. The valid range for this parameter is 0 to FbxMesh::GetPolygonCount().
pPositionInPolygon	Position of polygon vertex in indexed polygon. The valid range for this parameter is 0 to FbxMesh::GetPolygonSize(pPolygonIndex).
pTypeIdentifier	The texture channel the UVIndex refers to.

void SetTextureUVIndex	(	int	pPolygonIndex,
		int	pPositionInPolygon,
		int	pIndex,
		FbxLayerElement::EType	pTypeIdentifier
	)

bool BuildMergeList	(	FbxArray< int > &	pMergeList,
		bool	pExport = `false`
	)

pMergeList	The list that will contain the indexes of the objects to merge.
pExport	If set to `true`, include the duplicate indexes in the merge list.

int GetMeshEdgeIndex	(	int	pStartVertexIndex,
		int	pEndVertexIndex,
		bool &	pReversed,
		int	pExistedEdgeCount = `-1`
	)

pStartVertexIndex	The starting point of the edge.
pEndVertexIndex	The ending point of the edge.
pReversed	flag will be set to true if the reverse edge is found, false otherwise.
pExistedEdgeCount	legal edge count in mEdgeArray

int GetMeshEdgeIndexForPolygon	(	int	pPolygon,
		int	pPositionInPolygon
	)

pPolygon	The polygon of interest.
pPositionInPolygon	The specific edge number in the polygon.

void GetMeshEdgeVertices	(	int	pEdgeIndex,
		int &	pStartVertexIndex,
		int &	pEndVertexIndex
	)		const