Tk_GetPixmap(3) Tk Library Procedures Tk_GetPixmap(3)
____________________________________________________________________________
Tk_GetPixmap, Tk_FreePixmap - allocate and free pixmaps
#include <tk.h>
Pixmap
Tk_GetPixmap(display, d, width, height, depth)
Tk_FreePixmap(display, pixmap)
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.
pixmap, resource identifier
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
Tk 4.0 Tk_GetPixmap(3)