Informational Functions

These functions are used to obtain information: version of bool.dll, error coordinates reported by the boolean main function or to clear the error coordinates.

Syntax:

char *QisBool_Version();

Function:

returns a string giving the version number of the boolean library.

Error codes:

Syntax:

void QisBool_GetIllegalPolygonIndices
(int* pn, int** pxy, void *bdll_handle);

Function:

tests a polygon for convex (in X or both in X and Y) and breaks down polygons as needed to insure that they are convex. A single source polygon can generate multiple convex polygons.

Inputs:

Outputs:

pn - an integer that indicates the number of vertex pairs in the error coordinate array.

pxy - an array containing the vertex pairs for the error coordinates.

Note:

Whenever n > 0, memory has been allocated for the pxy array and the user should call QisBool_ReleaseArray(int* xy) to free that memory after he is done using the info in the coordinate array.

Syntax:

void ResetIllegalCnts(void *bdll_handle);

Function:

The value of iiegalpolys[bdll_handle] is reset to zero.

Inputs:

bdll_handle - handle of the thread

Notes

Programmer - please provide some information about which function generates this illegalpolys value and of what use one can make of it ...