lstrwidth(3G) lstrwidth(3G)
NAME
lstrwidth - returns the width of the specified text string
C SPECIFICATION
long lstrwidth(type,str)
long type;
void *str;
PARAMETERS
type expects one of the following symbolic constants defined in
<gl/gl.h>:
STR_B Each character is represented by
a single unsigned byte.
STR_2B Each character is represented by
two, consecutive unsigned bytes.
The first byte is most
significant.
STR_3B Each character is represented by
three, consecutive unsigned
bytes. The first byte is most
significant. The last byte is
least significant.
STR_4B Each character is represented by
four, consecutive unsigned bytes.
The first byte is most
significant. The last byte is
least significant.
STR_16 Each character is represented by
a 16-bit unsigned integer.
STR_32 Each character is represented by
a 32-bit unsigned integer.
str expects a pointer to the string whose width is to be computed.
The contents of the string should be consistent with respect to
the type parameter.
DESCRIPTION
lstrwidth returns the width of a text string in pixels, using the
character spacing parameters of the current raster font.
Multi-byte types (2B, 3B and 4B) are converted to character values using
the following formulas for character i 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]
End of string is indicated by a character value of zero.
Undefined characters have zero width.
Page 1
lstrwidth(3G) lstrwidth(3G)
SEE ALSO
deflfont, getlwidth, lcharstr, mapw, mapw2
NOTE
This routine is available only in immediate mode.
Page 2