PixelSearch

指定された色のピクセルを画面上の領域で検索します。

PixelSearch &OutputVarX, &OutputVarY, X1, Y1, X2, Y2, ColorID , Variation

パラメータ

&OutputVarX, &OutputVarY

型：VarRef

ColorIDに一致する最初のピクセルの X 座標と Y 座標を格納する出力変数への参照（一致しない場合、変数は空白にされます）。座標は、CoordMode関数を使用して変更した場合を除いて、アクティブウィンドウのクライアント領域を基準にしています。

X1, Y1

型：整数

検索する矩形の開始角のX、Y座標。座標は、CoordMode関数を使用して変更した場合を除いて、アクティブウィンドウのクライアント領域を基準にしています。

X2, Y2

型：整数

検索する矩形の終了角のX、Y座標。座標は、CoordMode関数を使用して変更した場合を除いて、アクティブウィンドウのクライアント領域を基準にしています。

ColorID

型：整数

検索するカラーIDを指定します。これは通常、赤緑青（RGB）形式の16進数で表現されます。事例：0x9d6346。カラーIDは、Window Spy（トレイメニューからアクセス可能）またはPixelGetColorを使用して決定することができます。

Variation

型：整数

省略したときの初期値は0です。Otherwise, specify a number between 0 and 255 (inclusive) to indicate the allowed number of shades of variation in either direction for the intensity of the red, green, and blue components of the color. 例えば、2が指定され、ColorIDが0x444444の場合、0x424242から0x464646までのすべての色が一致するとみなされます。このパラメータは、求める色が常に全く同じ色合いでない場合に有効です。255色のバリエーションを指定した場合、すべての色が一致します。

戻り値

型：整数（ブーリアン）

この関数は、指定された領域で色が見つかった場合は 1（真）を、見つからなかった場合は 0（偽）を返します。

エラー処理

関数が検索を行うことを妨げる問題があった場合、OSErrorがスローされる。

備考

検索する領域は可視でなければなりません。言い換えれば、ウィンドウが他のウィンドウの後ろに隠れている領域を検索することは不可能です。一方、マウスカーソルの下にある画素は、通常、検出することができます。The exception to this is game cursors, which in most cases will obstruct any pixels beneath them.

Although color depths as low as 8-bit (256-color) are supported, PixelSearch performs much better in 24-bit or 32-bit color.

X1とY1で指定された座標から検索を開始し、X1からX2までの行のすべてのピクセルが一致するかどうかをチェックします。そこで一致する画素が見つからなければ、一致する画素が見つかるまで、Y2に向かって1行ずつ検索を続けます。

検索順序は、パラメータの順序に依存します。つまり、X1が X2より大きい場合、X1列目から右から左へ検索を行うことになる。同様に、Y1が Y2より大きい場合は、下から上に向かって検索を行うことになります。

検索する領域が大きく、高い頻度で検索を繰り返す場合、CPU時間を多く消費する可能性があります。これを緩和するために、面積を最小限に抑えます。

関連

PixelGetColor、ImageSearch、CoordMode、MouseGetPos

例

if PixelSearch(&Px, &Py, 200, 200, 300, 300, 0x9d6346, 3)
    MsgBox "A color within 3 shades of variation was found at X" Px " Y" Py
else
    MsgBox "That color was not found in the specified region."