ultrix man page for xdrawrectangles

XDrawRectangle(3X11)						     MIT X11R4						      XDrawRectangle(3X11)

Name
       XDrawRectangle, XDrawRectangles, XRectangle - draw rectangles and rectangles structure

Syntax
       XDrawRectangle(display, d, gc, x, y, width, height)
	  Display *display;
	  Drawable d;
	  GC gc;
	  int x, y;
	  unsigned int width, height;

       XDrawRectangles(display, d, gc, rectangles, nrectangles)
	  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 a pointer to 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 and functions draw the outlines of the specified rectangle or rectangles as if a five-point protocol request were specified for each
       rectangle:

	      [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.  draws the rectangles in the order listed in
       the array.  If rectangles intersect, the intersecting pixels are drawn multiple times.

       Both functions use these GC components: function, plane-mask, line-width, line-style, join-style, fill-style, subwindow-mode, clip-x-ori-
       gin, 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.

       and can generate and errors.

Structures
       The 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
       A value for a Drawable argument does not name a defined Window or Pixmap.

       A value for a GContext argument does not name a defined GContext.

       An	 window is used as a Drawable.

       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(3X11), XDrawLine(3X11), XDrawPoint(3X11)
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

															      XDrawRectangle(3X11)