charst(3G)charst(3G)NAME
charst, lchstr - draws a string of characters
FORTRAN 77 SPECIFICATION
subroutine charst(str, length)
character*(*) str
integer*4 length
subroutine lchstr(type, str, length)
integer*4 type
character*(*) str
integer*4 length
PARAMETERS
str expects a pointer to the memory containing a sequence of
character id's.
type expects one of the following symbolic constants defined in
<gl/fgl.h>:
Each character id is represented
by a single, unsigned byte.
STRB
Each character id is represented
by two, consecutive unsigned
bytes.
STR2B
Each character id is represented
by three, consecutive unsigned
bytes.
STR3B
Each character id is represented
by four, consecutive unsigned
bytes.
STR4B
Each character id is represented
by a 16-bit unsigned integer.
STR16
Each character id is represented
by a 32-bit unsigned integer.
STR32
length expects the number of characters in the string.
DESCRIPTIONcharst and lchstr draw a string of text using the current raster font,
color and writemask. The first character in the string is drawn at the
current character position. After each character is drawn, the
character's x-pixel spacing value is added to the x-coordinate of the
current character position, and if defined using deflfo, the character's
y-pixel spacing value is added to the y-coordinate.
For strings displayed with lchstr sequences of character id's are
converted to character values using the following formulas for the i-th
character in unsigned byte-string s:
STRB s[i]
STR2B (s[2*i]*256) + s[2*i+1]
Page 1
charst(3G)charst(3G)
STR3B ((s[3*i]*256) + s[3*i+1])*256 + s[3*i+2]
STR4B (((s[4*i]*256) + s[4*i+1])*256) + s[4*i+2])*256 + s[4*i+3]
For types STR16 and STR32, integer character id's correspond directly to
character values.
The call charstr(str) is equivalent in all cases to the call
lcharstr(STR_B,str). charst and lchstr may be used with raster fonts
defined by either defras or deflfo.
Characters not defined in the current raster font are ignored.
SEE ALSO
charst, cmov, deflfo, defras, font, lstwid, strwid, getcpo
Page 2
