fgf_undefine() (Fastgraph/Fonts)

Win32 DirectX Fastgraph/Light

Prototype

void fgf_undefine (int handle);

Sub fgf_undefine (ByVal handle As Long)

procedure fgf_undefine (handle : integer);

Description

The fgf_undefine() function releases the handle for a font loaded with fgf_define(). It makes the handle again available but does not release the memory used by the font. Normally you only need to use fgf_undefine() when you've loaded the maximum allowable 256 fonts and need to make one or more of the fonts temporarily unavailable so your program can load additional fonts.

Parameters

handle is the font handle, between 1 and 256. Alternatively, handle can be negative if you want to release all font handles.

Return value

none

Restrictions

This function has no effect if there is no font associated with the specified handle.

Do not use fgf_undefine() to release font handles for fonts loaded with fgf_load() (use fgf_unload() for this purpose).

See also

fgf_define(), fgf_unload()