OkfLoadAndRegister

Load an OKF Font file located in the SMC card and register it.

int OkfLoadAndRegister( unsigned char *pFilename );

Routine Required Header
OkfLoadAndRegister "okf.h"
 

Libraries

OKLIB.A Oankali's GP32 run-time library
 

Return Value

In case of success OkfLoadAndRegister returns the handle of the new registered font, otherwise it returns -1. Look at okf.lastError for details on what happened.


Parameters

pFilename

String containing the path and filename of the OKF Font file you want to load and register.


Remarks

The OkfLoadAndRegister function loads the file pointed by pFilename into memory. It then analyses the file to see if it is a valid OKF Font file. In case of success, the font is automatically registered.

To release the registered font and recover allocated memory, use OkfRelease.


Example

int handle;

handle = OkfLoadAndRegister("gp:\\gpmm\\fonts\\fancy12.okf");
if (handle == -1)
{
  switch (okf.lastError)
  {
    case ...
  }
}


See Also

OKF Font Engine Routines, OKF Font Engine Constants, OkfRegister, OkfRelease