


XDrawImageString(3X11)				       XDrawImageString(3X11)
X11R5									X11R5



NAME
  XDrawImageString, XDrawImageString16 - draw image text

SYNTAX
  XDrawImageString(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _s_t_r_i_n_g, _l_e_n_g_t_h)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	char *_s_t_r_i_n_g;
	int _l_e_n_g_t_h;

  XDrawImageString16(_d_i_s_p_l_a_y, _d, _g_c, _x,	_y, _s_t_r_i_n_g, _l_e_n_g_t_h)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	XChar2b	*_s_t_r_i_n_g;
	int _l_e_n_g_t_h;

ARGUMENTS

  _d	    Specifies the drawable.

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

  _g_c	    Specifies the GC.

  _l_e_n_g_t_h    Specifies the number of characters in the string argument.

  _s_t_r_i_n_g    Specifies the character string.

  _x
  _y	    Specify the	x and y	coordinates, which are relative	to the origin
	    of the specified drawable and define the origin of the first
	    character.

DESCRIPTION
  The _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g_1_6 function is similar to	_X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g except	that
  it uses 2-byte or 16-bit characters.	Both functions also use	both the
  foreground and background pixels of the GC in	the destination.

  The effect is	first to fill a	destination rectangle with the background
  pixel	defined	in the GC and then to paint the	text with the foreground
  pixel.  The upper-left corner	of the filled rectangle	is at:

  [x, y	- font-ascent]

  The width is:

  overall-width

  The height is:

  font-ascent +	font-descent

  The overall-width, font-ascent, and font-descent are as would	be returned
  by _X_Q_u_e_r_y_T_e_x_t_E_x_t_e_n_t_s using gc	and string.  The function and fill-style
  defined in the GC are	ignored	for these functions. The effective function
  is _G_X_c_o_p_y, and the effective fill-style is _F_i_l_l_S_o_l_i_d.

  For fonts defined with 2-byte	matrix indexing	and used with _X_D_r_a_w_I_m_a_g_e_-
  _S_t_r_i_n_g, each byte is used as a byte2 with a byte1 of zero.

  Both functions use these GC components: plane-mask, foreground, background,
  font,	subwindow-mode,	clip-x-origin, clip-y-origin, and clip-mask.

  _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g and _X_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g_1_6 can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C,
  and _B_a_d_M_a_t_c_h errors.

DIAGNOSTICS

  _B_a_d_D_r_a_w_a_b_l_e
	    A value for	a Drawable argument does not name a defined Window or
	    Pixmap.

  _B_a_d_G_C	    A value for	a GContext argument does not name a defined GContext.

  _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window	is used	as a Drawable.

  _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct type and	range
	    but	fails to match in some other way required by the request.

SEE ALSO
  XDrawString(3X11), XDrawText(3X11), XLoadFont(3X11), XTextExtents(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






































