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
       XmbDrawText and XwcDrawText allow complex spacing and font
       set shifts between text strings.  Each text item is pro-
       cessed 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 addi-
       tional 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 text_items list.  Leading
       text items with 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



X Version 11                Release 5                           1

XmbDrawText(3X11)         XLIB FUNCTIONS        XmbDrawText(3X11)


       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 characters */
            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(3X11), XDrawString(3X11), XDraw-
       Text(3X11), XmbDrawImageString(3X11), XmbDrawString(3X11)
       Xlib - C Language X Interface


































X Version 11                Release 5                           2