charst(3G)

NAME
     charst, lchstr - draws a string of characters

FORTRAN 77 SPECIFICATION
     subroutine charst(str, length)
     character*(*) str
     integer*4 length

     subroutine lchstr(type, str, length)
     integer*4 type
     character*(*) str
     integer*4 length

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/fgl.h>:

                         Each character id is represented
                         by a single, unsigned byte.
               STRB

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


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


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


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

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


     length   expects the number of characters in the string.

DESCRIPTION
     charst and lchstr 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 deflfo, the character's
     y-pixel spacing value is added to the y-coordinate.

     For strings displayed with lchstr sequences of character id's are
     converted to character values using the following formulas for the i-th
     character in unsigned byte-string s:

       STRB      s[i]
       STR2B     (s[2*i]*256) + s[2*i+1]
       STR3B     ((s[3*i]*256) + s[3*i+1])*256 + s[3*i+2]
       STR4B     (((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.

     The call charstr(str) is equivalent in all cases to the call
     lcharstr(STR_B,str).   charst and lchstr may be used with raster fonts
     defined by either defras or deflfo.


     Characters not defined in the current raster font are ignored.


SEE ALSO
     charst, cmov, deflfo, defras, font, lstwid, strwid, getcpo