charstr(3G)							   charstr(3G)

NAME    [Toc]    [Back]

     charstr, lcharstr - draws a string	of characters

C SPECIFICATION    [Toc]    [Back]

     void charstr(String str)

     void lcharstr(type,str)
     long type;
     void *str;

PARAMETERS    [Toc]    [Back]

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

	       STR_B	  Each character id is represented
			  by a single unsigned byte.
	       STR_2B	  Each character id is represented
			  by two, consecutive unsigned
			  bytes.
	       STR_3B	  Each character id is represented
			  by three, consecutive	unsigned
			  bytes.
	       STR_4B	  Each character id is represented
			  by four, consecutive unsigned
			  bytes.
	       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.

DESCRIPTION    [Toc]    [Back]

     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.



									Page 1






charstr(3G)							   charstr(3G)



     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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222