1XFontsOfFontSet(3)              XLIB FUNCTIONS              XFontsOfFontSet(3)
2
3
4

NAME

6       XFontsOfFontSet,  XBaseFontNameListOfFontSet,  XLocaleOfFontSet,  XCon‐
7       textDependentDrawing, XContextualDrawing,  XDirectionalDependentDrawing
8       - obtain fontset information
9

SYNTAX

11       int        XFontsOfFontSet(XFontSet        font_set,        XFontStruct
12              ***font_struct_list_return, char ***font_name_list_return);
13
14       char *XBaseFontNameListOfFontSet(XFontSet font_set);
15
16       char *XLocaleOfFontSet(XFontSet font_set);
17
18       Bool XContextDependentDrawing(XFontSet font_set);
19
20       Bool XContextualDrawing(XFontSet font_set);
21
22       Bool XDirectionalDependentDrawing(XFontSet font_set);
23

ARGUMENTS

25       font_set  Specifies the font set.
26
27       font_name_list_return
28                 Returns the list of font names.
29
30       font_struct_list_return
31                 Returns the list of font structs.
32

DESCRIPTION

34       The XFontsOfFontSet function returns a list of one or more XFontStructs
35       and  font  names  for  the fonts used by the Xmb and Xwc layers for the
36       given font set.  A list of pointers to the  XFontStruct  structures  is
37       returned to font_struct_list_return.  A list of pointers to null-termi‐
38       nated, fully specified font name strings in the locale of the font  set
39       is  returned to font_name_list_return.  The font_name_list order corre‐
40       sponds to the font_struct_list order.  The number of XFontStruct struc‐
41       tures and font names is returned as the value of the function.
42
43       Because  it is not guaranteed that a given character will be imaged us‐
44       ing a single font glyph, there is no provision for mapping a  character
45       or  default  string  to the font properties, font ID, or direction hint
46       for the font for the character.  The client may access the  XFontStruct
47       list to obtain these values for all the fonts currently in use.
48
49       Xlib  does  not  guarantee that fonts are loaded from the server at the
50       creation of an XFontSet.  Xlib may choose to cache font  data,  loading
51       it  only as needed to draw text or compute text dimensions.  Therefore,
52       existence of the per_char metrics in the XFontStruct structures in  the
53       XFontStructSet  is  undefined.   Also,  note that all properties in the
54       XFontStruct structures are in the STRING encoding.
55
56       The XFontStruct and font name lists are owned by Xlib and should not be
57       modified  or  freed  by  the  client.   They will be freed by a call to
58       XFreeFontSet with the associated XFontSet.  Until freed, their contents
59       will not be modified by Xlib.
60
61       The  XBaseFontNameListOfFontSet function returns the original base font
62       name list supplied by the client when  the  XFontSet  was  created.   A
63       null-terminated  string containing a list of comma-separated font names
64       is returned as the value of the function.  White space may appear imme‐
65       diately on either side of separating commas.
66
67       If  XCreateFontSet  obtained  an XLFD name from the font properties for
68       the font specified by a non-XLFD base  name,  the  XBaseFontNameListOf‐
69       FontSet function will return the XLFD name instead of the non-XLFD base
70       name.
71
72       The base font name list is owned by Xlib and should not be modified  or
73       freed  by  the client.  It will be freed by a call to XFreeFontSet with
74       the associated XFontSet.  Until freed, its contents will not  be  modi‐
75       fied by Xlib.
76
77       The  XLocaleOfFontSet  function returns the name of the locale bound to
78       the specified XFontSet, as a null-terminated string.
79
80       The returned locale name string is owned by Xlib and should not be mod‐
81       ified  or  freed  by  the  client.  It may be freed by a call to XFree‐
82       FontSet with the associated XFontSet.  Until freed, it will not be mod‐
83       ified by Xlib.
84
85       The XContextDependentDrawing function returns True if the drawing func‐
86       tions implement implicit text directionality or if text drawn with  the
87       font_set might include context-dependent drawing; otherwise, it returns
88       False.
89
90       The XContextualDrawing function returns True if  text  drawn  with  the
91       font set might include context-dependent drawing; otherwise, it returns
92       False.
93
94       The XDirectionalDependentDrawing function returns True if  the  drawing
95       functions implement implicit text directionality; otherwise, it returns
96       False.
97

SEE ALSO

99       XCreateFontSet(3),  XCreateOM(3),  XCreateOC(3),  XExtentsOfFontSet(3),
100       XFontSetExtents(3)
101       Xlib - C Language X Interface
102
103
104
105X Version 11                     libX11 1.7.2               XFontsOfFontSet(3)
Impressum