formZ SDK | 4.0 Call Back Reference | Object Attributes

# fz_attr_cbak_objt_merge

Description

Custom attribute merge function (Optional). This function is called whenever part (or all) of an object was appended to or merged with another object. This callback function gives the plugin the opportunity to make adjustments to the attributes of appended faces, curves segments. This function may be called for any of the topological levels which contain attribute data.
When this function is called, dst_obj already contains the merged data, including any copied attributes. The dst_indx parameter contains the face, curve or segment index of the entity which was merged, or -1, if the topological level is the object level. src_obj is the original object which was merged and src_indx is the index of the original face, curve or segment, if the topological level is the object level.
The topo_level parameter indicates for which topological level this function is called.

Plugin Prototype

fzrt_error_td fz_attr_cbak_objt_merge(

fzrt_int | src_windex,
fz_objt_ptr | src_obj,
fzrt_int | src_indx,
fzrt_int | dst_windex,
fz_objt_ptr | dst_obj,
fzrt_int | dst_indx,
fz_objt_topo_level_enum | topo_level )

Parameters

src_windex [Input]

project of the source object

src_obj [Input]

source object

src_indx [Input]

entity index of the source object. If the topo_level parameter is FZ_OBJT_TOPO_LEVEL_OBJT, src_indx is passed as -1. If the topo_level parameter is FZ_OBJT_TOPO_LEVEL_FACE, src_indx is the face index etc.

dst_windex [Input]

project of the destination object

dst_obj [Input]

destination object

dst_indx [Input]

entity index of the destination object. If the topo_level parameter is FZ_OBJT_TOPO_LEVEL_OBJT, dst_indx is passed as -1. If the topo_level parameter is FZ_OBJT_TOPO_LEVEL_FACE, dst_indx is the face index etc.

topo_level [Input]

The topological level for which the merge operation occurs.

Returns

Error codes

Availability

5.0.0.0

Function Set

fz_attr_cbak_fset

Defined in

fz_objt_attr_api.h