Region

Một vùng chữ nhật trên màn hình để tìm ảnh hoặc màu, chụp ảnh hoặc vẽ khung đánh dấu. Tọa độ dùng pixel theo trục ngang/dọc hiện tại; sau khi điều chỉnh kích thước và độ lệch, chỉ phần trong màn hình được sử dụng. Đọc kích thước bằng x, y, width, height = region.

Cú pháp

Region(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())

Tham số khởi tạo

TênMô tả
xNumber
Tọa độ X góc trên trái
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
yNumber
Tọa độ Y góc trên trái
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
widthNumber
Chiều rộng vùng
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
heightNumber
Chiều cao vùng
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
scaleString
Cách điều chỉnh tọa độ giữa các màn hình: fixed giữ pixel; auto đổi X theo tỉ lệ chiều rộng, Y theo tỉ lệ chiều cao; width hoặc height đổi cả hai trục theo kích thước đó. Dùng kích thước màn hình nguồn của macro, không xoay trục và không dùng kích thước cửa sổ app.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: fixed
anchorString
Vị trí làm mốc khi điều chỉnh tọa độ: none (góc trên trái), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. auto chọn cạnh hoặc tâm gần nhất.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: none
scale_paramScaleParam
**Áp dụng cho template**. Tham số scale template.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: ScaleParam()

Giá trị trả về

Ví dụ

region = Region(100, 200, 300, 400)
hit = region.find("img", 3000, threshold=0.8, rate=3.0)

Thuộc tính

TênMô tả
xNumber
Tọa độ ngang góc trên trái.
yNumber
Tọa độ dọc góc trên trái.
widthNumber
Chiều rộng vùng theo pixel.
heightNumber
Chiều cao vùng theo pixel.
scaleString
Cách điều chỉnh tọa độ giữa các màn hình: fixed giữ pixel; auto đổi X theo tỉ lệ chiều rộng, Y theo tỉ lệ chiều cao; width hoặc height đổi cả hai trục theo kích thước đó. Dùng kích thước màn hình nguồn của macro, không xoay trục và không dùng kích thước cửa sổ app.
Mặc định: fixed
anchorString
Vị trí làm mốc khi điều chỉnh tọa độ: none (góc trên trái), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. auto chọn cạnh hoặc tâm gần nhất.
Mặc định: none
scale_paramScaleParam
**Áp dụng cho template**. Tham số scale template dùng bởi các hàm find/wait trên region này.
Mặc định: ScaleParam()
middle_pointPoint
Điểm chính giữa của region này.
Ví dụ đọc thuộc tính
search_area = Region(120, 240, 360, 420)
left = search_area.x
top = search_area.y
w = search_area.width
h = search_area.height
scale = search_area.scale
anchor = search_area.anchor
search_area.x = 300
search_area.scale_param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE")
center = search_area.middle_point

# Bung Region thành x, y, width, height
x, y, width, height = search_area
Ví dụ khởi tạo
search_region = Region(120, 240, 360, 420)
fixed_center = Region(120, 240, 360, 420, "fixed", "center")
left_lane = Region(120, 240, 360, 420, scale="width", anchor="left", scale_param=ScaleParam(auto_scale=True, template_scale="LONG_EDGE"))

Phương thức

30 phương thức

Region.from_center

Tạo Region cố định, không anchor từ tọa độ tâm hữu hạn và kích thước hữu hạn dương. Giữ nguyên tọa độ lẻ.

Cú pháp

Region.from_center(cx, cy, width, height)

Tham số

TênMô tả
cxNumber
Tọa độ X của tâm.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
cyNumber
Tọa độ Y của tâm.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
widthNumber
Chiều rộng dương.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
heightNumber
Chiều cao dương.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Region — Tọa độ và các cạnh sau tính toán phải hữu hạn; nếu không sẽ báo lỗi.

Ví dụ

# Tạo vùng quanh một tâm
area = Region.from_center(100, 200, 50, 30)

Region.highlighted

Trả về các vùng màn hình đang được script đánh dấu, gồm cả khung vuông tạo bởi Point.highlight().

Cú pháp

Region.highlighted()

Giá trị trả về

list[Region] — Danh sách các region highlight đang còn hiệu lực.

Ví dụ

active_regions = Region.highlighted()
for area in active_regions:
    area.highlight("yellow", auto_hide_ms=500)

Region.full_screen

Trả về region toàn màn hình hiện tại.

Cú pháp

Region.full_screen()

Giá trị trả về

Region — Region phủ toàn màn hình hiện tại từ (0, 0).

Ví dụ

scan = Region.full_screen()
hit = scan.find("ok", 2000)

Region.highlight_off

Tắt toàn bộ region highlight đang hoạt động.

Cú pháp

Region.highlight_off()

Giá trị trả về

None — Không trả về giá trị.

Ví dụ

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
Region.highlight_off()

Region.macro_width

Trả về chiều rộng màn hình của thiết bị đã tạo macro này theo hướng xoay màn hình hiện tại, nếu có.

Cú pháp

Region.macro_width()

Giá trị trả về

Number? — Chiều rộng màn hình nguồn của macro, hoặc None nếu không có.

Ví dụ

macro_w = Region.macro_width()

Region.macro_height

Trả về chiều cao màn hình của thiết bị đã tạo macro này theo hướng xoay màn hình hiện tại, nếu có.

Cú pháp

Region.macro_height()

Giá trị trả về

Number? — Chiều cao màn hình nguồn của macro, hoặc None nếu không có.

Ví dụ

macro_h = Region.macro_height()

Region.intersection

Trả Region mới là phần giao có diện tích dương, hoặc None. Hai cạnh chỉ chạm nhau không giao nhau. Dùng tọa độ đã lưu trong cùng hệ tọa độ, không chụp, đổi tỉ lệ hay cắt; giữ scale, anchor và scale_param của Region này, không thay đổi đối tượng gốc.

Cú pháp

region.intersection(other)

Tham số

TênMô tả
otherRegion
Vùng còn lại.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Region? — Tọa độ và các cạnh sau tính toán phải hữu hạn; nếu không sẽ báo lỗi.

Ví dụ

# Tìm vùng giao nhau
overlap = Region(0, 0, 100, 100).intersection(Region(50, 50, 100, 100))

Region.intersects

Kiểm tra phần giao có diện tích dương bằng tọa độ đã lưu trong cùng hệ tọa độ. Hai cạnh chỉ chạm nhau không giao; không chụp, đổi tỉ lệ hay cắt.

Cú pháp

region.intersects(other)

Tham số

TênMô tả
otherRegion
Vùng còn lại.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean — Tọa độ và các cạnh sau tính toán phải hữu hạn; nếu không sẽ báo lỗi.

Ví dụ

# Kiểm tra hai vùng có giao nhau
print(Region(0, 0, 100, 100).intersects(Region(50, 50, 20, 20)))

Region.contains

Kiểm tra bao chứa bằng tọa độ đã lưu trong cùng hệ tọa độ, không chụp, đổi tỉ lệ hay cắt. Point được tính ở cạnh trái và trên, không tính ở cạnh phải và dưới. Region có thể trùng cạnh; kích thước rỗng hoặc âm trả False.

Cú pháp

region.contains(point_or_region)

Tham số

TênMô tả
point_or_regionPoint | Region
Điểm hoặc vùng cần kiểm tra.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean — Tọa độ và các cạnh sau tính toán phải hữu hạn; nếu không sẽ báo lỗi.

Ví dụ

# Kiểm tra điểm có nằm trong vùng
print(Region(0, 0, 100, 100).contains(Point(10, 10)))

Region.find_text

Tìm chữ bằng OCR trong vùng này theo pixel màn hình. Kết quả phải khớp từ hoặc cụm từ trọn vẹn, không cắt giữa chữ cái, chữ số hoặc dấu gạch dưới. Chức năng chụp màn hình phải sẵn sàng. Thử lại đến khi tìm thấy hoặc hết thời gian, có hỗ trợ tạm dừng và dừng; bộ nhớ đệm ảnh chụp hoạt động như các phép nhận diện khác. Lỗi OCR hoặc chụp màn hình sẽ được báo lỗi.

Cú pháp

region.find_text(text, timeout=0, threshold=100, rate=5, language="latin", preserve_case=False)

Tham số

TênMô tả
textString
Chữ cần tìm; không được để trống.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây; 0 hoặc số âm quét một lần.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdInteger
Ngưỡng khớp OCR là số nguyên từ 0 đến 100; 100 yêu cầu khớp chính xác sau chuẩn hóa.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 100
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, tính bằng Hz, giới hạn từ 1 đến 60.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 5
languageString
Hệ chữ OCR: latin, chinese, devanagari, japanese hoặc korean. Giá trị khác, kể cả bí danh ngôn ngữ theo vùng, sẽ gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: "latin"
preserve_caseBoolean
Phân biệt chữ hoa và chữ thường khi là True; mặc định không phân biệt.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False

Giá trị trả về

Match — Match tìm thấy có bounds và point theo pixel toàn màn hình, confidence từ 0 đến 1 và name là chữ mục tiêu đã khớp. Nếu không tìm thấy, found=False. Các vị trí riêng biệt cùng đạt điểm cao nhất sẽ gây lỗi mơ hồ; hãy thu hẹp vùng tìm kiếm. Các kết quả chồng nhau được tính là một vị trí.

Ví dụ

# Tìm và nhấn nút OK trong cửa sổ bật lên
hit = Region(500, 100, 400, 300).find_text("OK", timeout=3000)
if hit.found:
    click(hit)

Region.find

Tìm một vị trí khớp ảnh mẫu trong vùng này. Thử lại đến khi tìm thấy hoặc hết thời gian; timeout=0 quét một lần. Cần sẵn sàng chụp màn hình. ScreenCapture.cache_on() cho các lần tìm dùng lại một ảnh chụp đến khi gọi cache_off(); nếu không, ảnh vẫn được tự động dùng lại tối đa 100 ms. Dùng auto_cache_off() để lấy ảnh mới nhất hiện có, nhưng sẽ cần chụp nhiều hơn.

Cú pháp

region.find(template, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateString | Template
Tên ảnh mẫu hoặc đường dẫn thư mục tương đối không kèm đuôi ảnh trong macro hiện tại, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

Match — Match có found=True khi tìm thấy; nếu không, found=False sau lượt quét hoặc khi hết thời gian. Không trả None.

Ví dụ

region = Region(80, 220, 420, 520)
hit = region.find("ok", 4000, 0.8, 4.0)
MacroPanel.notify(str(hit))

Region.find_multi

Quét trong region này và trả về tất cả kết quả khớp cho một template khi tìm thấy ít nhất một kết quả. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.find_multi(template, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateString | Template
Tên ảnh mẫu hoặc đường dẫn thư mục tương đối không kèm đuôi ảnh trong macro hiện tại, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

MatchList — Tất cả kết quả khớp cho template, hoặc danh sách rỗng khi hết thời gian chờ.

Ví dụ

region = Region(80, 220, 420, 520)
matches = region.find_multi("enemy", 3000)
MacroPanel.notify(str(matches))

Region.find_any

Quét region này và trả về khi bất kỳ template nào trong danh sách được tìm thấy. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.find_any(templates, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateslist[String | Template]
Tên ảnh mẫu/đường dẫn thư mục tương đối không kèm đuôi ảnh, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

MatchList — Một Match cho mỗi ảnh mẫu theo thứ tự đầu vào khi tìm thấy ít nhất một ảnh; một số mục có thể có found=False. MatchList rỗng nếu không tìm thấy ảnh nào trước khi hết thời gian.

Ví dụ

region = Region(80, 220, 420, 520)
matches = region.find_any(["enemy_a", "enemy_b"], 2500)
MacroPanel.notify(str(matches))

Region.find_all

Quét region này và chỉ trả về khi toàn bộ template trong danh sách đều được tìm thấy. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.find_all(templates, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateslist[String | Template]
Tên ảnh mẫu/đường dẫn thư mục tương đối không kèm đuôi ảnh, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

MatchList — Một Match tìm thấy cho mỗi ảnh mẫu theo thứ tự đầu vào, hoặc MatchList rỗng nếu không có lượt quét nào tìm đủ trước khi hết thời gian.

Ví dụ

region = Region(80, 220, 420, 520)
matches = region.find_all(["hp", "mp"], 5000)
MacroPanel.notify(str(matches))

Region.find_color

Tìm một pixel được kiểm tra có màu gần mục tiêu nhất trong vùng này. Sai lệch của từng kênh đỏ, xanh lá và xanh dương không được vượt tolerance; chọn điểm có sai lệch lớn nhất giữa các kênh nhỏ nhất. Thử lại đến khi tìm thấy hoặc hết thời gian; timeout=0 quét một lần. Cần sẵn sàng chụp màn hình.

Cú pháp

region.find_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Tham số

TênMô tả
colorColor | String | Number
Màu mục tiêu.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
toleranceNumber
Sai số RGB cho phép trên từng kênh từ 0 đến 255.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3
intervalNumber
Khoảng cách yêu cầu theo pixel giữa các vị trí được kiểm tra; tối thiểu 1. Giá trị nhỏ kiểm tra nhiều pixel hơn và có thể lâu hơn. Khoảng cách có thể tự tăng khi vùng lớn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 10

Giá trị trả về

Match — Match có tối đa một Point trong point, hoặc found=False và danh sách point rỗng nếu không có pixel được kiểm tra nào khớp hoặc không thể chụp.

Ví dụ

scan = Region(80, 220, 420, 520)
hit = scan.find_color("#FF4CAF50", tolerance=8, interval=4)
if hit.found:
    click(hit.point[0], random=0)

Region.find_any_color

Tìm bất kỳ màu mục tiêu nào trong vùng này theo quy tắc sai số RGB của find_color. Mỗi màu tìm thấy trả tối đa một điểm được kiểm tra tốt nhất, theo thứ tự đầu vào. Thử lại đến khi tìm thấy ít nhất một màu hoặc hết thời gian; timeout=0 quét một lần. Cần sẵn sàng chụp màn hình.

Cú pháp

region.find_any_color(colors, timeout=0, tolerance=0, rate=3, interval=10)

Tham số

TênMô tả
colorslist[Color | String | Number] | tuple[Color | String | Number]
Danh sách màu mục tiêu.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
toleranceNumber
Sai số RGB cho phép trên từng kênh từ 0 đến 255.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3
intervalNumber
Khoảng cách yêu cầu theo pixel giữa các vị trí được kiểm tra; tối thiểu 1. Giá trị nhỏ kiểm tra nhiều pixel hơn và có thể lâu hơn. Khoảng cách có thể tự tăng khi vùng lớn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 10

Giá trị trả về

Match — Match có một Point tốt nhất cho mỗi màu tìm thấy trong point, theo thứ tự đầu vào. found=False và danh sách point rỗng nếu không có màu khớp hoặc không thể chụp.

Ví dụ

colors = ["#FF0000", "#00FF00", "#0000FF"]
hit = Region.full_screen().find_any_color(colors, tolerance=6)
if hit.found:
    click(hit, random=0)

Region.find_multi_color

Tìm mọi pixel được kiểm tra khớp một màu mục tiêu theo quy tắc sai số RGB của find_color. Danh sách hoặc tuple màu sẽ gây lỗi. Thử lại đến khi tìm thấy ít nhất một điểm hoặc hết thời gian; timeout=0 quét một lần. Cần sẵn sàng chụp màn hình.

Cú pháp

region.find_multi_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Tham số

TênMô tả
colorColor | String | Number
Một màu mục tiêu.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
toleranceNumber
Sai số RGB cho phép trên từng kênh từ 0 đến 255.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3
intervalNumber
Khoảng cách yêu cầu theo pixel giữa các vị trí được kiểm tra; tối thiểu 1. Giá trị nhỏ kiểm tra nhiều pixel hơn và có thể lâu hơn. Khoảng cách có thể tự tăng khi vùng lớn.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 10

Giá trị trả về

Match — Match chứa các Point được kiểm tra khớp màu trong point, màu gần nhất đứng trước. found=False và danh sách point rỗng nếu không có điểm khớp hoặc không thể chụp.

Ví dụ

hit = Region(80, 220, 420, 520).find_multi_color("red", tolerance=4, interval=3)
if hit.found:
    first = hit.point[0]
    hit.highlight(color="yellow", auto_hide_ms=800)

Region.wait

Chờ cho đến khi template biến mất khỏi region này. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.wait(template, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateString | Template
Tên ảnh mẫu hoặc đường dẫn thư mục tương đối không kèm đuôi ảnh trong macro hiện tại, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

Match — Match mới nhất: found=False nghĩa là không thấy ảnh; found=True nghĩa là vẫn thấy ảnh khi kết thúc chờ. Không trả None. Cần sẵn sàng chụp màn hình; không thể chụp cũng có thể trả found=False.

Ví dụ

region = Region(0, 0, 1080, 2400)
result = region.wait("loading", 8000)
MacroPanel.notify(str(result))

Region.wait_any

Chờ đến khi có ít nhất một template trong danh sách biến mất khỏi region này. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.wait_any(templates, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateslist[String | Template]
Tên ảnh mẫu/đường dẫn thư mục tương đối không kèm đuôi ảnh, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

MatchList — Match mới nhất của mỗi ảnh mẫu theo thứ tự đầu vào khi có ảnh biến mất hoặc hết thời gian. Kiểm tra found của từng mục; False nghĩa là không thấy ảnh đó. Cần sẵn sàng chụp màn hình; không thể chụp cũng có thể trả found=False.

Ví dụ

watch = ["loading", "syncing"]
result = region.wait_any(watch, 10000)
MacroPanel.notify(str(result))

Region.wait_all

Chờ đến khi tất cả template trong danh sách đều biến mất khỏi region này. Nếu bỏ qua timeout, hệ thống chỉ quét đúng một lần.

Cú pháp

region.wait_all(templates, timeout=0, threshold=0.7, rate=3.0)

Tham số

TênMô tả
templateslist[String | Template]
Tên ảnh mẫu/đường dẫn thư mục tương đối không kèm đuôi ảnh, hoặc đối tượng Template. Tên không tồn tại sẽ gây lỗi.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
timeoutNumber
Thời gian chờ tối đa theo mili giây. Bỏ qua, 0 hoặc số âm thì quét một lần. Lượt quét đang chạy có thể kết thúc sau thời gian này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
thresholdNumber
Ngưỡng khớp từ 0.0 đến 1.0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.7
rateNumber
Số lượt quét yêu cầu mỗi giây khi chờ, giới hạn từ 1 đến 60. Tốc độ thực tế phụ thuộc thời gian nhận diện.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3.0

Giá trị trả về

MatchList — Match mới nhất của mỗi ảnh mẫu theo thứ tự đầu vào khi ảnh biến mất hoặc hết thời gian. Mọi giá trị found đều False chỉ khi không thấy ảnh nào. Cần sẵn sàng chụp màn hình; không thể chụp cũng có thể trả found=False.

Ví dụ

watch = ["loading", "syncing"]
result = region.wait_all(watch, 10000)
MacroPanel.notify(str(result))

Region.capture

Chụp vùng màn hình này thành Template. Cần phiên chụp màn hình đang hoạt động đã được người dùng cho phép. Báo lỗi nếu không thể chụp hoặc vùng nằm hoàn toàn ngoài màn hình.

Cú pháp

region.capture(name=None)

Tham số

TênMô tả
nameString?
Truyền tên để lưu ảnh ngay vào macro hiện tại; None tạo ảnh tạm. Không được lưu ảnh có tên trong macro được bảo vệ.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None

Giá trị trả về

Template — Template chứa ảnh vừa chụp.

Ví dụ

sample = Region(120, 280, 220, 120).capture()
saved = sample.save_as("buttons/top/enemy_slot")

Region.left

Thu nhỏ region về phía trái. Cạnh phải sẽ dịch sang trái theo giá trị yêu cầu.

Cú pháp

region.left(value=0.5)

Tham số

TênMô tả
valueNumber
Chiều rộng cần bỏ: 0-1 là tỉ lệ chiều rộng hiện tại; trên 1 là pixel, tối đa bằng toàn bộ chiều rộng. Giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region mới được thu từ cạnh phải.

Ví dụ

full = Region(100, 200, 1000, 500)
left_focus = full.left(0.4)
left_focus_px = full.left(400)

Region.right

Thu nhỏ region về phía phải. Cạnh trái sẽ dịch sang phải theo giá trị yêu cầu.

Cú pháp

region.right(value=0.5)

Tham số

TênMô tả
valueNumber
Chiều rộng cần bỏ: 0-1 là tỉ lệ chiều rộng hiện tại; trên 1 là pixel, tối đa bằng toàn bộ chiều rộng. Giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region mới được thu từ cạnh trái.

Ví dụ

full = Region(100, 200, 1000, 500)
right_focus = full.right(0.3)
right_focus_px = full.right(240)

Region.top

Thu nhỏ region về phía trên. Cạnh dưới sẽ dịch lên theo giá trị yêu cầu.

Cú pháp

region.top(value=0.5)

Tham số

TênMô tả
valueNumber
Chiều cao cần bỏ: 0-1 là tỉ lệ chiều cao hiện tại; trên 1 là pixel, tối đa bằng toàn bộ chiều cao. Giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region mới được thu từ cạnh dưới.

Ví dụ

full = Region(100, 200, 1000, 500)
top_focus = full.top(0.25)
top_focus_px = full.top(120)

Region.bottom

Thu nhỏ region về phía dưới. Cạnh trên sẽ dịch xuống theo giá trị yêu cầu.

Cú pháp

region.bottom(value=0.5)

Tham số

TênMô tả
valueNumber
Chiều cao cần bỏ: 0-1 là tỉ lệ chiều cao hiện tại; trên 1 là pixel, tối đa bằng toàn bộ chiều cao. Giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region mới được thu từ cạnh trên.

Ví dụ

full = Region(100, 200, 1000, 500)
bottom_focus = full.bottom(0.25)
bottom_focus_px = full.bottom(120)

Region.horizontal

Thu nhỏ theo trục ngang về phía giữa bằng cách dịch cả cạnh trái và cạnh phải vào trong.

Cú pháp

region.horizontal(value=0.5)

Tham số

TênMô tả
valueNumber
Tổng chiều rộng cần bỏ, chia đều hai bên: 0-1 là tỉ lệ, trên 1 là pixel. Tối đa bằng toàn bộ chiều rộng; giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region canh giữa với chiều rộng đã giảm.

Ví dụ

full = Region(100, 200, 1000, 500)
center_lane = full.horizontal(0.5)
center_lane_px = full.horizontal(300)

Region.vertical

Thu nhỏ theo trục dọc về phía giữa bằng cách dịch cả cạnh trên và cạnh dưới vào trong.

Cú pháp

region.vertical(value=0.5)

Tham số

TênMô tả
valueNumber
Tổng chiều cao cần bỏ, chia đều hai bên: 0-1 là tỉ lệ, trên 1 là pixel. Tối đa bằng toàn bộ chiều cao; giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region canh giữa với chiều cao đã giảm.

Ví dụ

full = Region(100, 200, 1000, 500)
center_band = full.vertical(0.5)
center_band_px = full.vertical(200)

Region.middle

Thu nhỏ cả chiều rộng và chiều cao về phía giữa.

Cú pháp

region.middle(value=0.5)

Tham số

TênMô tả
valueNumber
Mức bỏ trên mỗi chiều: 0-1 là tỉ lệ của chiều đó; trên 1 là pixel. Chia đều hai cạnh đối diện, tối đa bằng kích thước mỗi chiều. Giá trị âm gây lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0.5

Giá trị trả về

Region — Region canh giữa đã giảm theo cả hai trục.

Ví dụ

full = Region(100, 200, 1000, 500)
focus = full.middle(0.4)
focus_px = full.middle(160)

Region.highlight

Vẽ khung chữ nhật quanh vùng này. Gọi lại trên cùng Region sẽ thay khung cũ. Hàm trả về trước khi vẽ xong; chỉ cập nhật mới nhất trước lần làm mới màn hình kế tiếp được hiển thị.

Cú pháp

region.highlight(color="green", line_width=2, auto_hide_ms=0, movable=False)

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 khung theo dp; giá trị dưới 1 được đổi thành 1.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 2
auto_hide_msNumber
Tự tắt sau N mili giây. 0 là không tự tắt.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
movableBoolean
Cho phép kéo region đang highlight và cập nhật ngược toạ độ mới vào chính Region này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False

Giá trị trả về

Region — Trả về chính region sau khi vẽ highlight.

Ví dụ

scan = Region(120, 260, 280, 160)
scan.highlight("#FF00BCD4", line_width=3, auto_hide_ms=1500, movable=True)

Region.highlight_off

Xóa khung đánh dấu do Region này tạo ra.

Cú pháp

region.highlight_off()

Giá trị trả về

Region — Trả về chính region sau khi tắt highlight.

Ví dụ

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
scan.highlight_off()