opensolaris man page for tk_getpixmap

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-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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk									4.0							 Tk_GetPixmap(3TK)