All Frameworks  Class Hierarchy  This Framework  Indexes

SPAcstr Global Function api_make_wire

outcome api_make_wire(	BODY*	`given_body`,
	int	`length_pts`,
	SPAposition[]	`array_pts`,
	BODY*&	`body`,
	AcisOptions*	`ao`	`= NULL` )

Creates a polygonal wire from an array of positions.

Role: This API constructs a polygonal wire from an array of positions. The wire is considered closed if the first and last points coincide.

Does not check that points other than adjacent points are distinct.

If given body is NULL, makes a new body. It leaves the new wire as first in wire list of body, new or old. Returns the body.

A single point wire can be made. However, such wires are not fully supported by Booleans and offsetting.

Errors: Pointer to given body is not to a BODY. Distance between adjacent points in list less than SPAresabs.

Limitations: Wires that are in single isolated point (characterized by an edge with null geometry) are not fully supported.

Effect: Changes model

Journal: Available

Parameters:

given_body: body to add wire to, or NULL for new body.
length_pts: number of span end points in array.
array_pts: array of points.
body: wire body returned.
ao: acis options.

This object is included in the file: cstrapi.hxx