Tk_GetPixmap


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