hpux man page for xdrawsegments

XDrawSegments() 														   XDrawSegments()

Name
  XDrawSegments - draw multiple disjoint lines.

Synopsis
  XDrawSegments(display, drawable, gc, segments, nsegments)
	Display *display;
	Drawable drawable;
	GC gc;
	XSegment *segments;
	int nsegments;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  drawable  Specifies the drawable.

  gc	    Specifies the graphics context.

  segments  Specifies a pointer to an array of line segments.

  nsegments Specifies the number of segments in the array.

Description
  XDrawSegments()  draws  multiple line segments into the specified drawable.  Each line is specified by a pair of points, so the line may be
  connected or disjoint.

  For each segment, XDrawSegments() draws a line between (x1, y1) and (x2, y2).  The lines are drawn in the order listed  in  segments.   For
  any  given line, no pixel is drawn more than once.  If lines intersect, pixels will be drawn multiple times.	The lines will be drawn sepa-
  rately, without regard to the join_style.

  In R4 and earlier there is a limit to the number of rectangles that can be drawn in a single XDrawSegments() call,  based  on  the  maximum
  request  size, which varies according to the server.	In R5, Xlib chops your call into as many protocol requests as required.  To determine
  how many rectangles you can draw in a single call in R4, find out your server's maximum request  size  using	XMaxRequestSize().   Subtract
  three and divide by two.  This is the maximum number of segments you can draw in a single XDrawSegments() call.

  XDrawSegments()  uses  these	graphics  context  components:	 function, plane_mask, line_width, line_style, cap_style, fill_style, subwin-
  dow_mode, clip_ x_origin, clip_y_origin, and clip_mask.  XDrawSegments() also uses these graphics context mode-dependent components:	fore-
  ground, background, tile, stipple, ts_x_origin, ts_y_origin, dash_offset, and dashes.

  For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, The Graphics Context.

Structures
     typedef struct {
	 short x1, y1, x2, y2;
     } XSegment;

Errors
  BadDrawable
	    Specified drawable is invalid.

  BadGC     Specified GC is invalid, or does not match the depth of drawable.

  BadMatch  Specified drawable is an InputOnly window.

See Also
  XClearArea(),  XClearWindow(),  XCopyArea(), XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLine(), XDrawLines(), XDraw-
  Point(), XDrawPoints(), XDrawRectangle(), XDrawRectangles(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectangles().

Xlib - Drawing Primitives													   XDrawSegments()