If_PixelSearch_Loop

If_PixelSearch_Loop는 지정한 시간 동안 화면의 특정 범위(사각형 영역)를 지속적으로 감시하여 특정

색상의 픽셀이 나타나는지 찾아내는 '대기형' 조건문 명령어입니다.

단순히 한 번 검사하고 끝나는 것이 아니라, 설정한 시간(Timeout) 동안 픽셀이 나타날 때까지 반복해서

서치하므로 유동적인 화면 변화에 대응하기 매우 강력한 도구입니다.

 

스크립트 명령어 사용방법

<If_PixelSearch_Loop,숫자1,숫자2,숫자3,숫자3,색정보,허용수치,숫자5>

 

사용 값

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

 

추가설명

• 반복 서치 및 타임아웃: 숫자5에 입력한 시간 동안 픽셀을 계속 찾습니다. 시간 내에 찾으면 즉시 다음 스크립트를 수행하고, **시간이 초과(Timeout)**될 때까지 못 찾으면 대괄호 안의 내용을 무시하고 다음으로 넘어갑니다.
• 변수 자동 생성: 픽셀을 찾으면 해당 위치의 좌표가 X와 Y라는 변수에 자동으로 저장됩니다. 이를 통해 찾은 위치를 즉시 클릭하거나 이동할 수 있습니다.
• 조건문 규칙: If_로 시작하는 모든 명령어는 파란색으로 표시되는 조건문입니다. 반드시 <If~...>[ ] 형태를 유지해야 합니다.
• 주의 (공백 에러): 명령어 태그 끝(>)과 여는 대괄호([) 사이에 공백이 있으면 안 됩니다.
  • 정상: <If_PixelSearch_Loop,...>[
  • 에러: <If_PixelSearch_Loop,...> [

 

사용예제1

<If_PixelSearch_Loop,0,0,100,100,0000FF,0,5000ms>[
<MouseMove,X,Y>
]

설명:  화면의 (0,0)부터 가로 100, 세로 100 범위 내에서 파란색(0000FF)을 5초(5000ms) 동안 반복해서 서치합니다. 5초 안에 픽셀을 찾으면 자동으로 생성된 X, Y 좌표로 마우스 커서를 이동시킵니다. 만약 5초 안에 찾지 못하면 대괄호 안의 스크립트를 무시하고 다음 단계로 넘어갑니다.

 

 

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

<If_PixelSearch_Loop,0,0,100,100,0000FF,0,5000>[
<MouseMove,X,Y>
<Msg_box,파란색 발견>
]

설명:  화면의 (0,0)부터 가로 100, 세로 100 범위 내에서 **파란색(0000FF)**을 5초 동안 찾습니다. 5초 이내에 찾게 되면 자동 생성된 X, Y 좌표로 마우스 커서를 이동시킨 후 메시지 박스를 띄웁니다. 만약 5초 동안 찾지 못하면 아무 작업 없이 다음 스크립트로 넘어갑니다.

 

 

언제 사용하면 좋은지 예제

• 유동적인 로딩 대기: 웹페이지나 게임에서 특정 버튼이 나타나는 시간이 매번 다를 때, 해당 버튼의 색상을 지정하여 나타날 때까지 기다린 후 클릭할 때 유용합니다.
• 오브젝트 자동 감지: 화면 내 특정 영역에 아이템이 드롭되거나 몬스터가 젠되는 것을 최대 대기 시간을 두고 실시간으로 감시할 때 유용합니다.
• 조건부 타이핑/매크로: 특정 색상이 감지되었을 때만 연속적인 키보드 입력(타이핑)이나 마우스 동작을 수행하고자 할 때 사용합니다.

 

사용 이점 요약

• 대기 최적화: 별도의 Loop나 Delay 구문 없이도 지정한 시간만큼 스마트하게 대기할 수 있어 스크립트가 매우 간결해집니다.
• 정밀한 탐색: 넓은 영역을 지속적으로 훑기 때문에 화면의 미세한 변화나 지연 현상에도 유연하게 대응합니다.
• 좌표 자동 획득: 찾은 위치의 좌표를 별도 계산 없이 X, Y 변수로 즉시 활용 가능하여 효율적입니다.