home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xsetlineattributes.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  5.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XSetLineAttributes(3X11)  XLIB FUNCTIONS XSetLineAttributes(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSetLineAttributes, XSetDashes - GC convenience routines
  9.  
  10. SSYYNNTTAAXX
  11.        XSetLineAttributes(_d_i_s_p_l_a_y, _g_c, _l_i_n_e___w_i_d_t_h, _l_i_n_e___s_t_y_l_e,
  12.        _c_a_p___s_t_y_l_e, _j_o_i_n___s_t_y_l_e)
  13.          Display *_d_i_s_p_l_a_y;
  14.          GC _g_c;
  15.          unsigned int _l_i_n_e___w_i_d_t_h;
  16.          int _l_i_n_e___s_t_y_l_e;
  17.          int _c_a_p___s_t_y_l_e;
  18.          int _j_o_i_n___s_t_y_l_e;
  19.  
  20.        XSetDashes(_d_i_s_p_l_a_y, _g_c, _d_a_s_h___o_f_f_s_e_t, _d_a_s_h___l_i_s_t, _n)
  21.            Display *_d_i_s_p_l_a_y;
  22.            GC _g_c;
  23.            int _d_a_s_h___o_f_f_s_e_t;
  24.            char _d_a_s_h___l_i_s_t[];
  25.            int _n;
  26.  
  27. AARRGGUUMMEENNTTSS
  28.        _c_a_p___s_t_y_l_e Specifies the line-style and cap-style you want
  29.          to set for the specified GC.  You can pass
  30.          _C_a_p_N_o_t_L_a_s_t, _C_a_p_B_u_t_t, _C_a_p_R_o_u_n_d, or _C_a_p_P_r_o_j_e_c_t_i_n_g.
  31.  
  32.        _d_a_s_h___l_i_s_t Specifies the dash-list for the dashed line-
  33.          style you want to set for the specified GC.
  34.  
  35.        _d_a_s_h___o_f_f_s_e_t
  36.          Specifies the phase of the pattern for the
  37.          dashed line-style you want to set for the speci-
  38.          fied GC.
  39.  
  40.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  41.  
  42.        _g_c     Specifies the GC.
  43.  
  44.        _j_o_i_n___s_t_y_l_e
  45.          Specifies the line join-style you want to set
  46.          for the specified GC.    You can pass _J_o_i_n_M_i_t_e_r,
  47.          _J_o_i_n_R_o_u_n_d, or _J_o_i_n_B_e_v_e_l.
  48.  
  49.        _l_i_n_e___s_t_y_l_e
  50.          Specifies the line-style you want to set for the
  51.          specified GC.    You can pass _L_i_n_e_S_o_l_i_d,
  52.          _L_i_n_e_O_n_O_f_f_D_a_s_h, or _L_i_n_e_D_o_u_b_l_e_D_a_s_h.
  53.  
  54.        _l_i_n_e___w_i_d_t_h
  55.          Specifies the line-width you want to set for the
  56.          specified GC.
  57.  
  58.        _n     Specifies the number of elements in dash_list.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSetLineAttributes(3X11)  XLIB FUNCTIONS XSetLineAttributes(3X11)
  71.  
  72.  
  73. DDEESSCCRRIIPPTTIIOONN
  74.        The _X_S_e_t_L_i_n_e_A_t_t_r_i_b_u_t_e_s function sets the line drawing com-
  75.        ponents in the specified GC.
  76.  
  77.        _X_S_e_t_L_i_n_e_A_t_t_r_i_b_u_t_e_s can generate _B_a_d_A_l_l_o_c, _B_a_d_G_C, and _B_a_d_-
  78.        _V_a_l_u_e errors.
  79.  
  80.        The _X_S_e_t_D_a_s_h_e_s function sets the dash-offset and dash-list
  81.        attributes for dashed line styles in the specified GC.
  82.        There must be at least one element in the specified
  83.        dash_list, or a _B_a_d_V_a_l_u_e error results.    The initial and
  84.        alternating elements (second, fourth, and so on) of the
  85.        dash_list are the even dashes, and the others are the odd
  86.        dashes.    Each element specifies a dash length in pixels.
  87.        All of the elements must be nonzero, or a _B_a_d_V_a_l_u_e error
  88.        results.     Specifying an odd-length list is equivalent to
  89.        specifying the same list concatenated with itself to pro-
  90.        duce an even-length list.
  91.  
  92.        The dash-offset defines the phase of the pattern, specify-
  93.        ing how many pixels into the dash-list the pattern should
  94.        actually begin in any single graphics request.  Dashing is
  95.        continuous through path elements combined with a join-
  96.        style but is reset to the dash-offset between each
  97.        sequence of joined lines.
  98.  
  99.        The unit of measure for dashes is the same for the ordi-
  100.        nary coordinate system.    Ideally, a dash length is mea-
  101.        sured along the slope of the line, but implementations are
  102.        only required to match this ideal for horizontal and ver-
  103.        tical lines.  Failing the ideal semantics, it is suggested
  104.        that the length be measured along the major axis of the
  105.        line.  The major axis is defined as the x axis for lines
  106.        drawn at an angle of between -45 and +45 degrees or
  107.        between 135 and 225 degrees from the x axis.  For all
  108.        other lines, the major axis is the y axis.
  109.  
  110.        _X_S_e_t_D_a_s_h_e_s can generate _B_a_d_A_l_l_o_c, _B_a_d_G_C, and _B_a_d_V_a_l_u_e
  111.        errors.
  112.  
  113. DDIIAAGGNNOOSSTTIICCSS
  114.        _B_a_d_A_l_l_o_c     The server failed to allocate the requested
  115.          resource or server memory.
  116.  
  117.        _B_a_d_G_C     A value for a GContext argument does not name a
  118.          defined GContext.
  119.  
  120.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  121.          values accepted by the request.  Unless a spe-
  122.          cific range is specified for an argument, the
  123.          full range defined by the argument's type is
  124.          accepted.  Any argument defined as a set of
  125.          alternatives can generate this error.
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSetLineAttributes(3X11)  XLIB FUNCTIONS XSetLineAttributes(3X11)
  137.  
  138.  
  139. SSEEEE AALLSSOO
  140.        XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11),
  141.        XSetClipOrigin(3X11), XSetFillStyle(3X11), XSetFont(3X11),
  142.        XSetState(3X11), XSetTile(3X11)
  143.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.