HC_Insert_Polyline

Key HC_Insert_Polyline(int count, Point const points[])
Key HC_Insert_Polyline(int count, Point const points)

Generates a connected chain of line segments. Can be used to approximate arcs.

Insert_Polyline() is the most basic way of inserting a connected sequence of lines into a scene.

The visual difference between lines created with Insert_Polyline() and those created using a series of calls to Insert_Line() is just that the Line Pattern, if any, flows smoothly and without interruption around corners.

Insert_Polyline() does require all the coordinates to be supplied. If the coordinates are not known or are being supplied from a construction operation, use Restart_Ink() and Insert_Ink(). The final result will be the same.

Changing the values of the line color, line weight, and line pattern attributes can vary the way polylines are depicted.

Users can create a disjointed polyline by supplying an even, negative value for count. This will cause the polyline to appear as a collection of 2-point line segments.

If you only work in two dimensions, specify all the z coordinates as zero. (The system notices and optimizes the drawing.)

There is no requirement for the points in a polyline all to be coplanar.

In most cases line patterns will flow smoothly around the corners of a polyline.

HC_Insert_Polygon, HC_Insert_Line, HC_Insert_Ink, HC_Insert_Shell, HC_Insert_Mesh, HC_Insert_Circular_Arc, HC_Insert_Elliptical_Arc, HC_Set_Line_Pattern, HC_Set_Color, HC_Set_Line_Weight, HC_Set_Visibility, HC_Renumber_Key.

Parameters

count: Number of valid points in points.

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.) Passed by reference always.

Returns

The key to the inserted geometry, or -1 if an error occurred.