XcmsStoreColor(3X11)

名前
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[];

引き数

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

color
    格納するカラーセルと色を指定。 この 構造体で指定される値は、返される時にも変更されていない。

colors
    表色である 構造体の配列を指定。配列のそれぞれの要素は、カラーセルとそのセルに格納 される色を指定する。 配列で指定した値は、返される時にも変更されない。

colormap
    カラーマップを指定。

compression_flags_return
    圧縮の状態を示す Boolean 値の配列が返される。 NULL でない値が与えられた場合、対応する色が圧縮されていれば配列の各要 素には がセットされ、そうでなければ がセットされる。 圧縮の状態が不要であれば、NULL を指定すること。

ncolors
    表色の配列内の 構造体の数を指定。

説明
関数 は、 構造体で指定された色を RGB 値に変換する。 その後、この関数は3つのフラグ がセットされている 構造体の RGB 表色を用いて を呼び出し、 構造体の pixel メンバで指定されたカラーセルを変更する。 このピクセル値は指定したカラーマップに対する有効なインデックスでなけれ ばならない。また、ピクセル値によって指定されるカラーセルは読み書き可能 なセルでなければならない。 ピクセル値が有効なインデックスでない場合は、エラー となる。 カラーセルがアロケートされていないか、リードオンリーでアロケートされて いる場合は、エラー となる。 カラーマップがそのスクリーンにインストールされていれば、変更は即座に画 面表示に反映される。

は返し値を持たないことに注意せよ。したがって、この関数が返す は、RGB 値への変換が成功し、 の呼び出した行われたことだけを示す。 実際に格納された色を取得するには、 を使用すること。 スクリーンのハードウェアの制限やガモット圧縮のため、カラーマップに格納 された色は指定した色と異なることがある。

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

関数 は、 構造体の配列で指定された色を RGB 値に変換する。 その後、この関数は3つのフラグ がセットされている 構造体の RGB 表色を用いて を呼び出し、対応する 構造体の pixel メンバで指定されたカラーセルを変更する。 このピクセル値は指定したカラーマップに対する有効なインデックスでなけれ ばならない。また、ピクセル値によって指定されるカラーセルは読み書き可能 なセルでなければならない。 ピクセル値が有効なインデックスでない場合は、エラー となる。 カラーセルがアロケートされていないか、リードオンリーでアロケートされて いる場合は、エラー となる。 1つ以上のピクセルでエラーになった場合1つのピクセルに対してエラーが通知 されるが、どのピクセルになるかはわからない。 カラーマップがそのスクリーンにインストールされていれば、変更は即座に画 面表示に反映される。

は返し値を持たないことに注意せよ。したがって、この関数が返す は、RGB 値への変換が成功し、 の呼び出した行われたことだけを示す。 実際に格納された色を取得するには、 を使用すること。 スクリーンのハードウェアの制限やガモット圧縮のため、カラーマップに格納 された色は指定した色と異なることがある。

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

返り値

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

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

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

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

関連項目
XcmsAllocColor(3X11), XcmsQueryColor(3X11)
Xlib - C Language X Interface