Tk_GetPixmap - allocate and free pixmaps
#include <tk.h> Pixmap Tk_GetPixmap(display, d, width, height, depth) Tk_FreePixmap(display, pixmap)
Tk_GetPixmap(3tk) Tk Library Procedures Tk_GetPixmap(3tk)
______________________________________________________________________________
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 proce-
dures rather than XCreatePixmap and XFreePixmap; otherwise long-run-
ning applications may run out of resource identifiers.
Tk_GetPixmap creates a pixmap suitable for drawing in d, with dimen-
sions 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
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk 4.0 Tk_GetPixmap(3tk)