fgf_load() (Fastgraph/Fonts)

Win32 DirectX Fastgraph/Light

Prototype

int fgf_load (char *filename);

Function fgf_load (ByVal filename As String) As Long

function fgf_load (filename : string) : integer;

Description

The fgf_load() function loads a font from an external file. If the function is successful, the font just loaded becomes the current font.

Parameters

filename is the name of the file containing the font data. A device and path name may be included as part of the file name. The file name must be terminated by a null character (that is, a zero byte).

Return value

This function returns a font handle between 1 and 256 if successful. Use this font handle with fgf_select() to reference the font. If filename does not exist or is not a font file, if 256 fonts are already in use, or if there is not enough memory to load the font data, fgf_load() returns zero.

Restrictions

none

See also

fgf_define(), fgf_select(), fgf_unload()

Examples

FGFW1, FGFW2, FGFW3, FGFW5, FGFW6, FGFW7