glcStringType(3G) OpenGL Character Renderer glcStringType(3G)
NAME
glcStringType - assign a value to GLCSTRINGTYPE
C SPECIFICATION
void glcStringType( GLCenum inStringType )
PARAMETERS
inStringType Value to assign to GLCSTRINGTYPE.
DESCRIPTION
glcStringType assigns the value in inStringType to the variable
GLCSTRINGTYPE. GLC supports the string types GLCUCS1, GLCUCS2, and
GLCUCS4.
Every character string used in the GLC API is represented as a zero-
terminated array, unless otherwise specified. The value of the variable
GLCGLCSTRINGTYPE determines the interpretation of the array. The
values GLCUCS1, GLCUCS2, and GLCUCS4 specify that each array element
is a UCS code of type GLubyte, GLushort, or GLint, respectively. The
initial value of GLCSTRINGTYPE is GLCUCS1.
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 GLCSTRINGTYPE. 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
GLCSTATEERROR is generated if the issuing thread has no current GLC
context.
ASSOCIATED GETS
glcGeti with argument GLCSTRINGTYPE
Page 1