Tk\_GetPixmap(3) Tk Library Procedures Tk\_GetPixmap(3)

```

```

# [NAME](#NAME)

Tk\_GetPixmap, Tk\_FreePixmap - allocate and free pixmaps

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

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

Tk_FreePixmap(display, pixmap)
```

# [ARGUMENTS](#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](#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](#KEYWORDS)

pixmap, resource identifier

4.0 Tk

---

Document: Tk_FreePixmap(3) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz