If_PixelSearch

If_PixelSearch는 사용자가 지정한 모니터 화면의 특정 범위(사각형 영역) 안에서

특정 색상의 픽셀을 찾아내는 조건문 명령어입니다.

 

단일 좌표만 확인하는 If_Pixel과 달리, 넓은 영역 내에서 원하는 색상이 어디에 있는지 찾아낼 때 사용하며,

검색 성공 시 해당 픽셀의 위치 좌표를 자동으로 반환하는 강력한 기능을 제공합니다.

 

스크립트 명령어 사용방법

< If_PixelSearch,숫자1,숫자2,숫자3,숫자4,색정보,허용수치 >

 

사용 값

숫자1	범위 시작위치 가로(X) 값을 의미합니다.
숫자2	범위 시작위치 세로(Y) 값을 의미합니다.
숫자3	범위 가로넓이(Width) 값을 의미합니다.
숫자4	범위 세로높이(Height) 값을 의미합니다.
색정보	RGB 색상코드를 의미합니다. (FF0000,00FF00,0000FF)
스크립트1	설정한 범위에서 픽셀을 찾으면  - 기호 대괄호 [ , ] 묶은 내용만 스크립트1 실행 합니다. 설정한 범위에서 픽셀을 못 찾으면  - 기호 대괄호 [ , ] 묶은 내용을 스크립트1 실행하지 않습니다.
허용수치	픽셀서치의 허용수치를 의미 합니다. ( 0 = 완전일치 )
반환값	픽셀을 찾는경우, 픽셀 위치정보 값 X,Y변수값이 자동으로 생성 됩니다.

추가설명

• 변수 자동 생성: 이 명령어의 가장 큰 장점은 찾은 위치의 좌표를 별도 설정 없이 바로 X와 Y 변수로
  사용할 수 있다는 점입니다. 이를 통해 찾은 위치를 즉시 클릭하거나 이동할 수 있습니다.
• 조건문 규칙: If_로 시작하는 명령어는 파란색으로 표시되는 조건문이며, 반드시 <If~...>[ ] 형태를 유지해야 합니다.
• 주의 (공백 에러): <If_PixelSearch,...> 태그와 여는 대괄호 [ 사이에 공백이 있으면 안 됩니다.
  • (정상: <If_PixelSearch,...>[, 에러: <If_PixelSearch,...> [ )
• 문제 해결: 픽셀을 찾지 못할 경우 윈도우 디스플레이 설정에서 **'배율'을 100%**로 설정했는지 확인하세요.

 

사용예제1

<If_PixelSearch,0,0,100,100,FF0000,0>[
<MouseMove,X,Y>
<Msg_box,색 일치>
]

설명: 화면의 (0,0)부터 가로 100, 세로 100 범위 내에서 빨간색(FF0000)을 찾습니다. 찾게 되면 자동 생성된 X, Y 좌표로 마우스 커서를 이동시킨 후 "색 일치" 메시지를 띄웁니다.

 

 

사용예제2 (대기 기능 - 픽셀이 나타날 때까지)

<Loop_A>
<If_PixelSearch,0,0,100,100,FF0000,0>[<ExitLoop>]
<Delay,10>
<Goto_A>
ABCDEFG

설명:  Loop_A를 통해 범위 내에 빨간색이 나타날 때까지 반복해서 검색합니다. 색상을 찾는 순간 ExitLoop를 통해 반복문을 빠져나와 아래에 있는 "ABCDEFG" 타이핑 작업을 수행합니다.

 

 

언제 사용하면 좋은지 예제

• 유동적인 버튼 클릭: 버튼의 위치가 매번 조금씩 달라지는 웹페이지나 게임에서 버튼의 특정 색상을 찾아 정확히 클릭해야 할 때 사용합니다.
• 아이템/오브젝트 감지: 화면 내 특정 영역에 아이템이 드롭되거나 몬스터가 나타나는지 실시간으로 감시할 때 유용합니다.
• 진행 바 확인: 로딩 바나 게이지가 특정 지점까지 차오르는 것을 범위로 지정해 확인하고 다음 동작을 수행할 때 사용합니다.

 

사용 이점 요약

• 정밀한 탐색: 단일 점이 아닌 넓은 영역을 훑기 때문에 변화에 유연하게 대응합니다.
• 좌표 자동 획득: 찾은 위치의 좌표를 계산할 필요 없이 변수(X, Y)로 바로 활용할 수 있어 스크립트가 간결해집니다.
• 오차 허용: '허용수치'를 통해 미세한 색감 차이가 있는 환경에서도 안정적으로 동작합니다.