HM_ExtAPI::ComponentGetNextGeomFace()
Returns the next face of the component.
Syntax
bool ComponentGetNextGeomFace(
const HM_EntityComponent& comp,
HM_EntityGeomFace& face
);Type
HyperMesh Ext API Function
Description
The function ComponentGetNextGeomFace is used together with the function HM_ExtAPI::ComponentGetFirstGeomFace() to iterate through all faces contained in the component. The call to ComponentGetFirstGeomFace resets internal component counter to the first face. The following calls to ComponentGetNextGeomFace increment the counter until all faces of the component are iterated.
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
- comp
- [in] - Handle to component object that was returned by previous calls to API functions.
- face
- [out] - Handle to the next face of the component. The value of the handle is zero in case if component does not contain faces or if all free faces were already returned by previous calls to ComponentGetFirstGeomFace and ComponentGetNextGeomFace.
Errors
None.