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
displaySpecifies a connection to an X server; returned from XOpenDisplay().
drawableSpecifies the drawable.
gcSpecifies the graphics context.
x1
y1
x2
y2Specify the coordinates of the endpoints of the line relative to the drawable origin. XDrawLine() connects point (x1,y1) to point (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, 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.
Errors
BadDrawable
Specified drawable is invalid.
BadGCSpecified GC is invalid, or does not match the depth of drawable.
BadMatchSpecified drawable is an InputOnly window.
See Also
XClearArea(), XClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLines(), XDrawPoint(), XDrawPoints(), XDrawRectangle(), XDrawRectangles(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectangles().
Copyright O’Reilly & Assoc. —