


XDrawPoint(3X11)					     XDrawPoint(3X11)
X11R5									X11R5



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

SYNTAX
  XDrawPoint(_d_i_s_p_l_a_y, _d, _g_c, _x,	_y)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	int _x, _y;

  XDrawPoints(_d_i_s_p_l_a_y, _d, _g_c, _p_o_i_n_t_s, _n_p_o_i_n_t_s, _m_o_d_e)
	Display	*_d_i_s_p_l_a_y;
	Drawable _d;
	GC _g_c;
	XPoint *_p_o_i_n_t_s;
	int _n_p_o_i_n_t_s;
	int _m_o_d_e;

ARGUMENTS

  _d	    Specifies the drawable.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _g_c	    Specifies the GC.

  _m_o_d_e	    Specifies the coordinate mode. You can pass	_C_o_o_r_d_M_o_d_e_O_r_i_g_i_n	or
	    _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s.

  _n_p_o_i_n_t_s   Specifies the number of points in the array.

  _p_o_i_n_t_s    Specifies an array of points.

  _x
  _y	    Specify the	x and y	coordinates where you want the point drawn.

DESCRIPTION
  The _X_D_r_a_w_P_o_i_n_t function uses the foreground pixel and	function components
  of the GC to draw a single point into	the specified drawable;	_X_D_r_a_w_P_o_i_n_t_s
  draws	multiple points	this way.  _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as
  relative to the origin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s	treats all coordinates after
  the first as relative	to the previous	point.	_X_D_r_a_w_P_o_i_n_t_s 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.

  _X_D_r_a_w_P_o_i_n_t can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C, and _B_a_d_M_a_t_c_h errors.
  _X_D_r_a_w_P_o_i_n_t_s can generate _B_a_d_D_r_a_w_a_b_l_e,	_B_a_d_G_C, _B_a_d_M_a_t_c_h, and _B_a_d_V_a_l_u_e errors.



STRUCTURES
  The _X_P_o_i_n_t 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

  _B_a_d_D_r_a_w_a_b_l_e
	    A value for	a Drawable argument does not name a defined Window or
	    Pixmap.

  _B_a_d_G_C	    A value for	a GContext argument does not name a defined GContext.

  _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window	is used	as a Drawable.

  _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct type and	range
	    but	fails to match in some other way required by the request.

  _B_a_d_V_a_l_u_e  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(3X11), XDrawLine(3X11), XDrawRectangle(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e






































