화면의 구역을 검색해 지정된 컬러의 픽셀을 찾습니다.
PixelSearch, OutputVarX, OutputVarY, X1, Y1, X2, Y2, ColorID [, Variation, Fast|RGB]
ColorID에 부합하는 첫 번째 픽셀의 X와 Y의 좌표를 저장할 변수의 이름 (부합이 발견되지 않으면, 변수는 비워집니다). 좌표는 활성 창에 상대적입니다. 단, CoordMode를 사용하여 좌표 체계를 바꾼 경우는 예외입니다.
이 매개변수가 비어 있으면, ErrorLevel (아래 참조)를 사용하여 부합이 발견되었는지 알아낼 수 있습니다.
검색할 사각 구역의 좌상 모서리의 X와 Y의 좌표. 표현식 가능. 좌표는 활성 창에 상대적입니다. 단, CoordMode를 사용하여 좌표 체계를 바꾼 경우는 예외입니다..
검색할 사각 구역의 우하 모서리의 X와 Y의 좌표. 표현식 가능. 좌표는 활성 창에 상대적입니다. 단, CoordMode를 사용하여 좌표 체계를 바꾼 경우는 예외입니다.
검색에 사용할 청-녹-적(Blue-Green-Red (BGR)) 형식의 십육진 또는 십진 컬러 ID. 표현식 가능. Color ID는 Window Spy를 사용하여 또는 PixelGetColor를 통하여 알아낼 수 있습니다 (트레이 메뉴로 접근 가능). 예를 들어: 0x9d6346.
0과 255 (포함) 사이의 값. 컬러의 적녹청 채도에 대하여 방향에 관계없이 몇 개의 쉐이드 변형을 허용할지 나타냅니다. (표현식 가능). 이 매개변수는 구하는 컬러가 언제나 정확하게 같은 쉐이드가 아닐 경우 유용합니다. 255 쉐이드의 변형을 지정했다면, 모든 컬러가 부합합니다. 기본값은 0 쉐이드입니다.
이 매개변수는 단어 Fast, RGB를 담거나 또는 둘 담을 수 있습니다 (둘 다 존재하면, 스페이스로 둘사이를 가르십시오; 즉, Fast RGB).
Fast: 빠른 검색 방법을 사용합니다. 대부분의 경우 검색에 사용된 CPU 시간의 양을 극적으로 줄여줍니다. 8-비트 (256-색) 컬러 깊이를 지원하지만, 빠른 모드는 24-비트 또는 32-비트 컬러에서 훨씬 더 빠릅니다. 화면의 컬러 깊이가 16-비트 이하라면, Variation 매개변수는 빠른 모드에서 느린 모드와 약간 다르게 행동할 수도 있습니다. 마지막으로, 빠른 모드는 화면을 컬럼 단위가 아니라 줄 단위로 (위에서 아래로) 검색합니다. 그러므로, 부합하는 픽셀이 많은 경우 느린 모드에서 발견되는 픽셀과 다른 픽셀을 발견할 수도 있습니다.
RGB: ColorID는 BGR이 아니라 RGB 값으로 번역됩니다. 다른 말로, 적과 청 구성요소가 서로 바뀝니다.
[v1.1.04+] 이 명령어는 검색하는 동안 문제가 있으면 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.
ErrorLevel은 지정된 구역에서 컬러를 발견하였으면 0이 설정되고, 발견하지 못했으면 1이 설정됩니다. 아니면 문제가 있어서 검색을 수행하지 못했으면 2가 설정됩니다.
검색될 구역은 반드시 보여야 합니다; 다른 말로, 창에서 또다른 창에 가려진 구역은 검색이 불가능하니다. 대조적으로, 마우스 커서 아래의 픽셀은 보통 탐지할 수 있습니다. 이에 대한 예외는 게임 커서입니다. 대부분의 경우 게임 커서는 자신의 아래에 있는 픽셀들을 감춥니다.
Slow 모드 전용: 기본값으로, 검색은 해당 구역의 좌상 모서리로부터 시작하여 수직으로 내려가며 픽셀이 부합하는지 맞추어 봅니다. 부합을 발견하지 못하면, 검색은 컬럼 오른쪽에서 부합하는 픽셀을 찾을 때까지 계속됩니다. 기본값이 좌에서 우로 검색 순서는 매개변수 리스트에서 X1와 X2를 바꾸면 뒤집어 집니다. 다른 말로, X1이 X2보다 더 크면, 검색은 X1컬럼에서 시작하여, 오른쪽에서 왼쪽으로 수행됩니다. 비슷하게, Y1이 Y2보다 크면, 검색될 픽셀 컬럼이 위가 아니라 아래부터 시작합니다. 마지막으로, 검색될 구역이 방대하고 검색이 높은 빈도록 반복되면, CPU 시간을 많이 소비할 수 있습니다. 이를 경감하려면, 검색 구역의 크기를 최소한으로 유지하십시오.
PixelGetColor, ImageSearch, CoordMode, MouseGetPos
PixelSearch, Px, Py, 200, 200, 300, 300, 0x9d6346, 3, Fast
if ErrorLevel
MsgBox, 해당 컬러를 지정된 구역에서 발견하지 못했습니다.
else
MsgBox, 3 쉐이드의 변형 안에서 컬러가 X%Px% Y%Py%에서 발견되었습니다.