Tk_GetPixmap(3) | Tk Library Procedures | Tk_GetPixmap(3) |
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
4.0 | Tk |