glcAppendCatalog(3G)

NAME
     glcAppendCatalog, glcPrependCatalog - append a catalog to the catalog
     list


C SPECIFICATION
     void glcAppendCatalog( const GLCchar *inCatalog )


C SPECIFICATION
     void glcPrependCatalog( const GLCchar *inCatalog )


PARAMETERS
     inCatalog  Specifies the catalog to append (or prepend) to the list
                GLC_CATALOG_LIST.

DESCRIPTION
     The command appends (or prepends) a catalog to the catalog list
     GLC_CATALOG_LIST.

     The catalog is represented as a zero-terminated string. The
     interpretation of this string is specified by the value of the variable
     GLC_STRING_TYPE (see glcintro).

     A catalog is a path to a file named "fonts.dir" which is a list of
     masters. A master is a representation of a font that is stored outside
     GLC in a standard format such as TrueType or Type1.

     A catalog defines the list of masters that can be instantiated (that is,
     be used as fonts) in a GLC context.

     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, bold italic) that the font contains.  A typeface
     is the combination of a family and a face (for example Palatino Bold).

ERRORS
     GLC_PARAMETER_ERROR is generated if inCatalog is not a valid catalog.

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

ASSOCIATED GETS
     glcGetListc with argument GLC_CATALOG_LIST
     glcGeti with argument GLC_CATALOG_COUNT

SEE ALSO
     glcRemoveCatalog