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 GLC_NONE.

NOTES
     Changing the map of a font is possible but changing the map for a master
     is not.

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

SEE ALSO
     glcFontMap