AntBot Studio > Activity > 어플리케이션제어 > 화면제어 > 이미지 찾기
정의 (Description)
- 이미지를 찾거나, 찾은 이미지를 클릭합니다.
속성 (Properties) (*은 필수값입니다.)
| 항목 | 설명 | 데이터타입 | 기본값 | 설정가능옵션 |
|---|---|---|---|---|
| Common | ||||
| Activity이름 | 해당 Activity의 이름을 설정합니다.(기본값은 Activity명이며, 사용자가 직접 변경가능함) | String | 이미지 찾기 | |
| 에러무시여부 | 에러가 발생해도, Activity를 실패로 보지 않습니다.(True : 에러가 발생해도 에러무시 / False or null : 에러발생시 에러처리) : 요소를 못찾을 경우 에러가 발생합니다. | Boolean | Null(False) | |
| 지연(시작전) | Activity 시작전에 대기시간을 갖습니다. (ms 단위, 기본 0ms) | Int32 | Null(0) | |
| 지연(완료후) | Activity 완료후에 대기시간을 갖습니다. (ms 단위, 기본 0ms) | Int32 | Null(0) | |
| 타임 아웃 | Activity 실행시 지정한 시간을 초과하면 Activity 실행이 중지하며, 타임 아웃 오류가 발생합니다. (ms 단위, 기본 15000ms) | Int32 | 15000 | |
| Option | ||||
| 이미지일치율 | 얼마의 일치율 이상의 이미지를 찾을지 설정합니다. (0 ~ 100%) 찾아낸 이미지가 여러개의 경우 일치율이 높은 대상을 찾습니다. | Int32 | 90 | |
| 재시도 횟수 | 이미지 찾기를 실패하였을 경우, 몇회 반복할지 설정합니다. (1 ~ 100) 재시도횟수가 설정될 경우 1000ms 간격으로 이미지를 횟수만큼 찾습니다. | Int32 | 1 | |
| 찾을이미지 * | 이미지파일을 경로로 선택하거나, Activity의 카메라 버튼으로 설정합니다. 카메라버튼으로 이미지 설정시 F9키를 누르면, 5초후 고정된 이미지를 선택할수 있습니다. | String | Null | |
| Option Execution | ||||
| 마우스동작 | 이미지를 찾은 후 마우스 이벤트에 대한 액션을 지정합니다. (None / LButtonClick / RButtonClick / LButtonDblClick / Hover) | String | None | |
| 마우스클릭X좌표 | 이미지를 찾은후 액션을 취할 X좌표 | Int32 | -1 | |
| 마우스클릭Y좌표 | 이미지를 찾은후 액션을 취할 Y좌표 | Int32 | -1 | |
| Output | ||||
| 결과Rectangle | 이미지가 발견된 영역을 Rectangle객체 타입의 변수에 담아 출력합니다. | System.Drawing.Rectangle | Null | |
| 결과수록 | 이미지를 찾을 결과를 Return 합니다. Boolean 변수를 설정합니다. | Boolean | Null |
액티비티 사용 예시 (Example Usage)
- 이미지 찾기 예시
- AntBot 브라우져 열기
- AntBot URL 입력 : "https://portal.antbot.co.kr/manual/Manual/index.html"
이미지 찾기 사용
2-1. 이미지 설정
- 카메라 버튼 클릭
- 찾을 이미지 설정 후 s 누르기
2-2. Option Execution 설정
- 커서 버튼 클릭
- Hover 선택
2-3. Option 및 Output 입력
- 이미지 일치율 Default값(90) 유지
- 재시도 횟수 Default값(1) 유지
- Output값에 선언한 변수 각각 입력
실행 결과 확인
- 메시지 박스 내용에 변수 값 확인을 위한 수식 작성
"이미지를 찾은 위치 : " + Rectangle.ToString +Environment.NewLine + "이미지 찾기 결과 : " + Result.ToString