PointLocatorData.Count operator

Introduced

v5.0

Description

Returns the number of point locators contained in the PointLocatorData as a Long.

C# Syntax

// get accessor
Int32 rtn = PointLocatorData.Count;

Examples

JScript Example

/*
	This example uses PointLocatorData to find closest vertices on a polygon mesh
	within a specific radius, and then creates a cluster on these points.
*/
NewScene(null, false);
var root = Application.ActiveSceneRoot;
var GridObj = root.AddGeometry("Grid", "MeshSurface");
Translate(GridObj, 0, 0, -2.0, siRelative, siView, siObj, siXYZ);
var GridGeom = GridObj.ActivePrimitive.Geometry;
// Set up to closest vertex search
GridGeom.SetupPointLocatorQueries(siClosestVertexOrKnot, GridObj.Kinematics.Global.Transform, null, -1);
// Get all vertices within a radius of 2 units relatively to the world center
var PositionToQuery = XSIMath.CreateVector3(0,0,0);
var PointLocatorsWithinTwoUnits = GridGeom.GetClosestLocationsWithinRadius(PositionToQuery, 2.0);
var VerticesString = " ";
var ClosestVerticesArray = new Array();
var PtLocIndexToQuery = new Array();
for( i=0; i<PointLocatorsWithinTwoUnits.Count; i++ ) {
	// Even though the point locators have be defined to exactly match the vertex 
	// positions, the search data is returned as a position on a specific triangle, 
	// just as any other use of the Point Locator.  However the vertex that matches 
	// can be determined because it will be weighted at 100%.
	PtLocIndexToQuery[0] = i;
	var SubTriangleVertices = GridGeom.GetTriangleVertexIndexArray(
		PointLocatorsWithinTwoUnits, PtLocIndexToQuery).toArray();
	var SubTriangleWeights = GridGeom.GetTriangleWeightArray(
		PointLocatorsWithinTwoUnits, PtLocIndexToQuery).toArray();
	var VtxIdx = SubTriangleVertices[0];
	if(SubTriangleWeights[1] > SubTriangleWeights[0] && SubTriangleWeights[1] > SubTriangleWeights[2])
		VtxIdx = SubTriangleVertices[1];
	else if(SubTriangleWeights[2] > SubTriangleWeights[0] && SubTriangleWeights[2] > SubTriangleWeights[1])
		VtxIdx = SubTriangleVertices[2];
	ClosestVerticesArray[i] = VtxIdx;
	VerticesString += VtxIdx
	if( i != PointLocatorsWithinTwoUnits.Count-1) {
		VerticesString += ", ";
	}
}
// Create a cluster on these vertices
GridGeom.AddCluster(siVertexCluster, "ClosestVertices", ClosestVerticesArray);
Application.LogMessage("There are " + PointLocatorsWithinTwoUnits.Count 
			+ " grid vertices in the 2 unit sphere located at the world center.");
Application.LogMessage("These vertices are (ordered by proximity):");
Application.LogMessage(VerticesString);
// Expected results:
// INFO : There are 5 grid vertices in the 2 unit sphere located at the world center.
// INFO : These vertices are (ordered by proximity):
// INFO :  42, 51, 41, 33, 43

See Also

PointLocatorData Geometry Geometry.GetClosestLocations Geometry.GetClosestLocationsWithinRadius Geometry.GetRaycastIntersections Geometry.SetupPointLocatorQueries Geometry.GetSurfacePointLocatorsFromPoints Geometry.EvaluatePositions Geometry.EvaluateNormals Geometry.EvaluateClusterProperty PolygonMesh.GetPolygonIndexArray PolygonMesh.GetTriangleVertexIndexArray PolygonMesh.GetTriangleNodeIndexArray PolygonMesh.GetTriangleWeightArray PolygonMesh.ConstructPointLocators NurbsSurfaceMesh.GetSubSurfaceIndexArray NurbsSurfaceMesh.GetNormalizedUVArray NurbsSurfaceMesh.ConstructPointLocators