OkfRelease

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

int newCurrentFont;

// Release current font
newCurrentFont = OkfRelease(okf.font);


See Also

OKF Font Engine Routines, OKF Font Engine Constants, OkfLoadAndRegister, OkfRegister, OkfClone