aiFace Struct Reference

A single face in a mesh, referring to multiple vertices. More...

Public Member Functions
	aiFace ()
	Default constructor. More...
	aiFace (const aiFace &o)
	Copy constructor. Copy the index array. More...
bool	operator!= (const aiFace &o) const
	Inverse comparison operator. More...
const aiFace &	operator= (const aiFace &o)
	Assignment operator. Copy the index array. More...
bool	operator== (const aiFace &o) const
	Comparison operator. More...
	~aiFace ()
	Default destructor. Delete the index array. More...

Public Attributes
unsigned int *	mIndices
	Pointer to the indices array. Size of the array is given in numIndices. More...
unsigned int	mNumIndices
	Number of indices defining this face. More...

Detailed Description

A single face in a mesh, referring to multiple vertices.

If mNumIndices is 3, we call the face 'triangle', for mNumIndices > 3 it's called 'polygon' (hey, that's just a definition!).
aiMesh::mPrimitiveTypes can be queried to quickly examine which types of primitive are actually present in a mesh. The aiProcess_SortByPType flag executes a special post-processing algorithm which splits meshes with different primitive types mixed up (e.g. lines and triangles) in several 'clean' submeshes. Furthermore there is a configuration option ( AI_CONFIG_PP_SBP_REMOVE) to force aiProcess_SortByPType to remove specific kinds of primitives from the imported scene, completely and forever. In many cases you'll probably want to set this setting to

* aiPrimitiveType_LINE|aiPrimitiveType_POINT
* 

Together with the aiProcess_Triangulate flag you can then be sure that aiFace::mNumIndices is always 3.

Note

Take a look at the Data Structures page for more information on the layout and winding order of a face.

Constructor & Destructor Documentation

aiFace::aiFace ( )

inline

Default constructor.

aiFace::~aiFace ( )

inline

Default destructor. Delete the index array.

aiFace::aiFace ( const aiFace &  o )

inline

Copy constructor. Copy the index array.

Member Function Documentation

bool aiFace::operator!= ( const aiFace &  o ) const

inline

Inverse comparison operator.

Checks whether the index array of two faces is NOT identical

const aiFace& aiFace::operator= ( const aiFace &  o )

inline

Assignment operator. Copy the index array.

bool aiFace::operator== ( const aiFace &  o ) const

inline

Comparison operator.

Checks whether the index array of two faces is identical

Member Data Documentation

unsigned int* aiFace::mIndices

Pointer to the indices array. Size of the array is given in numIndices.

unsigned int aiFace::mNumIndices

Number of indices defining this face.

The maximum value for this member is AI_MAX_FACE_INDICES.

---

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

• mesh.h