<     > 

GetSurfacePointLocatorsFromPoints (Geometry) *

Introduced

5.0

Description

Returns a PointLocatorData object containing surface locations corresponding to the specified Points of the geometry (or all Points if not specified).

In the case of a NurbsSurfaceMesh, there is no direct relationship between the points (control vertices) and the surface. In that case, the returned point locators correspond to the surface locations being the most influenced by each input control vertex.

Note: The returned point locators can be evaluated on any Geometry instance having the same topology.

Scripting Syntax

Geometry.GetSurfacePointLocatorsFromPoints( [PointIndices] )

C# Syntax

PointLocatorData Geometry.GetSurfacePointLocatorsFromPoints( Object in_pPoints );

Parameters

Return Value

PointLocatorData

Examples

JScript Example

/* 
   This example uses point locators to place a null positioned 
   and oriented to a surface location corresponding to each
   control vertex of the NURBS sphere.
*/

NewScene( null, false );
var root = Application.ActiveSceneRoot;
var SphereGeom = root.AddGeometry("Sphere", "NurbsSurface").ActivePrimitive.Geometry;
var PointLocatorsFromSpherePoints = SphereGeom.GetSurfacePointLocatorsFromPoints();

CreateNullsAtPointLocations(SphereGeom, PointLocatorsFromSpherePoints);


function CreateNullsAtPointLocations( InGeom, InPointLocators )
{
   var SpherePositions = InGeom.EvaluatePositions(InPointLocators).toArray();
   var SphereNormals = InGeom.EvaluateNormals(InPointLocators).toArray();

   var TempVector = XSIMath.CreateVector3();
   var TempRotation = XSIMath.CreateRotation();

   for (i = 0; i < SpherePositions.length; i+=3)
   {
       var NullObj = root.AddNull();

       TempVector.Set(SpherePositions[i], SpherePositions[i+1], SpherePositions[i+2]);
       NullObj.LocalTranslation = TempVector;

       TempVector.Set(SphereNormals[i], SphereNormals[i+1], SphereNormals[i+2]);

       TempRotation.SetFromXYZAxes( TempVector, TempVector, TempVector );
       NullObj.LocalRotation = TempRotation;
   }
}

See Also

Autodesk Softimage v7.5     <     >