class HT_Point

class HT_Point_Set

HT_Point_Set is a collection of points. This base class is used to derive polylines, polygons, polytriangles, as well as other geometric collections such as vertex sets and segment sets.

See Also

HT_Point

Access Methods

count

Returns the number of vertices in this point set.

points

Returns a pointer to the points array. Constructor/Destructor

HT_Point_Set

Constructs an HT_Point_Set object.

~HT_Point_Set

Destroys an HT_Point_Set object.

HT_Point_Set::count

Purpose

Queries the number of points of this HT_Point_Set object. Synopsis

int count()

Details Returns the number of points in the point set.

HT_Point_Set::HT_Point_Set

Purpose

Constructor to initialize a new HT_Point_Set object Synopsis

HT_Point_Set()

HT_Point_Set(int count, HT_Point const * points)

HT_Point_Set(int count, HT_Point const * points, HT_Boolean copy)

Details The first form initializes to an empty point set, that is, one with no points.

The second form creates a point set with count points. The HT_Point_Set object refers to the array points for the point definitions. In this case, no additional storage allocation is required to hold the points.

The third form creates a point set and allocates storage for count points. If the copy parameter is HK_True, then the constructor copies the points from the array points into the HT_Point_Set object. This form only allocates storage if either copy == HK_True or points is null. If copy is false and points is a valid pointer, no memory is allocated¾ similar to the second form.

Note: This information is applicable to all of the Point_Set derived classes as well¾ if points is null and count is >0, then count points will be allocated.

HT_Point_Set::~HT_Point_Set

Purpose

Destroys an HT_Point_Set object. Synopsis

~HT_Point_Set()

Details Deletes the point set and frees storage for the point list.

HT_Point_Set::points

Purpose

Queries the point array of this point set object. Synopsis

HT_Point const * points()

Details Returns a pointer to an array of HT_Point objects defining the point set.