C++ Syntax

bool

MKI_CalcPointInsideObject(

MKI_CONST_ENTITY_OBJECT_PTR f_pObj,

MKI_CONST_POINT_REF f_rPoint,

double f_dTolerance,

bool& f_rfUncertain );

Determines whether a point lies within the area of the given object Obj or not.

Parameters

Obj

[MKI_CONST_ENTITY_OBJECT_PTR] Address of the object whose area shall be used for the inside/outside check. It must be of one of the following object types (see MKI_OBJ_*):

MKI_OBJ_CIRCLE

MKI_OBJ_SECTOR

MKI_OBJ_SEGMENT

MKI_OBJ_SURFACE

MKI_OBJ_ELLIPSE

MKI_OBJ_ESECTOR

MKI_OBJ_ESEGMENT

MKI_OBJ_HYPERLINK

MKI_OBJ_GEOCIRCLE

MKI_OBJ_GEOELLIPSE

Point

[MKI_CONST_POINT_REF] Coordinates of the point to check.

Tolerance

[double] Tolerance for the inside/outside check.

Uncertain

[bool&] This value will be set by the function to either true (if the point lies so close to the object’s border that the inside/outside check could not be performed with certainty) or false (if the inside/outside check is reliable).

Return Value

Returns true if given object is of a correct type and the point lies within the given object’s area. Otherwise, false is returned.