AutoHotKey(오토핫키) 설명서 PixelSearch

Posted by 발전소장
2014. 8. 14. 13:48 AutoHotKey/Commands

PixelSearch

지정 범위로 지정한 색이 존재하면, 그 좌표를 취득한다

PixelSearch, [OutputVarX], [OutputVarY], X1, Y1, X2, Y2, ColorID [, Variation, Fast|RGB]

Parameters

인수명설명
OutputVarX , OutputVarY 발견되었을 경우X좌표와Y좌표가 격납되는 변수명.
생략 가능.
X1,Y1 검색 대상이 되는 구형의 좌상의 좌표.
통상은 액티브 윈도우의 좌상으로부터의 상대 좌표이지만,CoordMode커멘드를 사용하면 스크린 전체로의 좌표가 된다.
X2,Y2 검색 대상이 되는 구형의 우하의 좌표.
통상은 액티브 윈도우의 좌상으로부터의 상대 좌표이지만,CoordMode커멘드를 사용하면 스크린 전체로의 좌표가 된다.
ColorID 검색하는 칼라 코드.
RGB(을)를16진수로0BBGGRR되는 포맷으로 지정.
PixelGetColor그리고 취득할 수도 있다.
Variation RGB각 요소마다의 허용 하는 오차.
생략시는 「0」.
Fast|RGB 이하의 것을 반각 스페이스에서 단락지어 지정한다.
Fast
고속의 검색 방법을 사용한다.
시스템의 칼라 모드가8비트 미만의 경우 동작하지 않는다.
24비트나32비트 쪽이 보다 고속으로 된다.
통상의 방법이 세로 방향을 먼저 검색하는데 대해,Fast모드는 횡방향을 먼저 검색하기 위해(때문에), 발견되는 좌표가 바뀌는 경우가 있다.
RGB
ColorID하지만0xRRGGBB의 포맷으로 간주해진다.

ErrorLevel

색이 발견되면 「0」, 발견되지 않으면 「1」, 문제가 발생하고 있으면 「2」

Remarks

검색 대상으로 할 수 있는 것은, 화면에 표시되고 있는 부분 뿐이어서, 윈도우의 화면에서는 봐 내고 있는 부분등의 색은 취득할 수 없다.
다만, 마우스 커서아래의 색은 취득할 수 있다.

Fast모드를 사용하지 않는 경우, 우선X1,Y1의 좌표로부터X2의 방향으로 검색되어 다음에Y2의 방향으로1열이동해 검색한다고 하는 동작을X2,Y2하지만 검색될 때까지 반복한다.

너무 넓은 범위를 검색하면, 처리 부하가 커지므로 주의.

Related

PixelGetColor, ImageSearch, CoordMode, MouseGetPos

Example(s)

PixelSearch, Px, Py, 200, 200, 300, 300, 16777215, 3, Fast
if ErrorLevel = 0
	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.