MirBSD manpage: XDrawRectangle(3), XDrawRectangles(3), XRectangle(3)

XDrawRectangle(3X11)     XLIB FUNCTIONS      XDrawRectangle(3X11)


     XDrawRectangle, XDrawRectangles, XRectangle - draw rectan-
     gles and rectangles structure


     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);


     d         Specifies the drawable.

     display   Specifies the connection to the X server.

     gc        Specifies the GC.

               Specifies the number of rectangles in the array.

               Specifies an array of rectangles.

     height    Specify the width and height, which specify the
               dimensions of the rectangle.

     y         Specify the x and y coordinates, which specify the
               upper-left corner of the rectangle.


     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

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

     For the specified rectangle or rectangles, these functions
     do not draw a pixel more than once. XDrawRectangles draws
     the rectangles in the order listed in the array. If rectan-
     gles intersect, the intersecting pixels are drawn multiple

     Both functions use these GC components: function, plane-
     mask, line-width, line-style, cap-style, join-style, 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, tile-stipple-y-origin, dash-offset, and dash-list.

XFree86                   Version 4.5.0                         1

XDrawRectangle(3X11)     XLIB FUNCTIONS      XDrawRectangle(3X11)

     XDrawRectangle and XDrawRectangles can generate BadDrawable,
     BadGC, and BadMatch errors.


     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.


               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.


     XDrawArc(3X11), XDrawLine(3X11), XDrawPoint(3X11)
     Xlib - C Language X Interface

XFree86                   Version 4.5.0                         2

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.