Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄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
                                    -♦-