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_Polyline

Parameters

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.