DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Tk_GetPixmap(3)




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


Man(1) output converted with man2html