Class: TGCardinalSpline3D

Declaration: Curve3D.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

TGCardinalSpline3D is the 3-D equivalent of TGCardinalSpline. TGCardinalSpline3D is one of several lightweight classes derived from TGCurve3D whose sole purpose is to disambiguate the constructors for cubic splines having similar arguments. Applications shouldn't define variables of type TGCardinalSpline3D. Instead, use TGCurve3D and rely on TGCardinalSpline3D only for its constructor. For example: TGCurve3D myCurve =TGCardinalSpline3D( points, tension ); This creates a curve as a cubic matrix spline, where the curve interpolates the control points. The tension parameter controls how tightly the curve interpolates the points. The number of points must be a multiple of four, or else an assertion occurs.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

Do not derive from this class.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TGCardinalSpline3D::TGCardinalSpline3D

TGCardinalSpline3D (const TGPoint3DArray & points, GCoordinate tension =1.0)
TGCardinalSpline3D ()
TGCardinalSpline3D (const TGCardinalSpline3D &)

Interface Category:

API.

Purpose:

Creates a curve as a cubic matrix spline, where the curve interpolates the control points. The tension parameter controls how tightly the curve interpolates the points.
Default constructor.
Copy constructor.

Calling Context:

Call this function directly.
Called by the stream-in operators and directly.
Called to copy an object.

Parameters:

const TGPoint3DArray & points -The control points.
GCoordinate tension -Controls how tightly the curve interpolates the points. The tension must be between 0 and 1 (inclusive); values over the maximum are set to 1 and negative values are set to 0.
Takes no parameters.
const TGCardinalSpline3D & -The spline to be copied.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TGCardinalSpline3D::~TGCardinalSpline3D

virtual ~ TGCardinalSpline3D ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.