XFillRectangle(3X) — X Version 11

NAME

XFillRectangle, XFillRectangles, XFillPolygon, XFillArc, XFillArcs − fill rectangles, polygons, or arcs

SYNTAX

XFillRectangle(display, d, gc, x, y, width, height)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      unsigned int width, height;

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

XFillPolygon(display, d, gc, points, npoints, shape, mode)
      Display ∗display;
      Drawable d;
      GC gc;
      XPoint ∗points;
      int npoints;
      int shape;
      int mode;

XFillArc(display, d, gc, x, y, width, height, angle1, angle2)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      unsigned int width, height;
      int angle1, angle2;

XFillArcs(display, d, gc, arcs, narcs)
      Display ∗display;
      Drawable d;
      GC gc;
      XArc ∗arcs;
      int narcs;

ARGUMENTS

angle1Specifies the start of the arc relative to the three-o-clock position from the center, in units of degrees ∗ 64.

angle2Specifies the path and extent of the arc relative to the start of the arc, in units of degrees ∗ 64.

arcsSpecifies a pointer to an array of arcs.

dSpecifies the drawable.

displaySpecifies the connection to the X server.

gcSpecifies the graphics context.

modeSpecifies the coordinate mode. CoordModeOrigin treats a coordinates as related to the origin, while CoordModePrevious treats all coordinates after the first as relative to the previous point.

narcsSpecifies the number of arcs in the array.

npointsSpecifies the number of points in the array.

nrectanglesSpecifies the number of rectangles in the array.

pointsSpecifies a pointer to an array of points.

rectanglesSpecifies a pointer to an array of rectangles.

shapeSpecifies an argument that helps the server to improve performance. You can pass one of these constants: Complex, Convex, or Nonconvex.

width

heightSpecify the width and height.

ySpecify the x and y coordinates.

DESCRIPTION

The XFillRectangle and XFillRectangles functions fill the specified rectangle or rectangles as if a four-point XFillPolygon were specified for each rectangle:

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

.PN XFillRectangle and .PN XFillRectangles can generate BadDrawable, BadGC, and BadMatch errors.

The XFillPolygon function fills a polygon area in the specified drawable. .PN XFillRectangle can generate BadDrawable, BadGC, BadMatch, and BadValue errors.

The XFillArc function fills a single arc in the specified drawable, while XFillArcs fills multiple arcs in the specified drawable. .PN XFillArc and .PN XFillArcs 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.

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument’s type is accepted. Any argument defined as a set of alternatives can generate this error.

Museum