HM_ExtAPI::GeomVertexGetFaces()

Returns faces connected to the vertex.

Syntax

bool GeomVertexGetFaces(
const HM_EntityGeomVertex & vertex,
int& faces_count,
HM_EntityGeomEdge * & faces
);

Type

HyperMesh Ext API

Description

The primary purpose of the function GeomVertexGetFaces is to query association of internal face points to corresponding face.

Each face connected to the vertex is returned only once.

To free arrays allocated for faces during the function call use the function HM_ExtAPI::MemoryFree.

If the function succeeds, the return value is true. If the function fails, the return value is false. To get extended value information, call HM_ExtAPI::GetLastErrorCode().

Requires including hm_extapi.h.

Inputs

vertex
[in] - Handle to vertex object that was returned by previous calls to API functions.
faces_count
[out] - Number of faces.
faces
[out] - Returns pointer to array of handles to faces. The number of values in the array is faces_count. The pointer is NULL if the vertex is not connected to any faces.

Errors

None.