สร้าง Region แบบ fixed ไม่มี anchor จากพิกัดศูนย์กลางที่เป็นจำนวนจำกัดและขนาดบวกจำกัด โดยเก็บพิกัดทศนิยมไว้
รูปแบบคำสั่ง Region.from_center(cx, cy, width, height)ค่าที่ส่งกลับ Region — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด ตัวอย่าง # สร้างบริเวณรอบจุดศูนย์กลาง
area = Region.from_center(100, 200, 50, 30)คืนพื้นที่หน้าจอที่สคริปต์กำลังวาดกรอบ รวมกรอบสี่เหลี่ยมจัตุรัสจาก Point.highlight ()
ค่าที่ส่งกลับ list [Region ] — รายการภูมิภาคที่ไฮไลท์ที่ใช้งานอยู่ ตัวอย่าง active_regions = Region.highlighted()
for area in active_regions:
area.highlight("yellow", auto_hide_ms=500)กลับขอบเขตเต็มหน้าจอปัจจุบัน
ค่าที่ส่งกลับ Region — Region ที่ครอบคลุมหน้าจอปัจจุบันทั้งหมด เริ่มจาก (0, 0) ตัวอย่าง scan = Region.full_screen()
hit = scan.find("ok", 2000)ปิดไฮไลท์ภูมิภาคที่ใช้งานอยู่ทั้งหมด
ค่าที่ส่งกลับ None — ไม่มีค่า.
ตัวอย่าง scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
Region.highlight_off()Return the screen width of the device that created this macro, adapted to current screen orientation, when available.
ค่าที่ส่งกลับ Number? — ความกว้างของหน้าจอแหล่งมาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน
ตัวอย่าง macro_w = Region.macro_width()Return the screen height of the device that created this macro, adapted to current screen orientation, when available.
ค่าที่ส่งกลับ Number? — ความสูงของหน้าจอที่มาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน
ตัวอย่าง macro_h = Region.macro_height()คืนส่วนซ้อนทับที่มีพื้นที่บวกเป็น Region ใหม่ หรือ None ขอบที่แตะกันไม่นับว่าซ้อนทับ ใช้พิกัดที่เก็บไว้ในระบบเดียวกันโดยไม่จับภาพ ปรับขนาดหรือตัด และคง scale, anchor และ scale_param ของ Region นี้โดยไม่แก้ไขต้นฉบับ
รูปแบบคำสั่ง region.intersection(other)ค่าที่ส่งกลับ Region ? — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด ตัวอย่าง # หาบริเวณที่ซ้อนทับ
overlap = Region(0, 0, 100, 100).intersection(Region(50, 50, 100, 100))ตรวจสอบพื้นที่ซ้อนทับที่เป็นบวกด้วยพิกัดที่เก็บไว้ในระบบเดียวกัน ขอบที่แตะกันไม่นับว่าซ้อนทับ โดยไม่จับภาพ ปรับขนาดหรือตัด
ค่าที่ส่งกลับ Boolean — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด
ตัวอย่าง # ตรวจสอบว่าสองบริเวณซ้อนทับกันหรือไม่
print(Region(0, 0, 100, 100).intersects(Region(50, 50, 20, 20)))ตรวจสอบการอยู่ภายในด้วยพิกัดที่เก็บไว้ในระบบเดียวกัน โดยไม่จับภาพ ปรับขนาดหรือตัด จุดบนขอบซ้ายและบนถือว่าอยู่ภายใน แต่ขอบขวาและล่างไม่อยู่ภายใน Region อาจมีขอบร่วมกันได้ ขนาดว่างหรือติดลบคืน False
รูปแบบคำสั่ง region.contains(point_or_region)ค่าที่ส่งกลับ Boolean — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด
ตัวอย่าง # ตรวจสอบว่าจุดอยู่ในบริเวณหรือไม่
print(Region(0, 0, 100, 100).contains(Point(10, 10)))ค้นหาข้อความด้วย OCR ภายในบริเวณนี้โดยใช้พิกเซลหน้าจอ ผลที่ตรงกันต้องเป็นคำหรือวลีเต็ม โดยไม่ตัดกลางตัวอักษร ตัวเลข หรือขีดล่าง การจับภาพหน้าจอต้องพร้อมใช้งาน ระบบจะลองซ้ำจนพบหรือหมดเวลา โดยรองรับการหยุดชั่วคราวและหยุด การใช้ภาพจับแคชเป็นไปตามการค้นหาด้วยการรู้จำอื่น หาก OCR หรือการจับภาพล้มเหลวจะเกิดข้อผิดพลาด
รูปแบบคำสั่ง region.find_text(text, timeout=0, threshold=100, rate=5, language="latin", preserve_case=False)ค่าที่ส่งกลับ Match — Match ที่พบมี bounds และ point เป็นพิกเซลของทั้งหน้าจอ confidence ตั้งแต่ 0 ถึง 1 และ name เป็นข้อความเป้าหมายที่ตรงกัน หากไม่พบจะได้ found=False ตำแหน่งที่แยกจากกันและได้คะแนนสูงสุดเท่ากันจะทำให้เกิดข้อผิดพลาดว่าไม่สามารถระบุผลได้ ให้จำกัดบริเวณค้นหาให้แคบลง ผลที่ซ้อนกันจะนับเป็นตำแหน่งเดียว ตัวอย่าง # ค้นหาและแตะปุ่ม OK ในหน้าต่างป๊อปอัป
hit = Region(500, 100, 400, 300).find_text("OK", timeout=3000)
if hit.found:
click(hit)ค้นหาตำแหน่งที่ตรงกับแม่แบบหนึ่งจุดในพื้นที่นี้ ลองซ้ำจนพบหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ ScreenCapture.cache_on () ทำให้ใช้ภาพเดิมจนเรียก cache_off(); โดยปกติจะใช้ภาพซ้ำอัตโนมัติสูงสุด 100 ms ใช้ auto_cache_off() เพื่อรับภาพล่าสุดที่มี แต่ต้องจับภาพเพิ่ม
รูปแบบคำสั่ง region.find(template, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ Match — Match ที่มี found=True เมื่อพบ มิฉะนั้น found=False หลังสแกนหรือหมดเวลา ไม่คืน None ตัวอย่าง region = Region(80, 220, 420, 520)
hit = region.find("ok", 4000, 0.8, 4.0)
MacroPanel.notify(str(hit))สแกนภายในภูมิภาคนี้และส่งคืนรายการที่ตรงกันทั้งหมดสำหรับเทมเพลตเดียวเมื่อพบอย่างน้อยหนึ่งรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
รูปแบบคำสั่ง region.find_multi(template, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ MatchList — รายการที่ตรงกันทั้งหมดสำหรับเทมเพลต หรือรายการว่างเมื่อหมดเวลา ตัวอย่าง region = Region(80, 220, 420, 520)
matches = region.find_multi("enemy", 3000)
MacroPanel.notify(str(matches))สแกนขอบเขตนี้และกลับมาเมื่อพบเทมเพลตในรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
รูปแบบคำสั่ง region.find_any(templates, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ MatchList — Match หนึ่งรายการต่อแม่แบบตามลำดับอินพุต เมื่อพบอย่างน้อยหนึ่งภาพ บางรายการอาจมี found=False คืน MatchList ว่างหากไม่พบภาพใดก่อนหมดเวลา ตัวอย่าง region = Region(80, 220, 420, 520)
matches = region.find_any(["enemy_a", "enemy_b"], 2500)
MacroPanel.notify(str(matches))สแกนขอบเขตนี้และกลับมาเมื่อพบทุกเทมเพลตในรายการเท่านั้น หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
รูปแบบคำสั่ง region.find_all(templates, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ MatchList — Match ที่พบหนึ่งรายการต่อแม่แบบตามลำดับอินพุต หรือ MatchList ว่างหากไม่มีการสแกนใดพบครบก่อนหมดเวลา ตัวอย่าง region = Region(80, 220, 420, 520)
matches = region.find_all(["hp", "mp"], 5000)
MacroPanel.notify(str(matches))ค้นหาพิกเซลที่ตรวจซึ่งมีสีใกล้เป้าหมายที่สุดในพื้นที่นี้ แต่ละช่องสีแดง เขียว และน้ำเงินต้องต่างไม่เกิน tolerance โดยเลือกจุดที่มีความต่างสูงสุดของช่องสีน้อยที่สุด ลองซ้ำจนพบหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ
รูปแบบคำสั่ง region.find_color(color, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — Match ที่มี Point ใน point ไม่เกินหนึ่งรายการ หรือ found=False และ point ว่างหากไม่มีพิกเซลที่ตรวจตรงกันหรือจับภาพไม่ได้ ตัวอย่าง scan = Region(80, 220, 420, 520)
hit = scan.find_color("#FF4CAF50", tolerance=8, interval=4)
if hit.found:
click(hit.point[0], random=0)ค้นหาสีเป้าหมายใดก็ได้ในพื้นที่นี้ตามกฎความคลาดเคลื่อน RGB ของ find_color คืนจุดที่ตรวจที่ดีที่สุดไม่เกินหนึ่งจุดต่อสีที่พบ ตามลำดับอินพุต ลองซ้ำจนพบอย่างน้อยหนึ่งสีหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ
รูปแบบคำสั่ง region.find_any_color(colors, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — Match ที่มี Point ที่ดีที่สุดต่อสีที่พบใน point ตามลำดับอินพุต เป็น found=False และ point ว่างหากไม่มีสีตรงกันหรือจับภาพไม่ได้ ตัวอย่าง colors = ["#FF0000", "#00FF00", "#0000FF"]
hit = Region.full_screen().find_any_color(colors, tolerance=6)
if hit.found:
click(hit, random=0)ค้นหาพิกเซลที่ตรวจทั้งหมดซึ่งตรงกับสีเป้าหมายหนึ่งสีตามกฎความคลาดเคลื่อน RGB ของ find_color การส่งรายการหรือ tuple ของสีทำให้เกิดข้อผิดพลาด ลองซ้ำจนพบอย่างน้อยหนึ่งจุดหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ
รูปแบบคำสั่ง region.find_multi_color(color, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — Match ที่เก็บ Point ที่ตรวจแล้วตรงกันใน point โดยสีใกล้ที่สุดอยู่ก่อน เป็น found=False และ point ว่างหากไม่มีจุดตรงกันหรือจับภาพไม่ได้ ตัวอย่าง 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(template, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ Match — Match ล่าสุด: found=False หมายถึงไม่พบภาพ; found=True หมายถึงยังพบภาพเมื่อสิ้นสุดการรอ ไม่คืน None ต้องพร้อมจับภาพหน้าจอ; หากจับภาพไม่ได้ก็อาจได้ found=False ตัวอย่าง region = Region(0, 0, 1080, 2400)
result = region.wait("loading", 8000)
MacroPanel.notify(str(result))รอจนกระทั่งเทมเพลตในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
รูปแบบคำสั่ง region.wait_any(templates, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ MatchList — Match ล่าสุดของแต่ละแม่แบบตามลำดับอินพุต เมื่อภาพหายไปหรือหมดเวลา ตรวจ found ของแต่ละรายการ; False หมายถึงไม่พบภาพนั้น ต้องพร้อมจับภาพหน้าจอ; หากจับภาพไม่ได้ก็อาจได้ found=False ตัวอย่าง watch = ["loading", "syncing"]
result = region.wait_any(watch, 10000)
MacroPanel.notify(str(result))รอจนกระทั่งเทมเพลตทั้งหมดในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
รูปแบบคำสั่ง region.wait_all(templates, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ MatchList — Match ล่าสุดของแต่ละแม่แบบตามลำดับอินพุต เมื่อภาพหายไปหรือหมดเวลา ค่า found ทั้งหมดเป็น False ต่อเมื่อไม่พบทุกภาพ ต้องพร้อมจับภาพหน้าจอ; หากจับภาพไม่ได้ก็อาจได้ found=False ตัวอย่าง watch = ["loading", "syncing"]
result = region.wait_all(watch, 10000)
MacroPanel.notify(str(result))จับภาพพื้นที่หน้าจอนี้เป็น Template ต้องมีเซสชันจับภาพหน้าจอที่ทำงานและผู้ใช้อนุญาตแล้ว เกิดข้อผิดพลาดหากจับภาพไม่ได้หรือพื้นที่อยู่นอกหน้าจอทั้งหมด
รูปแบบคำสั่ง region.capture(name=None)ตัวอย่าง sample = Region(120, 280, 220, 120).capture()
saved = sample.save_as("buttons/top/enemy_slot")ย่อส่วนนี้ไปทางด้านซ้าย ขอบด้านขวาเลื่อนไปทางซ้ายตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านขวา ตัวอย่าง full = Region(100, 200, 1000, 500)
left_focus = full.left(0.4)
left_focus_px = full.left(400)ย่อส่วนนี้ไปทางด้านขวา ขอบซ้ายเลื่อนไปทางขวาตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านซ้าย ตัวอย่าง full = Region(100, 200, 1000, 500)
right_focus = full.right(0.3)
right_focus_px = full.right(240)ย่อส่วนนี้ไปทางด้านบน ขอบด้านล่างเลื่อนขึ้นตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านล่าง ตัวอย่าง full = Region(100, 200, 1000, 500)
top_focus = full.top(0.25)
top_focus_px = full.top(120)ย่อส่วนนี้ไปทางด้านล่าง ขอบด้านบนเลื่อนลงตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านบน ตัวอย่าง full = Region(100, 200, 1000, 500)
bottom_focus = full.bottom(0.25)
bottom_focus_px = full.bottom(120)ย่อแนวนอนไปทางกึ่งกลางโดยเลื่อนขอบทั้งซ้ายและขวาเข้าด้านใน
รูปแบบคำสั่ง region.horizontal(value=0.5)ค่าที่ส่งกลับ Region — พื้นที่กึ่งกลางที่มีความกว้างลดลง ตัวอย่าง full = Region(100, 200, 1000, 500)
center_lane = full.horizontal(0.5)
center_lane_px = full.horizontal(300)ย่อแนวตั้งเข้าหากึ่งกลางโดยเลื่อนขอบทั้งด้านบนและด้านล่างเข้าด้านใน
รูปแบบคำสั่ง region.vertical(value=0.5)ค่าที่ส่งกลับ Region — บริเวณกึ่งกลางที่มีความสูงลดลง ตัวอย่าง full = Region(100, 200, 1000, 500)
center_band = full.vertical(0.5)
center_band_px = full.vertical(200)ย่อทั้งความกว้างและความสูงเข้าหากึ่งกลาง
ค่าที่ส่งกลับ Region — บริเวณศูนย์กลางลดลงบนทั้งสองแกน ตัวอย่าง full = Region(100, 200, 1000, 500)
focus = full.middle(0.4)
focus_px = full.middle(160)วาดกรอบสี่เหลี่ยมรอบพื้นที่นี้ การเรียกซ้ำบน Region เดิมจะแทนที่กรอบเดิม เมธอดคืนค่าก่อนวาดเสร็จ และแสดงเฉพาะการอัปเดตล่าสุดก่อนรีเฟรชหน้าจอครั้งถัดไป
รูปแบบคำสั่ง region.highlight(color="green", line_width=2, auto_hide_ms=0, movable=False)ค่าที่ส่งกลับ Region — ส่งคืนขอบเขตเดียวกันหลังจากวาดไฮไลท์ ตัวอย่าง scan = Region(120, 260, 280, 160)
scan.highlight("#FF00BCD4", line_width=3, auto_hide_ms=1500, movable=True)ลบกรอบที่ Region นี้สร้าง
ค่าที่ส่งกลับ Region — ส่งคืนขอบเขตเดิมหลังจากปิดไฮไลต์ ตัวอย่าง scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
scan.highlight_off()