XcmsStoreColor(3X11) — NEWS-OS Programmer’s Manual
名称
XcmsStoreColor, XcmsStoreColors − カラーを設定する
形式
Status XcmsStoreColor(display, colormap, color)
Display ∗display;
Colormap colormap;
XcmsColor ∗color; Status XcmsStoreColors(display, colormap, colors, ncolors, compression_flags_return)
Display ∗display;
Colormap colormap;
XcmsColor colors[];
int ncolors;
Bool compression_flags_return[];
引数
displayX サーバとの接続を指定します。
color格納するカラーセルおよびカラーを指定します。 この XcmsColor 構造体に指定された値は返り値において変更されずに そのまま残ります。
colorsXcmsColor 構造体のカラー仕様列を指定します。 各要素はそのセルに格納するカラーセルおよび カラーを指定しています。 配列に指定された値は返り値において、 変更されずにそのまま残ります。
colormapカラーマップを指定します。
compression_flags_return
圧縮ステータスを返す際の ブーレン値配列を指定します。 ナル以外のポインタが指定された場合で、 対応するカラーが圧縮される場合、 配列の各要素は True に設定されます。 そうでなければ、 False となります。 圧縮ステータスが使用できない場合、 ナルを渡します。
ncolorsカラー仕様配列内の XcmsColor 構造体の数を指定します。
解説
XcmsStoreColor 関数は XcmsColor 構造体に指定されたカラーを RGB 値に変換し、 XcmsColor 構造体のピクセルメンバによって 指定されたカラーセルを変更する XStoreColor へのコールの中で、3 つのフラグ (DoRed、 DoGreen、 および DoBlue) が設定されている XColor 構造体でこの RGB 仕様を使用します。 このピクセル値は指定カラーマップ に対する有効なインデックスでなければ なりません。 また、ピクセル値によって指定されたカラーセル は読み込み／書き込みセルでなければなりません。 ピクセル値が有効なインデックスではない場合、 BadValue エラーとなります。 カラーセルが割り当てられてなかったり、 または読み込みのみに割り当てられている場合、 BadAccess エラーとなります。 カラーマップがそのスクリーンに対してインストールされた マップの場合、その変化はすぐに判明します。 XStoreColor は返り値を持たないことに注意してください。 この関数からの XcmsSuccess 返り値は RGB への変換がうまくゆき、 XStoreColor へのコールが実行されたことを示します。 格納された実際のカラーを獲得するためには、 XcmsQueryColor を使用します。 スクリーンのハードウェア制限または全域圧縮により、 カラーマップに格納されたカラーは 指定されたカラーに一致しないことがあります。 XcmsStoreColor は BadAccess、 BadColor、 および BadValue エラーを生成します。 XcmsStoreColors 関数は XcmsColor 構造体の配列内に指定されたカラーを RGB 値に変換し、 対応する XcmsColor 構造体のピクセルメンバによって 指定されたカラーセルを変更する XStoreColors へのコールの中で、3 つのフラグ (DoRed、 DoGreen、 および DoBlue) が設定されている XColor 構造体の RGB 仕様を使用します。 各ピクセル値は指定カラマップに対する 有効なインデックスでなければならず、 各ピクセル値によって指定されたカラーセル は読み込み／書き込みセルでなければなりません。 ピクセル値が有効なインデックスでない場合、 BadValue エラーとなります。 カラーセルが割り当てられてなかったり、 または読み込みのみに割り当てられていた場合、 BadAccess エラーとなります。 一つ以上のピクセルがエラーとなった場合、 報告されたものが任意となります。 カラーマップがそのスクリーンに対して インストールされたマップの場合、 変更はすぐに判明します。 XStoreColors は返り値を持たないことに注意してください。 この関数からの返り値 XcmsSuccess は RGB への変換がうまくゆき、 XStoreColors へのコールが実行されたことを示します。 格納されている実際のカラーを獲得するためには、 XcmsQueryColors を使用します。 スクリーンの制限または全域圧縮により、 カラーマップに格納されたカラーは指定されたカラー と一致しないことがあります。 XcmsStoreColors は BadAccess、 BadColor、 および BadValue エラーを返すことがあります。
自己診断
BadAccess 割り当てていなかったカラーマップエントリを クライアントが開放しようとした。
BadAccess 読み込みのみのカラーマップエントリにクライアント は格納しようとした。
BadColor カラーマップの引数値が、定義されたカラーマップ名でない。
BadValue いくつかの値がリクエストによって認められた 値の範囲外である。 引数に対して範囲が指定されたのでなければ、 引数のタイプによって定義された範囲全てが認められます。 二者択一のセットで引数が定義された場合、 このエラーとなります。
関連事項
XcmsAllocColor(3X11), XcmsQueryColor(3X11)
Xlib − C Language X Interface
NEWS-OSRelease 4.2.1R