<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY>
<PRE>



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
       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



X Version 11		   Release 6.1				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 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(3X11), XDrawString(3X11), XDraw
       Text(3X11), XmbDrawImageString(3X11), XmbDrawString(3X11)
       Xlib - C Language X Interface


































X Version 11		   Release 6.1				2


</PRE>
</BODY>
</HTML>
