table of contents
XDrawRectangle(3) | XLIB FUNCTIONS | XDrawRectangle(3) |
NAME¶
XDrawRectangle, XDrawRectangles, XRectangle - draw rectangles and rectangles structureSYNTAX¶
int XDrawRectangle(Display *display, Drawable d,
GC gc, int x, int y, unsigned int width, unsigned
int height);
int XDrawRectangles(Display *display, Drawable d,
GC gc, XRectangle rectangles[], int nrectangles);
ARGUMENTS¶
- d
- Specifies the drawable.
- display
- Specifies the connection to the X server.
- gc
- Specifies the GC.
- nrectangles
- Specifies the number of rectangles in the array.
- rectangles
- Specifies an array of rectangles.
- width
-
- height
- Specify the width and height, which specify the dimensions of the rectangle.
- x
-
- y
- Specify the x and y coordinates, which specify the upper-left corner of the rectangle.
DESCRIPTION¶
The XDrawRectangle and XDrawRectangles functions draw the outlines of the specified rectangle or rectangles as if a five-point PolyLine protocol request were specified for each rectangle:- [x,y] [x+width,y] [x+width,y+height] [x,y+height] [x,y]
STRUCTURES¶
The XRectangle structure contains:typedef struct { short x, y; unsigned short width, height; } XRectangle;All x and y members are signed integers. The width and height members are 16-bit unsigned integers. You should be careful not to generate coordinates and sizes out of the 16-bit ranges, because the protocol only has 16-bit fields for these values.
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(3), XDrawLine(3), XDrawPoint(3)libX11 1.6.2 | X Version 11 |