XDrawPoints()															     XDrawPoints()

Name
  XDrawPoints - draw multiple points.

Synopsis
  XDrawPoints(display, drawable, gc, points, npoints, mode)
	Display *display;
	Drawable drawable;
	GC gc;
	XPoint *points;
	int npoints;
	int mode;

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

  drawable  Specifies the drawable.

  gc	    Specifies the graphics context.

  points    Specifies a pointer to an array of XPoint structures containing the positions of the points.

  npoints   Specifies the number of points to be drawn.

  mode	    Specifies  the  coordinate mode. CoordModeOrigin treats all coordinates as relative to the origin, while CoordModePrevious treats
	    all coordinates after the first as relative to the previous point, while the first is still relative to the origin.

Description
  XDrawPoints() draws one or more points into the specified drawable.  XDrawPoints() draws the points in the order listed in the array.

  In R4 and earlier, because of the maximum request size, there is a limit to the number of points that can  be  drawn	in  a  single  XDraw-
  Points()  call,  that  varies according to the server.  In R5, Xlib breaks the call up into as many requests as required.  To determine how
  many points you can draw in a single call in R4, you find out your server's maximum request size using XMaxRequestSize().   Subtract	three
  and this is the maximum number of points you can draw in a single XDrawPoints() call.

  XDrawPoints()  uses  these graphics context components: function, plane_mask, foreground, subwindow_mode, clip_x_origin, clip_y_origin, and
  clip_mask.

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

Structures
     typedef struct {
	 short x, y;
     } XPoint;

Errors
  BadDrawable
  BadGC
  BadMatch
  BadValue

See Also
  XClearArea(), XClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLine(),	XDrawLines(),  XDraw-
  Points(),  XDrawRectangle(),	XDrawRectangles(),  XDrawSegments(),  XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan-
  gles().

Xlib - Drawing Primitives													     XDrawPoints()