XSetTile(XS)      X Version 11 (Release 5) 6 January 1993       XSetTile(XS)


 Name

    XSetTile - GC convenience routines

 Syntax


    XSetTile(display, gc, tile)
          Display *display;
          GC gc;
          Pixmap tile;

    XSetStipple(display, gc, stipple)
          Display *display;
          GC gc;
          Pixmap stipple;

    XSetTSOrigin(display, gc, ts_x_origin, ts_y_origin)
          Display *display;
          GC gc;
          int ts_x_origin, ts_y_origin;


 Arguments


    display        Specifies the connection to the X server.

    gc             Specifies the GC.

    stipple        Specifies the stipple you want to set for the specified
                   GC.

    tile           Specifies the fill tile you want to set for the specified
                   GC.

    tsxorigin
    tsyorigin    Specify the x and y coordinates of the tile and stipple
                   origin.

 Description

    The XSetTile function sets the fill tile in the specified GC.  The tile
    and GC must have the same depth, or a ``BadMatch'' error results.

    XSetTile can generate ``BadAlloc'', ``BadGC'', ``BadMatch'', and ``Bad-
    Pixmap'' errors.

    The XSetStipple function sets the stipple in the specified GC.  The stip-
    ple must have a depth of one, or a ``BadMatch'' error results.

    XSetStipple can generate ``BadAlloc'', ``BadGC'', ``BadMatch'', and
    ``BadPixmap'' errors.

    The XSetTSOrigin function sets the tile/stipple origin in the specified
    GC.  When graphics requests call for tiling or stippling, the parent's
    origin will be interpreted relative to whatever destination drawable is
    specified in the graphics request.

    XSetTSOrigin can generate ``BadAlloc'' and ``BadGC'' errors.

 Diagnostics


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

    ``BadGC''      A value for a GContext argument does not name a defined
                   GContext.

    ``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 Pix-
                   map.

 See also

    XCreateGC(XS), XQueryBestSize(XS), XSetArcMode(XS), XSetClipOrigin(XS),
    XSetFillStyle(XS), XSetFont(XS), XSetLineAttributes(XS), XSetState(XS)
    Xlib - C Language X Interface