xcb_query_font_properties(3)

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

NAME

6       xcb_query_font - query font metrics
7

SYNOPSIS

9       #include <xcb/xproto.h>
10
11   Request function
12       xcb_query_font_cookie_t xcb_query_font(xcb_connection_t *conn,
13              xcb_fontable_t font);
14
15   Reply datastructure
16       typedef struct xcb_query_font_reply_t {
17           uint8_t        response_type;
18           uint8_t        pad0;
19           uint16_t       sequence;
20           uint32_t       length;
21           xcb_charinfo_t min_bounds;
22           uint8_t        pad1[4];
23           xcb_charinfo_t max_bounds;
24           uint8_t        pad2[4];
25           uint16_t       min_char_or_byte2;
26           uint16_t       max_char_or_byte2;
27           uint16_t       default_char;
28           uint16_t       properties_len;
29           uint8_t        draw_direction;
30           uint8_t        min_byte1;
31           uint8_t        max_byte1;
32           uint8_t        all_chars_exist;
33           int16_t        font_ascent;
34           int16_t        font_descent;
35           uint32_t       char_infos_len;
36       } xcb_query_font_reply_t;
37
38   Reply function
39       xcb_query_font_reply_t *xcb_query_font_reply(xcb_connection_t *conn,
40              xcb_query_font_cookie_t cookie, xcb_generic_error_t **e);
41
42   Reply accessors
43       xcb_fontprop_t *xcb_query_font_properties(const
44              xcb_query_font_request_t *reply);
45
46       int xcb_query_font_properties_length(const xcb_query_font_reply_t
47              *reply);
48
49       xcb_fontprop_iterator_t xcb_query_font_properties_iterator(const
50              xcb_query_font_reply_t *reply);
51
52       xcb_charinfo_t *xcb_query_font_char_infos(const
53              xcb_query_font_request_t *reply);
54
55       int xcb_query_font_char_infos_length(const xcb_query_font_reply_t
56              *reply);
57
58       xcb_charinfo_iterator_t xcb_query_font_char_infos_iterator(const
59              xcb_query_font_reply_t *reply);
60

REQUEST ARGUMENTS

62       conn      The XCB connection to X11.
63
64       font      The fontable (Font or Graphics Context) to query.
65

REPLY FIELDS

67       response_type
68                 The type of this reply, in this case XCB_QUERY_FONT. This
69                 field is also present in the xcb_generic_reply_t and can be
70                 used to tell replies apart from each other.
71
72       sequence  The sequence number of the last request processed by the X11
73                 server.
74
75       length    The length of the reply, in words (a word is 4 bytes).
76
77       min_bounds
78                 minimum bounds over all existing char
79
80       max_bounds
81                 maximum bounds over all existing char
82
83       min_char_or_byte2
84                 first character
85
86       max_char_or_byte2
87                 last character
88
89       default_char
90                 char to print for undefined character
91
92       properties_len
93                 how many properties there are
94
95       draw_direction
96                 One of the following values:
97
98                 XCB_FONT_DRAW_LEFT_TO_RIGHT
99                           TODO: NOT YET DOCUMENTED.
100
101                 XCB_FONT_DRAW_RIGHT_TO_LEFT
102                           TODO: NOT YET DOCUMENTED.
103
104
105
106       min_byte1 TODO: NOT YET DOCUMENTED.
107
108       max_byte1 TODO: NOT YET DOCUMENTED.
109
110       all_chars_exist
111                 flag if all characters have nonzero size
112
113       font_ascent
114                 baseline to top edge of raster
115
116       font_descent
117                 baseline to bottom edge of raster
118
119       char_infos_len
120                 TODO: NOT YET DOCUMENTED.
121

DESCRIPTION

123       Queries information associated with the font.
124

RETURN VALUE

126       Returns an xcb_query_font_cookie_t. Errors have to be handled when
127       calling the reply function xcb_query_font_reply.
128
129       If you want to handle errors in the event loop instead, use
130       xcb_query_font_unchecked. See xcb-requests(3) for details.
131

ERRORS

133       This request does never generate any errors.
134

AUTHOR

139       Generated from xproto.xml. Contact xcb@lists.freedesktop.org for cor‐
140       rections and improvements.
141
142
143
144X Version 11                      libxcb 1.12                xcb_query_font(3)