XmbDTxt(1) X Version 11 XmbDTxt(1)XmbDrawText(3X11) XLIB FUNCTIONS XmbDrawText(3X11)NAME
XmbDrawText, XwcDrawText - draw text using multiple font sets
SYNTAX
void XmbDrawText(display, d, gc, x, y, items, nitems)
Display *display;
Drawable d;
GC gc;
int x, y;
XmbTextItem *items;
int nitems;
void XwcDrawText(display, d, gc, x, y, items, nitems)
Display *display;
Drawable d;
GC gc;
int x, y;
XwcTextItem *items;
int nitems;
ARGUMENTS
d Specifies the drawable.
display Specifies the connection to the X server.
gc Specifies the GC.
items Specifies an array of text items.
nitems Specifies the number of text items in the array.
x
y Specify the x and y coordinates.
DESCRIPTION
The XmbDrawText and XwcDrawText functions allow complex spacing and
font set shifts between text strings. Each text item is processed in
turn, with the origin of a text element advanced in the primary draw
direction by the escapement of the previous text item. A text item
delta specifies an additional escapement of the text item drawing ori‐
gin in the primary draw direction. A font_set member other than None
in an item causes the font set to be used for this and subsequent text
items in the text_items list. Leading text items with a font_set mem‐
ber set to None will not be drawn.
XmbDrawText and XwcDrawText do not perform any context-dependent ren‐
dering between text segments. Clients may compute the drawing metrics
by passing each text segment to XmbTextExtents and XwcTextExtents or
XmbTextPerCharExtents and XwcTextPerCharExtents. When the XFontSet has
missing charsets, each unavailable character is drawn with the default
string returned by XCreateFontSet. The behavior for an invalid code‐
point is undefined.
STRUCTURES
The XmbTextItem structure contains:
typedef struct {
char *chars; /* pointer to string */
int nchars; /* number of bytes */
int delta; /* pixel delta between strings */
XFontSet font_set; /* fonts, None means don't change */
} XmbTextItem;
The XwcTextItem structure contains:typedef struct {
wchar_t *chars; /* pointer to wide char string */
int nchars; /* number of wide characters */
int delta; /* pixel delta between strings */
XFontSet font_set; /* fonts, None means don't change */
} XwcTextItem;
SEE ALSOXDrawImageString(3X11), XDrawString(3X11), XDrawText(3X11), XmbDrawIm‐
ageString(3X11), XmbDrawString(3X11)
Xlib - C Language X Interface
X Version 11 Release 6 XmbDrawText(3X11)
