*** UNIX MANUAL PAGE BROWSER ***

XDrawPoint(3X11) XDrawPoint(3X11) NAME XDrawPoint, XDrawPoints, XPoint - draw points and points structure SYNOPSIS XDrawPoint(display, d, gc, x, y) Display *display; Drawable d; GC gc; int x, y; XDrawPoints(display, d, gc, points, npoints, mode) Display *display; Drawable d; GC gc; XPoint *points; int npoints; int mode; ARGUMENTS Specifies the drawable. Specifies the connection to the X server. Specifies the GC. Specifies the coordinate mode. You can pass Coord- ModeOrigin or CoordModePrevious. Specifies the number of points in the array. Specifies an array of points. Specify the x and y coordinates where you want the point drawn. DESCRIPTION The XDrawPoint function uses the foreground pixel and function compo- nents of the GC to draw a single point into the specified drawable; XDrawPoints draws multiple points this way. CoordModeOrigin treats all coordinates as relative to the origin, and CoordModePrevious treats all coordinates after the first as relative to the previous point. XDraw- Points draws the points in the order listed in the array. Both functions use these GC components: function, plane-mask, fore- ground, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask. XDrawPoint can generate BadDrawable, BadGC, and BadMatch errors. XDrawPoints can generate BadDrawable, BadGC, BadMatch, and BadValue er- rors. STRUCTURES The XPoint structure contains: typedef struct { short x, y; } XPoint; 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 co- ordinates 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 GCon- text. An InputOnly 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. Some numeric value falls out- side the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argu- ment's type is accepted. Any argument defined as a set of alternatives can generate this error. SEE ALSO XDrawArc(3X11), XDrawLine(3X11), XDrawRectangle(3X11) Xlib -- C Language X Interface XDrawPoint(3X11)