C++ Syntax

bool

MKI_EnumPointsProc(

MKI_ENTITY_PTR f_pEntity,

MKI_BLOCK_PTR f_pBlock,

void* f_pUserData );

typedef bool

(*MKI_ENUMPOINTS_PROC)(

MKI_ENTITY_PTR f_pEntity,

MKI_BLOCK_PTR f_pBlock,

void* f_pUserData );

This callback procedure is called once for each identified point after starting an enumeration by means of the MKI_EnumeratePoints procedure.

Parameters

Entity

[MKI_ENTITY_PTR] Address of the entity containing the identified point. Even though this value is not declared as const, the object should not be altered directly! If you want to modify identified objects, be sure to first create a duplicate of those objects.

[Anyway, modifying an object directly in memory should only be done by advanced developers with deep knowledge of the internal memory structure of entities.

Block

[MKI_BLOCK_PTR] Address of the identified point data block. Even though this value is not declared as const, the point should not be altered directly! If you want to modify identified points, be sure to first create a duplicate of the objects containing those points.

UserData

[void*] User data pointer as passed to enumeration function.

Return Value

Should return true to continue the enumeration or false to stop it.

Comment

The name MKI_EnumPointsProc is only a placeholder, the procedure may have any name.

The enumeration will always enumerate all identified points of each object directly after each other, i.e. if you only want to enumerate all objects containing identified points, save the parameter Entity in a static variable and ignore all directly following calls with an equal value of Entity.