charstr, lcharstr - draws a string of characters
void charstr(String str)
str expects a pointer to the memory containing a sequence of
type expects one of the following symbolic constants defined in
STR_B Each character id is represented
by a single unsigned byte.
STR_2B Each character id is represented
by two, consecutive unsigned
STR_3B Each character id is represented
by three, consecutive unsigned
STR_4B Each character id is represented
by four, consecutive unsigned
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.
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_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 STR_16 and STR_32, 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). 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.
cmov, charstr, deflfont, defrasterfont, font, lstrwidth, strwidth,
PPPPaaaaggggeeee 2222 [ Back ]