surface_getpixel()

2D グラフィック機能

surface_getpixel †

サーフェースの指定した座標のピクセル（色）情報を取得します

構文 †

surface_getpixel(index, x, y);

index

サーフェースのインデックス番号

x

X座標

y

Y座標

戻り値 †

Real

色

説明 †

この関数はサーフェースの(0,0)を基準としたローカル座標を指定して、特定のピクセルの色を取得できます。ただしこれは非常に遅い処理となるため、頻繁に使用すべきではありません

注意 †

サーフェースはいつでも破棄される可能性があるため、surface_exists()を使用して常に存在をチェックする必要があります。詳しくはサーフェース機能についてを参照してください

例 †

col = surface_getpixel(surf, 56, 78 );

変数"surf"のサーフェースの座標(56, 78)にあるピクセルの色を取得します