home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xfillrectangle.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  9.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XFillRectangle(3X11)      XLIB FUNCTIONS     XFillRectangle(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XFillRectangle, XFillRectangles, XFillPolygon, XFillArc,
  9.        XFillArcs - fill rectangles, polygons, or arcs
  10.  
  11. SSYYNNTTAAXX
  12.        XFillRectangle(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
  13.          Display *_d_i_s_p_l_a_y;
  14.          Drawable _d;
  15.          GC _g_c;
  16.          int _x, _y;
  17.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  18.  
  19.        XFillRectangles(_d_i_s_p_l_a_y, _d, _g_c, _r_e_c_t_a_n_g_l_e_s, _n_r_e_c_t_a_n_g_l_e_s)
  20.          Display *_d_i_s_p_l_a_y;
  21.          Drawable _d;
  22.          GC _g_c;
  23.          XRectangle *_r_e_c_t_a_n_g_l_e_s;
  24.          int _n_r_e_c_t_a_n_g_l_e_s;
  25.  
  26.        XFillPolygon(_d_i_s_p_l_a_y, _d, _g_c, _p_o_i_n_t_s, _n_p_o_i_n_t_s, _s_h_a_p_e, _m_o_d_e)
  27.          Display *_d_i_s_p_l_a_y;
  28.          Drawable _d;
  29.          GC _g_c;
  30.          XPoint *_p_o_i_n_t_s;
  31.          int _n_p_o_i_n_t_s;
  32.          int _s_h_a_p_e;
  33.          int _m_o_d_e;
  34.  
  35.        XFillArc(_d_i_s_p_l_a_y, _d, _g_c,     _x, _y, _w_i_d_t_h, _h_e_i_g_h_t, _a_n_g_l_e_1,
  36.        _a_n_g_l_e_2)
  37.          Display *_d_i_s_p_l_a_y;
  38.          Drawable _d;
  39.          GC _g_c;
  40.          int _x, _y;
  41.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  42.          int _a_n_g_l_e_1, _a_n_g_l_e_2;
  43.  
  44.        XFillArcs(_d_i_s_p_l_a_y, _d, _g_c, _a_r_c_s, _n_a_r_c_s)
  45.          Display *_d_i_s_p_l_a_y;
  46.          Drawable _d;
  47.          GC _g_c;
  48.          XArc *_a_r_c_s;
  49.          int _n_a_r_c_s;
  50.  
  51. AARRGGUUMMEENNTTSS
  52.        _a_n_g_l_e_1     Specifies the start of the arc relative to the
  53.          three-o'clock position from the center, in units
  54.          of degrees * 64.
  55.  
  56.        _a_n_g_l_e_2     Specifies the path and extent of the arc rela-
  57.          tive to the start of the arc, in units of
  58.          degrees * 64.
  59.  
  60.        _a_r_c_s     Specifies an array of arcs.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XFillRectangle(3X11)      XLIB FUNCTIONS     XFillRectangle(3X11)
  71.  
  72.  
  73.        _d     Specifies the drawable.
  74.  
  75.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  76.  
  77.        _g_c     Specifies the GC.
  78.  
  79.        _m_o_d_e     Specifies the coordinate mode.     You can pass
  80.          _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.
  81.  
  82.        _n_a_r_c_s     Specifies the number of arcs in the array.
  83.  
  84.        _n_p_o_i_n_t_s     Specifies the number of points in the array.
  85.  
  86.        _n_r_e_c_t_a_n_g_l_e_s
  87.          Specifies the number of rectangles in the array.
  88.  
  89.        _p_o_i_n_t_s     Specifies an array of points.
  90.  
  91.        _r_e_c_t_a_n_g_l_e_s
  92.          Specifies an array of rectangles.
  93.  
  94.        _s_h_a_p_e     Specifies a shape that helps the server to
  95.          improve performance.  You can pass _C_o_m_p_l_e_x,
  96.          _C_o_n_v_e_x, or _N_o_n_c_o_n_v_e_x.
  97.  
  98.        _w_i_d_t_h
  99.        _h_e_i_g_h_t     Specify the width and height, which are the
  100.          dimensions of the rectangle to be filled or the
  101.          major and minor axes of the arc.
  102.  
  103.        _x
  104.        _y     Specify the x and y coordinates, which are rela-
  105.          tive to the origin of the drawable and specify
  106.          the upper-left corner of the rectangle.
  107.  
  108. DDEESSCCRRIIPPTTIIOONN
  109.        The _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s functions fill the
  110.        specified rectangle or rectangles as if a four-point
  111.        _F_i_l_l_P_o_l_y_g_o_n protocol request were specified for each rect-
  112.        angle:
  113.  
  114.        [x,y] [x+width,y] [x+width,y+height] [x,y+height]
  115.  
  116.        Each function uses the x and y coordinates, width and
  117.        height dimensions, and GC you specify.
  118.  
  119.        _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s fills the rectangles in the order listed
  120.        in the array.  For any given rectangle, _X_F_i_l_l_R_e_c_t_a_n_g_l_e and
  121.        _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s do not draw a pixel more than once.  If
  122.        rectangles intersect, the intersecting pixels are drawn
  123.        multiple times.
  124.  
  125.        Both functions use these GC components: function, plane-
  126.        mask, fill-style, subwindow-mode, clip-x-origin, clip-y-
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XFillRectangle(3X11)      XLIB FUNCTIONS     XFillRectangle(3X11)
  137.  
  138.  
  139.        origin, and clip-mask.  They also use these GC mode-
  140.        dependent components: foreground, background, tile, stip-
  141.        ple, tile-stipple-x-origin, and tile-stipple-y-origin.
  142.  
  143.        _X_F_i_l_l_R_e_c_t_a_n_g_l_e and _X_F_i_l_l_R_e_c_t_a_n_g_l_e_s can generate
  144.        _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.
  145.  
  146.        _X_F_i_l_l_P_o_l_y_g_o_n fills the region closed by the specified
  147.        path.  The path is closed automatically if the last point
  148.        in the list does not coincide with the first point.
  149.        _X_F_i_l_l_P_o_l_y_g_o_n does not draw a pixel of the region more than
  150.        once.  _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as relative
  151.        to the origin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s treats all coordi-
  152.        nates after the first as relative to the previous point.
  153.  
  154.        Depending on the specified shape, the following occurs:
  155.  
  156.        +o    If shape is _C_o_m_p_l_e_x, the path may self-intersect.
  157.         Note that contiguous coincident points in the path
  158.         are not treated as self-intersection.
  159.  
  160.        +o    If shape is _C_o_n_v_e_x, for every pair of points inside
  161.         the polygon, the line segment connecting them does
  162.         not intersect the path.  If known by the client,
  163.         specifying _C_o_n_v_e_x can improve performance.    If you
  164.         specify _C_o_n_v_e_x for a path that is not convex, the
  165.         graphics results are undefined.
  166.  
  167.        +o    If shape is _N_o_n_c_o_n_v_e_x, the path does not self-
  168.         intersect, but the shape is not wholly convex.  If
  169.         known by the client, specifying _N_o_n_c_o_n_v_e_x instead of
  170.         _C_o_m_p_l_e_x may improve performance.  If you specify _N_o_n_-
  171.         _c_o_n_v_e_x for a self-intersecting path, the graphics
  172.         results are undefined.
  173.  
  174.        The fill-rule of the GC controls the filling behavior of
  175.        self-intersecting polygons.
  176.  
  177.        This function uses these GC components: function, plane-
  178.        mask, fill-style, fill-rule, subwindow-mode, clip-x-
  179.        origin, clip-y-origin, and clip-mask.  It also uses these
  180.        GC mode-dependent components: foreground, background,
  181.        tile, stipple, tile-stipple-x-origin, and tile-stipple-y-
  182.        origin.
  183.  
  184.        _X_F_i_l_l_P_o_l_y_g_o_n 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,
  185.        and _B_a_d_V_a_l_u_e errors.
  186.  
  187.        For each arc, _X_F_i_l_l_A_r_c or _X_F_i_l_l_A_r_c_s fills the region
  188.        closed by the infinitely thin path described by the speci-
  189.        fied arc and, depending on the arc-mode specified in the
  190.        GC, one or two line segments.  For _A_r_c_C_h_o_r_d, the single
  191.        line segment joining the endpoints of the arc is used.
  192.        For _A_r_c_P_i_e_S_l_i_c_e, the two line segments joining the
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XFillRectangle(3X11)      XLIB FUNCTIONS     XFillRectangle(3X11)
  203.  
  204.  
  205.        endpoints of the arc with the center point are used.
  206.        _X_F_i_l_l_A_r_c_s fills the arcs in the order listed in the array.
  207.        For any given arc, _X_F_i_l_l_A_r_c and _X_F_i_l_l_A_r_c_s do not draw a
  208.        pixel more than once.  If regions intersect, the inter-
  209.        secting pixels are drawn multiple times.
  210.  
  211.        Both functions use these GC components: function, plane-
  212.        mask, fill-style, arc-mode, subwindow-mode, clip-x-origin,
  213.        clip-y-origin, and clip-mask.  They also use these GC
  214.        mode-dependent components: foreground, background, tile,
  215.        stipple, tile-stipple-x-origin, and tile-stipple-y-origin.
  216.  
  217.        _X_F_i_l_l_A_r_c and _X_F_i_l_l_A_r_c_s can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C,
  218.        and _B_a_d_M_a_t_c_h errors.
  219.  
  220. DDIIAAGGNNOOSSTTIICCSS
  221.        _B_a_d_D_r_a_w_a_b_l_e
  222.          A value for a Drawable argument does not name a
  223.          defined Window or Pixmap.
  224.  
  225.        _B_a_d_G_C     A value for a GContext argument does not name a
  226.          defined GContext.
  227.  
  228.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  229.  
  230.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  231.          rect type and range but fails to match in some
  232.          other way required by the request.
  233.  
  234.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  235.          values accepted by the request.  Unless a spe-
  236.          cific range is specified for an argument, the
  237.          full range defined by the argument's type is
  238.          accepted.  Any argument defined as a set of
  239.          alternatives can generate this error.
  240.  
  241. SSEEEE AALLSSOO
  242.        XDrawArc(3X11), XDrawPoint(3X11), XDrawRectangle(3X11)
  243.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.