Tk_GetPixmap(3tk)

Tk_GetPixmap(3)       Tk Library Procedures       Tk_GetPixmap(3)

_________________________________________________________________

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

Tk                      Last change: 4.0                        1