SETBKCOLORRGB

グラフィックス関数：指定した RBB 色値を現在の背景色に設定します。

モジュール：USE DFLIB

形式

result = SETBKCOLORRGB (color)

color
(入力) INTEGER(4)。背景色に設定する RGB 色値。範囲と結果はシステムのディスプレイ・アダプタに依存します。

結果

結果の型は INTEGER(4) です。結果は，以前の背景の RGB 色値です。

各 RGB 色値では，3 つの色，赤，緑，青のそれぞれは 8 ビット値 (2 つの 16 進数) で表されます。SETBKCOLORRGB で指定した値は，赤が最も右のバイトで続いて緑，青の順になります。RGB 色値の内部構造は以下のとおりです。

最大値は，3 つの要素の各々のが最大の 2 進 1111111 (16 進 FF) の最大の色強度に対応します。たとえば，#0000FF は赤の最大強度，#00FF00 は緑の最大強度，#FF0000 は青の最大強度，#FFFFFF は 3 つすべての最大強度 (結果として明るい白) になります。

基本背景色は，黒を示す値 0 です。背景色の変更は，直ちに画面に反映されませんが，CLEARSCREEN が実行される時，または READ，WRITE，または OUTTEXT のようなテキスト入力または出力が行われる時，有効になります。グラフィックス出力関数 OUTGTEXT は，背景の色に影響しません。

SETBKCOLORRGB は，テキストおよびグラフィックスの両方の現在の背景の RGB 色値を設定します。背景色上のテキストの RGB 色値 (OUTTEXT，WRITE，および PRINT のようなテキスト関数で使用) は，SETTEXTCOLORRGB で設定します。背景色上のグラフィックスの RGB 色値 (ARC，OUTGTEXT，および FLOODFILLRGB のようなグラフィックス関数で使用) は，SETCOLORRGB で設定します。

SETBKCOLORRGB (と他の SETCOLORRGB と SETTEXTCOLORRGB のような RGB 色選択関数) は，全利用可能範囲から選択された値に色を設定します。非 RGB 色関数 (SETBKCOLOR，SETCOLOR，および SETTEXTCOLOR) は， True Color 値ではなく色指標を使います。色指標を使う場合，パレットで利用可能な色に制限されます。最大で 256 色です。幾つかのディスプレイ・アダプタ (SVGA または True Color) は 262,144 (256K) 色以上を作成する機能を持っています。すべての利用可能な色を参照するには，非 RGB 色関数でパレット指標を指定するのではなく，RGB 色関数で明示的に RGB 色値を指定する必要があります。

互換性

STANDARD GRAPHICS QUICKWIN GRAPHICS LIB

関連情報

GETBKCOLORRGB，SETBKCOLOR，SETCOLORRGB，SETPIXELRGB，SETPIXELSRGB，SETTEXTCOLORRGB

例

	! QuickWin または Standard Graphics アプリケーションでビルドします。
	USE DFLIB
	INTEGER(4) oldcolor
	INTEGER(2) status, x1, y1, x2, y2
	x1 = 80; y1 = 50
	x2 = 240; y2 = 150
	oldcolor = SETBKCOLORRGB(#FF0000)	! 青色
	oldcolor = SETCOLORRGB(#FF)		! 赤色
	CALL CLEARSCREEN ($GCLEARSCREEN)
	status = ELLIPSE($GBORDER, x1, y1, x2, y2)
	END