CBL_SCR_ALLOCATE_COLOR

1つ以上の与えられたRGB値のそれぞれに対してカラーマップのあるエントリーを検索する。

構文:

call "CBL_SCR_ALLOCATE_COLOR" using     table-count
                                        RGB-values
                                        color-attribute
                                        non-exact-match
                              returning status-code

パラメタ:

		呼び出しプロトタイプ使用時 ( 説明の読み方)		PIC (32bitシステム)
table-count		cblt-x2-compx		pic x(2) comp-x.
RGB-values		Group predefined as cblt-generic-attr-rgb-values containing:		Group, occurs n times, containing:
	cblte-garv-red-value		cblt-x2-compx		pic x(2) comp-x.
	cblte-garv-green-value		cblt-x2-compx		pic x(2) comp-x.
	cblte-garv-blue-value		cblt-x2-compx		pic x(2) comp-x.
	cblte-garv-filler		cblt-x1 occurs 2		pic x(2).
color-attribute		cblt-x4-compx occurs n times.		pic x(4) comp-x occurs n times.
non-exact-match		cblt-x4-compx occurs n times.		pic x comp-x occurs n times.
status-code		説明の読み方.

入力パラメタ:

table-count	要求されたカラーの数
	検索する、またはカラーマップに追加するカラーの表

出力パラメタ:

color-attribute	要求されたカラーに対応するカラーマップの索引の表。既存のカラーマップエントリーか、要求されたカラーが設定された割り当てられていない読み書きカラーマップエントリー。
non-exact-match	対応するcolor-attributeが完全に一致しているか否かを示すフラグの表。完全に一致している場合はゼロ、それ以外はゼロ以外の値が入る。
table-count	割当てに成功したカラーの数。通常、要求された数が入るが、呼出しが完全に成功しなかった場合はそれよりも小さい 値が入る。
RGB-values	検索中に実際に使用されたRGB値の表。環境にあわせて切り取られる。
cblte-garv-filler	使用されていない。

説明:

RGB値は、定数として指定したりCBL_SCR_NAME_TO_RGBルーチンの呼出しにより取得することができる。もっとも似ているものを決めるアルゴリズムは、環境によって定義される。

他参照:

関連項目