formZ SDK | 4.0 Call Back Reference | Object Attributes
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, |
src_obj, | |
fzrt_int | src_indx, |
fzrt_int | dst_windex, |
dst_obj, | |
fzrt_int | dst_indx, |
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
Defined in