名称

XQueryColor, XQueryColors, XLookupColor − カラー値を問合わせる

形式

XQueryColor(display, colormap, def_in_out)
      Display ∗display;
      Colormap colormap;
      XColor ∗def_in_out; XQueryColors(display, colormap, defs_in_out, ncolors)
      Display ∗display;
      Colormap colormap;
      XColor defs_in_out[];
      int ncolors; Status XLookupColor(display, colormap, color_name, exact_def_return, screen_def_return)
      Display ∗display;
      Colormap colormap;
      char ∗color_name;
      XColor ∗exact_def_return, ∗screen_def_return;

引数

colormapcolormap を指定します。

color_name返してほしいカラー定義構造体をもつカラー名の文字列 ( 例えば、赤 ) を指定します。

def_in_out構造体中に指定されたピクセルの RGB 値を指定し、返します。

defs_in_out構造体中に指定されたピクセルのカラー定義構造体の配列を指定し、返します。

displayX サーバへのコネクションを指定します。

exact_def_return
正確な RGB 値を返します。

ncolorsカラー定義配列中の XColor 構造体の数を指定します。

screen_def_return
ハードウェアが提供する一番近い RGB 値を返します。

解説

XQueryColor 関数は、 XColor 構造体中の各ピクセルの RGB 値（ハードウェアによって決まる）を返し、 DoRed、 DoGreen および DoBlue フラグを設定します。 XQueryColors 関数は、 XColor 構造体中の各ピクセルの RGB 値を返し、 DoRed、 DoGreen および DoBlue フラグを設定します。 .PN XQueryColor および .PN XQueryColors は、 BadColor および BadValue エラーを生じることがあります。 XLookupColor 関数は、指定されたカラーマップと対応するスクリーンに関するカラーの 文字列名を調べます。 XLookupColor は、指定されたカラーマップのビジュアルタイプに関するスクリーンが 提供する正確なカラー値および一番近い値を返します。
 ISO Latin-1 のエンコーディングを使用しなければなりません。 大文字小文字は両方使用できます。 XLookupColor は、名前がカラーデータベースに存在する場合は非零の値を、 また存在しない場合は零を返します。

診断

BadColor Colormap 引数の値が定義された Colormap を指さない。

BadValue ある数値が許容範囲を超えた。 引数の値の範囲が明示されない限り、引数の型によって決まる最大の範囲まで 指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XAllocColor(3X11), XCreateColormap(3X11), XStoreColors(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C