formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Editing Operations

# fz_objt_edit_replace

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,
fz_objt_ptr | src_objt,
fz_objt_ptr * | dst_objts,
fzrt_int | n_dst_objts,
fzrt_boolean | make_clones,
fzrt_boolean | scale,
fzrt_boolean | 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

util_objt_clones.fsl

Function Set

fz_model_fset

Defined in

fz_objt_api.h