HC_Insert_PolyCylinder
-
Key
HC_Insert_PolyCylinder(int p_count, Point const pts[], int r_count, float const radii[], char const *capping) - Key HC_Insert_PolyCylinder(int p_count, Point const pts, int r_count, float const radii, char const capping)
Create a polycylinder from a 3D array of points and an array of radii.
A polycylinder is a multi-segmented cylinder that can have varying radii at the ends of each segment. If p_count is greater than r_count the corresponding elements of pts and radii are paired up and elements beyond r_count will be wrapped around to the begining of radii. p_count should not be less than r_count. When the radii of two adjacent vertices are both 0, the section betwen those points will be rendered as a line.
This primitive can be used to create cones.
Any local vertex attributes will be thrown away if the polycylinder is edited.
HC_Edit_PolyCylinder, HC_Show_PolyCylinder, HC_Insert_PolylineParameters
p_count: number of items in pts
pts: Vector of x-y-z triplets for the coordinates of the center of the polycylinder. (A simple N x 3 array may also be used.) Passed by reference always.
r_count: number of items in radii
radii: array of radius lengths as measured from the centerline
capping: string specifying which ends to cap, either “first”, “second”, “none”, or “both”
Returns
The key to the inserted geometry, or -1 if an error occurred.