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

# fz_objt_edit_mesh_face

Description

Meshes a face of an object into a set of rectangular faces. The size and orientation of the meshed faces are determined by a 2D grid. This grid has separate dimensions in x and y. The x direction is determined by the faces first segment plus a rotation. The mesh options determine the grid x/y dimension (x and y of FZ_OBJT_MESH_OPTS_IVAL with z ignored) and rotation (z angle of FZ_OBJT_MESH_OPTS_ROTATION, with x and y angle ignored). The x and y value of FZ_OBJT_MESH_OPTS_ORIGIN determines an additional translation of the grid from the face's first point, relative to the face's x and y axis. Meshing can be performed the in x and y dimensions, or in x and y separately. This is again determined by the mesh options ( FZ_OBJT_MESH_OPTS_USE_IVAL_X and FZ_OBJT_MESH_OPTS_USE_IVAL_Y, with FZ_OBJT_MESH_OPTS_USE_IVAL_Z not used)
Smooth and controlled objects are converted to plain facetted objects. Objects must be solids of surfaces.

Plugin Prototype

fzrt_error_td fz_objt_edit_mesh_face(

fzrt_int | windex,
fz_objt_ptr | obj,
fzrt_int | findx,
fz_objt_mesh_opts_ptr | opts )

Parameters

windex [Input]

project window index

obj [Input, Result]

object

findx [Input]

face index

opts [Input, Optional]

mesh options

Returns

Error codes

Availability

5.0.0.0

Example Files

util_objt_meshes.fsl

See Also

Function Set

fz_model_fset

Defined in

fz_objt_api.h