The MESH_SURFACEAREA function computes various mesh properties to determine the mesh surface area, including integration of other properties interpolated on the surface of the mesh.

Syntax


Result = MESH_SURFACEAREA ( Verts, Conn [, AUXDATA=array] [, MOMENT=variable] )

Return Value


Returns the cumulative (weighted) surface area of the polygons in the mesh.

Note: The input polygonal mesh is assumed to contain only planar, convex polygons.

Arguments


Verts

Array of polygonal vertices [3, n].

Conn

Polygonal mesh connectivity array.

Keywords


AUXDATA

Array of input auxiliary data (one value per vertex). If present, these values are used to weight a vertex for the purpose of the area computation. The surface area integral will linearly interpolate these values over the surface of each triangle. The default weight is 1.0 which results in the basic polygon area.

MOMENT

If this keyword is present, it will return a three element float vector which corresponds to the first order moments computed with respect to the X, Y and Z axis. The computation is:

where a is the (weighted) area of the triangle and c is the centroid of the triangle, thus

yields the (weighted) centroid of the polygon mesh.

Version History


5.5

Introduced

See Also


MESH_CLIP, MESH_DECIMATE, MESH_ISSOLID, MESH_MERGE, MESH_NUMTRIANGLES, MESH_OBJ, MESH_SMOOTH, MESH_VALIDATE, MESH_VOLUME