C++ Syntax

bool

MKI_HatchAddObjectProc(

MKI_CONST_GEO_OBJECT_PTR f_pGeoObject,

__int32 f_nScanLineID,

void* f_pUserData );

typedef bool

(*MKI_HATCHADDOBJECT_PROC)(

MKI_CONST_GEO_OBJECT_PTR f_pGeoObject,

__int32 f_nScanLineID,

void* f_pUserData );

This callback procedure is called once for each object to be added to a path after starting a hatching enumeration by means of the MKI_EnumerateHatchLine or MKI_EnumerateHatchBlock procedure. A path consists of objects with the same MKI_XPROPERTY set.

Parameters

GeoObject

[MKI_CONST_GEO_OBJECT_PTR] Address of a structure that contains the object to be added to the current path. Currently, only the types MKI_OBJ_LINE and MKI_OBJ_ARC are supported. If you started the hatching enumeration by means of the MKI_EnumerateHatchLine procedure all partial lines on the same scan line as well as the scan lines relative to each other are sorted. I.e., the coordinates of the previous partial line are always greater or smaller respectively than the coordinates of the current partial line. The same is true for scan lines.

ScanLineID

[__int32] Identifier of the scan line. The first value passed after the enumeration was started is always greater or equal 0. If the hatching enumeration was started by means of the MKI_EnumerateHatchBlock procedure this value is always 0 because this value wouldn't make any sense since also objects of type MKI_OBJ_ARC could be passed. When hatching, each new scan line will have its own identifier (incremented by 1). By comparing two identifiers, the plug-in can detect whether the hatching has jumped to a new scan line. A scan line can contain up to 500 partial lines.

UserData New in Version 2014.0

[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_HatchAddObjectProc is only a placeholder, the procedure may have any name.