Tk_GetPixmap man page
Tk_GetPixmap, Tk_FreePixmap — allocate and free pixmaps
#include <tk.h> Pixmap Tk_GetPixmap(display, d, width, height, depth) Tk_FreePixmap(display, pixmap)
- 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.
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.
pixmap, resource identifier
The man page Tk_FreePixmap(3) is an alias of Tk_GetPixmap(3).