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

# fz_objt_edit_join_open_wires_multi

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,
fz_objt_ptr * | src_obj,
fzrt_int | nobj,
fzrt_boolean | keep_smooth,
fz_enty_list_ptr | 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

util_objt_cnstr_plin.fsl

See Also

, fz_objt_cnstr_arc,, ,, ,

Function Set

fz_model_fset

Defined in

fz_objt_api.h