


XmbDrawText(3X11)					    XmbDrawText(3X11)
X11R5									X11R5



NAME
  XmbDrawText, XwcDrawText - draw text using multiple font sets

SYNTAX
  void XmbDrawText(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _i_t_e_m_s,	_n_i_t_e_m_s)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	XmbTextItem *_i_t_e_m_s;
	int _n_i_t_e_m_s;

  void XwcDrawText(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _i_t_e_m_s,	_n_i_t_e_m_s)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	XwcTextItem *_i_t_e_m_s;
	int _n_i_t_e_m_s;

ARGUMENTS

  _d	    Specifies the drawable.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _g_c	    Specifies the GC.

  _i_t_e_m_s	    Specifies an array of text items.

  _n_i_t_e_m_s    Specifies the number of text items in the array.

  _x
  _y	    Specify the	x and y	coordinates.

DESCRIPTION
  _X_m_b_D_r_a_w_T_e_x_t and _X_w_c_D_r_a_w_T_e_x_t 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 _N_o_n_e 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 _N_o_n_e will not be drawn.

  _X_m_b_D_r_a_w_T_e_x_t and _X_w_c_D_r_a_w_T_e_x_t do not perform any context-dependent rendering
  between text segments.  Clients may compute the drawing metrics by passing
  each text segment to _X_m_b_T_e_x_t_E_x_t_e_n_t_s and XwcTextExtents or _X_m_b_T_e_x_t_P_e_r_C_h_a_r_E_x_-
  _t_e_n_t_s	and _X_w_c_T_e_x_t_P_e_r_C_h_a_r_E_x_t_e_n_t_s.  When the _X_F_o_n_t_S_e_t has missing charsets,
  each unavailable character is	drawn with the default string returned by
  _X_C_r_e_a_t_e_F_o_n_t_S_e_t.  The behavior	for an invalid codepoint is undefined.

STRUCTURES
  The _X_m_b_T_e_x_t_I_t_e_m 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 _X_w_c_T_e_x_t_I_t_e_m 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), XDrawText(3X11),
  XmbDrawImageString(3X11), XmbDrawString(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off

















































