XCreateGC(3X11)         COMMAND REFERENCE         XCreateGC(3X11)



NAME
     XCreateGC, XCopyGC, XChangeGC, XFreeGC, XGContextFromGC -
     create or free graphics contexts

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

     XCopyGC(display, src, valuemask, dest)
           Display *display;
           GC src, dest;
           unsigned long valuemask;

     XChangeGC(display, gc, valuemask, values)
           Display *display;
           GC gc;
           unsigned long valuemask;
           XGCValues *values;

     XFreeGC(display, gc)
           Display *display;
           GC gc;

     GContext XGContextFromGC(gc)
           GC gc;

ARGUMENTS
     d         Specifies the drawable.

     dest      Specifies the destination GC.

     display   Specifies the connection to the X server.

     gc        Specifies the GC.

     src       Specifies the components of the source GC.

     valuemask Specifies which components in the GC are to be
               set, copied, or changed . This argument is the
               bitwise inclusive OR of one 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



X Version 11            1 September 1988                        1

XCreateGC(3X11)         COMMAND REFERENCE         XCreateGC(3X11)



     drawable.  Use with other drawables results in a BadMatch
     error.

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

     The XCopyGC function copies the specified components from
     the source GC to the destination GC.  The source and
     destination GCs must have the same root and depth, or a
     BadMatch error results.  The valuemask specifies which
     component to copy, as for XCreateGC.

     XCopyGC can generate BadAlloc, BadGC, and BadMatch errors.

     The XChangeGC function changes the components specified by
     valuemask for the specified GC.  The values argument
     contains the values to be set.  The values and restrictions
     are the same as for XCreateGC.  Changing the clip-mask
     overrides any previous XSetClipRectangles request on the
     context. Changing the dash-offset or dash-list overrides any
     previous XSetDashes request on the context.  The order in
     which components are verified and altered is server-
     dependent.  If an error is generated, a subset of the
     components may have been altered.

     XChangeGC can generate BadAlloc, BadFont, BadGC, BadMatch,
     BadPixmap, and BadValue errors.

     The XFreeGC function destroys the specified GC as well as
     all the associated storage.

     XFreeGC can generate a BadGC error.

DIAGNOSTICS
     BadAlloc  The server failed to allocate the requested
               resource or server memory.

     BadDrawable
               A value for a Drawable argument does not name a
               defined Window or Pixmap.

     BadFont   A value for a Font or GContext argument does not
               name a defined Font.

     BadGC     A value for a GContext argument does not name a
               defined 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.



X Version 11            1 September 1988                        2

XCreateGC(3X11)         COMMAND REFERENCE         XCreateGC(3X11)



     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
     XQueryBestSize(3x11), XSetArcMode(3x11),
     XSetClipOrigin(3x11), XSetFillStyle(3x11), XSetFont(3x11),
     XSetLineAttributes(3x11), XSetState(3x11), XSetTile(3x11)
     Xlib - C Language X Interface








































X Version 11            1 September 1988                        3

%%index%%
na:432,147;
sy:579,1716;
de:2295,2673;
di:4968,1874;
se:6842,442;
%%index%%000000000099