Provided by: libx11-doc_1.6.4-3ubuntu0.4_all bug

NAME

       XFontsOfFontSet, XBaseFontNameListOfFontSet, XLocaleOfFontSet, XContextDependentDrawing,
       XContextualDrawing, XDirectionalDependentDrawing - obtain fontset information

SYNTAX

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

       char *XBaseFontNameListOfFontSet(XFontSet font_set);

       char *XLocaleOfFontSet(XFontSet font_set);

       Bool XContextDependentDrawing(XFontSet font_set);

       Bool XContextualDrawing(XFontSet font_set);

       Bool XDirectionalDependentDrawing(XFontSet font_set);

ARGUMENTS

       font_set  Specifies the font set.

       font_name_list_return
                 Returns the list of font names.

       font_struct_list_return
                 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 font_struct_list_return.  A list of pointers to
       null-terminated, fully specified font name strings in the locale of the font set is
       returned to font_name_list_return.  The font_name_list order corresponds to the
       font_struct_list order.  The number of XFontStruct structures 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.

       Xlib does not guarantee that fonts are 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 structures 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, their 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.  White space 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 modified 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 the drawing functions implement
       implicit text directionality or if text drawn with the font_set might include context-
       dependent drawing; otherwise, it returns False.

       The XContextualDrawing function returns True if text drawn with the font set might include
       context-dependent drawing; otherwise, it returns False.

       The XDirectionalDependentDrawing function returns True if the drawing functions implement
       implicit text directionality; otherwise, it returns False.

SEE ALSO

       XCreateFontSet(3), XCreateOM(3), XCreateOC(3), XExtentsOfFontSet(3), XFontSetExtents(3)
       Xlib - C Language X Interface