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

                          Each character id is represented
                          by a single unsigned byte.
               STR_B

                          Each character id is represented
                          by two, consecutive unsigned
                          bytes.
               STR_2B


                          Each character id is represented
                          by three, consecutive unsigned
                          bytes.
               STR_3B


                          Each character id is represented
                          by four, consecutive unsigned
                          bytes.
               STR_4B


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

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


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


SEE ALSO
     cmov, charstr, deflfont, defrasterfont, font, lstrwidth, strwidth,
     getcpos