hpux man page for xsetforeground

XSetForeground()														  XSetForeground()

Name
  XSetForeground - set the foreground pixel value in a graphics context.

Synopsis
  XSetForeground(display, gc, foreground)
	Display *display;
	GC gc;
	unsigned long foreground;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  gc	    Specifies the graphics context.

  foreground
	    Specifies the foreground pixel value you want for the specified graphics context.

Description
  XSetForeground()  sets  the foreground component in a GC.  This pixel value is used for set bits in the source according to the fill_style.
  This pixel value must be returned by BlackPixel, WhitePixel(), or a routine that allocates colors.

  See Volume One, Chapter 5, The Graphics Context, for more information on the GC.

Errors
  BadAlloc
  BadGC

See Also
  XDefaultGC(), XChangeGC(), XCopyGC(), XCreateGC(), XFreeGC(), XGContextFromGC(), XSetArcMode(), XSetBackground(), XSetClipMask(),  XSetCli-
  pOrigin(),  XSetClipRectangles(),  XSetDashes(),  XSetFillRule(),  XSetFillStyle(),  XSetFunction(),	XSetGraphicsExposures(),  XSetLineAt-
  tributes(), XSetPlaneMask(), XSetState(), XSetStipple(), XSetSubwindowMode(), XSetTSOrigin().

Xlib - Graphics Context 													  XSetForeground()