glcNewFontFromFamily(3G)

NAME
     glcNewFontFromFamily - create a new font from a master of specified
     family


C SPECIFICATION
     GLint glcNewFontFromFamily( GLint inFont,
                                 const GLCchar *inFamily )


PARAMETERS
     inFont    Specifies the ID of the new font.

     inFamily  Specifies the font family, that is, the string that the
               GLC_FAMILY attribute has to match.

DESCRIPTION
     glcNewFontFromFamily performs a sequential search beginning with the
     first element of the GLC master list, looking for the first master whose
     string attribute GLC_FAMILY equals inFamily.

     If there is no such master, glcNewFontFromFamily returns zero. Otherwise,
     glcNewFontFromFamily creates a new font from the master.

     The ID of the new font is inFont. If inFont is already the ID of a font,
     glcNewFontFromFamily generates GLC_PARAMETER_ERROR and returns zero.

     If the command succeeds, it returns inFont.

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, glcNewFontFromMaster, glcDeleteFont