XDrawPoint(3X11)        COMMAND REFERENCE        XDrawPoint(3X11)



NAME
     XDrawPoint, XDrawPoints - draw points

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
     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 a pointer to 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 components 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.  XDrawPoints draws the points in the order listed in
     the array.

     Both functions use these GC components: function, plane-
     mask, foreground, subwindow-mode, clip-x-origin, clip-y-
     origin, and clip-mask.

     XDrawPoint can generate BadDrawable, BadGC, and BadMatch
     errors.  XDrawPoint can generate BadDrawable, BadGC,



X Version 11            1 September 1988                        1

XDrawPoint(3X11)        COMMAND REFERENCE        XDrawPoint(3X11)



     BadMatch, and BadValue errors.

DIAGNOSTICS
     BadDrawable
               A value for a Drawable argument does not name a
               defined Window or Pixmap.

     BadGC     A value for a GContext argument does not name a
               defined GContext.

     BadMatch  An InputOnly window is used as a Drawable.

     BadMatch  Some argument or pair of arguments has the correct
               type and range but fails to match in some other
               way required by the request.

     BadValue  Some numeric value falls outside the range of
               values accepted 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            1 September 1988                        2

%%index%%
na:456,89;
sy:545,1263;
de:1808,1688;
di:3496,1027;
se:4523,317;
%%index%%000000000098