HM_ExtAPI::MeshGetNextComponent()

Returns the next mesh component in a mesh object.

Syntax

bool MeshGetNextComponent(
const HM_EntityMesh& hmesh,
HM_EntityMeshComponent& hcomp
);

Type

HyperMesh Ext API Function

Description

This is used together with the funciton HM_ExtAPI::MeshGetFirstComponent() to iterate through all the components contained in the mesh referenced by the mesh object. The call to HM_ExtAPI::MeshGetFirstComponent() resets the internal component counter of the mesh object to the first component. Subsequent calls to HM_ExtAPI::MeshGetNextComponent() increment the counter until all components are iterated.

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

Requires including hm_extapi.h.

Inputs

hmesh
[in] - Handle to mesh object that was returned by previous calls to API functions.
hcomp
[out] - Handle to the next mesh component in the mesh referenced by the mesh object. The value of the handle is zero if the mesh does not have components or if all components were already returned by previous calls to this function.

Errors

None.

Version History

11.0.101