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