Class: TCurveList

Declaration: CurveList.h

Taxonomy Categories:

Member Functions:

TCurveList
~TCurveList
SetCurve
AdoptCurve
GetCurve
GetCurveRef
GetCurvePosition
SetCurvePosition
SetNumberCurves
GetNumberCurves
SetArclengthMapped
ArclengthMapped
operator=
operator<<=
operator>>=

Interface Category:

API.

Inherits From:

MCollectible

Inherited By:

None.

Purpose:

A TCurveList is a collection of TGCurves. The class is derived from MCollectible. For each curve in the list, the TCurveList maintains a distinct parametric value, used to keep track of the position of the curve in a sweep or loft operation.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TCurveList::TCurveList

TCurveList ()
TCurveList (const TGCurve & singleCurve)
TCurveList (unsigned long numberCurves)
TCurveList (const TCurveList & curveList)

Interface Category:

API.

Purpose:

Default constructor.
Creates a TCurveList with the specified curve in it.
Creates a TCurveList with the specified number of curves in it.
Copy constructor.

Calling Context:

Called by the stream-in operators. You can also call this function directly.
Call this function directly.
Call this function directly.
Called to copy an object.

Parameters:

Takes no parameters.
const TGCurve & singleCurve -The curve that is to be the only one in the curve list.
unsigned long numberCurves -The number of curves to be included in the curve list.
const TCurveList & curveList -The new curve list that this object is set to.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::~TCurveList

~ TCurveList ()

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.

Member Function: TCurveList::SetCurve

void SetCurve (unsigned long nr, const TGCurve & crv, GParametric u)
void SetCurve (const TGCurve & singleCurve)

Interface Category:

API.

Purpose:

Adds a copy of the TGCurve to the list at the location specified by the index. The specified parametric value is associated with the curve. If the index is larger than the size of curve list, the list is resized and padded with NIL pointers to curves.
Sets the first curve in the list to a copy of the specified curve. Sets the associated parametric value to 0.

Calling Context:

Call this function directly.
Call this function directly.

Parameters:

unsigned long nr -The location in the list to be set to the new curve.
const TGCurve & crv -The new curve.
GParametric u -The parametric value to be associated with the new curve.
const TGCurve & singleCurve -The new curve.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::AdoptCurve

void AdoptCurve (unsigned long nr, TGCurve * crv, GParametric u)

Interface Category:

API.

Purpose:

Adds the TGCurve to the list at the location specified by the index. The specified parametric value is associated with the curve. If the index is equal to or larger than the size of curve list, the list is resized.

Calling Context:

Call this function directly.

Parameters:

unsigned long nr -The location (an array index) in the list.
TGCurve * crv -The curve to be adopted.
GParametric u -The parametric value to be associated with the adopted curve.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::GetCurve

void GetCurve (unsigned long nr, TGCurve & crv, GParametric & u) const
void GetCurve (TGCurve & singleCurve) const

Interface Category:

API.

Purpose:

Returns the TGCurve from the location specified by the index and its associated parametric value in the respective parameters.
Returns the list's first TGCurve in the specified parameter.

Calling Context:

Call this function directly.
Call this function directly.

Parameters:

unsigned long nr -The location index.
TGCurve & crv -The curve from the specified location.
GParametric & u -The associated parametric value.
TGCurve & singleCurve -The first curve in the list.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::GetCurveRef

TGCurve * GetCurveRef (unsigned long i) const

Interface Category:

API.

Purpose:

Returns a pointer to the TGCurve specified by the index.

Calling Context:

Call this function directly.

Parameters:

unsigned long i -The index.

Return Value:

A pointer to the curve specified by the index.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::GetCurvePosition

GParametric GetCurvePosition (unsigned long i) const

Interface Category:

API.

Purpose:

Returns the parametric value associated with the TGCurve at the specified index.

Calling Context:

Call this function directly.

Parameters:

unsigned long i -The index into the list of curves. The first curve is numbered 0.

Return Value:

The parametric value of the indexed curve.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::SetCurvePosition

void SetCurvePosition (unsigned long i, GParametric u)

Interface Category:

API.

Purpose:

Sets the parametric value associated with the TGCurve at the specified index to the new value.

Calling Context:

Call this function directly.

Parameters:

unsigned long i -The index into the list of curves. The first curve is numbered 0.
GParametric u -The new parametric value.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::SetNumberCurves

void SetNumberCurves (unsigned long n)

Interface Category:

API.

Purpose:

Sets the number of curves in the curve list. If the number is smaller than before, the extra curves are deleted; if the number is larger, the TCurveList is padded with NILs.

Calling Context:

Call this function directly.

Parameters:

unsigned long n -The new number of curves in the list.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::GetNumberCurves

unsigned long GetNumberCurves () const

Interface Category:

API.

Purpose:

Returns the number of curves in this TCurveList.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

The number of curves in this list.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::SetArclengthMapped

void SetArclengthMapped (bool mapped)

Interface Category:

API.

Purpose:

Sets the fArclengthMapped flag to the specified Boolean.

Calling Context:

Call this function directly.

Parameters:

bool mapped -The desired Boolean.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::ArclengthMapped

bool ArclengthMapped () const

Interface Category:

API.

Purpose:

Determines whether the fArclengthMapped flag is set.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Returns true if the ArclengthMapped flag is set.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::operator=

TCurveList & operator =(const TCurveList & source)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TCurveList & source -The object to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::operator<<=

TStream & operator <<= (TStream & fromwhere)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

TStream & fromwhere -The stream which the object's data is streamed in from.

Return Value:

Returns a reference to the stream the object streams itself in from.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TCurveList::operator>>=

TStream & operator >>=(TStream & towhere) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

TStream & towhere -The stream which the object's data is streamed out to.

Return Value:

Returns a reference to the stream the object streams itself out to.

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.