Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XDrawPoint(3)			 XLIB FUNCTIONS 		   XDrawPoint(3)

NAME
     XDrawPoint, XDrawPoints, XPoint - draw points and points structure

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

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  argu-
	       ment,  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(3), XDrawLine(3), XDrawRectangle(3)
     Xlib - C Language X Interface

X Version 11			  libX11 1.8.13 		   XDrawPoint(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XPoint&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help