registerfonts
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
The registerfonts function initializes the fonts graphics system.
Font files must be registered with the registerfonts function
before any other font-related library functions (getgtextextent,
setfont, outgtext, unregisterfonts) can be used.
The registerfonts function reads the specified files and loads
font-header information into memory. Each font header takes up
about 140 bytes of memory.
The <pathname> argument is the path specification and file name of
valid .FON files. The <pathname> argument can contain standard DOS
wildcard characters.
The font functions affect only the output from the font output
subroutine outgtext; no other output functions are affected by font
usage.
Return Value
The registerfonts function returns a positive value for the number
of fonts successfully registered. A negative return value indicates
failure. The following negative values may be returned:
Value Meaning
-1 No such file or directory
-2 One or more of the .FON files was not a valid binary
.FON file
-3 One or more of the .FON files is damaged
-4 Not enough free memory to register the font
-♦-