SYNTAX

       int XSetLineAttributes(Display *display, GC gc, unsigned int
              line_width, int line_style, int cap_style, int join_style);

       int XSetDashes(Display *display, GC gc, int dash_offset, char
              dash_list[], int n);

ARGUMENTS

       cap_style Specifies the line-style and cap-style you want to set for
                 the specified GC.  You can pass CapNotLast, CapButt,
                 CapRound, or CapProjecting.

       dash_list Specifies the dash-list for the dashed line-style you want to
                 set for the specified GC.

       dash_offset
                 Specifies the phase of the pattern for the dashed line-style
                 you want to set for the specified GC.

       display   Specifies the connection to the X server.

       gc        Specifies the GC.

       join_style
                 Specifies the line join-style you want to set for the speci-
                 fied GC.  You can pass JoinMiter, JoinRound, or JoinBevel.

       line_style
                 Specifies the line-style you want to set for the specified
                 GC.  You can pass LineSolid, LineOnOffDash, or LineDou-
                 bleDash.

       line_width
                 Specifies the line-width you want to set for the specified
                 GC.

       n         Specifies the number of elements in dash_list.

DESCRIPTION

       The XSetLineAttributes function sets the line drawing components in the
       specified GC.

       XSetLineAttributes can generate BadAlloc, BadGC, and BadValue errors.

       The XSetDashes 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 BadValue 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 BadValue error results.  Specifying an odd-length list is
       equivalent to specifying the same list concatenated with itself to pro-
       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.

       XSetDashes can generate BadAlloc, BadGC, and BadValue errors.

DIAGNOSTICS

       BadAlloc  The server failed to allocate the requested resource or
                 server memory.

       BadGC     A value for a GContext argument does not name a defined GCon-
                 text.

       BadValue  Some numeric value falls outside the range of values accepted
                 by the request.  Unless a specific range is specified for an
                 argument, 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), XSetClipOri-
       gin(3X11), XSetFillStyle(3X11), XSetFont(3X11), XSetState(3X11), XSet-
       Tile(3X11)
       Xlib - C Language X Interface



X Version 11                      Release 6.6         XSetLineAttributes(3X11)