XmbDrawText()XmbDrawText()NameXmbDrawText – draw internationalized multi-byte text using multiple
font sets.
Synopsis
void XmbDrawText(display, drawable, gc, x, y, items, nitems)
Display *display;
Drawable drawable;
GC gc;
int x, y;
XmbTextItem *items;
int nitems;
Arguments
display Specifies the connection to the X server.
drawable Specifies the drawable.
gc Specifies the graphics context.
x, y Specifies the starting position and baseline of the text,
relative to the origin of the specified drawable.
items Specifies an array of text items.
nitems Specifies the number of text items in the array.
DescriptionXmbDrawText() allows complex spacing and font set shifts between inter‐
nationalized multi-byte 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 items list. Leading text items with font_set member set
to None will not be drawn.
XmbDrawText() does not perform any context-dependent rendering between
text segments. Clients may compute the drawing metrics by passing each
text segment to XmbTextExtents() or XmbTextPerCharExtents(). 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.
XmbDrawText() draws with fonts from the font sets of the items list
rather than the font of the GC. For this reason, it may modify the
font value of the GC. Except for the font, it uses the same GC compo‐
nents as its pre-X11R5 analog XDrawText().
Structures
The XmbTextItem structure contains:
typedef struct {
char *chars; /* pointer to string */
int nchars; /* number of characters */
int delta; /* pixel delta between strings */
XFontSet font_set; /* fonts, None means don't change */
} XmbTextItem;
See AlsoXDrawImageString(), XDrawString(), XDrawText(), XmbDrawImageString(),
XmbDrawString(), XwcDrawText().
Xlib - Internationalized Text XmbDrawText()
