v5.0
Evaluates the cluster property data at the surface locations
defined by the point locator data.
The dimension of the returned array depends on the cluster property
type, in the same way as defined in ClusterProperty.
If a point locator doesn't correspond exactly to a component
defining a value for the cluster property (for example, sampled
point for UVs), then the value will be interpolated between
adjacent components. In the case of NurbsSurfaceMesh, the returned values
will be smoothed according to the NURBS surface mathematical
equation since some properties are defined on control vertices (for
example, weight maps) while point locators are defined on the
surface.
If a point locator corresponds to a discontinuity in property
space, the returned value will be an arbitrary one among the many
values corresponding to that location.
Notice that the parent cluster is required in addition to the
cluster property even if it is unambiguous to get the parent
cluster from the cluster property. The reason is that, in the
context of a scripted operator, both the cluster and the cluster
property must come from the value of an input port, otherwise
evaluation errors will occur.
An example using this method can be found in PointLocatorData object's
description.
Object Geometry.EvaluateClusterProperty( PointLocatorData in_pPtLocators, Cluster in_pParentCluster, ClusterProperty in_pClusterProperty, Object in_pPointLocatorsIndices ); |
oArray = Geometry.EvaluateClusterProperty( PointLocators, ParentCluster, ClusterProp, [Indices] ); |
2-dimensional Array
Parameter | Type | Description |
---|---|---|
PointLocators | PointLocatorData | Point locators to be evaluated. |
ParentCluster | Cluster | Parent of the cluster property to be evaluated. |
ClusterProp | ClusterProperty | Cluster property to be evaluated. |
Indices | 1-dimensional Array | Indices of the point locators to be evaluated (all in not specified). |
PointLocatorData Geometry Geometry.GetClosestLocations Geometry.GetClosestLocationsWithinRadius Geometry.GetRaycastIntersections Geometry.SetupPointLocatorQueries Geometry.GetSurfacePointLocatorsFromPoints Geometry.EvaluatePositions Geometry.EvaluateNormals PolygonMesh.GetPolygonIndexArray PolygonMesh.GetTriangleVertexIndexArray PolygonMesh.GetTriangleNodeIndexArray PolygonMesh.GetTriangleWeightArray PolygonMesh.ConstructPointLocators NurbsSurfaceMesh.GetSubSurfaceIndexArray NurbsSurfaceMesh.GetNormalizedUVArray NurbsSurfaceMesh.ConstructPointLocators