GPR_$LOAD_FONT_FILE               GPR Calls                GPR_$LOAD_FONT_FILE


NAME
     gpr_$load_font_file - loads a font from a file.

FORMAT
     gpr_$load_font_file (pathname, pathname_length, font_id, status)

DESCRIPTION
     This routine loads a font from a file into the display's font storage
     area.

   Input Parameters
     pathname
          Pathname of the file containing the font, in name_$long_pname_t for-
          mat.  This is a character string.  If you supply a relative path-
          name, the system will search for the font in the current directory
          and then in the /sys/dm/fonts directory.

     pathname_length
          Number of characters in font file pathname.  This is a 2-byte
          integer.

   Output Parameters
     font_id
          Font identifier.  This is a 2-byte integer.  Available fonts are
          listed in the directory /sys/dm/fonts.

     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$set_text_font, gpr_$unload_font_file.

NOTES
     Use the font-id returned from this file as input for gpr_$set_text_font.

     You can call gpr_$load_font_file multiple times without unloading  fonts.
     However,  if you do want to unload a font, call the gpr_$unload_font_file
     routine.