HC_Show_Polygon
-
void
HC_Show_Polygon(Key key, int *count, Point points[]) - void HC_Show_Polygon(Key key, int count, Point points)
Returns the vector of points along the edge of the polygon referenced by a key.
Show_Polygon finds the coordinates of the points along the edge of the polygon in the database corresponding to the given key. You could use this ability, for example, to extract the data necessary to extrude a polygon selected by the user. The key for the polygon might come from Show_Selection_Element() or Find_Contents, or it might have been saved by your program when the polygon was created (via Insert_Polygon() ).
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, Insert_Polygon() will have trimmed it off as redundant.
HC_Show_Selection_Element, HC_Insert_Polygon, HC_Get_Selection, HC_Begin_Contents_Search, HC_Compute_Coordinates.Parameters
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.