Functions | |
void | Show_Polygon (HC_KEY key, int *count, HC_POINT *points) |
void | Show_Polygon_Count (HC_KEY key, int *count) |
void | Show_Partial_Polygon (HC_KEY key, int offset, int request, HC_POINT *points) |
void | DShow_Polygon (HC_KEY key, int *count, HCD_POINT *points) |
void Show_Polygon | ( | HC_KEY | key, | |
int * | count, | |||
HC_POINT * | points | |||
) |
Returns the vector of points along the edge of the polygon referenced by a key.
key | - Unique numeric identifier pointing to a polygon in the database. | |
count | - Number of valid points in points. Returned to user. Passed by reference always. | |
points | - Vector of x-y-z triplets for the coordinates along the edge of the polygon. (A simple N x 3 array may also be used.) Returned to user. Passed by reference always. |
To aid in the allocation of a data structure large enough to receive the array, you may wish to call Show_Polygon_Count first which just returns the number of points in the polygon.
Show_Partial_Polygon is useful when you want to look at just one or a few points of the polygon.
NOTE
If you originally specified the last point as identical to your first point, the Insert_Polygon() will have trimmed it off as redundant.
void Show_Polygon_Count | ( | HC_KEY | key, | |
int * | count | |||
) |
Finds the number of points in a given polygon. This is useful in determining the size of the data structure that must hold points.
key | - Unique numeric identifier pointing to a polygon in the database. | |
count | - Number of valid points in points. Returned to user. Passed by reference always. |
void Show_Partial_Polygon | ( | HC_KEY | key, | |
int | offset, | |||
int | request, | |||
HC_POINT * | points | |||
) |
Returns a portion of the vector of points along the edge of a given polygon, as referenced by a key.
key | - Unique numeric identifier pointing to a polygon in the database. | |
offset | - Starting point to be returned in points. The first point in the polygon is at offset0. | |
request | - Number of points requested by this call. | |
points | - Vector of x-y-z triplets for the coordinates along the edge of the polygon. (A simple N x 3 array may also be used.) Returned to user. Passed by reference always. |
void DShow_Polygon | ( | HC_KEY | key, | |
int * | count, | |||
HCD_POINT * | points | |||
) |
Similar to Show_Polygon(), but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.h.
key | - Unique numeric identifier pointing to a polygon in the database. | |
count | - Number of valid points in points. Returned to user. Passed by reference always. | |
points | - Vector of x-y-z triplets for the coordinates along the edge of the polygon. (A simple N x 3 array may also be used.) Returned to user. Passed by reference always. |