XDrawString() XDrawString()
Name
XDrawString - draw an 8-bit text string, foreground only.
Synopsis
XDrawString(display, drawable, gc, x, y, string, length)
Display *display;
Drawable drawable;
GC gc;
int x, y;
char *string;
int length;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
drawable Specifies the drawable.
gc Specifies the graphics context.
x Specify the x and y coordinates of the baseline starting position for the character, relative to the origin of the specified
y drawable.
string Specifies the character string.
length Specifies the number of characters in string.
Description
XDrawString() draws the given string into a drawable using the foreground only to draw set bits in the font. It does not affect any other
pixels in the bounding box for each character.
The y coordinate defines the baseline row of pixels while the x coordinate is the point from which lbearing, rbearing, and width are mea-
sured.
XDrawString() uses these graphics context components: function, plane_mask, fill_style, font, subwindow_mode, clip_x_origin, clip_y_ori-
gin, and clip_mask. This function also uses these graphics context mode-dependent components: foreground, background, tile, stipple,
ts_x_origin, and ts_y_origin. Each character image, as defined by the font in gc, is treated as an additional mask for a fill operation on
the drawable.
For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, The Graphics Context.
Errors
BadDrawable
BadGC
BadMatch
See Also
XDrawImageString(), XDrawImageString16(), XDrawString16(), XDrawText(), XDrawText16(), XQueryTextExtents(), XQueryTextExtents16(), XTextEx-
tents(), XTextExtents16(), XTextWidth(), XTextWidth16().
Xlib - Text XDrawString()
