![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
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.
- 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.
~ TGRPoint3DArray ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
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.
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:
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.
TGBox3D GetBounds () const
Interface Category:
API.
Purpose:
Returns a TGBox3D that bounds the TGRPoint3Ds in this TGRPoint3DArray.
Calling Context:
Call this function directly.
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.
Copyright©1995 Taligent,Inc. All rights reserved.