TkGetPixmap(3) Tk Library Procedures TkGetPixmap(3)

NAME
       TkGetPixmap, TkFreePixmap - allocate and free pixmaps

SYNOPSIS
       ##iinncclluuddee <>

       Pixmap
       TTkkGGeettPPiixxmmaapp((display, d, width, height, depth))

       TTkkFFrreeeePPiixxmmaapp((display, pixmap))

AARRGGUUMMEENNTTSS
       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 XXCCrreeaatteePPiixxmmaapp and
       XXFFrreeeePPiixxmmaapp,  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 XXCCrreeaatteePPiixxmmaapp and XXFFrreeeePPiixxmmaapp;   otherwise  long-run-
       ning applications may run out of resource identifiers.

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


KKEEYYWWOORRDDSS
       pixmap, resource identifier



Tk                                    4.0                      TkGetPixmap(3)