formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Control Objects | Symbol

# fz_objt_cmpt_place

Description

Places a new component group. The component tag is passed in as lev_ptr. Origin, scale and rotation are optional and substituted by (0,0,0) for origin, (1,1,1) for scale and (0,0,0) for rotation.

Plugin Prototype

fzrt_error_td fz_objt_cmpt_place(

fzrt_int | windex,
fz_tag_td * | cmpt_tag,
fz_xyz_td * | origin_ptr,
fz_xyz_td * | scale_ptr,
fz_xyz_td * | rotation_ptr,
fz_symb_ins_color_opt_enum | color_opts,
fz_symb_ins_layer_opt_enum | layer_opts,
fzrt_boolean | use_lights,
fz_grup_ptr * | new_grup )

Parameters

windex [Input]

project window index

cmpt_tag [Input]

definition level

origin_ptr [Input, Optional]

origin (placement point).

Default Value: {0.0, 0.0, 0.0}

scale_ptr [Input, Optional]

scale factor.

Default Value: {1.0, 1.0, 1.0}

rotation_ptr [Input, Optional]

3d rotation angles, applies in z y x order.

Default Value: {0.0, 0.0, 0.0}

color_opts [Input]

color options

layer_opts [Input]

layer options

use_lights [Input]

use lights

new_grup [Result]

component group

Returns

Error codes

Availability

7.0.0.0

Example Files

util_symb_test.fsl

See Also

fz_symb_def_model_create,

Function Set

fz_model_fset

Defined in

fz_objt_symb_api.h