If images
선택된 이미지가 화면에 존재하는지 여부에 따라 분기합니다.
지정된 이미지가 화면에서 발견되는지 여부에 따라 조건부 동작 블록을 시작합니다. 카테고리 공통 입력 필드는 Images 명령어 개요 페이지를 참고하세요.
매개변수
| Argument | Type | Description |
|---|---|---|
| Images | 리스트 | 명령어에서 사용할 이미지 리스트 |
| Select image | 선택 | 사용할 이미지 선택 |
| Search for image on | 선택 | 이미지를 찾을 위치 — Entire screen / Foreground window only |
| Tolerance | 숫자 | 픽셀 컬러 매칭 허용 오차 |
| Find all images in the list | 체크 | 체크 시 리스트의 모든 이미지를 확인 |
| Option | 선택 | 분기 조건 — If image exists / If image doesn't exist |
| Search on specified subregion | — | 이미지를 찾을 영역 선택 |
반환값
반환값
조건이 참이면 1, 거짓이면 0. 장치 연결·화면 캡처·이미지 오류는 음수 에러 코드로 보고되며, 종료 수준 설정에 따라 실행이 멈춥니다.
설명
Images 의 이미지들이 화면에 존재하거나 존재하지 않을 경우, Option 설정에 따라 결과가 결정됩니다.
출력 창 표시
실행 결과는 출력 창에 한 줄로 표시됩니다. 문구는 Aurora 표시 언어를 따릅니다(아래는 한국어 UI 예).
| 상황 | 출력 창 예 |
|---|---|
| 이미지 하나를 찾음 | 찾음 'button.png' (120, 340, 64x24) 일치율 97.5% |
| 여러 이미지 중 일부를 찾음 | 2/3개 찾음 (최고 일치율 96.0%) |
| 찾지 못함 | 찾지 못함 (이미지 3개, 최고 일치율 72.4%, 허용 오차 10) |
| 리소스 이미지 파일이 없음 | 리소스 이미지가 없습니다 'button.png' |
| 화면을 캡처하지 못함 | 화면 캡처 실패 (오류 코드) |
| 조건 판정 (If images) | 위 결과 뒤에 → 참 / → 거짓이 붙어 어느 쪽으로 진행했는지 표시 |
관련 명령어