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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

drawableSpecifies the drawable. 

gcSpecifies the graphics context. 

x

ySpecify the x and y coordinates of the baseline starting position for the character, relative to the origin of the specified drawable. 

stringSpecifies the character string. 

lengthSpecifies 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 measured.  XDrawString() uses these graphics context components:  function, plane_mask, fill_style, font, subwindow_mode, clip_x_origin, clip_y_origin, 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(), XTextExtents(), XTextExtents16(), XTextWidth(), XTextWidth16(). 

Copyright O’Reilly & Assoc.  —