pub fn image_text8<'c, 'input, Conn>(
conn: &'c Conn,
drawable: Drawable,
gc: Gcontext,
x: i16,
y: i16,
string: &'input [u8],
) -> Result<VoidCookie<'c, Conn>, ConnectionError>where
Conn: RequestConnection + ?Sized,
Expand description
Draws text.
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.
§Fields
drawable
- The drawable (Window or Pixmap) to draw text on.string_len
- The length of thestring
. Note that this parameter limited by 255 due to using 8 bits!string
- The string to draw. Only the first 255 characters are relevant due to the data type ofstring_len
.x
- The x coordinate of the first character, relative to the origin ofdrawable
.y
- The y coordinate of the first character, relative to the origin ofdrawable
.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.
§Errors
Drawable
- The specifieddrawable
(Window or Pixmap) does not exist.GContext
- The specified graphics context does not exist.Match
- TODO: reasons?
§See
ImageText16
: request