書式

Status XcmsConvertColors(ccc, colors_in_out, ncolors, target_format, compression_flags_return)

      XcmsCCC ccc;

      XcmsColor colors_in_out[];

      unsigned int ncolors;

      XcmsColorFormat target_format;

      Bool compression_flags_return[];

引き数

ccc

CCC を指定する。 デバイス独立な色空間だけの間の変換では(例えば、TekHVC から CIELuv への 変換)、CCC はクライアント白色点だけを指定すればよい。

colors_in_out

表色の配列を指定する。 pixel メンバは無視され、返される時にも変更されない。

compression_flags_return

圧縮の状態を示す真偽値(Boolean 型)の配列が返される。 NULL でないポインタが与えられた場合、配列の各要素には対し、対応する色 が圧縮されていれば True がセットされ、そうでなければ False がセットされる。 圧縮の状態が不要であれば NULL を渡すこと。

ncolors

表色の配列内の XcmsColor 構造体の数を指定する。

target_format

対象とする表色のフォーマットを指定する。

説明

関数 XcmsConvertColors は指定した CCC を用い、指定した XcmsColor 構造体の配列に含まれる表色を、現在のフォーマットから1つの対象のフォー マットに変換する。 返り値が XcmsFailure の場合、表色の配列の内容は変化しない。

配列内では複数の表色のフォーマットが混在することがある(例えば、3 つの CIE XYZ と 2 つの CIE Luv 等)。 配列がデバイス独立の表色とデバイス依存の表色を含み、引き数 target_format がデバイス依存のフォーマット(例えば、 XcmsRGBiFormat, XcmsRGBFormat )を指定している場合、全ての表色は CIE XYZ フォーマットに変換され、その 後で目的のデバイス依存フォーマットに変換される。