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

# fz_objt_edit_extract_cntrl_objs

Description

Extracts the control objects from a parametric object as new objects. As it is possible that more than one object is created, the pointers of the resulting objects are stored in the entity list passed in. The object passed in must be a parametric (control) object and must have nested control objects. If the object is a NurbZ object, the do_nurbz_depth and do_nurbz_curves arguments apply. If do_nurbz_depth is TRUE, the control objects extracted connect the control points of the nurbs surface in depth (v) direction. Otherwise they connect in the length (u) direction. If do_nurbz_curves is TRUE, the extracted objects become nurbs curves in the same degree as the surface. Otherwise they are simple vector lines. If the object passed in is not a NurbZ object, the two arguments are ignored.

Plugin Prototype

fzrt_error_td fz_objt_edit_extract_cntrl_objs(

fzrt_int | windex,
fz_objt_ptr | obj,
fzrt_boolean | do_nurbz_depth,
fzrt_boolean | do_nurbz_curves,
fz_enty_list_ptr | ent_list )

Parameters

windex [Input]

project window index

obj [Input]

object

do_nurbz_depth [Input]

If TRUE, the control objects extracted connect the control points of the nurbs surface in depth (v) direction, otherwise they connect in the length (u) direction.
Note: Only applies to Nurbz objects

do_nurbz_curves [Input]

If TRUE, the extracted objects become nurbs curves in the same degree as the surface, otherwise they are simple vector lines.
Note: Only applies to Nurbz objects

ent_list [Result]

list of extracted control object pointers

Returns

Error codes

Availability

5.0.0.0

Example Files

util_objt_topo.fsl

Function Set

fz_model_fset

Defined in

fz_objt_api.h