*** UNIX MANUAL PAGE BROWSER ***

XSetLineAttributes(3X11) XSetLineAttributes(3X11) NAME XSetLineAttributes, XSetDashes - GC convenience routines SYNOPSIS XSetLineAttributes(display, gc, line_width, line_style, cap_style, join_style) Display *display; GC gc; unsigned int line_width; int line_style; int cap_style; int join_style; XSetDashes(display, gc, dash_offset, dash_list, n) Display *display; GC gc; int dash_offset; char dash_list[]; int n; ARGUMENTS Specifies the line-style and cap-style you want to set for the speci- fied GC. You can pass CapNotLast, CapButt, CapRound, or CapProjecting. Specifies the dash-list for the dashed line-style you want to set for the specified GC. Specifies the phase of the pattern for the dashed line-style you want to set for the specified GC. Specifies the connec- tion to the X server. Specifies the GC. Specifies the line join-style you want to set for the specified GC. You can pass JoinMiter, Join- Round, or JoinBevel. Specifies the line-style you want to set for the specified GC. You can pass LineSolid, LineOnOffDash, or LineDoubleDash. Specifies the line-width you want to set for the specified GC. Speci- fies 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- duce an even-length list. The dash-offset defines the phase of the pattern, specifying how many pixels into the dash-list the pattern should actually begin in any sin- gle graphics request. Dashing is continuous through path elements com- bined 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 system. Ideally, a dash length is measured along the slope of the line, but implementations are only required to match this ideal for horizon- tal 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. XSetDashes can generate BadAlloc, BadGC, and BadValue errors. DIAGNOSTICS The server failed to allocate the requested resource or server memory. A value for a GContext argument does not name a defined GContext. Some numeric value falls outside the range of values accepted by the re- quest. 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 XSetLineAttributes(3X11)