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

### 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_GetColormap, Tk_PreserveColormap, Tk_FreeColormap — 色地図の割当てと開放　 allocate and free colormaps
  SYNOPSIS
    #include <tk.h>
    Colormap
    Tk_GetColormap(interp, tkwin, string)
    Tk_PreserveColormap(display, colormap)
    Tk_FreeColormap(display, colormap)
  引数 ARGUMENTS
    Tcl_Interp *interp (入力in)
    Tk_Window tkwin (入力in)
    const char *string (入力in)
    Display *display (入力in)
    Colormap colormap (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_GetColormap, Tk_PreserveColormap, Tk_FreeColormap — 色地図の割当てと開放　 allocate and free colormaps

### SYNOPSIS

#include <tk.h>
Colormap
Tk_GetColormap(interp, tkwin, string)
Tk_PreserveColormap(display, colormap)
Tk_FreeColormap(display, colormap)

### 引数 ARGUMENTS

Tcl_Interp *interp (入力in)
  不都合の報告に使う為の解釈実行機能｡　 Interpreter to use for error reporting.

Tk_Window tkwin (入力in)
  色地図が使われる窓の字句｡ Token for window in which colormap will be used.

const char *string (入力in)
  色地図を選択する: 新しい又は tkwin として同じ画面と可視を伴う窓の名前のどちらか｡　 Selects a colormap: either new or the name of a window with the same screen and visual as tkwin.

Display *display (入力in)
  其処に色地図が割当てられる表示器｡　 Display for which colormap was allocated.

Colormap colormap (入力in)
  開放すべき又は保存すべき色地図; 以前の Tk_GetColormap か Tk_GetVisual への呼出しによって予め返されていなければならない｡　 Colormap to free or preserve; must have been returned by a previous call to Tk_GetColormap or Tk_GetVisual.

### 説明 DESCRIPTION

これ等の手続函数は色地図の管理に使われる｡ Tk_GetColormap は tkwin 内に使う為に適した色地図を返す｡もしその string 引数が new であると､新しい色地図が作られる; それ以外では string は同じ画面の他の窓の名前でなければならない､又 tkwin としての外観と窓の色地図が返される｡もし string が意味を成さない場合､もしそれが tkwin からの異なる画面上の窓を参照しているか､ tkwin 以外の異なる外観を伴うかであると Tk_GetColormap は何も返さず､解釈実行機能の結果に不都合伝言文を残す｡ These procedures are used to manage colormaps. Tk_GetColormap returns a colormap suitable for use in tkwin. If its string argument is new then a new colormap is created; otherwise string must be the name of another window with the same screen and visual as tkwin, and the colormap from that window is returned. If string does not make sense, or if it refers to a window on a different screen from tkwin or with a different visual than tkwin, then Tk_GetColormap returns None and leaves an error message in interp's result.

Tk_PreserveColormap は､幾つかの位置に保存されるべき色地図をどの順で解放されるかを知ることなしに許容している Tk_GetColormap によって予め返された色地図への内部参照計数を増加する｡ Tk_PreserveColormap increases the internal reference count for a colormap previously returned by Tk_GetColormap, which allows the colormap to be stored in several locations without knowing which order they will be released.

Tk_FreeColormap は､ Tk_GetColormap によって返された色地図が最早必要なくなった時に呼出される｡ Tk は Tk_GetColormap によって返された色地図への参照計数を維持しているので､夫々の Tk_GetColormap への呼び出しと夫々の Tk_PreserveColormap への呼び出し毎に１回の Tk_FreeColormap 呼出があるべきである｡色地図への参照計数が零になった時 Tk は X 色地図を解放する｡ Tk_FreeColormap should be called when a colormap returned by Tk_GetColormap is no longer needed. Tk maintains a reference count for each colormap returned by Tk_GetColormap, so there should eventually be one call to Tk_FreeColormap for each call to Tk_GetColormap and each call to Tk_PreserveColormap. When a colormap's reference count becomes zero, Tk releases the X colormap.

Tk_GetVisual and Tk_GetColormap は一緒に働く､そこでは Tk_GetVisual によって作成された色地図は後に Tk_GetColormap よって返されるかもしれない｡色地図への参照計数の仕組みは両方の手続函数を含むので､ Tk_GetVisual への呼出し側は色地図の解放の為に Tk_FreeColormap を呼ばなくてはならない｡もし Tk_GetColormap が new の string 値と共に呼ばれた場合､結果の色地図は Tk_GetVisual によって返されることはない､但し､ string として元の窓の名前と共に Tk_GetColormap により他の窓を呼ぶことには使うことができる｡ Tk_GetVisual and Tk_GetColormap work together, in that a new colormap created by Tk_GetVisual may later be returned by Tk_GetColormap. The reference counting mechanism for colormaps includes both procedures, so callers of Tk_GetVisual must also call Tk_FreeColormap to release the colormap. If Tk_GetColormap is called with a string value of new then the resulting colormap will never be returned by Tk_GetVisual; however, it can be used in other windows by calling Tk_GetColormap with the original window's name as string.

### KEYWORDS

666colormap, visual
Copyright © 1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.