SYNTAX

       int XDrawPoint(Display *display, Drawable d, GC gc, int x, int y);

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

ARGUMENTS

       d         Specifies the drawable.

       display   Specifies the connection to the X server.

       gc        Specifies the GC.

       mode      Specifies the coordinate mode.  You can pass CoordModeOrigin
                 or CoordModePrevious.

       npoints   Specifies the number of points in the array.

       points    Specifies an array of points.

       x
       y         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
       errors.

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
       coordinates and sizes out of the 16-bit ranges, because the protocol
       only has 16-bit fields for these values.

DIAGNOSTICS

                 by the request.  Unless a specific range is specified for an
                 argument, the full range defined by the argument'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



X Version 11                      Release 6.6                 XDrawPoint(3X11)