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()