xcb_image_text_8(3) XCB Requests xcb_image_text_8(3)
NAME
xcb_image_text_8 - Draws text
SYNOPSIS
#include <xcb/xproto.h> Request function
xcb_void_cookie_t
xcb_image_text_8(xcb_connection_t *
conn,
uint8_t
string_len, xcb_drawable_t
drawable,
xcb_gcontext_t
gc, int16_t
x, int16_t
y, const char *
string);
REQUEST ARGUMENTS
conn The XCB connection to X11.
string_len The length of the
string. Note that this parameter limited
by 255 due to using 8 bits!
drawable The drawable (Window or Pixmap) to draw text on.
gc The graphics context to use.
The following graphics context components are used: plane-
mask, foreground, background, font, subwindow-mode, clip-x-
origin, clip-y-origin, and clip-mask.
x The x coordinate of the first character, relative to the
origin of
drawable.
y The y coordinate of the first character, relative to the
origin of
drawable.
string The string to draw. Only the first 255 characters are
relevant due to the data type of
string_len.
DESCRIPTION
Fills the destination rectangle with the background pixel from
gc,
then paints the text with the foreground pixel from
gc. The upper-
left corner of the filled rectangle is at [x, y - font-ascent]. The
width is overall-width, the height is font-ascent + font-descent. The
overall-width, font-ascent and font-descent are as returned by
xcb_query_text_extents (TODO).
Note that using X core fonts is deprecated (but still supported) in
favor of client-side rendering using Xft.
RETURN VALUE
Returns an
xcb_void_cookie_t. Errors (if any) have to be handled in
the event loop.
If you want to handle errors directly with
xcb_request_check instead,
use
xcb_image_text_8_checked. See
xcb-requests(3) for details.
ERRORS
xcb_drawable_error_t The specified
drawable (Window or Pixmap) does not exist.
xcb_g_context_error_t The specified graphics context does not exist.
xcb_match_error_t TODO: reasons?
SEE ALSO
xcb-requests(3),
xcb_image_text_16(3)AUTHOR
Generated from xproto.xml. Contact xcb@lists.freedesktop.org for
corrections and improvements.
X Version 11 libxcb 1.16.1 xcb_image_text_8(3)
