XSetLineAttribute(3X) — X Version 11

NAME

XSetLineAttribute, XSetDashes − GC convience routines

SYNTAX

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

cap_styleSpecifies the line and cap style you want to set for the specified graphics context. Possible values are CapNotLast, CapButt, CapRound, or CapProjecting.

dash_listSpecifies the dash list for the dashed line style you want to set for the specified graphics context.

dash_offsetSpecifies the phase of the pattern for the dashed line style you want to set for the specified graphics context.

displaySpecifies the connection to the X server.

gcSpecifies the graphics context.

join_styleSpecifies the line-join style you want to set for the specified graphics context. Possible values are JoinMiter, JoinRound, or JoinBevel.

line_styleSpecifies the line style you want to set for the specified graphics context. Possible values are LineSolid (solid), LineOnOffDash (on-off dash), or LineDoubleDash (double dash).

line_widthSpecifies the line width you want to set for the specified graphics context.

nSpecifies the number of elements in the dash list argument.

DESCRIPTION

The XSetLineAttributes function sets the line drawing components in the specified graphics context. .PN XSetLineAttributes can generate BadGC and BadValue errors.

The XSetDashes function sets the dash_offset and dash_list for dashed line styles in the specified graphics context. .PN 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 GContext.

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.

Museum