charstr(3G) charstr(3G)
NAME
charstr, lcharstr - draws a string of characters
C SPECIFICATION
void charstr(String str)
void lcharstr(type,str)
long type;
void *str;
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/gl.h>:
STR_B Each character id is represented
by a single unsigned byte.
STR_2B Each character id is represented
by two, consecutive unsigned
bytes.
STR_3B Each character id is represented
by three, consecutive unsigned
bytes.
STR_4B Each character id is represented
by four, consecutive unsigned
bytes.
STR_16 Each character id is represented
by a 16-bit unsigned integer.
STR_32 Each character id is represented
by a 32-bit unsigned integer.
DESCRIPTION
charstr and lcharstr 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 deflfont, the
character's y-pixel spacing value is added to the y-coordinate.
For strings displayed with lcharstr sequences of character id's are
converted to character values using the following formulas for the i-th
character in unsigned byte-string s:
STR_B s[i]
STR_2B (s[2*i]*256) + s[2*i+1]
STR_3B ((s[3*i]*256) + s[3*i+1])*256 + s[3*i+2]
STR_4B (((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.
Page 1
charstr(3G) charstr(3G)
The call charstr(str) is equivalent in all cases to the call
lcharstr(STRB,str). charstr and lcharstr may be used with raster fonts
defined by either defrasterfont or deflfont.
End of string is indicated by a character id with a character value of
zero. Characters not defined in the current raster font are ignored.
SEE ALSO
cmov, charstr, deflfont, defrasterfont, font, lstrwidth, strwidth,
getcpos
Page 2