XDrawLine(3X) — X Version 11

NAME

XDrawLine, XDrawLines, XDrawSegments − draw lines and polygons

SYNTAX

XDrawLine(display, d, gc, x1, y1, x2, y2)
      Display ∗display;
      Drawable d;
      GC gc;
      int x1, y1, x2, y2;

XDrawLines(display, d, gc, points, npoints, mode)
      Display ∗display;
      Drawable d;
      GC gc;
      XPoint ∗points;
      int npoints;
      int mode;

XDrawSegments(display, d, gc, segments, nsegments)
      Display ∗display;
      Drawable d;
      GC gc;
      XSegment ∗segments;
      int nsegments;

ARGUMENTS

dSpecifies the drawable.

displaySpecifies the connection to the X server.

gcSpecifies the graphics context.

modeSpecifies the coordinate mode. CoordModeOrigin treats a coordinates as related to the origin, while CoordModePrevious treats all coordinates after the first as relative to the previous point.

npointsSpecifies the number of points in the array.

nsegmentsSpecifies the number of segments in the array.

pointsSpecifies a pointer to an array of points.

segmentsSpecifies a pointer to an array of segments.

y2Specify the points used to connect the line. Thus, XDrawLine draws a line connecting point x1, y1 to point x2, y2.

DESCRIPTION

The XDrawLine funtion draws a single line between two points in the specified drawable.

The XDrawLines function draws multiple lines in the specified drawable.

The XDrawSegments function draws multiple, but not necessarily connected, lines in the specified drawable.

.PN XDrawLine , .PN XDrawLines , and .PN XDrawSegments can generate BadDrawable, BadGC, and BadMatch errors.

XDrawLines can also generate a BadValue error.

DIAGNOSTICS

BadDrawable
A value for a Drawable argument does not name a defined Window or Pixmap.

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

BadMatch An InputOnly window is used as a Drawable.

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.

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