GETPIXELS

グラフィックス・サブルーチン:複数のピクセルの色指標を返します。

モジュールUSE DFLIB

形式

CALL GETPIXELS (n, x, y, color)

n
(入力) INTEGER(4)。得たいピクセルの数。他の引数の要素数を設定します。

x, y
(入力) INTEGER(2)。得たいピクセルのビューポート座標を含む並行配列。

color
(出力) INTEGER(2)xy にあるピクセルの色指標を書き込む配列。

GETPIXELS は,2 つの入力配列 xy で指定されたピクセルの色指標を配列 color に書き込みます。これらの配列は平行です。各 3 つの配列の第 1 要素は,1 ピクセルを参照し,第 2 要素は次のピクセルを参照します。

ピクセルがクリッピング領域外にある場合,配列 color に置かれる値は未定義です。n が 1 より小さい値で GETPIXELS を呼び出した場合,無視されます。GETPIXELS は,GETPIXEL で個別に呼び出すよりも複数のピクセル色指標を得るより早い方法です。

ピクセル色指標値の可能な範囲は,現在のビデオ・モードとパレットで決定されます。最大は 256 色です。すべてのシステム色を参照するには,非 RGB 色関数でパレット指標を使うのではなく,SETPIXELSRGB のような RGB 色関数で明示的に RGB 値を指定し,GETPIXELSRGB で値を取り出す必要があります。

互換性

STANDARD GRAPHICS QUICKWIN GRAPHICS LIB

関連情報

GETPIXELGETPIXELSRGBSETPIXELSSETPIXELSRGB