tk_freexid(3tk) [opensolaris man page]

Tk_FreeXId(3TK) 					       Tk Library Procedures						   Tk_FreeXId(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_FreeXId - make X resource identifier available for reuse

SYNOPSIS

       #include <tk.h>

       Tk_FreeXId(display, id)

ARGUMENTS

       Display	 *display   (in)      Display for which id was allocated.

       XID	 id	    (in)      Identifier  of X resource (window, font, pixmap, cursor, graphics context, or colormap) that is no longer in
				      use.
_________________________________________________________________

DESCRIPTION

       The default allocator for resource identifiers provided by Xlib is very simple-minded and does not allow resource  identifiers  to  be  re-
       used.  If a long-running application reaches the end of the resource id space, it will generate an X protocol error and crash.  Tk replaces
       the default id allocator with its own allocator, which allows identifiers to be reused.	In order for this  to  work,  Tk_FreeXId  must	be
       called  to  tell the allocator about resources that have been freed.  Tk automatically calls Tk_FreeXId whenever it frees a resource, so if
       you use procedures like Tk_GetFont, Tk_GetGC, and Tk_GetPixmap then you need not call  Tk_FreeXId.   However,  if  you  allocate  resources
       directly  from Xlib, for example by calling XCreatePixmap, then you should call Tk_FreeXId when you call the corresponding Xlib free proce-
       dure, such as XFreePixmap.  If you don't call Tk_FreeXId then the resource identifier will be lost,  which  could  cause  problems  if  the
       application runs long enough to lose all of the available identifiers.

KEYWORDS

       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_FreeXId(3TK)

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

tk_freexid(3tk) [opensolaris man page]

Check Out this Related Man Page