PolygonFace.TriangleSubIndexArray operator

Introduced

v5.0

Description

Returns a 1-dimensional packed Array of triangulation descriptions corresponding to the tesselation of the polygon. The polygon is tesselated into (NbPoints - 2) triangles, and 3 indices in the range (0..NbPoints-1) are returned for each triangle. Each index triplet describes a subtriangle of the polygon, and the indices correspond to the vertex or node ordering within the polygon.

Notice that the triangulation of a polygon may change accordingly to the deformation of the geometry.

C# Syntax

// get accessor
Object rtn = PolygonFace.TriangleSubIndexArray;

Examples

JScript Example

/*
	This example demonstrates how to describe the triangulation of some polygons.
*/
NewScene( null, false );
var SphereGeom = Application.ActiveSceneRoot.AddGeometry("Sphere", "MeshSurface").ActivePrimitive.Geometry;
var Polygons = SphereGeom.Polygons;
for(i = 0; i < Polygons.Count; i++)
{
	var Polygon = Polygons.Item(i);
	var NbTriangles = Polygon.NbPoints-2;
	var PolygonVertices = Polygon.Vertices;
	var PolygonNodes = Polygon.Nodes;
	var TriangleSubIndices = Polygon.TriangleSubIndexArray.toArray();
	for(j = 0; j < NbTriangles; j++)
	{
		Application.LogMessage("SubTriangle " + j + " of Polygon " + i + " correspond to vertices (" + 
			PolygonVertices.Item(TriangleSubIndices[j*3]).Index + ", " +
			PolygonVertices.Item(TriangleSubIndices[j*3+1]).Index + ", " +
			PolygonVertices.Item(TriangleSubIndices[j*3+2]).Index + ") and nodes (" +
			PolygonNodes.Item(TriangleSubIndices[j*3]).Index + ", " +
			PolygonNodes.Item(TriangleSubIndices[j*3+1]).Index + ", " +
			PolygonNodes.Item(TriangleSubIndices[j*3+2]).Index + ").");
	}
}
// Expected results:
//INFO : SubTriangle 0 of Polygon 0 correspond to vertices (9, 2, 0) and nodes (0, 1, 2).
//INFO : SubTriangle 0 of Polygon 1 correspond to vertices (2, 9, 10) and nodes (3, 4, 5).
//INFO : SubTriangle 1 of Polygon 1 correspond to vertices (2, 10, 3) and nodes (3, 5, 6).
//INFO : SubTriangle 0 of Polygon 2 correspond to vertices (3, 10, 11) and nodes (7, 8, 9).
//INFO : SubTriangle 1 of Polygon 2 correspond to vertices (3, 11, 4) and nodes (7, 9, 10).
//etc.

See Also

PolygonFace.Vertices PolygonFace.Nodes