NAME

       Tk_GetPixmap, Tk_FreePixmap - allocate and free pixmaps

SYNOPSIS

       #include <tk.h>

       Pixmap
       Tk_GetPixmap(display, d, width, height, depth)

       Tk_FreePixmap(display, pixmap)

ARGUMENTS

       Display *display (in)            X display for the pixmap.

       Drawable d (in)                  Pixmap  or  window  where the new pixmap will be used for
                                        drawing.

       int width (in)                   Width of pixmap.

       int height (in)                  Height of pixmap.

       int depth (in)                   Number of bits per pixel in pixmap.

       Pixmap pixmap (in)               Pixmap to destroy.
_________________________________________________________________________________________________

DESCRIPTION

       These procedures are identical to  the  Xlib  procedures  XCreatePixmap  and  XFreePixmap,
       except  that they have extra code to manage X resource identifiers so that identifiers for
       deleted pixmaps can be reused in the future.  It is important for Tk applications  to  use
       these  procedures  rather  than  XCreatePixmap  and  XFreePixmap;   otherwise long-running
       applications may run out of resource identifiers.

       Tk_GetPixmap creates a pixmap suitable for drawing in d, with dimensions given  by  width,
       height, and depth, and returns its identifier.  Tk_FreePixmap destroys the pixmap given by
       pixmap and makes its resource identifier available for reuse.

KEYWORDS

       pixmap, resource identifier