


XFillRectangle(3X11)					 XFillRectangle(3X11)
X11R5									X11R5



NAME
  XFillRectangle, XFillRectangles, XFillPolygon, XFillArc, XFillArcs - fill
  rectangles, polygons,	or arcs

SYNTAX
  XFillRectangle(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;

  XFillRectangles(_d_i_s_p_l_a_y, _d, _g_c, _r_e_c_t_a_n_g_l_e_s, _n_r_e_c_t_a_n_g_l_e_s)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	XRectangle *_r_e_c_t_a_n_g_l_e_s;
	int _n_r_e_c_t_a_n_g_l_e_s;

  XFillPolygon(_d_i_s_p_l_a_y,	_d, _g_c, _p_o_i_n_t_s, _n_p_o_i_n_t_s,	_s_h_a_p_e, _m_o_d_e)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	XPoint *_p_o_i_n_t_s;
	int _n_p_o_i_n_t_s;
	int _s_h_a_p_e;
	int _m_o_d_e;

  XFillArc(_d_i_s_p_l_a_y, _d, _g_c,  _x, _y, _w_i_d_t_h, _h_e_i_g_h_t, _a_n_g_l_e_1, _a_n_g_l_e_2)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	int _a_n_g_l_e_1, _a_n_g_l_e_2;

  XFillArcs(_d_i_s_p_l_a_y, _d,	_g_c, _a_r_c_s, _n_a_r_c_s)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	XArc *_a_r_c_s;
	int _n_a_r_c_s;

ARGUMENTS

  _a_n_g_l_e_1    Specifies the start	of the arc relative to the three-o'clock
	    position from the center, in units of degrees * 64.

  _a_n_g_l_e_2    Specifies the path and extent of the arc relative to the start of
	    the	arc, in	units of degrees * 64.

  _a_r_c_s	    Specifies an array of arcs.

  _d	    Specifies the drawable.

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

  _g_c	    Specifies the GC.

  _m_o_d_e	    Specifies the coordinate mode. You can pass	_C_o_o_r_d_M_o_d_e_O_r_i_g_i_n	or
	    _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s.

  _n_a_r_c_s	    Specifies the number of arcs in the	array.

  _n_p_o_i_n_t_s   Specifies the number of points in the array.

  _n_r_e_c_t_a_n_g_l_e_s
	    Specifies the number of rectangles in the array.

  _p_o_i_n_t_s    Specifies an array of points.

  _r_e_c_t_a_n_g_l_e_s
	    Specifies an array of rectangles.

  _s_h_a_p_e	    Specifies a	shape that helps the server to improve performance.
	    You	can pass _C_o_m_p_l_e_x, _C_o_n_v_e_x, or _N_o_n_c_o_n_v_e_x.

  _w_i_d_t_h
  _h_e_i_g_h_t    Specify the	width and height, which	are the	dimensions of the
	    rectangle to be filled or the major	and minor axes of the arc.

  _x
  _y	    Specify the	x and y	coordinates, which are relative	to the origin
	    of the drawable and	specify	the upper-left corner of the rectan-
	    gle.

DESCRIPTION
  The _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s functions fill	the specified rectan-
  gle or rectangles as if a four-point _F_i_l_l_P_o_l_y_g_o_n protocol request were
  specified for	each rectangle:

  [x,y]	[x+width,y] [x+width,y+height] [x,y+height]

  Each function	uses the x and y coordinates, width and	height dimensions,
  and GC you specify.

  _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s fills	the rectangles in the order listed in the array. For
  any given rectangle, _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s do not draw a	pixel
  more than once. If rectangles	intersect, the intersecting pixels are drawn
  multiple times.

  Both functions use these GC components: function, plane-mask,	fill-style,
  subwindow-mode, clip-x-origin, clip-y-origin,	and clip-mask.	They also use
  these	GC mode-dependent components: foreground, background, tile, stipple,
  tile-stipple-x-origin, and tile-stipple-y-origin.

  _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s 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.

  _X_F_i_l_l_P_o_l_y_g_o_n fills the region	closed by the specified	path.  The path	is
  closed automatically if the last point in the	list does not coincide with
  the first point.  _X_F_i_l_l_P_o_l_y_g_o_n does not draw a pixel of the region more
  than once.  _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as	relative to the	ori-
  gin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s treats all	coordinates after the first as rela-
  tive to the previous point.

  Depending on the specified shape, the	following occurs:

  oo++    If shape	is _C_o_m_p_l_e_x, the	path may self-intersect. Note that contiguous
       coincident points in the	path are not treated as	self-intersection.

  oo++    If shape	is _C_o_n_v_e_x, for every pair of points inside the polygon,	the
       line segment connecting them does not intersect the path.  If known by
       the client, specifying _C_o_n_v_e_x can improve performance. If you specify
       _C_o_n_v_e_x for a path that is not convex, the graphics results are unde-
       fined.

  oo++    If shape	is _N_o_n_c_o_n_v_e_x, the path does not	self-intersect,	but the	shape
       is not wholly convex. If	known by the client, specifying	_N_o_n_c_o_n_v_e_x
       instead of _C_o_m_p_l_e_x may improve performance. If you specify _N_o_n_c_o_n_v_e_x
       for a self-intersecting path, the graphics results are undefined.

  The fill-rule	of the GC controls the filling behavior	of self-intersecting
  polygons.

  This function	uses these GC components: function, plane-mask,	fill-style,
  fill-rule, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask.  It
  also uses these GC mode-dependent components:	foreground, background,	tile,
  stipple, tile-stipple-x-origin, and tile-stipple-y-origin.

  _X_F_i_l_l_P_o_l_y_g_o_n can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C,	_B_a_d_M_a_t_c_h, and _B_a_d_V_a_l_u_e
  errors.

  For each arc,	_X_F_i_l_l_A_r_c or _X_F_i_l_l_A_r_c_s fills the	region closed by the infin-
  itely	thin path described by the specified arc and, depending	on the arc-
  mode specified in the	GC, one	or two line segments. For _A_r_c_C_h_o_r_d, the	sin-
  gle line segment joining the endpoints of the	arc is used. For _A_r_c_P_i_e_S_l_i_c_e,
  the two line segments	joining	the endpoints of the arc with the center
  point	are used. _X_F_i_l_l_A_r_c_s fills the arcs in the order	listed in the array.
  For any given	arc, _X_F_i_l_l_A_r_c and _X_F_i_l_l_A_r_c_s do not draw	a pixel	more than
  once.	If regions intersect, the intersecting pixels are drawn	multiple
  times.

  Both functions use these GC components: function, plane-mask,	fill-style,
  arc-mode, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask.
  They also use	these GC mode-dependent	components: foreground,	background,
  tile,	stipple, tile-stipple-x-origin,	and tile-stipple-y-origin.

  _X_F_i_l_l_A_r_c and _X_F_i_l_l_A_r_c_s 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.

  _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
  XDrawArc(3X11), XDrawPoint(3X11), XDrawRectangle(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e







