FreeBSD Manual Pages
Tk_FreeXId(3) Tk Library Procedures Tk_FreeXId(3) ________________________________________________________________________________ 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 col- ormap) 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 alloca- tor with its own allocator, which allows identifiers to be reused. In or- der 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 allo- cate resources directly from Xlib, for example by calling XCreatePixmap, then you should call Tk_FreeXId when you call the corresponding Xlib free procedure, such as XFreePixmap. If you do not call Tk_FreeXId then the re- source identifier will be lost, which could cause problems if the applica- tion runs long enough to lose all of the available identifiers. KEYWORDS resource identifier Tk 4.0 Tk_FreeXId(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_FreeXId.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>