XFontsOfFontSet(XS)      X Version 11 (Release 5)        XFontsOfFontSet(XS)
                                6 January 1993


 Name

    XFontsOfFontSet - obtain fontset information

 Syntax


    int XFontsOfFontSet(font_set, font_struct_list_return,
                        font_name_list_return)
           XFontSet font_set;
           XFontStruct ***font_struct_list_return;
           char ***font_name_list_return;

    char *XBaseFontNameListOfFontSet(font_set)
           XFontSet font_set;

    char *XLocaleOfFontSet(font_set)
           XFontSet font_set;

    Bool XContextDependentDrawing(font_set)
           XFontSet font_set;


 Arguments


    fontset       Specifies the font set.

    fontnamelistreturn
                   Returns the list of font names.

    fontstructlistreturn
                   Returns the list of font structs.

 Description

    The XFontsOfFontSet function returns a list of one or more XFontStructs
    and font names for the fonts used by the Xmb and Xwc layers, for the
    given font set.  A list of pointers to the XFontStruct structures is
    returned to fontstructlistreturn.  A list of pointers to null-
    terminated fully specified font name strings in the locale of the font
    set is returned to fontnamelistreturn.  The fontnamelist order cor-
    responds to the fontstructlist order.  The number of XFontStruct struc-
    tures and font names is returned as the value of the function.

    Because it is not guaranteed that a given character will be imaged using
    a single font glyph, there is no provision for mapping a character or
    default string to the font properties, font ID, or direction hint for the
    font for the character.  The client may access the XFontStruct list to
    obtain these values for all the fonts currently in use.

    It is not required that fonts be loaded from the server at the creation
    of an XFontSet.  Xlib may choose to cache font data, loading it only as
    needed to draw text or compute text dimensions.  Therefore, existence of
    the per_char metrics in the XFontStruct structures in the XFontStructSet
    is undefined.  Also, note that all properties in the XFontStruct struc-
    tures are in the STRING encoding.

    The XFontStruct and font name lists are owned by Xlib and should not be
    modified or freed by the client.  They will be freed by a call to
    XFreeFontSet with the associated XFontSet.  Until freed, its contents
    will not be modified by Xlib.

    The XBaseFontNameListOfFontSet function returns the original base font
    name list supplied by the client when the XFontSet was created.  A null-
    terminated string containing a list of comma-separated font names is
    returned as the value of the function.  Whitespace may appear immediately
    on either side of separating commas.

    If XCreateFontSet obtained an XLFD name from the font properties for the
    font specified by a non-XLFD base name, the XBaseFontNameListOfFontSet
    function will return the XLFD name instead of the non-XLFD base name.

    The base font name list is owned by Xlib and should not be modified or
    freed by the client.  It will be freed by a call to XFreeFontSet with the
    associated XFontSet.  Until freed, its contents will not be modified by
    Xlib.

    The XLocaleOfFontSet function returns the name of the locale bound to the
    specified XFontSet, as a null-terminated string.

    The returned locale name string is owned by Xlib and should not be modi-
    fied or freed by the client.  It may be freed by a call to XFreeFontSet
    with the associated XFontSet.  Until freed, it will not be modified by
    Xlib.

    The XContextDependentDrawing function returns True if text drawn with the
    font_set might include context-dependent drawing.

 See also

    XCreateFontSet(XS), XExtentsOfFontSet(XS), XFontSetExtents(XS)
    Xlib - C Language X Interface