XmbDrawText(XS)   X Version 11 (Release 5) 6 January 1993    XmbDrawText(XS)


 Name

    XmbDrawText - 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 processed in turn, with the ori-
    gin 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 fontset member other than None in an item causes the font
    set to be used for this and subsequent text items in the textitems list.
    Leading text items with fontset member set to None will not be drawn.

    XmbDrawText and XwcDrawText do not perform any context-dependent render-
    ing 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 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(XS), XDrawString(XS), XDrawText(XS),
    XmbDrawImageString(XS), XmbDrawString(XS)
    Xlib - C Language X Interface