名称

XcmsAllocColor, XcmsAllocNamedColor − カラーを割り当てる

形式

Status XcmsAllocColor(display, colormap, color_in_out, result_format)
      Display ∗display;
      Colormap colormap;
      XcmsColor ∗color_in_out;
      XcmsColorFormat result_format; Status XcmsAllocNamedColor(display, colormap, color_string, result_format, color_screen_return,
                            color_exact_return)
      Display ∗display;
      Colormap colormap;
      char ∗color_string;
      XcmsColorFormat result_format;
      XcmsColor ∗color_screen_return;
      XcmsColor ∗color_exact_return;

引数

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

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

color_exact_return
カラー文字列から、 またはカラーネームデータベース内の対応する文字列から 分析してカラー仕様を返します。

color_in_out割り当てるカラーを指定し、 実際にカラーマップで仕様されるピクセル およびカラーを返します。

color_screen_return
カラーセルのピクセル値および そのセルに対して実際に格納されているカラー仕様を返します。

color_string返されるカラー定義構造体のカラー文字列を指定します。

result_format
返されたカラー仕様に対するカラー形式を指定します。

解説

どの形式でもカラーが指定できることを除いて、 XcmsAllocColor 関数は XAllocColor 同様です。 指定カラーで読み込みのみの カラーセル (カラーマップエントリ) を割り当てるため、 XcmsAllocColor 関数は XAllocColor をコールします。 XcmsAllocColor は最初に指定カラーを RGB 値に変換し、 XAllocColor に渡します。 XcmsAllocColor はカラーセルのピクセル値および実際に割り当てられた カラー仕様を返します。 この返されたカラー仕様は、 XAllocColor によって返された RGB 値を result_format 引数 で指定された形式に変換した結果です。 返されたカラー仕様内に関連するデータが なかった場合で、なおかつ result_format が XcmsRGBFormat に設定されている場合には不要な計算結果は無視されます。 対応するカラーマップセルは読み込みのみのデータです。 このルーチンが XcmsFailure を返す場合、 color_in_out カラー仕様は変更されずに、残ります。 XcmsAllocColor は BadColor エラーを生成できます。 指定のどの形式でもカラーが返されることを除けば、 XcmsAllocNamedColor 関数は XAllocNamedColor と同様です。 カラー文字列で指定されたカラーで読み込みのみのカラーセル を割り当てるために この関数は、 XAllocColor をコールします。 カラー文字列は XcmsColor 構造体 ( XcmsLookupColor 参照) に渡され、 RGB 値に変換され、 XAllocColor に渡されます。 カラーネームがホストポータブルキャラクタエンコーディング に存在しない場合、 その結果はインプリメンテーション依存となります。 大文字、小文字の区別はありません。 この関数は連結結果(実際の仕様)としてのカラー仕様 および格納されている実際のカラー仕様 (スクリーン仕様) を返します。 このスクリーン仕様は XAllocColor によって返された RGB 値を result_format で指定された形式に変換した結果です。 返されたカラー仕様に必要なデータがなかった場合で、 なおかつ result_format が XcmsRGBFormat に設定されている場合には、 不要な計算結果は無視されます。 XcmsAllocNamedColor は BadColor エラーを発生することがあります。

自己診断

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

関連事項

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

NEWS-OSRelease 4.2.1R