glcStringType(3G) OpenGL Character Renderer glcStringType(3G)NAMEglcStringType - assign a value to GLC_STRING_TYPE
C SPECIFICATION
void glcStringType( GLCenum inStringType )
PARAMETERS
inStringType Value to assign to GLC_STRING_TYPE.
DESCRIPTIONglcStringType 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 zero-
terminated 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
GLC_STATE_ERROR is generated if the issuing thread has no current GLC
context.
ASSOCIATED GETS
glcGeti with argument GLC_STRING_TYPE
Page 1
