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

fz_objt_edit_reduce_mesh

Description

Reduces the meshing of an object based on the angle of adjacent faces. Also reduces the segmentation of face boundaries, based on the angle between the segments. If do_color is TRUE, only faces with the same surface style are reduced. Likewise if do_tspace is TRUE, only faces which belong to the same texture space are reduced.
The optional face_list parameters allow for specific faces to be reduced.

Plugin Prototype

fzrt_error_td fz_objt_edit_reduce_mesh(

fzrt_int

windex,

fz_objt_ptr

obj,

double

face_angle,

double

edge_angle,

fzrt_boolean

do_color,

fzrt_boolean

do_tspace,

fzrt_int *

face_list,

fzrt_int

n_face_list )

Parameters

windex [Input]

project window index

obj [Input, Result]

object

face_angle [Input]

face angle. If two adjacent face enclose an angle less than this value, they are merged together. The angle is measured between the normal directions (perpendiculars) of the faces. An angle of 0.0 indicates that both faces are parallel.

Range: 0.0 < face_angle < PI/4.0 (45 degrees)

edge_angle [Input]

edge angle. If two adjacent consecutive edges enclose an angle less than this value, they are merged together. The angle is measured between the normal directions (perpendiculars) of the edges. An angle of 0.0 indicates that both edges are collinear.

Range: 0.0 < edge_angle < PI/4.0 (45 degrees)

do_color [Input]

if TRUE, only faces with the same surface style are reduced, otherwise all faces are reduced

do_tspace [Input]

if TRUE, only faces which belong to the same texture space are reduced, otherwise all faces are reduced

face_list [Input, Optional]

list of faces to be reduced

n_face_list [Input, Optional]

number of faces in list

Returns

Error codes

Availability

5.0.0.0

Example Files

util_objt_meshes.fsl

Function Set

fz_model_fset


Defined in

fz_objt_api.h