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►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _registerfonts function initializes the fonts graphics system.
     Font files must be registered with the _registerfonts function
     before any other font-related library function (_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 filename of
     valid .FON files. The <pathname> argument can contain standard DOS
     wildcards.
 
     The font functions affect only the output from the font output
     function _outgtext; no other run-time output functions are
     affected by font usage.
 
     Return Value
 
     The _registerfonts function returns a positive value that
     indicates 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
                                    -♦-