formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Editing Operations
Description
Replaces the geometry of all destination objects (in array dst_objts) with the geometry of the source object (src_objt). The geometry of the source object is copied to each destination object and transformed by the matrix, which transforms the object axes of the source object into the object axes of the destination object. If the make_clones flag is set to TRUE, the replaced objects become clones of the source object. If the scale flag is TRUE, the copied geometry is scaled, so that the bounding box of the source object fits into the bounding box of the destination object, as measured before the copy operation. if the scale_uniform is also set to TRUE, the scale factor is allowed to be non uniform. That is, geometry is scaled so that the two bounding boxes match exactly. If scale_uniform is set to FALSE, the smallest scale factor is used for x, y and z scale.
Plugin Prototype
fzrt_error_td fz_objt_edit_replace(
fzrt_int | windex, |
src_objt, | |
dst_objts, | |
fzrt_int | n_dst_objts, |
make_clones, | |
scale, | |
scale_uniform ) |
Parameters
windex [Input]
project window index
src_objt [Input]
source object, from which the geometry is copied
dst_objts [Input]
an array of destination objects, to which the geometry is copied
n_dst_objts [Input]
the number of objects in the dst_objts array
make_clones [Input]
set to TRUE, if the destination objects and the source object need to be turned into a clone family
scale [Input]
set to TRUE if the scale of the destination objects needs to be maintained
scale_uniform [Input]
set to TRUE if the scale can be non uniform
Returns
Error codes
Availability
5.0.0.0
Example Files
Function Set
Defined in