◄Summary► ◄Details► ◄Example►                                   ◄Back►
 
  Argument
 
    pathname    DOS path for location of .FON files
 
  Returns
 
    Integer     Number of fonts registered; a negative value indicates
                failure
 
  Description
 
    The _RegisterFonts function initializes the fonts graphics system.
    Font files must be registered with _RegisterFonts before any other
    font-related function (_GetGTextExtent, _OutGText, _SetFont,
    _UnRegisterFonts) can be used.
 
    _RegisterFonts reads the specified files and loads font header
    information into memory. Each font header takes up about 140
    bytes of memory.
 
    The file name argument is the path specification and file name of
    valid .FON files. The file name can contain standard DOS wildcard
    characters.
 
    Note:  The font functions affect only text displayed using
    _OutGText.
 
    _RegisterFonts 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 exists
      -2       One or more of the .FON files was not a valid .FON file
      -3       One or more of the .FON files is damaged
      -4       Insufficient memory to register fonts
 
  _GrStatus Returns
 
    _GrCorruptedFontFile, _GrFontFileNotFound, _GrInsufficientMemory,
    _GrInvalidFontFile,