xdrawline(3) [hpux man page]
XDrawLine() XDrawLine() Name XDrawLine - draw a line between two points. Synopsis XDrawLine(display, drawable, gc, x1, y1, x2, y2) Display *display; Drawable drawable; GC gc; int x1, y1, x2, y2; Arguments display Specifies a connection to an X server; returned from XOpenDisplay(). drawable Specifies the drawable. gc Specifies the graphics context. x1, y1, Specify the coordinates of the endpoints of the line relative to the drawable origin. XDrawLine() connects point (x1,y1) to point (x2,y2). x2, y2 Description XDrawLine() uses the components of the specified graphics context to draw a line between two points in the specified drawable. No pixel is drawn more than once. XDrawLine() uses these graphics context components: function, plane_mask, line_width, line_style, cap_style, fill_style, subwindow_mode, clip_ x_origin, clip_y_origin, and clip_mask. XDrawLine() also uses these graphics context mode-dependent components: foreground, back- ground, 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. 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(), XDrawLines(), XDrawPoint(), XDraw- Points(), XDrawRectangle(), XDrawRectangles(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan- gles(). Xlib - Drawing Primitives XDrawLine()
Check Out this Related Man Page
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()