GPR_$TEXT                         GPR Calls                          GPR_$TEXT


NAME
     gpr_$text - writes text to the current bitmap.

FORMAT
     gpr_$text (string, string_length, status)

DESCRIPTION
     This routine writes text to the current bitmap, beginning at the current
     position.

     Text is written at the current position.  The origin of the first charac-
     ter of the character string is placed at the current position.  Gen-
     erally, the origin of the character is at the bottom left, excluding des-
     cenders of the character.

     Upon completion of the gpr_$text routine, the current position is updated
     to the coordinate position where the next character would be written.
     This is true even if the string is partly or completely clipped.  How-
     ever, the current position always remains within the boundaries of the
     bitmap.

   Input Parameters
     string
          The string to write, in gpr_$string_t format.  This is an array of
          up to 256 characters.

     string_length
          Number of characters in the string.  This is a 2-byte integer.  The
          maximum value is 256.

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

SEE ALSO
     gpr_$text16.

NOTES
     gpr_$text always clips to the edge of the bitmap, regardless of whether
     clipping is enabled.

     gpr_$text writes the characters in the current font which correspond to
     the ASCII values of the characters in the specified string.  If the font
     does not have a character which corresponds to a character in the string,
     gpr_$text leaves a space.  The size of the space is set by
     gpr_$set_space_size.

     gpr_$text can only print character strings.  If you want other kinds of
     data (for example, numbers) printed, you must convert the data to a char-
     acter string before calling gpr_$text.

     To write 16-bit text, use gpr_$text16.