


XSetState(3X11)						      XSetState(3X11)
X11R5									X11R5



NAME
  XSetState, XSetFunction, XSetPlanemask, XSetForeground, XSetBackground - GC
  convenience routines

SYNTAX
  XSetState(_d_i_s_p_l_a_y, _g_c, _f_o_r_e_g_r_o_u_n_d, _b_a_c_k_g_r_o_u_n_d, _f_u_n_c_t_i_o_n, _p_l_a_n_e__m_a_s_k)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	unsigned long _f_o_r_e_g_r_o_u_n_d, _b_a_c_k_g_r_o_u_n_d;
	int _f_u_n_c_t_i_o_n;
	unsigned long _p_l_a_n_e__m_a_s_k;

  XSetFunction(_d_i_s_p_l_a_y,	_g_c, _f_u_n_c_t_i_o_n)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	int _f_u_n_c_t_i_o_n;

  XSetPlaneMask(_d_i_s_p_l_a_y, _g_c, _p_l_a_n_e__m_a_s_k)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	unsigned long _p_l_a_n_e__m_a_s_k;

  XSetForeground(_d_i_s_p_l_a_y, _g_c, _f_o_r_e_g_r_o_u_n_d)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	unsigned long _f_o_r_e_g_r_o_u_n_d;

  XSetBackground(_d_i_s_p_l_a_y, _g_c, _b_a_c_k_g_r_o_u_n_d)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	unsigned long _b_a_c_k_g_r_o_u_n_d;

ARGUMENTS

  _b_a_c_k_g_r_o_u_n_d
	    Specifies the background you want to set for the specified GC.

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

  _f_o_r_e_g_r_o_u_n_d
	    Specifies the foreground you want to set for the specified GC.

  _f_u_n_c_t_i_o_n  Specifies the function you want to set for the specified GC.

  _g_c	    Specifies the GC.

  _p_l_a_n_e__m_a_s_k
	    Specifies the plane	mask.




DESCRIPTION
  The _X_S_e_t_S_t_a_t_e	function sets the foreground, background, plane	mask, and
  function components for the specified	GC.

  _X_S_e_t_S_t_a_t_e can	generate _B_a_d_A_l_l_o_c, _B_a_d_G_C, and _B_a_d_V_a_l_u_e errors.

  _X_S_e_t_F_u_n_c_t_i_o_n sets a specified	value in the specified GC.

  _X_S_e_t_F_u_n_c_t_i_o_n can generate _B_a_d_A_l_l_o_c, _B_a_d_G_C, and _B_a_d_V_a_l_u_e errors.

  The _X_S_e_t_P_l_a_n_e_M_a_s_k function sets the plane mask in the	specified GC.

  _X_S_e_t_P_l_a_n_e_M_a_s_k	can generate _B_a_d_A_l_l_o_c and _B_a_d_G_C	errors.

  The _X_S_e_t_F_o_r_e_g_r_o_u_n_d function sets the foreground in the specified GC.

  _X_S_e_t_F_o_r_e_g_r_o_u_n_d can generate _B_a_d_A_l_l_o_c and _B_a_d_G_C errors.

  The _X_S_e_t_B_a_c_k_g_r_o_u_n_d function sets the background in the specified GC.

  _X_S_e_t_B_a_c_k_g_r_o_u_n_d can generate _B_a_d_A_l_l_o_c and _B_a_d_G_C errors.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

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

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

SEE ALSO
  XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11),
  XSetClipOrigin(3X11),	XSetFillStyle(3X11), XSetFont(3X11),
  XSetLineAttributes(3X11), XSetTile(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
































