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