ScaleParam

Class

Các tham số so khớp template cho Region.

Cú pháp

ScaleParam(grayscale=True, auto_scale=False, cache_scale=True, template_scale="SHORT_EDGE", fast_matching=False)

Tham số khởi tạo

Tên	Mô tả
`grayscaleBoolean`	Áp dụng cho template. Chuyển so khớp template sang ảnh xám. Tùy chọn · Theo vị trí hoặc tên Mặc định: `True`
`auto_scaleBoolean`	Thử kích thước template với khoảng rìa thích ứng 0.70x-1.30x sau khi scale theo cài đặt. Tùy chọn · Theo vị trí hoặc tên Mặc định: `False`
`cache_scaleBoolean`	Cache các mức auto-scale đã match thành công. Tùy chọn · Theo vị trí hoặc tên Mặc định: `True`
`template_scaleString`	Giá trị: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE. Tùy chọn · Theo vị trí hoặc tên Mặc định: `SHORT_EDGE`
`fast_matchingBoolean`	Giảm cả ảnh Region và template xuống 2/3 trước khi so khớp. Chế độ này nhanh hơn nhưng có thể giảm nhẹ độ chính xác, đặc biệt với icon nhỏ. Tùy chọn · Theo vị trí hoặc tên Mặc định: `False`

Giá trị trả về

ScaleParam

Hành vi / tác động

Các tham số so khớp template cho Region. fast_matching giảm kích thước cả ảnh Region và template.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Cấu hình tiền xử lý so khớp cho Region này
settings = ScaleParam(grayscale=True, fast_matching=True)
region = Region(100, 200, 300, 400, scale_param=settings)
print(region.find("start", timeout=0).found)

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Thuộc tính

Tên	Mô tả
`grayscaleBoolean`	Áp dụng cho template. Chuyển screenshot/template sang ảnh xám trước khi so khớp template. Mặc định: `True`
`auto_scaleBoolean`	Thử kích thước template quanh mức scale đã cấu hình bằng khoảng quét thích ứng: DPI/độ phân giải cao quét candidate nhỏ xuống 0.70x, còn DPI/độ phân giải thấp quét candidate lớn lên 1.30x. Mặc định: `False`
`cache_scaleBoolean`	Cache mức auto-scale đầu tiên match thành công cho các lần chạy sau. Chỉ có tác dụng khi auto_scale là True. Mặc định: `True`
`template_scaleString`	Mode scale template nền. Giá trị: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE. Mặc định: `SHORT_EDGE`
`fast_matchingBoolean`	Giảm cả ảnh Region và template xuống 2/3 trước khi so khớp. Chế độ này nhanh hơn nhưng có thể giảm nhẹ độ chính xác, đặc biệt với icon nhỏ. Mặc định: `False`

Ví dụ đọc thuộc tính

param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE", fast_matching=True)
param.cache_scale = False
template_mode = param.template_scale

Ví dụ khởi tạo

param = ScaleParam(grayscale=True, auto_scale=True, cache_scale=True, template_scale="LONG_EDGE", fast_matching=True)
quick = ScaleParam(False, True, True, "LONG_EDGE", True)