HM_ExtAPI::MeshGetNextGrid()

Returns the next grid point in a mesh referenced by a mesh object.

Syntax

bool MeshGetNextGrid(
const HM_EntityMesh& hmesh,
HM_EntityGrid & hgrid
);

Type

HyperWorks Tcl Query Command

Description

The function MeshGetNextGrid is used together with the function HM_ExtAPI::MeshGetFirstGrid() to iterate through all the grid points contained in the mesh referenced by the mesh object. The call to MeshGetFirstGrid resets internal grid counter of the mesh object to the first grid point. The following calls to MeshGetNextGrid increment the counter until all grid points 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

hmesh
[in] - Handle to mesh object that was returned by previous calls to API functions.
hgrid
[out] - Handle to the next grid point in the mesh referenced by mesh object. The value of the handle is zero in case the mesh does not have grid points, or if all grid points were already returned by previous calls to MeshGetNextGrid function.

Errors

None.