Class: TGRPoint3DArray

Declaration: Point3DArray.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TRawArray

Inherited By:

None.

Purpose:

TGRPoint3DArray is a low-level class that provides access to linear arrays of TGRPoint3Ds (3-D homogeneous points). TGRPoint3DArray does not perform any computation. TGRPoint3DArray is used by such classes as TGCurve3D, TGSurface3D, and TSweep3D. TGRPoint3DArray is directly analogous to TGPoint3DArray, which handles arrays of TGPoint3Ds (non-homogeneous points).

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None. Do not create derived classes.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TGRPoint3DArray::TGRPoint3DArray

TGRPoint3DArray (unsigned long size =0)
TGRPoint3DArray (const TGPoint3DArray & source)
TGRPoint3DArray (const TGRPoint3DArray & source)

Interface Category:

API.

Purpose:

Creates a TGRPoint3DArray of the specified size. The points are not initialized.
Creates a TGRPoint3DArray by converting the specified TGPoint3DArray.
Copy constructor.

Calling Context:

Call this function directly.
Call this function directly.
Called to copy an object.

Parameters:

unsigned long size =0 -The size of the array.
const TGPoint3DArray & source -The array to be converted and copied.
const TGRPoint3DArray & source -The array to be copied.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TGRPoint3DArray::~TGRPoint3DArray

~ TGRPoint3DArray ()

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: TGRPoint3DArray::GetPoint

TGRPoint3D GetPoint (unsigned long i) const

Interface Category:

API.

Purpose:

Gets the TGRPoint3D at the specified index.

Calling Context:

Call this function directly.

Parameters:

unsigned long i -The index (whose value must be less than the number of points in the array).

Return Value:

Returns the point at the specified index.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TGRPoint3DArray::SetPoint

void SetPoint (unsigned long i, const TGRPoint3D & p)

Interface Category:

API.

Purpose:

Sets the TGRPoint3D at the specified index, to the specified point.

Calling Context:

Call this function directly.

Parameters:

unsigned long i -The index (whose value must be less than the number of points in the array).
const TGRPoint3D & p -The new point.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TGRPoint3DArray::GetNumberOfPoints

unsigned long GetNumberOfPoints () const

Interface Category:

API.

Purpose:

Computes the number of points in the TGRPoint3DArray.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Returns the number of points in the array.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TGRPoint3DArray::GetBounds

TGBox3D GetBounds () const

Interface Category:

API.

Purpose:

Returns a TGBox3D that bounds the TGRPoint3Ds in this TGRPoint3DArray.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Returns the bounding box of all the points in the array.

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.