formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Editing Operations

# fz_objt_edit_join_open_wires

Description

Join two 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. The resulting object is obj1, which contains all the segments from the original obj1 and obj2. obj2 remains unaltered.
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
HINTS :
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 two wires form a closed loop.

Plugin Prototype

fzrt_error_td fz_objt_edit_join_open_wires(

fzrt_int | windex,
fz_objt_ptr | obj1,
fz_objt_ptr | obj2,
fzrt_boolean | keep_smooth )

Parameters

windex [Input]

project window index

obj1 [Input, Result]

first wire object. Will also contain the joined second object after the operation is complete.

obj2 [Input]

second wire object

keep_smooth [Input]

If the two wires are of mixed type (smooth/facetted), this argument determines whether the result stays smooth or facetted

Returns

Error codes
MODEL_ERR_NOT_OPEN_WIRE one or both objects not an open wire
MODEL_ERR_WIRES_DONT_TOUCH nothing joined, wires don't touch

Availability

5.0.0.0

Example Files

util_objt_cnstr_plin.fsl

See Also

, fz_objt_cnstr_arc,, ,, ,

Function Set

fz_model_fset

Defined in

fz_objt_api.h