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 변수로 즉시 활용 가능하여 효율적입니다.
'심플 프로그램 > ├심플핫키 명령어 설명' 카테고리의 다른 글
| If_PixelSearch (1) | 2026.01.20 |
|---|---|
| If_Pixel (0) | 2025.12.11 |
| Cursor_Not_Pixel (0) | 2025.11.13 |
| Cursor_Pixel (0) | 2025.10.29 |
| OCR_File (0) | 2025.10.13 |






