formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Control Objects | Patch Object

# fz_objt_edit_patch_attach

Description

Attaches an open edge of the first patch to an open edge of the second patch. Note that the two required edges, could belong to the same patch or to different patches. The motion cause by this operation is applied to the first segment based on the movement type indicated ( FZ_OBJT_PATCH_ATTACH_MOVE_EDGE, FZ_OBJT_PATCH_ATTACH_MOVE_PATCH, FZ_OBJT_PATCH_ATTACH_MOVE_OBJECT).

Plugin Prototype

fzrt_error_td fz_objt_edit_patch_attach(

fzrt_int | windex,
fz_objt_ptr | src_obj,
fz_objt_ptr | dst_obj,
fzrt_int | edge_index1,
fzrt_int | edge_index2,
fzrt_boolean | do_smooth,
fzrt_boolean | by_ang,
double | att_ang,
fz_objt_patch_attach_move_type_enum | att_move_type,
fzrt_boolean | algn_norm,
fzrt_boolean | scale_patch )

Parameters

windex [Input]

project window index

src_obj [Input]

source object

dst_obj [Input]

destination object

edge_index1 [Input]

index of the first edge to be attached

edge_index2 [Input]

index of the second edge to be attached

do_smooth [Input]

smooth attachment when value is TRUE

by_ang [Input]

smooth attachment by angle when TRUE, do_smooth needs to be TRUE

att_ang [Input]

value of angle when by_ang is TRUE , 0.0 otherwise

att_move_type [Input]

move edge, move patch or move whole object

algn_norm [Input]

normals of two patches are aligned. only for move patch or move whole object

scale_patch [Input]

first edge is scaled up or down to match length of second edge

Returns

MODEL_ERR_WRONG_OBJT_TYPE - object passed in are not patches

Availability

5.0.0.0

Example Files

util_objt_patch_attach.fsl

See Also

fz_objt_cnstr_patch_opts_init, fz_objt_cnstr_patch_opts_finit, fz_objt_cnstr_patch_opts_finit, fz_objt_cnstr_patch_opts_get

Function Set

fz_model_fset

Defined in

fz_objt_ptch_api.h