Bool.dll Library Logo

 

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.

 

BoolDllGetVersion

LogFileLevel_MT

GetErrorCoordinates

ResetIllegalCnts



 

BoolDllGetVersion

Syntax:

char *BoolDllGetVersion();

Function:

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

Error codes:

0:(success)
failure: non-zero value indicating that an error occurred during initialization.



LogFileLevel_MT

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.



GetErrorCoordinates

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.



ResetIllegalCnts

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 ...






  Documentation Download Price Revision History



ARTWORK CONVERSION SOFTWARE, INC.       Company Profile
417 Ingalls St., Santa Cruz, CA 95060    Tel (831) 426-6163     Fax 426-2824    email: info@artwork.com