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