名称

XcmsQueryColor, XcmsQueryColors, XcmsLookupColor − カラー値を獲得する

形式

Status XcmsQueryColor(display, colormap, color_in_out, result_format)
      Display ∗display;
      Colormap colormap;
      XcmsColor ∗color_in_out;
      XcmsColorFormat result_format; Status XcmsQueryColors(display, colormap, colors_in_out, ncolors, result_format)
      Display ∗display;
      Colormap colormap;
      XcmsColor colors_in_out[];
      unsigned int ncolors;
      XcmsColorFormat result_format; Status XcmsLookupColor(display, colormap, color_string, color_exact_return, color_screen_return,
result_format)
      Display ∗display;
      Colormap colormap;
      char ∗color_string;
      XcmsColor ∗color_exact_return, ∗color_screen_return;
      XcmsColorFormat result_format;

引数

displayX サーバとの接続を指定します。

colormapカラーマップを指定します。

color_exact_return
カラー文字列から連結された仕様または カラーネームデータベース内で見つけた 対応する文字列から連結された仕様を 返します。

color_in_out要求するカラーセルおよびこの XcmsColor 構造体に返されたカラーセルに関して格納された カラー仕様を示すピクセルメンバを 指定します。

color_screen_return
Screen 上で再生できるカラーを返します。

color_stringカラー文字列を指定します。

result_format
返されたカラー仕様 (color_screen_return および color_exact_return 引数) に関するカラー形式を指定します。 形式が XcmsUndefinedFormat で、カラー文字列が数値のカラー仕様を保持して いる場合、仕様は数値のカラー仕様で使用される 形式で返されます。 形式が XcmsUndefinedFormat で、カラー文字列がカラーネーム を含む場合、 データベース内にカラーを 格納する際に使用される形式で仕様が返されます。

ncolorsカラー仕様列における XcmsColor 構造体の数を指定します。

解説

XcmsQueryColor 関数は指定の XcmsColor 構造体のピクセルメンバのピクセル値に 関する RGB 値を獲得し、 その値を result_format 引数で 指定された目的形式に変換します。 ピクセルが指定カラーマップ内で 有効なインデックスでない場合、 BadValue エラーとなります。 XcmsQueryColors 関数は XcmsColor 構造体のピクセルメンバ内のピクセル値 に関する RGB 値を獲得し、 result_format 引数で指定された 目的形式へその値を変換します。 指定カラーマップ内でピクセルが 有効なインデックスでない場合、 BadValue エラーとなります。 一つ以上のピクセルがエラーの場合、 報告されたものは任意となります。 XcmsQueryColor および XcmsQueryColors は、 BadColor および BadValue エラーを発生することがあります。 XcmsLookupColor 関数は指定されたカラーマップに関連 するスクリーンに関するカラーの 文字列名を求めます。 実際のカラーの値および 指定のカラーマップのビジュアルタイプに関しての スクリーンによって設定された最も近い値を 返します。 値は result_format 指定された形式で 返されます。 カラーネームがホストポータブルキャラクタエンコーディング に存在しない場合、 その結果はインプリメンテーション依存となります。 大文字、小文字の区別はしません。 その名前が分析されてない場合、 XcmsLookupColor は、 XcmsSuccess または XcmsSuccessWithCompression を返します。 そうでなけば、 XcmsFailure を返します。 XcmsSuccessWithCompression が返された場合、 color_screen_return 内のカラー仕様は全域圧縮の結果となります。

自己診断

BadColor Colormap 引数に対する値が定義された Colormap に一致しない。

BadValue いくつかの数値がリクエストによって認められた 範囲外である。 引数に対して範囲が指定されない限り、 引数のタイプによって定義された範囲全てが認められます。 二者択一のセットとして定義された引数であれば、 このエラーとなります。

関連事項

XcmsAllocColor(3X11), XcmsStoreColor(3X11), XQueryColor(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R