Documentation generated from fossil trunk
Tk_GetPixmap, Tk_FreePixmap -
allocate and free pixmaps
#include <tk.h> Pixmap Tk_GetPixmap(display, d, width, height, depth) Tk_FreePixmap(display, pixmap)
| Type | Name | Mode |
|---|---|---|
| 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.