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

### 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_GetVisual — 文字列から可視への翻訳　 translate from string to visual
  SYNOPSIS
    #include <tk.h>
    Visual *
    Tk_GetVisual(interp, tkwin, string, depthPtr, colormapPtr)
  引数 ARGUMENTS
    Tcl_Interp *interp (入力in)
    Tk_Window tkwin (入力in)
    const char *string (入力in)
    int *depthPtr (出力out)
    Colormap *colormapPtr (出力out)
  説明 DESCRIPTION
    class depth
    default
    pathName
    number
    best ?depth?
  著作権表示 CREDITS
  KEYWORDS

### NAME

Tk_GetVisual — 文字列から可視への翻訳　 translate from string to visual

### SYNOPSIS

#include <tk.h>
Visual *
Tk_GetVisual(interp, tkwin, string, depthPtr, colormapPtr)

### 引数 ARGUMENTS

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

Tk_Window tkwin (入力in)
  可視が使用される窓の為の字句｡　 Token for window in which the visual will be used.

const char *string (入力in)
  望ましい可視を識別する文字列｡適正な形式については下を見られたい｡ String that identifies the desired visual. See below for valid formats.

int *depthPtr (出力out)
  返された可視の深さは此処に保存させられる｡　 Depth of returned visual gets stored here.

Colormap *colormapPtr (出力out)
  もし非ヌルであれば､適正な可視に関する色地図が見出され､その識別子はここに保存される｡　 If non-NULL then a suitable colormap for visual is found and its identifier is stored here.

### 説明 DESCRIPTION

Tk_GetVisual は視覚の記述文字列を取り､もしあれば､ tkwin 内の利用の為に適切な X 視覚を見付ける｡それは可視の為の X 視覚構造へのポインターを返し､ *depthPtr の箇所での画素単位のビット数を保存する｡もし､ string が認識できないか､もし適切な可視が見付らない場合､ NULL が返され､ Tk_GetVisual は不都合伝言文を解釈実行機能の結果に残す｡もし colormap が非-NULL の場合､ Tk_GetVisual は又､結果の可視と共に使う為に適切な画素地図を据え､その *colormapPtr の箇所での X 識別子を保存する｡ Tk_GetVisual takes a string description of a visual and finds a suitable X Visual for use in tkwin, if there is one. It returns a pointer to the X Visual structure for the visual and stores the number of bits per pixel for it at *depthPtr. If string is unrecognizable or if no suitable visual could be found, then NULL is returned and Tk_GetVisual leaves an error message in interpreter interp's result. If colormap is non-NULL then Tk_GetVisual also locates an appropriate colormap for use with the result visual and stores its X identifier at *colormapPtr.

string 引数は次の内の一つの方法で望ましい視覚を指定する: The string argument specifies the desired visual in one of the following ways:

class depth
  どの様な量(なしでも良い)かの空白をその間に伴って､整数の深さが後に続く級によって構成された文字列｡ class はどの様な視覚が望ましいかを選択し､ directcolor, grayscale, greyscale, pseudocolor, staticcolor, staticgray, staticgrey, or truecolor の内の一つか､紛れない短縮表示かでなければならない｡ depth は視覚について画素あたり幾つのビットが必要であるかを指定する｡可能であれば､ Tk_GetVisual はこの深さを伴った視覚を返す; 望ましい深さの視覚がない場合､ Tk_GetVisual は初めにより深い視覚を捜し､次により浅い深さのものを捜す｡ The string consists of a class name followed by an integer depth, with any amount of white space (including none) in between. class selects what sort of visual is desired and must be one of directcolor, grayscale, greyscale, pseudocolor, staticcolor, staticgray, staticgrey, or truecolor, or a unique abbreviation. depth specifies how many bits per pixel are needed for the visual. If possible, Tk_GetVisual will return a visual with this depth; if there is no visual of the desired depth then Tk_GetVisual looks first for a visual with greater depth, then one with less depth.

default
  tkwin's の画面の為の無為設定視覚を使う｡ Use the default visual for tkwin's screen.

pathName
  pathName によって与えられた窓の為の視覚を使う｡ pathName は tkwin として同じ画面上の窓の名前でなければならない｡ Use the visual for the window given by pathName. pathName must be the name of a window on the same screen as tkwin.

number
  その X 識別子が number である視覚を使う｡ Use the visual whose X identifier is number.

best ?depth?
  次の規則を使って “最良の可能性” の視覚を選択する､優先順位の下がる順に: Choose the “best possible” visual, using the following rules, in decreasing order of priority:

  1. 厳密に希望の深さを有する視覚が最善､次に要求より大きい深さ(但し､超過は可能な限り少なく)､次に要求より深さが少ないもの(しかしできるだけ深い); a visual that has exactly the desired depth is best, followed by a visual with greater depth than requested (but as little extra as possible), followed by a visual with less depth than requested (but as great a depth as possible);

  2. 深さが指定されていない場合､利用できる最深の視覚が選択される; if no depth is specified, then the deepest available visual is chosen;

  3. 擬似色が真の色や直接色より良く､後者は静的色よりも良く､後者は静的灰色や灰色指標より良い｡ pseudocolor is better than truecolor or directcolor, which are better than staticcolor, which is better than staticgray or grayscale;

  4. 画像の為の無為設定視覚が他のどの視覚より良い｡ the default visual for the screen is better than any other visual.

### 著作権表示 CREDITS

Tk_GetVisual の概念と最初の実装は Paul Mackerras さんに由来する｡ The idea for Tk_GetVisual, and the first implementation, came from Paul Mackerras.

### KEYWORDS

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