## Tcl9.0.3/Tk9.0.3 Documentation > Tk C API > GetPixmap

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  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)
    Drawable d (入力in)
    int width (入力in)
    int height (入力in)
    int depth (入力in)
    Pixmap pixmap (入力in)
  説明 DESCRIPTION
  KEYWORDS

### 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 表示 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

これ等の手続函数は Xlib 手続函数 XCreatePixmap と XFreePixmap とほぼ同じであるが､それは X 源資識別子を管理する追加の符号命令を有するので､将来削除された画素地図の為の識別子が利用できる｡それは Tk 応用譜の為に XCreatePixmap や XFreePixmap よりもこれ等の手続函数を使う為に重要である; そうでない場合､長期間応用譜は原資の識別子の外で実行される｡ 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 は width と height と depth によって与えられた寸法を使い d 内での描写に適した画素地図を作成しその識別子を返す｡ Tk_FreePixmap は pixmap によって与えられる画素地図を破壊し､再使用に利用できる原資の識別子を作成する｡ 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 © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.