getpixmap(3Tk)

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