tcldoc Tcl/Tk 9.0.4
/

Home › Tk Library Procedures Tk

Tk_GetPixmap C API

Allocate and free pixmaps

Also documents Tk_FreePixmap

literal type exactly as shown argument replace with your value ?optional? may be omitted

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

Copyright#