xcb_image_text_8_checked(3)

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

NAME

6       xcb_image_text_8 - Draws text
7

SYNOPSIS

9       #include <xcb/xproto.h>
10
11   Request function
12       xcb_void_cookie_t xcb_image_text_8(xcb_connection_t *conn,
13              uint8_t string_len, xcb_drawable_t drawable, xcb_gcontext_t gc,
14              int16_t x, int16_t y, const char *string);
15

REQUEST ARGUMENTS

17       conn      The XCB connection to X11.
18
19       string_len
20                 The length of the string. Note that this parameter limited by
21                 255 due to using 8 bits!
22
23       drawable  The drawable (Window or Pixmap) to draw text on.
24
25       gc        The graphics context to use.
26
27                 The following graphics context components are used: plane-
28                 mask, foreground, background, font, subwindow-mode, clip-x-
29                 origin, clip-y-origin, and clip-mask.
30
31       x         The x coordinate of the first character, relative to the ori‐
32                 gin of drawable.
33
34       y         The y coordinate of the first character, relative to the ori‐
35                 gin of drawable.
36
37       string    The string to draw. Only the first 255 characters are rele‐
38                 vant due to the data type of string_len.
39

DESCRIPTION

41       Fills the destination rectangle with the background pixel from gc, then
42       paints the text with the foreground pixel from gc. The upper-left cor‐
43       ner of the filled rectangle is at [x, y - font-ascent]. The width is
44       overall-width, the height is font-ascent + font-descent. The overall-
45       width, font-ascent and font-descent are as returned by
46       xcb_query_text_extents (TODO).
47
48       Note that using X core fonts is deprecated (but still supported) in fa‐
49       vor of client-side rendering using Xft.
50

RETURN VALUE

52       Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the
53       event loop.
54
55       If you want to handle errors directly with xcb_request_check instead,
56       use xcb_image_text_8_checked. See xcb-requests(3) for details.
57

ERRORS

59       xcb_drawable_error_t
60                 The specified drawable (Window or Pixmap) does not exist.
61
62       xcb_g_context_error_t
63                 The specified graphics context does not exist.
64
65       xcb_match_error_t
66                 TODO: reasons?
67

AUTHOR

72       Generated from xproto.xml. Contact xcb@lists.freedesktop.org for cor‐
73       rections and improvements.
74
75
76
77X Version 11                      libxcb 1.12              xcb_image_text_8(3)