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