Provided by: libx11-doc_1.8.7-1build1_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