XwcDrawText()XwcDrawText()NameXwcDrawText – draw internationalized wide-character text using multiple
font sets.
Synopsis
void XwcDrawText(display, drawable, gc, x, y, items, nitems)
Display *display;
Drawable drawable;
GC gc;
int x, y;
XwcTextItem *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.
Availability
Release 5 and later.
DescriptionXwcDrawText() allows complex spacing and font set shifts between wide-
character 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 origin 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.
XwcDrawText() does not perform any context-dependent rendering between
text segments. Clients may compute the drawing metrics by passing each
text segment to XwcTextExtents() 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.
XwcDrawText() 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 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(), XDrawString(), XDrawText(), XwcDrawImageString(),
XwcDrawString(), XmbDrawText().
Xlib - Internationalized Text Output XwcDrawText()
