XDrawPoints(3x) — HP-UX ANSI C A.09.00

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

displaySpecifies a connection to an X server; returned from XOpenDisplay().

drawableSpecifies the drawable.

gcSpecifies the graphics context.

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

npointsSpecifies the number of points to be drawn.

modeSpecifies 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 XDrawPoints() 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 3 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