GPR_$SET_TEXT_FONT                GPR Calls                 GPR_$SET_TEXT_FONT


NAME
     gpr_$set_text_font - establishes a new font for subsequent text opera-
     tions.

FORMAT
     gpr_$set_text_font (font_id, status)

DESCRIPTION
     This routine establishes a new font for subsequent text operations.

     There is no default text font.  A program must load and set the font.

   Input Parameters
     font_id
          Identifier of the new text font.  This is a 2-byte integer.

   Output Parameters
     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$load_font_file, gpr_$inq_text.

NOTES
     Obtain the font-id when loading a font with gpr_$load_font_file.

     Call gpr_$set_text_font for each main memory bitmap.  Otherwise, an error
     is returned (invalid font id).