glcNewFontFromMaster(3G) OpenGL Character Renderer glcNewFontFromMaster(3G)NAME
glcNewFontFromMaster - create a new font from a master
C SPECIFICATION
GLint glcNewFontFromMaster( GLint inFont,
GLint inMaster )
PARAMETERS
inFont Specifies the ID of the new font.
inMaster Specifies the master from which to create the new font.
DESCRIPTION
glcNewFontFromMaster creates a new font from the master identified by
inMaster and gives it the font ID inFont. If inFont is already the ID of
a font, glcNewFontFromMaster generates GLC_PARAMETER_ERROR and returns
zero.
If the command succeeds, it returns inFont.
A font is a stylistically consistent set of glyphs that can be used to
render some set of characters. Each font has a family name (for example
Palatino) and a state variable that selects one of the faces (for example
Regular, Bold, Italic, BoldItalic) that the font contains. A typeface is
the combination of a family and a face (for example Palatino Bold).
A font is an instantiation of a master. A master is a representation of
the font that is stored outside of GLC in a standard format such as
TrueType or Type1. A named list of masters is called a catalog. A catalog
may be implemented as a file system directory containing master files. A
list of catalog names defines the list of masters that can be
instantiated (that is, become fonts) in a GLC context.
ERRORS
GLC_PARAMETER_ERROR is generated if inFont is already the ID of a font.
GLC_STATE_ERROR is generated if the issuing thread has no current GLC
context.
ASSOCIATED GETS
glcGetListi with argument GLC_FONT_LIST
glcGeti with argument GLC_FONT_COUNT
glcIsFont
SEE ALSO
glcGenFontID, glcNewFontFromFamily, glcDeleteFont
Page 1
