Interface to Alias Surface locators.
#include <AlSurfaceLocator.h>
class AlSurfaceLocator : public AlPointLocator
AlSurfaceLocator();
~AlSurfaceLocator();
virtual AlObject * copyWrapper() const;
virtual AlObjectType type() const;
statusCode create(const AlSurface *, double, double);
statusCode setParameter(double, double);
statusCode parameter(double &, double &) const;
virtual statusCode worldPosition(double &, double &, double &) const;
statusCode uTangent(double &, double &, double &) const;
statusCode vTangent(double &, double &, double &) const;
statusCode normal(double &, double &, double &) const;
statusCode meanRadius(double &) const;
statusCode gaussianRadius(double &) const;
statusCode principalMinimumRadius(double &) const;
statusCode principalMaximumRadius(double &) const;
statusCode uArcLength(double &) const;
statusCode vArcLength(double &) const;
A locator can be created in the parametric space of any AlSurface. This locator can be queried for the surface normal, tangents, position in world coordinate system, arc lengths, and curvatures. This class contains methods for creating, and moving the surface locator.
If the AlSurface is deleted, the surface locator created on it is automatically deleted.
Constructs an AlSurfaceLocator wrapper object.
Deletes an AlSurfaceLocator wrapper object.
Returns an exact copy of the AlSurfaceLocator wrapper.
Returns the class identifier kSurfaceLocatorType.
Creates a locator on the given surface.
< surface - the surface on which the locator is created
< u - surface parameter at which locator is created
< v - surface parameter at which locator is created
sSuccess - the locator was successfully created
sAlreadyCreated - object has already been created
sFailure - failed to create a locator
sInvalidArgument - the surface was not valid
Moves the locator created on a surface.
< u, v - the parameters of the surface where the locator has to be moved
sSuccess - the locator was moved
sInvalidObject - the locator is not valid
Finds the surface parameters where the surface locator is located.
> u, v - the U and V parameters of the surface
sSuccess - the parameters were found
sInvalidObject - the locator is not valid
Finds the world coordinates of the surface locator.
> x, y, z - the world coordinates of the surface locator
sSuccess - the coordinates were found
sInvalidObject - the locator is not valid
Finds the tangent to the surface at the point where the locator is present in the U direction.
> x, y, z - the X, Y, Z components of the normalized tangent
sSuccess - the tangent was found
sInvalidObject - the locator is not valid
Finds the tangent to the surface at the point where the locator is present in the V direction.
> x, y, z - the X, Y, Z components of the normalized tangent
sSuccess - the tangent was found
sInvalidObject - the locator is not valid
Finds the normal to the surface at the point where the locator is present.
> x, y, z - the X, Y, Z components of the normalized normal
sSuccess - the normal was found
sInvalidObject - the locator is not valid
Finds the mean of the principal radii of the surface at a point on which the locator is present.
> meanRad - the mean radius of the surface
sSuccess - the mean radius was found
sInvalidObject - the locator is not valid
Finds the product of the principle radii of the surface at a point on which the locator is present.
> gausRad - the gaussian radius of the surface at that point
sSuccess - the gaussian radius was found
sInvalidObject - the locator is not valid
Finds the minimum radius of the curves on surface that pass through the point at which the locator is present.
> pminRad - the principal minimum radius of the surface
sSuccess - the radius was found
sInvalidObject - the locator is not valid
Finds the maximum radius of the curves on surface that pass through the point at which the locator is present.
> pmaxRad - the principal maximum radius of the surface
sSuccess - the radius was found
sInvalidObject - the locator is not valid
Finds the arc length along the U tangent at the point on the surface where the locator is present.
> uarcLen - the arc length along the U tangent
sSuccess - the arc length was found
sInvalidObject - the locator is not valid
Finds the arc length along the V tangent at the point on the surface where the locator is present.
> varcLen - the arc length along the V tangent
sSuccess - the arc length was found
sInvalidObject - the locator is not valid