Tk_GetPixmap(3Tk)					     Tk_GetPixmap(3Tk)

NAME    [Toc]    [Back]

     Tk_GetPixmap, Tk_FreePixmap - allocate and	free pixmaps

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     Pixmap
     Tk_GetPixmap(display, d, width, height, depth)

     Tk_FreePixmap(display, pixmap)

ARGUMENTS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     pixmap, resource identifier


									PPPPaaaaggggeeee 1111