Drop a registered font from the OKF Font Engine font list and release the allocated resources.
int OkfRelease( int handle );
Routine | Required Header |
OkfRelease | "okf.h" |
Libraries
OKLIB.A | Oankali's GP32 run-time library |
Return Value
In case of success OkfRelease returns the handle of the new current font, otherwise it returns -1. Look at okf.lastError for details on what happened.
Parameters
handle
The handle of the font to be released. The handle must belong to a valid registered font.
Remarks
The OkfRelease function releases the memory allocated by the registering function that registered the font (OkfLoadAndRegister, OkfRegister or OkfClone). The function then drops the font from the okf.pFonts font list.
If the dropped font is the current font, the first font in the okf.pFonts font list is chosen as the new current font. If the font list is empty, okf.font is initialized with 0.
OkfRelease returns the new current font handle.
Example
|
See Also
OKF Font Engine Routines, OKF Font Engine Constants, OkfLoadAndRegister, OkfRegister, OkfClone