dwww Home | Manual pages | Find package

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 proce-
       dures rather than XCreatePixmap and XFreePixmap;   otherwise  long-run-
       ning applications may run out of resource identifiers.

       Tk_GetPixmap  creates  a  pixmap suitable for drawing in d, with dimen-
       sions given by width, height, and depth, and  returns  its  identifier.
       Tk_FreePixmap  destroys  the  pixmap  given by pixmap and makes its re-
       source identifier available for reuse.

KEYWORDS
       pixmap, resource identifier

Tk                                    4.0                    Tk_GetPixmap(3tk)

Generated by dwww version 1.14 on Fri Jan 24 09:40:41 CET 2025.