


XSetLineAttributes(3X11)			     XSetLineAttributes(3X11)
X11R5									X11R5



NAME
  XSetLineAttributes, XSetDashes - GC convenience routines

SYNTAX
  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, _c_a_p__s_t_y_l_e,
  _j_o_i_n__s_t_y_l_e)
	Display	*_d_i_s_p_l_a_y;
	GC _g_c;
	unsigned int _l_i_n_e__w_i_d_t_h;
	int _l_i_n_e__s_t_y_l_e;
	int _c_a_p__s_t_y_l_e;
	int _j_o_i_n__s_t_y_l_e;

  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)
	  Display *_d_i_s_p_l_a_y;
	  GC _g_c;
	  int _d_a_s_h__o_f_f_s_e_t;
	  char _d_a_s_h__l_i_s_t[];
	  int _n;

ARGUMENTS

  _c_a_p__s_t_y_l_e Specifies the line-style and cap-style you want to set for the
	    specified GC.  You can pass	_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.

  _d_a_s_h__l_i_s_t Specifies the dash-list for	the dashed line-style you want to set
	    for	the specified GC.

  _d_a_s_h__o_f_f_s_e_t
	    Specifies the phase	of the pattern for the dashed line-style you
	    want to set	for the	specified GC.

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

  _g_c	    Specifies the GC.

  _j_o_i_n__s_t_y_l_e
	    Specifies the line join-style you want to set for the specified
	    GC.	 You can pass _J_o_i_n_M_i_t_e_r, _J_o_i_n_R_o_u_n_d, or _J_o_i_n_B_e_v_e_l.

  _l_i_n_e__s_t_y_l_e
	    Specifies the line-style you want to set for the specified GC.
	    You	can pass _L_i_n_e_S_o_l_i_d, _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.

  _l_i_n_e__w_i_d_t_h
	    Specifies the line-width you want to set for the specified GC.

  _n	    Specifies the number of elements in	dash_list.



DESCRIPTION
  The _X_S_e_t_L_i_n_e_A_t_t_r_i_b_u_t_e_s function sets the line	drawing	components in the
  specified GC.

  _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_V_a_l_u_e	errors.

  The _X_S_e_t_D_a_s_h_e_s function sets the dash-offset and dash-list attributes	for
  dashed line styles in	the specified GC.  There must be at least one element
  in the specified dash_list, or a _B_a_d_V_a_l_u_e error results. The initial and
  alternating elements (second,	fourth,	and so on) of the dash_list are	the
  even dashes, and the others are the odd dashes.  Each	element	specifies a
  dash length in pixels.  All of the elements must be nonzero, or a _B_a_d_V_a_l_u_e
  error	results.  Specifying an	odd-length list	is equivalent to specifying
  the same list	concatenated with itself to produce an even-length list.

  The dash-offset defines the phase of the pattern, specifying how many	pix-
  els into the dash-list the pattern should actually begin in any single
  graphics request.  Dashing is	continuous through path	elements combined
  with a join-style but	is reset to the	dash-offset between each sequence of
  joined lines.

  The unit of measure for dashes is the	same for the ordinary coordinate sys-
  tem.	Ideally, a dash	length is measured along the slope of the line,	but
  implementations are only required to match this ideal	for horizontal and
  vertical lines.  Failing the ideal semantics,	it is suggested	that the
  length be measured along the major axis of the line.	The major axis is
  defined as the x axis	for lines drawn	at an angle of between -45 and +45
  degrees or between 135 and 225 degrees from the x axis.  For all other
  lines, the major axis	is the y axis.

  _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	errors.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

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

  _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
  XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11),
  XSetClipOrigin(3X11),	XSetFillStyle(3X11), XSetFont(3X11), XSetState(3X11),
  XSetTile(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off






















