Tk_GetPixmap(3) Tk (4.0) 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
Page 1 (printed 2/26/99)
