指定された 1 つ以上の RGB 値ごとに、カラーマップ内のエントリを検索します。
call "CBL_SCR_ALLOCATE_COLOR" using table-count RGB-values color-attribute non-exact-match returning status-code
01 cblt-generic-attr-rgb-values typedef. 03 cblte-garv-red-value cblt-x2-compx. *> pic x(2) comp-x. 03 cblte-garv-green-value cblt-x2-compx. *> pic x(2) comp-x. 03 cblte-garv-blue-value cblt-x2-compx. *> pic x(2) comp-x. 03 cblte-garv-filler cblt-x1-compx occurs 2. *> pic x(2).
color-attribute | 要求した色に対応するカラーマップの索引の表。この値は、既存のカラーマップ エントリ、または要求した色に設定された未割り当ての読み書き可能なカラーマップ エントリになります。 |
non-exact-match | color-attribute の対応する出現項目が完全一致であるかどうかを示すフラグの表。完全に一致した場合はゼロ、それ以外の場合はゼロ以外の値になります。 |
table-count | 正常に割り当てられた色の数。通常は要求した数ですが、呼び出しが完全には成功しなかった場合はそれよりも少なくなります。 |
RGB-values | 検索時に実際に使用された RGB 値の表。環境に合わせて切り捨てられます。 |
cblte-garv-filler | 未使用。 |
説明:
RGB 値は、リテラルとして指定することも、CBL_SCR_NAME_TO_RGB ルーチンの呼び出しを使用して取得することもできます。最も近い一致を決定するためのアルゴリズムは、環境で定義されます。