Functions | |
void | Show_Polyline (HC_KEY key, int *count, HC_POINT *points) |
void | Show_Polyline_Count (HC_KEY key, int *count) |
void | Show_Partial_Polyline (HC_KEY key, int offset, int request, HC_POINT *points) |
void | DShow_Polyline (HC_KEY key, int *count, HCD_POINT *points) |
void Show_Polyline | ( | HC_KEY | key, | |
int * | count, | |||
HC_POINT * | points | |||
) |
Returns the vector of points along the polyline, as referenced by a key.
key | - Unique numeric identifier pointing to a polyline 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 polyline. (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 can call Show_Polyline_Count() first, which just returns the number of points in the polyline.
Show_Partial_Polyline() is useful when you want to look at just one or a few points of the polyline.
void Show_Polyline_Count | ( | HC_KEY | key, | |
int * | count | |||
) |
Finds the number of points in a given polyline. This is useful in determining the size of the data structure that must hold points.
key | - Unique numeric identifier pointing to a polyline in the database. | |
count | - Number of valid points in points. Returned to user. Passed by reference always. |
void Show_Partial_Polyline | ( | HC_KEY | key, | |
int | offset, | |||
int | request, | |||
HC_POINT * | points | |||
) |
Returns a portion of the vector of points along a given polyline, as referenced by a key.
key | - Unique numeric identifier pointing to a polyline in the database. | |
offset | - Starting point to be returned in points. The first point in the polyline 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 polyline. (A simple N x 3 array may also be used.) Returned to user. Passed by reference always. |
void DShow_Polyline | ( | HC_KEY | key, | |
int * | count, | |||
HCD_POINT * | points | |||
) |
Similar to Show_Polyline(), 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 polyline 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. |