Interface to Alias curve
points.
Synopsis
#include <AlCurvePoint.h>
class AlCurvePoint : public AlPoint
AlCurvePoint();
~AlCurvePoint();
virtual AlObject * copyWrapper() const;
virtual AlObjectType type() const;
statusCode create(const AlCurve *, double);
statusCode setParameter(double);
statusCode parameter(double &) const;
virtual statusCode worldPosition(double &, double &, double &) const;
statusCode tangent(double &, double &, double &) const;
statusCode normal1(double &, double &, double &) const;
statusCode normal2(double &, double &, double &) const;
statusCode radius(double &) const;
statusCode arcLength(double &) const;
AlCurveNode *attachedTo();
Description
A point can be created
in the parametric space of any AlCurve. This point can be queried for
the curve normals, tangent, position in world coordinate system,
arc length, and curvature information. This class contains methods
for creating, and moving the curve point.
If the AlCurve is deleted,
the curve point created on it is deleted.
AlCurvePoint::AlCurvePoint(void)
Description
Constructs an AlCurvePoint
wrapper object.
AlCurvePoint::~AlCurvePoint()
Description
Deletes an AlCurvePoint
wrapper object.
AlObject *AlCurvePoint::copyWrapper()
const
Description
Returns an exact copy
of the AlCurvePoint wrapper.
AlObjectType AlCurvePoint::type()
const
Description
Returns the class identifier
kCurvePointType.
statusCode AlCurvePoint::create(const
AlCurve *curve, double u)
Description
Creates a point on the
given curve
Arguments
< curve - the curve
on which the point is created.
< u - curve parameter
at which point is created
Return Codes
sSuccess - the point
was successfully created
sAlreadyCreated - object
has already been created
sFailure - the point
could not be created on the curve.
sInvalidArgument - the
curve is not a valid object
statusCode AlCurvePoint::setParameter(double
u)
Description
Move the position of
a point created on a curve
Arguments
< u - the parameter
on the curve where the point has to be moved.
Return Codes
sSuccess - the point
was moved
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::parameter(double
&u) const
Description
Find the parameter value
at which the point is present
Arguments
> u - the curve parameter
where point is present
Return Codes
sSuccess - the parameter
was found
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::worldPosition(double
&x, double &y, double &z) const
Description
Find the world coordinates
of the curve point
Arguments
> x, y, z - the world
coordinates of the curve point
Return Codes
sSuccess - the coordinates
were found.
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::tangent(double
&x, double &y, double &z) const
Description
Find the tangent vector
to the curve at the point
Arguments
> x, y, z - the X,
Y, Z components of the tangent
Return Codes
sSuccess - the tangent
was found.
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::normal1(double
&x, double &y, double &z) const
Description
Find the normal to the
curve at the point
Arguments
> x, y, z - the X,
Y, Z components of the normal
Return Codes
sSuccess - the normal
was found.
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::normal2(double
&x, double &y, double &z) const
Description
Find the second normal
to the curve at the point
Arguments
> x, y, z - the X,
Y, Z components of the second normal normalized vector.
Return Codes
sSuccess - the normal
was found.
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::radius(double
&rad) const
Description
Find the radius of the
curve at the point
Arguments
> rad - the radius
of the curve at the point.
Return Codes
sSuccess - the radius
was found.
sInvalidObject - the
point is not valid
statusCode AlCurvePoint::arcLength(double
&arcLen) const
Description
Find the length of the
curve on which the point is present
Arguments
> arcLen - the length
of the curve
Return Codes
sSuccess - the arc length
was found.
sInvalidObject - the
point is not valid
AlCurveNode *AlCurvePoint::attachedTo()
Description
Returns the curve node
that this point is associated with. NULL is returned if this method fails.