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>:

                          Each character is represented by
                          a single unsigned byte.
               STR_B

                          Each character is represented by
                          two, consecutive unsigned bytes.
                          The first byte is most
                          significant.
               STR_2B



                          Each character is represented by
                          three, consecutive unsigned
                          bytes.  The first byte is most
                          significant.  The last byte is
                          least significant.
               STR_3B




                          Each character is represented by
                          four, consecutive unsigned bytes.
                          The first byte is most
                          significant.  The last byte is
                          least significant.
               STR_4B




                          Each character is represented by
                          a 16-bit unsigned integer.
               STR_16

                          Each character is represented by
                          a 32-bit unsigned integer.
               STR_32



     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.
SEE ALSO
     deflfont, getlwidth, lcharstr, mapw, mapw2

NOTE
     This routine is available only in immediate mode.