HC_Show_Polyline

void HC_Show_Polyline(Key key, int *count, Point points[])
void HC_Show_Polyline(Key key, int count, Point points)

Returns the vector of points along the polyline, as referenced by a key.

Show_Polyline finds the coordinates of the points along the edge of the polyline in the database that correspond to the given key. You could use this function, for example, to compute the length of a polyline selected by the user. The key for the polyline might come from Show_Selection_Element() or Find_Contents(), or it might have been saved by your program when the polyline was created (via Insert_Polyline() ).

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.

If the polyline was created using a negative value for count, Show_Polyline() will return a negative value.

HC_Show_Selection_Element, HC_Insert_Polyline, HC_Get_Selection, HC_Begin_Contents_Search, HC_Compute_Coordinates.

Parameters

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.