Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XDrawPoints()							 XDrawPoints()

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
  display   Specifies	a  connection  to  an  X  server;  returned  from
	    XOpenDisplay().

  drawable  Specifies the drawable.

  gc	    Specifies the graphics context.

  points    Specifies a pointer to an array of XPoint structures contain‐
	    ing the positions of the points.

  npoints   Specifies the number of points to be drawn.

  mode	    Specifies  the  coordinate	mode.  CoordModeOrigin treats all
	    coordinates as relative to the origin, while  CoordModePrevi‐
	    ous treats all coordinates after the first as relative to the
	    previous point, while the first is still relative to the ori‐
	    gin.

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 XDraw‐
  Points() 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 three 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

See Also
  XClearArea(),	  XClearWindow(),   XCopyArea(),   XCopyPlane(),   XDraw,
  XDrawArc(),	XDrawArcs(),  XDrawFilled(),  XDrawLine(),  XDrawLines(),
  XDrawPoints(),  XDrawRectangle(),  XDrawRectangles(),	 XDrawSegments(),
  XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan‐
  gles().

Xlib - Drawing Primitives					 XDrawPoints()

Vote for polarhome