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 *BoolDllGetVersion();

Function:

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

Error codes:

Syntax:

void LogfileLevel_MT(short logfilelevel, int bdll_handle);

Function:

used to define the level of detail in the log file.

Inputs:

logfilelevel 0=default, errors and warnings 1=information about polygons and vertices.

Note:

Level 1 can generate very large amounts of data and should be used for debugging purposes only.

Syntax:

void GetErrorCoordinates
(int* pn, int** pxy, int 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 BoolRelease_array(int* xy) to free that memory after he is done using the info in the coordinate array.

Syntax:

void ResetIllegalCnts(int 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 ...