formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Editing Operations
Description
Joins two or more open wires. Creates a composite curve, if one of the wires
is an arc, spline or composite curve. When joining vector lines,
the result remains a plain object.
As there may be more than one resulting object from sets of connected
wires, they are stored in the object list passed in. The source objects
remain unaltered.
The end points of the wires to be joined must touch (within
FZ_MATH_TOL_LIN tolerance). This function creates a closed wire, if
the wires form a closed loop.
If the two wires are of mixed input (smooth / facetted), keep_smooth
determines what the result is :
keep_smooth == TRUE : The result is smooth
keep_smooth == FALSE : The result is facetted
Plugin Prototype
fzrt_error_td fz_objt_edit_join_open_wires_multi(
fzrt_int | windex, |
src_obj, | |
fzrt_int | nobj, |
keep_smooth, | |
ent_list ) |
Parameters
windex [Input]
project window index
src_obj [Input]
array with all open wire object to be joined
nobj [Input]
the number of objects in the array
keep_smooth [Input]
If the two wires are of mixed type (smooth/facetted), this argument determines whether the result stays smooth or facetted
ent_list [Result]
list with new object pointers
Returns
Error codes
MODEL_ERR_NOT_OPEN_WIRE atleast one object is not an open wire
MODEL_ERR_WIRES_DONT_TOUCH nothing joined, wires don't touch
Availability
5.0.0.0
Example Files
See Also
, fz_objt_cnstr_arc,, ,, ,
Function Set
Defined in