XStoreColors(3X11)

名前
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 値か、色の名前を表す文字列(例えば red)を指定。

color
    格納される色定義のための構造体の配列を指定。

colormap
    カラーマップを指定。

display
    X サーバへの接続を指定。

flags
    RGB成分のどれがセットされるかを指定。

ncolors
    色定義のための配列内の 構造体の数を指定。

pixel
    カラーマップ内のエントリーを指定。

説明
関数 は、 構造体の pixel メンバで指定されているピクセル値のカラーマップエントリー を変更する。 構造体の flag メンバに をセットすることで、どの色成分を変更するか指定する。 カラーマップがスクリーンにインストールされていれば、変更は即座に表示に 反映される。 は、ピクセルが書き込み可能でカラーマップにアロケートされていれば、1つ 以上のピクセルでエラーになっても、指定したピクセルを変更する。 指定したピクセルがカラーマップの正しいインデックスでない場合には、 エラーとなる。 指定したピクセルがアロケートされていないか、リードオンリーでアロケート されている場合には、 エラーとなる。 1つ以上のピクセルがエラーになった場合、エラーとして報告されるピクセル は任意である。

はエラー を起こすことがある。

関数 は、 構造体の pixel メンバで指定されているピクセル値のカラーマップエントリ を変更する。 この値は 構造体の pixel メンバに指定する。 このピクセル値は読み書き可能なセルで、カラーマップ内の正しいインデック スでなければならない。 指定したピクセルがカラーマップ内の正しいインデックスでなければ、 エラーとなる。 は色のRGB成分も変更する。 構造体の flags メンバに を指定することにより、どの色成分を変更するか指定する。 カラーマップがスクリーンにインストールされていれば、変更は即座に画面に 反映される。

はエラー を起こすことがある。

関数 はカラーマップに対応するスクリーンについて名前で指定された色を問い合わ せ、その結果を指定したカラーマップに格納する。 引き数 pixel はカラーマップ内のエントリーを決定する。 引き数 flags は、RGB成分のどれがセットされるかを決定する。 このメンバはビット について、ビット単位の論理和をとることでセットできる。 色の名前のエンコーディングがホストポータブル文字エンコーディングでない 場合、実行結果は実装依存となる。 大文字を使用しても小文字を使用しても結果は同じである。 指定したピクセルがカラーマップの正しいインデックスでない場合はエラー となる。 指定したピクセルがアロケートされていないか、リードオンリーでアロケート されている場合には、 エラーとなる。

はエラー を起こすことがある。

返り値

クライアントが、アロケートされていないカラーマップエントリーを解放しよ
    うとした。

クライアントが、リードオンリーのカラーマップエントリーに格納しようとし
    た。

引き数 Colormap の値が、定義されている Colormap を指していない。

指定された名前のフォントや色が存在しない。

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていない限り、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

関連項目
XAllocColor(3X11), XCreateColormap(3X11), XQueryColor(3X11)
Xlib - C Language X Interface