XCreateGC

Syntax

GC XCreateGC(display, d, valuemask, values)
      Display *display;
      Drawable d;
      unsigned long valuemask;
      XGCValues *values;

Arguments

display Specifies the connection to the X server.
d Specifies the drawable.
valuemask Specifies which components in the GC are to be set using the information in the specified values structure. This argument is the bitwise inclusive OR of zero or more of the valid GC component mask bits.
values Specifies any values as specified by the valuemask.

Description

The XCreateGC() function creates a graphics context and returns a GC. The GC can be used with any destination drawable having the same root and depth as the specified drawable. Use with other drawables results in a BadMatch error.

XCreateGC() can generate BadAlloc, BadDrawable, BadFont, BadMatch, BadPixmap, and BadValue errors.

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadDrawable A value for a Drawable argument does not name a defined Window or Pixmap.
BadFont A value for a font argument does not name a defined font (or, in some cases, GContext).
BadMatch An InputOnly window is used as a Drawable.
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.
BadPixmap A value for a Pixmap argument does not name a defined Pixmap.
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

See also

AllPlanes(), XChangeGC(), XCopyArea(), XCopyGC(), XCreateRegion(), XDrawArc(), XDrawLine(), XDrawRectangle(), XDrawText(), XFillRectangle(), XFreeGC(), XGContextFromGC(), XGetGCValues(), XQueryBestSize(), XSetArcMode(), XSetClipOrigin(), "Manipulating Graphics Context/State".
Christophe Tronche, ch@tronche.com