Match

Đọc kết quả của một lần tìm kiếm nhận diện. Kiểm tra found trước khi nhấn hoặc dùng vị trí; lần tìm ảnh thất bại vẫn có thể chứa vị trí ứng viên giống nhất.

Cú pháp

Match

Không thể khởi tạo trực tiếp lớp này.

Giá trị trả về

—

Ví dụ

m = Region(100, 200, 300, 400).find("btn", 3000)
if m.found:
    click(m)
    conf = m.confidence

# Recognition.result chỉ có sẵn trong Python của nhánh Thành công nhận diện.
if Recognition.result.found:
    click(Recognition.result, random=0)

Thuộc tính

TênMô tả
nameString?
Tên mục tiêu đã khớp. Nhận diện template dùng tên template không có đuôi file, OCR dùng chính văn bản mục tiêu đã khớp, còn nhận diện màu dùng Color.
foundBoolean
Có tìm thấy kết quả khớp hay không.
confidenceNumber
Điểm độ tin cậy từ 0.0 đến 1.0.
confNumber
Bí danh của confidence; trả về cùng điểm độ tin cậy từ 0.0 đến 1.0.
pointPoint? | list[Point]
Vị trí kết quả: Point, list các Point hoặc None. Tìm màu trả về list, có thể rỗng. Kiểm tra found và dạng giá trị trước khi đọc tọa độ hoặc lấy phần tử list.
boundsRegion?
Hình chữ nhật bao quanh kết quả, hoặc None nếu không có. Tìm ảnh thất bại vẫn có thể cung cấp vùng của ứng viên giống nhất; hãy kiểm tra found trước.
regionRegion?
Bí danh của bounds; trả về cùng Region đã khớp hoặc None.
inference_infodict?
Thông tin bổ sung của kết quả, hoặc None. Kết quả mô hình có thể gồm class_id, class_name, thời gian ở các trường kết thúc bằng _ms (mili giây), input_width/input_height (pixel). Kết quả màu có thể gồm target_color, sampled_color, max_channel_delta, match_count và matches. Các khóa tùy theo phép tìm; kiểm tra khóa tồn tại trước khi đọc.
Ví dụ đọc thuộc tính
# Đọc an toàn thông tin tùy chọn và các điểm màu.
m = Region(100, 200, 300, 400).find("btn", 3000)
target_name = m.name
is_found = m.found
score = m.confidence
short_score = m.conf
center = m.point
box = m.bounds
same_box = m.region
info = m.inference_info
if info is not None:
    info_class_id = info.get("class_id")
    info_class_name = info.get("class_name")

color_hit = Region(0, 0, 1080, 1920).find_color("#FFFFFF", tolerance=4)
color_name = color_hit.name
if color_hit.found and color_hit.point:
    first_color_point = color_hit.point[0]

# Trong nhánh Thành công của nhận diện:
current = Recognition.result
if current.found:
    text(current.name)
    current.highlight(color="yellow", auto_hide_ms=800)

Phương thức

2 phương thức

Match.highlight

Đánh dấu kết quả tìm thấy trên màn hình. Vẽ bounds nếu có, nếu không thì vẽ hình vuông quanh từng điểm; không vẽ khi found=false. Khung được lên lịch vẽ nên lời gọi có thể trả về trước khi khung xuất hiện. Với cùng một đối tượng, chỉ cập nhật đang chờ mới nhất được vẽ ở khung hình màn hình kế tiếp.

Cú pháp

match.highlight(color="green", line_width=2, region_width=36, auto_hide_ms=0)

Tham số

TênMô tả
colorColor | String | Number
Màu highlight.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: green
line_widthNumber
Độ dày viền tính bằng pixel, tối thiểu 1.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 2
region_widthNumber
Độ rộng hình vuông tính bằng pixel khi chỉ có điểm, tối thiểu 1.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 36
auto_hide_msNumber
Thời gian trước khi ẩn, tính bằng mili giây. 0 hoặc giá trị âm giữ khung hiển thị cho đến khi gọi highlight_off().
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0

Giá trị trả về

Match — Chính Match này để bạn có thể gọi tiếp phương thức của nó.

Ví dụ

m = Region(100, 200, 300, 400).find("start", 3000)
m.highlight(color="yellow", line_width=3, auto_hide_ms=1200)

Match.highlight_off

Tắt highlight đang hoạt động được tạo từ match instance này.

Cú pháp

match.highlight_off()

Giá trị trả về

Match — Trả về chính match sau khi tắt highlight.

Ví dụ

m = Region(100, 200, 300, 400).find("start", 3000)
m.highlight()
m.highlight_off()