C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
_registerfonts
 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
                                    -♦-