XmbDrawImageString(3) XLIB FUNCTIONS XmbDrawImageString(3)

# [NAME](#NAME)

XmbDrawImageString, XwcDrawImageString, Xutf8DrawImageString - draw image text using a single font set

# [SYNTAX](#SYNTAX)

void XmbDrawImageString(Display \**display*, Drawable *d*, XFontSet *font\_set*, GC *gc*, int *x*, int *y*, \_Xconst char \**string*, int *num\_bytes*);

void XwcDrawImageString(Display \**display*, Drawable *d*, XFontSet *font\_set*, GC *gc*, int *x*, int *y*, \_Xconst wchar\_t \**string*, int *num\_wchars*);

void Xutf8DrawImageString(Display \**display*, Drawable *d*, XFontSet *font\_set*, GC *gc*, int *x*, int *y*, \_Xconst char \**string*, int *num\_bytes*);

# [ARGUMENTS](#ARGUMENTS)

[*d*](#d)

Specifies the drawable.

[*display*](#display)

Specifies the connection to the X server.

[*font\_set*](#font_set)

Specifies the font set.

[*gc*](#gc)

Specifies the GC.

[*num\_bytes*](#num_bytes)

Specifies the number of bytes in the string argument.

[*num\_wchars*](#num_wchars)

Specifies the number of characters in the string argument.

[*string*](#string)

Specifies the character string.

[*x*](#x)

[*y*](#y)

Specify the x and y coordinates.

# [DESCRIPTION](#DESCRIPTION)

The **XmbDrawImageString**, **XwcDrawImageString** and **Xutf8DrawImageString** functions fill a destination rectangle with the background pixel defined in the GC and then paint the text with the foreground pixel. The filled rectangle is the rectangle returned to overall\_logical\_return by **XmbTextExtents**, **XwcTextExtents** or **Xutf8TextExtents** for the same text and **XFontSet**.

When the **XFontSet** has missing charsets, each unavailable character is drawn with the default string returned by **XCreateFontSet**. The behavior for an invalid codepoint is undefined.

The function **Xutf8TextExtents** is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 release. Its presence is indicated by the macro **X\_HAVE\_UTF8\_STRING**.

# [SEE ALSO](#SEE_ALSO)

[**XDrawImageString**(3)](/man/os/libx11/XDrawImageString.3), [**XDrawString**(3)](/man/os/libx11/XDrawString.3), [**XDrawText**(3)](/man/os/libx11/XDrawText.3), [**XmbDrawString**(3)](/man/os/libx11/XmbDrawString.3), [**XmbDrawText**(3)](/man/os/libx11/XmbDrawText.3)  
*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: Xutf8DrawImageString(3) from libx11 1.8.14-r1 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git