GPR_$TEXT16 GPR Calls GPR_$TEXT16
NAME
gpr_$text16 - writes text consisting of 16-bit characters.
FORMAT
gpr_$text16 (t_array, t_arrayl, status)
DESCRIPTION
This routine writes text consisting of 16-bit characters to the current
bitmap, beginning at the current position. The text is written in the
current font.
Input Parameters
t_array
The array of 16-bit characters to write, in
gpr_$16bit_character_array_t format. This is an array of unsigned
2-byte integers.
t_arrayl
The number of 16-bit characters. This is a 2-byte integer.
status
Completion status, in status_$t format.
NOTES
This routine is not supported in frame mode.
The gpr_$text16 routine always clips to the edge of the bitmap, regard-
less of whether clipping is enabled.
The gpr_$text16 routine writes the 16-bit characters in the current font
that correspond to the values of the characters in the specified 16-bit
character array. If the font does not have a character that corresponds
to a character in the array, gpr_$text16 leaves a space.
The font sets the size of the space. To change the size of the space,
call gpr_$set_space_size.
Text is written at the current position. The origin of the first charac-
ter of the 16-bit character array is placed at the current position.
Generally, the origin of the character is at the bottom left, excluding
descenders of the character.
Upon completion of the gpr_$text16 routine, the current position is
updated to the coordinate position where the next character would be
written. This is true even if the text array is partly or completely
clipped. However, the current position always remains within the boun-
daries of the bitmap.
The gpr_$text16 routine can only print 16-bit character arrays. If you
want other kinds of data (for example, numbers) printed, you must convert
the data to a 16-bit character array before calling gpr_$text16.