xcb_list_fonts_with_info_unchecked(3)

1xcb_list_fonts_with_info(3)      XCB Requests      xcb_list_fonts_with_info(3)
2
3
4

NAME

6       xcb_list_fonts_with_info - get matching font names and information
7

SYNOPSIS

9       #include <xcb/xproto.h>
10
11   Request function
12       xcb_list_fonts_with_info_cookie_t
13              xcb_list_fonts_with_info(xcb_connection_t *conn,
14              uint16_t max_names, uint16_t pattern_len, const char *pattern);
15
16   Reply datastructure
17       typedef struct xcb_list_fonts_with_info_reply_t {
18           uint8_t        response_type;
19           uint8_t        name_len;
20           uint16_t       sequence;
21           uint32_t       length;
22           xcb_charinfo_t min_bounds;
23           uint8_t        pad0[4];
24           xcb_charinfo_t max_bounds;
25           uint8_t        pad1[4];
26           uint16_t       min_char_or_byte2;
27           uint16_t       max_char_or_byte2;
28           uint16_t       default_char;
29           uint16_t       properties_len;
30           uint8_t        draw_direction;
31           uint8_t        min_byte1;
32           uint8_t        max_byte1;
33           uint8_t        all_chars_exist;
34           int16_t        font_ascent;
35           int16_t        font_descent;
36           uint32_t       replies_hint;
37       } xcb_list_fonts_with_info_reply_t;
38
39   Reply function
40       xcb_list_fonts_with_info_reply_t
41              *xcb_list_fonts_with_info_reply(xcb_connection_t *conn,
42              xcb_list_fonts_with_info_cookie_t cookie,
43              xcb_generic_error_t **e);
44
45   Reply accessors
46       xcb_fontprop_t *xcb_list_fonts_with_info_properties(const
47              xcb_list_fonts_with_info_request_t *reply);
48
49       int xcb_list_fonts_with_info_properties_length(const
50              xcb_list_fonts_with_info_reply_t *reply);
51
52       xcb_fontprop_iterator_t
53              xcb_list_fonts_with_info_properties_iterator(const
54              xcb_list_fonts_with_info_reply_t *reply);
55
56       char *xcb_list_fonts_with_info_name(const
57              xcb_list_fonts_with_info_request_t *reply);
58
59       int xcb_list_fonts_with_info_name_length(const
60              xcb_list_fonts_with_info_reply_t *reply);
61
62       xcb_generic_iterator_t xcb_list_fonts_with_info_name_end(const
63              xcb_list_fonts_with_info_reply_t *reply);
64

REQUEST ARGUMENTS

66       conn      The XCB connection to X11.
67
68       max_names The maximum number of fonts to be returned.
69
70       pattern_len
71                 The length (in bytes) of pattern.
72
73       pattern   A font pattern, for example "-misc-fixed-*".
74
75                 The asterisk (*) is a wildcard for any number of characters.
76                 The question mark (?) is a wildcard for a single character.
77                 Use of uppercase or lowercase does not matter.
78

REPLY FIELDS

80       response_type
81                 The type of this reply, in this case XCB_LIST_FONTS_WITH_IN‐
82                 FO. This field is also present in the xcb_generic_reply_t and
83                 can be used to tell replies apart from each other.
84
85       sequence  The sequence number of the last request processed by the X11
86                 server.
87
88       length    The length of the reply, in words (a word is 4 bytes).
89
90       name_len  The number of matched font names.
91
92       min_bounds
93                 minimum bounds over all existing char
94
95       max_bounds
96                 maximum bounds over all existing char
97
98       min_char_or_byte2
99                 first character
100
101       max_char_or_byte2
102                 last character
103
104       default_char
105                 char to print for undefined character
106
107       properties_len
108                 how many properties there are
109
110       draw_direction
111                 One of the following values:
112
113                 XCB_FONT_DRAW_LEFT_TO_RIGHT
114                           TODO: NOT YET DOCUMENTED.
115
116                 XCB_FONT_DRAW_RIGHT_TO_LEFT
117                           TODO: NOT YET DOCUMENTED.
118
119
120
121       min_byte1 TODO: NOT YET DOCUMENTED.
122
123       max_byte1 TODO: NOT YET DOCUMENTED.
124
125       all_chars_exist
126                 flag if all characters have nonzero size
127
128       font_ascent
129                 baseline to top edge of raster
130
131       font_descent
132                 baseline to bottom edge of raster
133
134       replies_hint
135                 An indication of how many more fonts will be returned. This
136                 is only a hint and may be larger or smaller than the number
137                 of fonts actually returned. A zero value does not guarantee
138                 that no more fonts will be returned.
139

DESCRIPTION

141       Gets a list of available font names which match the given pattern.
142

RETURN VALUE

144       Returns an xcb_list_fonts_with_info_cookie_t. Errors have to be handled
145       when calling the reply function xcb_list_fonts_with_info_reply.
146
147       If you want to handle errors in the event loop instead, use
148       xcb_list_fonts_with_info_unchecked. See xcb-requests(3) for details.
149

ERRORS

151       This request does never generate any errors.
152

AUTHOR

157       Generated from xproto.xml. Contact xcb@lists.freedesktop.org for cor‐
158       rections and improvements.
159
160
161
162X Version 11                      libxcb 1.13      xcb_list_fonts_with_info(3)