glcGetFontMap(3G) OpenGL Character Renderer glcGetFontMap(3G)
NAME
glcGetFontMap - return the string name of a character
C SPECIFICATION
const GLCchar* glcGetFontMap( GLint inFont,
GLint inCode )
PARAMETERS
inFont Specifies the integer ID of the font from which to select the
character.
inCode Specifies the integer ID of the character in the font map.
DESCRIPTION
glcGetFontMap returns the string name of the character that the font
identified by inFont maps inCode to.
Every font has a font map associated with it. The font map is a table of
entries that map integer values to the name string that identifies the
character.
To change the map, that is, associate a different name string with the
integer ID of a font, use glcFontMap.
Every character code used in GLC is an element of the Universal
Multiple-Octet Coded Character Set (UCS) defined by the standards ISO/IEC
10646-1:1993 and Unicode 2.0 (unless otherwise specified). A UCS code is
denoted as U+hexcode, where hexcode is a sequence of hexadecimal digits.
Each UCS code corresponds to a character that has a unique name string.
For example, the code U+41 corresponds to the character LATIN CAPITAL
LETTER A.
If inCode cannot be mapped in the font, glcGetFontMap returns GLCNONE.
NOTES
Changing the map of a font is possible but changing the map for a master
is not.
ERRORS
GLCSTATEERROR is generated if the issuing thread has no current GLC
context.
SEE ALSO
glcFontMap
Page 1