This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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 XCre-atePixmap XCreatePixmap
       atePixmap 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                                                   4.0                                     Tk_GetPixmap(3)