home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XSetLineAttributes.z / XSetLineAttributes
Encoding:
Text File  |  2002-10-03  |  7.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetLineAttributes, XSetDashes - GC convenience routines
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           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,
  13.           _c_a_p__s_t_y_l_e, _j_o_i_n__s_t_y_l_e)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 GC _g_c;
  16.                 unsigned int _l_i_n_e__w_i_d_t_h;
  17.                 int _l_i_n_e__s_t_y_l_e;
  18.                 int _c_a_p__s_t_y_l_e;
  19.                 int _j_o_i_n__s_t_y_l_e;
  20.  
  21.           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)
  22.                   Display *_d_i_s_p_l_a_y;
  23.                   GC _g_c;
  24.                   int _d_a_s_h__o_f_f_s_e_t;
  25.                   char _d_a_s_h__l_i_s_t[];
  26.                   int _n;
  27.  
  28.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.           _c_a_p__s_t_y_l_e Specifies the line-style and cap-style you want to
  30.                     set for the specified GC.  You can pass
  31.                     _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.
  32.  
  33.           _d_a_s_h__l_i_s_t Specifies the dash-list for the dashed line-style
  34.                     you want to set for the specified GC.
  35.  
  36.           _d_a_s_h__o_f_f_s_e_t
  37.                     Specifies the phase of the pattern for the dashed
  38.                     line-style you want to set for the specified 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 for
  46.                     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.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  75.           The _X_S_e_t_L_i_n_e_A_t_t_r_i_b_u_t_e_s function sets the line drawing
  76.           components in the specified GC.
  77.  
  78.           _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
  79.           _B_a_d_V_a_l_u_e errors.
  80.  
  81.           The _X_S_e_t_D_a_s_h_e_s function sets the dash-offset and dash-list
  82.           attributes for dashed line styles in the specified GC.
  83.           There must be at least one element in the specified
  84.           dash_list, or a _B_a_d_V_a_l_u_e error results. The initial and
  85.           alternating elements (second, fourth, and so on) of the
  86.           dash_list are the even dashes, and the others are the odd
  87.           dashes.  Each element specifies a dash length in pixels.
  88.           All of the elements must be nonzero, or a _B_a_d_V_a_l_u_e error
  89.           results.  Specifying an odd-length list is equivalent to
  90.           specifying the same list concatenated with itself to produce
  91.           an even-length list.
  92.  
  93.           The dash-offset defines the phase of the pattern, specifying
  94.           how many pixels into the dash-list the pattern should
  95.           actually begin in any single graphics request.  Dashing is
  96.           continuous through path elements combined with a join-style
  97.           but is reset to the dash-offset between each sequence of
  98.           joined lines.
  99.  
  100.           The unit of measure for dashes is the same for the ordinary
  101.           coordinate system.  Ideally, a dash length is measured along
  102.           the slope of the line, but implementations are only required
  103.           to match this ideal for horizontal and vertical lines.
  104.           Failing the ideal semantics, it is suggested that the length
  105.           be measured along the major axis of the line.  The major
  106.           axis is defined as the x axis for lines drawn at an angle of
  107.           between -45 and +45 degrees or between 135 and 225 degrees
  108.           from the x axis.  For all other lines, the major axis is the
  109.           y axis.
  110.  
  111.           _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
  112.           errors.
  113.  
  114.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  115.           _B_a_d_A_l_l_o_c  The server failed to allocate the requested
  116.                     resource or server memory.
  117.  
  118.           _B_a_d_G_C     A value for a GContext argument does not name a
  119.                     defined GContext.
  120.  
  121.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  122.                     values accepted by the request.  Unless a specific
  123.                     range is specified for an argument, the full range
  124.                     defined by the argument's type is accepted.  Any
  125.                     argument defined as a set of alternatives can
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXSSSSeeeettttLLLLiiiinnnneeeeAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.                     generate this error.
  141.  
  142.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  143.           XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11),
  144.           XSetClipOrigin(3X11), XSetFillStyle(3X11), XSetFont(3X11),
  145.           XSetState(3X11), XSetTile(3X11)
  146.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.