名称

XStoreColors, XStoreColor, XStoreNamedColor - カラーを設定する

形式

XStoreColors(display, colormap, color, ncolors)
      Display ∗display;
      Colormap colormap;
      XColor color[];
      int ncolors; XStoreColor(display, colormap, color)
      Display ∗display;
      Colormap colormap;
      XColor ∗color; XStoreNamedColor(display, colormap, color, pixel, flags)
      Display ∗display;
      Colormap colormap;
      char ∗color;
      unsigned long pixel;
      int flags;

引数

colorピクセルと RGB 値または、カラー名文字列 ( 例えば、赤 ) を 指定します。 pixel and RGB values or the color name string (for example, red). 

colorストアするカラー定義構造体の配列を指定します。

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

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

flags赤、緑、青の構成要素のどれを設定するかを指定します。

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

pixelカラーマップ中のエントリを指定します。

解説

XStoreColors 関数は、 XColor 構造体のピクセルメンバに指定されたピクセル値のカラーマップエントリを 変更します。 XColor 構造体のフラグメンバの DoRed, DoGreen, および / または DoBlue を指定することにより どの構成要素を変更するかを指定します。 カラーマップが、そのスクリーンにインストールされたマップである場合は、 その変更をすぐに目で見ることができます。 XStoreColors は、たとえ１つ以上のピクセルがエラーを生じるとしても、 指定されたピクセルがクライアントにより、カラーマップ中に書き込み可能な ように割当てられている場合は、その指定されたピクセルを変更します。 指定されたピクセルがカラーマップへの有効索引 ( インデックス ) でない場合は、 BadValue が結果として生じます。 指定されたピクセルが割当てられていないか、または、 " リードオンリ " が 割当てられているかのいずれかの場合は、結果として BadAccess エラーが生じます。 １つ以上のピクセルがエラー状態にある場合は、 通知されるピクセルは任意です。 .PN XStoreColors は、 BadAccess, BadColor, および BadValue エラーを生じることがあります。 XStoreColor 関数は、 XColor 構造体のピクセルメンバに指定されているピクセル値のカラーマップエントリを 変更します。 XColor 構造体のピクセルメンバにこの値を指定します。 このピクセル値は、読込み / 書込みセルであり、カラーマップへの 有効索引でなければなりません。 指定されたピクセルがカラーマップへの有効索引でない場合は、 結果として BadValue エラーが生じます。また XStoreColor も、赤、緑および / または青のカラー構成要素を変更します。 XColor 構造体のフラグメンバの DoRed, DoGreen, および / または DoBlue を設定することにより、どのカラー構成要素を変更するかを指定します。 カラーマップがそのスクリーンにインストールされている場合は、 その変更をすぐに目で見ることができます。 .PN XStoreColor は、 BadAccess, BadColor, および BadValue エラーを生じることがあります。 XStoreNamedColor 関数は、カラーマップに対応するスクリーンに関して、 指定されたカラーを調べ、 指定されたカラーマップにその結果をストアします。
 pixel 引数は、カラーマップ中のエントリを決定します。
 flags 引数は、赤、緑、および青の構成要素のどれを設定するかを決定します。 このメンバを、ビットである DoRed, DoGreen, および DoBlue. のビット単位の内包的論理和に設定することができます。 指定されたピクセルがカラーマップへの有効索引でない場合は、結果として BadValue が生じます。 指定されたピクセルが割当てられていないか、または " リードオンリ " で 割当てられているかのいずれかの場合は、結果として BadAccess エラーが生じます。
 ISO Latin-1 のエンコーディング ( コード化 ) を使用しなければなりません。 この際、大文字、小文字は両方使用できます。 .PN XStoreNamedColor は、 BadAccess, BadColor, BadName, および BadValue エラーを生じることがあります。

診断

BadAccess クライアントが、 まだ割当てられていないカラーマップを解放しようとした。

BadAccess クライアントが、 リードオンリのカラーマップエントリに書き込みをしようとした。

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

BadName 指定された名前のフォントまたはカラーが存在しない。

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

関連事項

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

NEWS-OSRelease 3.3