glcStringType(3G)	  OpenGL Character Renderer	     glcStringType(3G)

NAME    [Toc]    [Back]

     glcStringType - assign a value to GLC_STRING_TYPE

C SPECIFICATION    [Toc]    [Back]

     void glcStringType( GLCenum inStringType )

PARAMETERS    [Toc]    [Back]

     inStringType  Value to assign to GLC_STRING_TYPE.

DESCRIPTION    [Toc]    [Back]

     glcStringType assigns the value in	inStringType to	the variable
     GLC_STRING_TYPE. GLC supports the string types GLC_UCS1, GLC_UCS2,	and
     GLC_UCS4.

     Every character string used in the	GLC API	is represented as a zeroterminated
	array, unless otherwise	specified.  The	value of the variable
     GLC_GLC_STRING_TYPE determines the	interpretation of the array. The
     values GLC_UCS1, GLC_UCS2,	and GLC_UCS4 specify that each array element
     is	a UCS code of type GL_ubyte, GL_ushort,	or GL_int, respectively. The
     initial value of GLC_STRING_TYPE is GLC_UCS1.

     Some GLC commands return strings. The return value	of these commands is a
     pointer to	a string return	buffer in the issuing thread's current GLC
     context. This pointer is valid until the next GLC command is issued. The
     pointer may be used as a parameter	to the next GLC	command. The client
     must copy the returned string to a	client-provided	buffer if the value of
     the string	is needed after	the next GLC command is	issued.

     The value of a character code in a	returned string	may exceed the range
     of	the character encoding selected	by GLC_STRING_TYPE. In this case, the
     returned character	is converted to	a character sequence \<hexcode>, where
     \ is the charcter REVERSE SOLIDUS (U+5C), < is the	character LESS-THAN
     SIGN (U+3C), > is the character GREATER-THAN SIGN (U+3E), and hexcode is
     the original character code represented as	a sequence of hexadecimal
     digits. The sequence has no leading zeros,	and alphabetic digits are in
     upper case.

ERRORS    [Toc]    [Back]

     GLC_STATE_ERROR is	generated if the issuing thread	has no current GLC
     context.

ASSOCIATED GETS    [Toc]    [Back]

     glcGeti with argument GLC_STRING_TYPE


									PPPPaaaaggggeeee 1111