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

fz_objt_edit_delete_multi

Description

Deletes one or more faces, curves, segments, or points from an object.
The faces are identified by their indices in the face_indx array. The curves must be holes. Outer boundary curves cannot be deleted. The curves are identified by their indices in the curv_indx array. The segments are identified by their indices in the segt_indx array. The points are identified by their indices in the pnt_indx array. If do_topo is TRUE, the faces are deleted topologically. Otherwise they are deleted geometrically.

Note : This function operates on smooth objects, only if do_topo is TRUE. Segments and points can be deleted only if the smooth object is either a wire or single face surface. Curves of smooth objects can not be deleted.
As it is possible that new objects are created, these objects are stored optionally in the entity_list passed in.

Plugin Prototype

fzrt_error_td fz_objt_edit_delete_multi(

fzrt_int

windex,

fz_objt_ptr

obj,

fzrt_int

face_indx[],

fzrt_int

nfaces,

fzrt_int

curv_indx[],

fzrt_int

ncurvs,

fzrt_int

segt_indx[],

fzrt_int

nsegts,

fzrt_int

pnt_indx[],

fzrt_int

npnts,

fzrt_boolean

do_topo,

fz_enty_list_ptr

ent_list )

Parameters

windex [Input]

project window index

obj [Input, Result]

object (must be facetted)

face_indx[] [Input, Optional]

array of face indices to delete

nfaces [Input, Optional]

number of faces in the array

curv_indx[] [Input, Optional]

array of curve indices to delete (curves must be holes)

ncurvs [Input, Optional]

number of curves in the array

segt_indx[] [Input, Optional]

array of segment indices to delete

nsegts [Input, Optional]

number of segments in the array

pnt_indx[] [Input, Optional]

array of point indices to delete

npnts [Input, Optional]

number of points in the array

do_topo [Input]

if TRUE, faces are deleted topologically, otherwise they are deleted geometrically

ent_list [Input, Optional]

list with new object pointers

Returns

Error codes

Availability

5.0.0.0

Example Files

util_objt_topo.fsl

See Also

,,,

Function Set

fz_model_fset


Defined in

fz_objt_api.h