XFillRectangles

Syntax

XFillRectangles(display, d, gc, rectangles, nrectangles)
      Display *display;
      Drawable d;
      GC gc;
      XRectangle *rectangles;
      int nrectangles;

Arguments

display Specifies the connection to the X server.
d Specifies the drawable.
gc Specifies the GC.
rectangles Specifies an array of rectangles.
nrectangles Specifies the number of rectangles in the array.

Description

The XFillRectangles() function fills rectangles as if a four-point FillPolygon protocol request were specified for each rectangle:

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

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

XFillRectangles() fills the rectangles in the order listed in the array. For any given rectangle, XFillRectangles() does not draw a pixel more than once. If rectangles intersect, the intersecting pixels are drawn multiple times.

The function uses 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.

XFillRectangles() can generate BadDrawable , BadGC , and BadMatch errors.

Diagnostics

BadDrawable A value for a Drawable argument does not name a defined Window or Pixmap.
BadGC A value for a GContext argument does not name a defined GContext.
BadMatch An InputOnly window is used as a Drawable.
BadMatch 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

XDrawArc(), XDrawPoint(), XDrawRectangles(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangles(), "Filling Single and Multiple Rectangles".
Christophe Tronche, ch@tronche.com