XwcDrawText
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 draw-
ing origin in the primary draw direction. A font_set mem-
ber 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 member set to
None will not be drawn.
XmbDrawText and XwcDrawText do not perform any context-
dependent rendering between text segments. Clients may
compute the drawing metrics by passing each text segment
to XmbTextExtents and XwcTextExtents or XmbTextPerCharEx-
tents and XwcTextPerCharExtents. When the XFontSet has
missing charsets, each unavailable character is drawn with
the default string returned by XCreateFontSet. The behav-
ior for an invalid codepoint 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 ALSO
XDrawImageString(3), XDrawString(3), XDraw-
Text(3), XmbDrawImageString(3), XmbDrawString(3)
Xlib - C Language X Interface
Man(1) output converted with
man2html