xflushgc(3) [hpux man page]

XFlushGC()																XFlushGC()

Name
  XFlushGC - force cached GC changes to the server.

Synopsis
  void XFlushGC(display, gc)
	 Display *display;
	 GC gc;

Arguments
  display   Specifies the connection to the X server.

  gc	    Specifies the graphics context.

Availability
  Release 5 and later.

Description
  Xlib	normally  defers  sending  changes to the components of a GC to the server until a graphics function is actually called with that GC.
  This permits batching of component changes into a single server request.  In some circumstances, however,  it  may  be  necessary  for  the
  client  to explicitly force sending of the changes to the server.  An example might be when a protocol extension uses the GC indirectly, in
  such a way that the extension interface cannot know what GC will be used.  In a case like this, the extension library could use  XFlushGC()
  to force any cached changes to the GC it will use to be flushed to the server.

See Also
  XChangeGC(), XSetForeground().

Xlib - Graphics Context 														XFlushGC()

XDrawRectangles()														 XDrawRectangles()

Name
  XDrawRectangles - draw the outlines of multiple rectangles.

Synopsis
  XDrawRectangles(display, drawable, gc, rectangles, nrectangles)
	Display *display;
	Drawable drawable;
	GC gc;
	XRectangle rectangles[];
	int nrectangles;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  drawable  Specifies the drawable.

  gc	    Specifies the graphics context.

  rectangles
	    Specifies a pointer to an array of rectangles containing position and size information.

  nrectangles
	    Specifies the number of rectangles in the array.

Description
  XDrawRectangles()  draws  the outlines of the specified rectangles by using the position and size values in the array of rectangles.	The x
  and y coordinates of each rectangle are relative to the drawable's origin, and define the upper-left corner of the rectangle.

  The rectangles are drawn in the order listed.  For any given rectangle, no pixel is drawn more than once.  If rectangles intersect,  pixels
  are drawn multiple times.

  In  R4  and earlier there is a limit to the number of rectangles that can be drawn in a single XDrawRectangles() call, based on the maximum
  request size, which varies according to the server.  In R5, Xlib chops your call into as many protocol requests as required.	To  determine
  how  many  rectangles  you  can draw in a single call in R4, find out your server's maximum request size using XMaxRequestSize().  Subtract
  three and divide by two.  This is the maximum number of rectangles you can draw in a single XDrawRectangles() call.

  This function uses these graphics context components: function, plane_mask, line_width, line_style, join_style, fill_style, subwindow_mode,
  clip_x_origin,  clip_y_origin,  and  clip_mask.   XDrawRectangles() also uses these graphics context mode-dependent components: foreground,
  background, tile, stipple, ts_x_origin, ts_y_origin, dash_offset, and dashes.

  For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, The Graphics Context.

Structures
     typedef struct {
	 short x, y;
	 unsigned short width, height;
     } XRectangle;

Errors
  BadDrawable
  BadGC
  BadMatch

See Also
  XClearArea(), XClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLine(),	XDrawLines(),  XDraw-
  Point(), XDrawPoints(), XDrawRectangle(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectangles().

Xlib - Drawing Primitives													 XDrawRectangles()