NAME
XmbDrawImageString, XwcDrawImageString, Xutf8DrawImageString - draw image text using a single font set
SYNTAX
void XmbDrawImageString(Display *_d_i_s_p_l_a_y, Drawable _d,
XFontSet _f_o_n_t___s_e_t, GC _g_c, int _x, int _y, char
*_s_t_r_i_n_g, int _n_u_m___b_y_t_e_s);
void XwcDrawImageString(Display *_d_i_s_p_l_a_y, Drawable _d,
XFontSet _f_o_n_t___s_e_t, GC _g_c, int _x, int _y,
wchar_t *_s_t_r_i_n_g, int _n_u_m___w_c_h_a_r_s);
void Xutf8DrawImageString(Display *_d_i_s_p_l_a_y, Drawable _d,
XFontSet _f_o_n_t___s_e_t, GC _g_c, int _x, int _y, char
*_s_t_r_i_n_g, int _n_u_m___b_y_t_e_s);
ARGUMENTS
-
_d
Specifies the drawable.
-
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_f_o_n_t___s_e_t
Specifies the font set.
-
-
_g_c
Specifies the GC.
-
-
_n_u_m___b_y_t_e_s
Specifies the number of bytes in the string argument.
-
-
_n_u_m___w_c_h_a_r_s
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.
-
DESCRIPTION
The
_X_m_b_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g,
_X_w_c_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g
and
_X_u_t_f_8_D_r_a_w_I_m_a_g_e_S_t_r_i_n_g
functions fill a destination rectangle with the background pixel defined
in the GC and then paint the text with the foreground pixel.
The filled rectangle is the rectangle returned to overall_logical_return by
_X_m_b_T_e_x_t_E_x_t_e_n_t_s,
_X_w_c_T_e_x_t_E_x_t_e_n_t_s
or
_X_u_t_f_8_T_e_x_t_E_x_t_e_n_t_s
for the same text and
_X_F_o_n_t_S_e_t.
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.
The function
_X_u_t_f_8_T_e_x_t_E_x_t_e_n_t_s
is an extension introduced by The XFree86 Project, Inc. in their 4.0.2
release. Its presence is
indicated by the macro
_X___H_A_V_E___U_T_F_8___S_T_R_I_N_G.
SEE ALSO
XDrawImageString(3X11),
XDrawString(3X11),
XDrawText(3X11),
XmbDrawString(3X11),
XmbDrawText(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e