home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xpoint.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XDrawPoint(3X11)      XLIB FUNCTIONS     XDrawPoint(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XDrawPoint, XDrawPoints, XPoint - draw points and points
  9.        structure
  10.  
  11. SSYYNNTTAAXX
  12.        XDrawPoint(_d_i_s_p_l_a_y, _d, _g_c, _x, _y)
  13.          Display *_d_i_s_p_l_a_y;
  14.          Drawable _d;
  15.          GC _g_c;
  16.          int _x, _y;
  17.  
  18.        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)
  19.          Display *_d_i_s_p_l_a_y;
  20.          Drawable _d;
  21.          GC _g_c;
  22.          XPoint *_p_o_i_n_t_s;
  23.          int _n_p_o_i_n_t_s;
  24.          int _m_o_d_e;
  25.  
  26. AARRGGUUMMEENNTTSS
  27.        _d     Specifies the drawable.
  28.  
  29.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  30.  
  31.        _g_c     Specifies the GC.
  32.  
  33.        _m_o_d_e     Specifies the coordinate mode.     You can pass
  34.          _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.
  35.  
  36.        _n_p_o_i_n_t_s     Specifies the number of points in the array.
  37.  
  38.        _p_o_i_n_t_s     Specifies an array of points.
  39.  
  40.        _x
  41.        _y     Specify the x and y coordinates where you want
  42.          the point drawn.
  43.  
  44. DDEESSCCRRIIPPTTIIOONN
  45.        The _X_D_r_a_w_P_o_i_n_t function uses the foreground pixel and
  46.        function components of the GC to draw a single point into
  47.        the specified drawable; _X_D_r_a_w_P_o_i_n_t_s draws multiple points
  48.        this way.  _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as rela-
  49.        tive to the origin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s treats all coor-
  50.        dinates after the first as relative to the previous point.
  51.        _X_D_r_a_w_P_o_i_n_t_s draws the points in the order listed in the
  52.        array.
  53.  
  54.        Both functions use these GC components: function, plane-
  55.        mask, foreground, subwindow-mode, clip-x-origin, clip-y-
  56.        origin, and clip-mask.
  57.  
  58.        _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
  59.        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,
  60.        _B_a_d_M_a_t_c_h, and _B_a_d_V_a_l_u_e errors.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XDrawPoint(3X11)      XLIB FUNCTIONS     XDrawPoint(3X11)
  71.  
  72.  
  73. SSTTRRUUCCTTUURREESS
  74.        The _X_P_o_i_n_t structure contains:
  75.  
  76.        typedef struct {
  77.         short x, y;
  78.        } XPoint;
  79.  
  80.        All x and y members are signed integers.     The width and
  81.        height members are 16-bit unsigned integers.  You should
  82.        be careful not to generate coordinates and sizes out of
  83.        the 16-bit ranges, because the protocol only has 16-bit
  84.        fields for these values.
  85.  
  86. DDIIAAGGNNOOSSTTIICCSS
  87.        _B_a_d_D_r_a_w_a_b_l_e
  88.          A value for a Drawable argument does not name a
  89.          defined Window or Pixmap.
  90.  
  91.        _B_a_d_G_C     A value for a GContext argument does not name a
  92.          defined GContext.
  93.  
  94.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  95.  
  96.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  97.          rect type and range but fails to match in some
  98.          other way required by the request.
  99.  
  100.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  101.          values accepted by the request.  Unless a spe-
  102.          cific range is specified for an argument, the
  103.          full range defined by the argument's type is
  104.          accepted.  Any argument defined as a set of
  105.          alternatives can generate this error.
  106.  
  107. SSEEEE AALLSSOO
  108.        XDrawArc(3X11), XDrawLine(3X11), XDrawRectangle(3X11)
  109.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.