.\\$1D \\$2 \\$1
.ps \\n(PS
.if \\n(VS>=40 .vs \\n(VSu
.if \\n(VS<=39 .vs \\n(VSp
..
 0
.nr BD 0

.KS .TA .5i 3i

..

.. .. .KS

.D

 choose appropriate monospace font
 the imagen conditional, 480,
 may be changed to L if LB is too
 heavy for your eyes...

..

.R
..
..
..
.TB

\\*(NO
.R
..
. \" Note End -- doug kraft 3/85
 0
..
.ny0
 XmbDrawText 3X11 "Release 5" "X Version 11" "XLIB FUNCTIONS"
 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
 $Header: d.a,v 1.1 88/02/26 10:04:25 mento Exp $
 d 1i
Specifies the drawable. 
 $Header: display.a,v 1.1 88/02/26 10:26:29 mento Exp $
 display 1i
Specifies the connection to the X server.
 $Header: gc.a,v 1.2 88/05/09 11:20:34 mento Exp $
 gc 1i
Specifies the GC.
 $Header: items.a,v 1.1 88/02/26 10:28:21 mento Exp $
 items 1i
Specifies an array of text items.
 $Header: nitems.a,v 1.1 88/02/26 10:29:33 mento Exp $
 nitems 1i
Specifies the number of text items in the array.
 $Header: xy_gen.a,v 1.2 88/08/04 11:22:37 mento Exp $
 x 1i

.ns
 y 1i
Specify the x and y coordinates\*(Xy.
 DESCRIPTION
.ZN XmbDrawText
and 
.ZN XwcDrawText 
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
drawing origin in the primary draw direction.
A font_set member other than 
.ZN 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
.ZN None
will not be drawn.

.ZN XmbDrawText
and
.ZN XwcDrawText
do not perform any context-dependent rendering between text segments.
Clients may compute the drawing metrics by passing each text segment to
.ZN XmbTextExtents
and XwcTextExtents
or 
.ZN XmbTextPerCharExtents
and
.ZN XwcTextPerCharExtents .
When the 
.ZN XFontSet
has missing charsets, each unavailable character is drawn 
with the default string returned by 
.ZN XCreateFontSet .
The behavior for an invalid codepoint is undefined.
 STRUCTURES
The
.ZN XmbTextItem
structure contains:
.Ds 0
.TA .5i 2.5i
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;
.De
The
.ZN XwcTextItem
structure contains:
.Ds 0
.TA .5i 2.5i
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;
.De
 "SEE ALSO"
XDrawImageString(3X11),
XDrawString(3X11),
XDrawText(3X11),
XmbDrawImageString(3X11),
XmbDrawString(3X11)

\*(xL