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
See Also
MESH_CLIP, MESH_DECIMATE, MESH_ISSOLID, MESH_MERGE, MESH_NUMTRIANGLES, MESH_OBJ, MESH_SMOOTH, MESH_VALIDATE, MESH_VOLUME