Scroll to navigation

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


pixmap, resource identifier







  

    4.0
    Tk