CDPL.Vis.TriangleMesh3D Class Reference

Data structure for the storage of 3D triangle mesh vertices, vertex normals and faces. More...

Inheritance diagram for CDPL.Vis.TriangleMesh3D:

Public Member Functions
None	__init__ ()
	Contructs the TriangleMesh3D instance.
None	__init__ (TriangleMesh3D mesh)
	Contructs a copy of the TriangleMesh3D instance mesh. More...
TriangleMesh3D	assign (TriangleMesh3D mesh)
	Replaces the current state with a copy of the state of the TriangleMesh3D instance mesh. More...
Math.Vector3DArray	getVertices ()
	Returns the array storing the mesh vertices. More...
None	addVertex (float x, float y, float z)
	Appends a new vertex at the position (x, y, z). More...
int	getNumVertices ()
	Returns the number of stored vertices. More...
Math.Vector3DArray	getVertexNormals ()
	Returns the array storing the per-vertex normals. More...
None	addVertexNormal (float x, float y, float z)
	Appends a new vertex normal with the components (x, y, z). More...
int	getNumVertexNormals ()
	Returns the number of stored vertex normals. More...
Math.Vector3ULArray	getFaces ()
	Returns the array storing the triangle faces. More...
None	addFace (int v1_idx, int v2_idx, int v3_idx)
	Appends a new triangle face defined by the three vertex indices v1_idx, v2_idx and v3_idx. More...
int	getNumFaces ()
	Returns the number of stored triangle faces. More...
bool	isClosed ()
	Tells whether the mesh has been flagged as a closed surface. More...
None	setClosed (bool closed=True)
	Sets the flag that marks the mesh as a closed surface. More...
None	clear ()
	Removes all vertices, vertex normals and faces and resets the closed-surface flag.
TriangleMesh3D	swap (TriangleMesh3D mesh)
	Swaps the vertices, vertex normals and faces of this mesh with those of mesh. More...
TriangleMesh3D	__iadd__ (TriangleMesh3D mesh)
	Appends the vertices, vertex normals and (vertex index corrected) faces of mesh to this mesh. More...
Public Member Functions inherited from CDPL.Vis.Shape3D
int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
Shape3D	clone ()
	Creates a dynamically allocated copy of the graphics primitive. More...
None	accept (Shape3DVisitor visitor)
	Vis.Shape3DVisitor implementation accept method [VPTN]. More...

Properties
	vertices = property(getVertices)
	numVertices = property(getNumVertices)
	vertexNormals = property(getVertexNormals)
	numVertexNormals = property(getNumVertexNormals)
	faces = property(getFaces)
	numFaces = property(getNumFaces)
	closed = property(isClosed, setClosed)
Properties inherited from CDPL.Vis.Shape3D
	objectID = property(getObjectID)

Detailed Description

Data structure for the storage of 3D triangle mesh vertices, vertex normals and faces.

Since

1.3

Constructor & Destructor Documentation

__init__()

None CDPL.Vis.TriangleMesh3D.__init__

(

TriangleMesh3D

mesh

)

Contructs a copy of the TriangleMesh3D instance mesh.

Parameters

mesh	The TriangleMesh3D instance to copy.

Member Function Documentation

assign()

TriangleMesh3D CDPL.Vis.TriangleMesh3D.assign

(

TriangleMesh3D

mesh

)

Replaces the current state with a copy of the state of the TriangleMesh3D instance mesh.

Parameters

mesh	The TriangleMesh3D instance to copy.

Returns

self.

getVertices()

Math.Vector3DArray CDPL.Vis.TriangleMesh3D.getVertices

(

)

Returns the array storing the mesh vertices.

Returns

The vertex array.

addVertex()

None CDPL.Vis.TriangleMesh3D.addVertex	(	float	x,
		float	y,
		float	z
	)

Appends a new vertex at the position (x, y, z).

Parameters

x	The x-coordinate of the vertex.
y	The y-coordinate of the vertex.
z	The z-coordinate of the vertex.

getNumVertices()

int CDPL.Vis.TriangleMesh3D.getNumVertices

(

)

Returns the number of stored vertices.

Returns

The vertex count.

getVertexNormals()

Math.Vector3DArray CDPL.Vis.TriangleMesh3D.getVertexNormals

(

)

Returns the array storing the per-vertex normals.

Returns

The vertex-normal array.

addVertexNormal()

None CDPL.Vis.TriangleMesh3D.addVertexNormal	(	float	x,
		float	y,
		float	z
	)

Appends a new vertex normal with the components (x, y, z).

Parameters

x	The x-component of the normal vector.
y	The y-component of the normal vector.
z	The z-component of the normal vector.

getNumVertexNormals()

int CDPL.Vis.TriangleMesh3D.getNumVertexNormals

(

)

Returns the number of stored vertex normals.

Returns

The vertex normal count.

getFaces()

Math.Vector3ULArray CDPL.Vis.TriangleMesh3D.getFaces

(

)

Returns the array storing the triangle faces.

Returns

The face array.

addFace()

None CDPL.Vis.TriangleMesh3D.addFace	(	int	v1_idx,
		int	v2_idx,
		int	v3_idx
	)

Appends a new triangle face defined by the three vertex indices v1_idx, v2_idx and v3_idx.

Parameters

v1_idx	The zero-based index of the first vertex.
v2_idx	The zero-based index of the second vertex.
v3_idx	The zero-based index of the third vertex.

getNumFaces()

int CDPL.Vis.TriangleMesh3D.getNumFaces

(

)

Returns the number of stored triangle faces.

Returns

The face count.

isClosed()

bool CDPL.Vis.TriangleMesh3D.isClosed

(

)

Tells whether the mesh has been flagged as a closed surface.

Returns

True if the mesh is flagged as closed, and False otherwise.

setClosed()

None CDPL.Vis.TriangleMesh3D.setClosed

(

bool

closed = True

)

Sets the flag that marks the mesh as a closed surface.

Parameters

closed

True to flag the mesh as closed, and False otherwise.

swap()

TriangleMesh3D CDPL.Vis.TriangleMesh3D.swap

(

TriangleMesh3D

mesh

)

Swaps the vertices, vertex normals and faces of this mesh with those of mesh.

Parameters

mesh	The mesh to swap with.

__iadd__()

TriangleMesh3D CDPL.Vis.TriangleMesh3D.__iadd__

(

TriangleMesh3D

mesh

)

Appends the vertices, vertex normals and (vertex index corrected) faces of mesh to this mesh.

Parameters

mesh	The mesh to append.

Returns

self.