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 identi
fiers.
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 avail
able for reuse.
KEYWORDS
- pixmap, resource identifier