ในหน้านี้
ข้อมูล JSON ต้นฉบับ ↗ Runtime v2.81 · อัปเดต 30 ก.ย. 2569
A rectangular region on the screen, measured in pixels on the current screen axes.
รูปแบบคำสั่ง Region(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())พารามิเตอร์สำหรับสร้างออบเจ็กต์ พฤติกรรม / ผลข้างเคียง A rectangular region on the screen, measured in pixels on the current screen axes. Scale/anchor control coordinate mapping across full-screen sizes without rotating through portrait coordinates or using the app viewport; runtime consumers clip the final region to the current screen after mapping and offsets. ScaleParam controls template matching inside this region. Region can be destructured as x, y, width, height.
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง region = Region(100, 200, 300, 400)
hit = region.find("img", 3000, threshold=0.8, rate=3.0)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
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
# แยก Region เป็น x, y, width, height
x, y, width, height = search_areasearch_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"))รับทุกภูมิภาคที่เน้นโดยอินสแตนซ์สคริปต์
ค่าที่ส่งกลับ list[Region] — รายการภูมิภาคที่ไฮไลท์ที่ใช้งานอยู่
พฤติกรรม / ผลข้างเคียง รับทุกภูมิภาคที่เน้นโดยอินสแตนซ์สคริปต์
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง active_regions = Region.highlighted()
for area in active_regions:
area.highlight("yellow", auto_hide_ms=500)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
กลับขอบเขตเต็มหน้าจอปัจจุบัน
ค่าที่ส่งกลับ Region — ขอบเขตขนาดหน้าจอจากโฮสต์รันไทม์
พฤติกรรม / ผลข้างเคียง กลับขอบเขตเต็มหน้าจอปัจจุบัน
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง 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? — ความกว้างของหน้าจอแหล่งมาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน
พฤติกรรม / ผลข้างเคียง Return the screen width of the device that created this macro, adapted to current screen orientation, when available.
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง macro_w = Region.macro_width()ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
Return the screen height of the device that created this macro, adapted to current screen orientation, when available.
ค่าที่ส่งกลับ Number? — ความสูงของหน้าจอที่มาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน
พฤติกรรม / ผลข้างเคียง Return the screen height of the device that created this macro, adapted to current screen orientation, when available.
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง macro_h = Region.macro_height()ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
สแกนภายในบริเวณนี้จนกว่าจะพบเทมเพลตที่ตรงกันหรือหมดเวลา หากไม่ระบุ timeout จะสแกนเพียงครั้งเดียว ใช้ ScreenCapture.cache_on() เพื่อตรวจหลายภาพในเฟรมที่ปักหมุดเดียวกัน แล้วใช้ cache_off() เพื่อเลิกปักหมุด หากต้องตรวจจับต่อเนื่องด้วยเฟรมล่าสุดที่มี ให้เรียก ScreenCapture.auto_cache_off() เพิ่มด้วย มิฉะนั้นแคชอัตโนมัติจะใช้เฟรมซ้ำได้นานถึง 100 ms การปิดแคชเพิ่มงานจับภาพและไม่รับประกันว่าจะทำงานเร็วขึ้น
รูปแบบคำสั่ง region.find(template, timeout=0, threshold=0.7, rate=3.0)ค่าที่ส่งกลับ Match — แมตช์แรกที่สำเร็จ หรือ found=false เมื่อหมดเวลา
พฤติกรรม / ผลข้างเคียง สแกนภายในบริเวณนี้จนกว่าจะพบเทมเพลตที่ตรงกันหรือหมดเวลา หากไม่ระบุ timeout จะสแกนเพียงครั้งเดียว ใช้ ScreenCapture.cache_on() เพื่อตรวจหลายภาพในเฟรมที่ปักหมุดเดียวกัน แล้วใช้ cache_off() เพื่อเลิกปักหมุด หากต้องตรวจจับต่อเนื่องด้วยเฟรมล่าสุดที่มี ให้เรียก ScreenCapture.auto_cache_off() เพิ่มด้วย มิฉะนั้นแคชอัตโนมัติจะใช้เฟรมซ้ำได้นานถึง 100 ms การปิดแคชเพิ่มงานจับภาพและไม่รับประกันว่าจะทำงานเร็วขึ้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — รายการที่ตรงกันทั้งหมดสำหรับเทมเพลต หรือรายการว่างเมื่อหมดเวลา
พฤติกรรม / ผลข้างเคียง สแกนภายในภูมิภาคนี้และส่งคืนรายการที่ตรงกันทั้งหมดสำหรับเทมเพลตเดียวเมื่อพบอย่างน้อยหนึ่งรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — ผลการจับคู่เป็นกลุ่มเมื่อพบเทมเพลตใดๆ หรือรายการว่างเมื่อหมดเวลา
พฤติกรรม / ผลข้างเคียง สแกนขอบเขตนี้และกลับมาเมื่อพบเทมเพลตในรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — ผลการจับคู่เป็นกลุ่มเมื่อพบเทมเพลตทั้งหมด หรือรายการว่างเมื่อหมดเวลา
พฤติกรรม / ผลข้างเคียง สแกนขอบเขตนี้และกลับมาเมื่อพบทุกเทมเพลตในรายการเท่านั้น หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง region = Region(80, 220, 420, 520)
matches = region.find_all(["hp", "mp"], 5000)
MacroPanel.notify(str(matches))ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
สแกนขอบเขตนี้เพื่อหาสีเป้าหมายหนึ่งสีโดยใช้กฎการยอมรับ RGB แบบ Raw-frame เดียวกันกับการจดจำสี UI จุดที่ดีที่สุดจะถูกเลือกโดยเดลต้าช่อง RGB สูงสุดที่เล็กที่สุด
รูปแบบคำสั่ง region.find_color(color, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — จับคู่กับ point เป็น list[Point]; find_color ส่งคืนค่าสูงสุดหนึ่งจุด
พฤติกรรม / ผลข้างเคียง สแกนขอบเขตนี้เพื่อหาสีเป้าหมายหนึ่งสีโดยใช้กฎการยอมรับ RGB แบบ Raw-frame เดียวกันกับการจดจำสี UI จุดที่ดีที่สุดจะถูกเลือกโดยเดลต้าช่อง RGB สูงสุดที่เล็กที่สุด
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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(colors, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — จับคู่กับ point เป็น list[Point]; หนึ่งจุดที่ดีที่สุดต่อสีอินพุตที่พบ
พฤติกรรม / ผลข้างเคียง สแกนภูมิภาคนี้เพื่อดูสีเป้าหมายหลายสี สีอินพุตแต่ละสีมีส่วนช่วยในจุดที่ดีที่สุดเพียงจุดเดียว โดยเรียงลำดับตามรายการสีอินพุต
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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(color, timeout=0, tolerance=0, rate=3, interval=10)ค่าที่ส่งกลับ Match — จับคู่กับ point เป็น list[Point]; จุดสุ่มตัวอย่างที่ตรงกันจะถูกจัดเรียงด้วยสีที่ใกล้เคียงที่สุดก่อน
พฤติกรรม / ผลข้างเคียง สแกนบริเวณนี้เพื่อหาตำแหน่งสุ่มตัวอย่างหลายตำแหน่งด้วยสีเป้าหมายเดียว การส่งผ่านรายการหรือทูเพิลถูกปฏิเสธ ดังนั้นจึงไม่กลายเป็นการค้นหาสีหลายเป้าหมายโดยเงียบๆ
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — สถานะการจับคู่ล่าสุดเมื่อเทมเพลตหายไปหรือถึงระยะหมดเวลา
พฤติกรรม / ผลข้างเคียง รอจนกระทั่งเทมเพลตหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — การจับคู่แบบกลุ่มจะระบุเมื่อไม่พบเทมเพลตอย่างน้อยหนึ่งรายการอีกต่อไป
พฤติกรรม / ผลข้างเคียง รอจนกระทั่งเทมเพลตในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง 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 — การจับคู่แบบกลุ่มจะระบุเมื่อไม่พบเทมเพลตทั้งหมดอีกต่อไป
พฤติกรรม / ผลข้างเคียง รอจนกระทั่งเทมเพลตทั้งหมดในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง watch = ["loading", "syncing"]
result = region.wait_all(watch, 10000)
MacroPanel.notify(str(result))ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
จับภาพหน้าจอและครอบตัดบริเวณนี้ จากนั้นส่งคืนผลลัพธ์เป็นเทมเพลต
รูปแบบคำสั่ง region.capture(name=None)ค่าที่ส่งกลับ Template — วัตถุเทมเพลตที่บันทึกไว้
พฤติกรรม / ผลข้างเคียง จับภาพหน้าจอและครอบตัดบริเวณนี้ จากนั้นส่งคืนผลลัพธ์เป็นเทมเพลต
การทำงาน รอให้เสร็จ: ใช่ ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข การตรวจจับทำในโฟลว์ผู้เรียกและใช้การจับภาพร่วมกัน find ค้นหาการปรากฏ ส่วน wait รอให้หายไป แม้สแกนครั้งเดียวก็ใช้เวลาจับภาพและประมวลผล timeout หรืออัตราตรวจสอบไม่ได้ทำให้เรียกแบบอะซิงโครนัส
ตัวอย่าง sample = Region(120, 280, 220, 120).capture()
saved = sample.save_as("buttons/top/enemy_slot")ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ย่อส่วนนี้ไปทางด้านซ้าย ขอบด้านขวาเลื่อนไปทางซ้ายตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านขวา
พฤติกรรม / ผลข้างเคียง ย่อส่วนนี้ไปทางด้านซ้าย ขอบด้านขวาเลื่อนไปทางซ้ายตามจำนวนที่ร้องขอ
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง full = Region(100, 200, 1000, 500)
left_focus = full.left(0.4)
left_focus_px = full.left(400)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ย่อส่วนนี้ไปทางด้านขวา ขอบซ้ายเลื่อนไปทางขวาตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านซ้าย
พฤติกรรม / ผลข้างเคียง ย่อส่วนนี้ไปทางด้านขวา ขอบซ้ายเลื่อนไปทางขวาตามจำนวนที่ร้องขอ
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง full = Region(100, 200, 1000, 500)
right_focus = full.right(0.3)
right_focus_px = full.right(240)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ย่อส่วนนี้ไปทางด้านบน ขอบด้านล่างเลื่อนขึ้นตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านล่าง
พฤติกรรม / ผลข้างเคียง ย่อส่วนนี้ไปทางด้านบน ขอบด้านล่างเลื่อนขึ้นตามจำนวนที่ร้องขอ
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง full = Region(100, 200, 1000, 500)
top_focus = full.top(0.25)
top_focus_px = full.top(120)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ย่อส่วนนี้ไปทางด้านล่าง ขอบด้านบนเลื่อนลงตามจำนวนที่ร้องขอ
ค่าที่ส่งกลับ Region — ขอบเขตใหม่แคบลงจากขอบด้านบน
พฤติกรรม / ผลข้างเคียง ย่อส่วนนี้ไปทางด้านล่าง ขอบด้านบนเลื่อนลงตามจำนวนที่ร้องขอ
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ 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 — พื้นที่กึ่งกลางที่มีความกว้างลดลง
พฤติกรรม / ผลข้างเคียง ย่อแนวนอนไปทางกึ่งกลางโดยเลื่อนขอบทั้งซ้ายและขวาเข้าด้านใน
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ 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 — บริเวณกึ่งกลางที่มีความสูงลดลง
พฤติกรรม / ผลข้างเคียง ย่อแนวตั้งเข้าหากึ่งกลางโดยเลื่อนขอบทั้งด้านบนและด้านล่างเข้าด้านใน
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง full = Region(100, 200, 1000, 500)
center_band = full.vertical(0.5)
center_band_px = full.vertical(200)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ย่อทั้งความกว้างและความสูงเข้าหากึ่งกลาง
ค่าที่ส่งกลับ Region — บริเวณศูนย์กลางลดลงบนทั้งสองแกน
พฤติกรรม / ผลข้างเคียง ย่อทั้งความกว้างและความสูงเข้าหากึ่งกลาง
การทำงาน รอให้เสร็จ: ไม่ ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์ การทำงานแบบขนาน: ใช่ สร้างหรือคำนวณเรขาคณิตในโฟลว์ผู้เรียกโดยไม่จับภาพหรือตรวจจับ เก็บบิลเดอร์ Region แยกในแต่ละโฟลว์
ตัวอย่าง full = Region(100, 200, 1000, 500)
focus = full.middle(0.4)
focus_px = full.middle(160)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
วาดรูปสี่เหลี่ยมผืนผ้าที่ไฮไลต์สำหรับบริเวณนี้ ด้วย movable=True ผู้ใช้สามารถลากขอบเขตและวัตถุภูมิภาคเดียวกันจะได้รับพิกัดหน้าจอที่อัปเดต การไฮไลต์อินสแตนซ์ภูมิภาคเดียวกันอีกครั้งจะแทนที่อินสแตนซ์ก่อนหน้า
รูปแบบคำสั่ง region.highlight(color="green", line_width=2, auto_hide_ms=0, movable=False)ค่าที่ส่งกลับ Region — ส่งคืนขอบเขตเดียวกันหลังจากวาดไฮไลท์
พฤติกรรม / ผลข้างเคียง วาดรูปสี่เหลี่ยมผืนผ้าที่ไฮไลต์สำหรับบริเวณนี้ ด้วย movable=True ผู้ใช้สามารถลากขอบเขตและวัตถุภูมิภาคเดียวกันจะได้รับพิกัดหน้าจอที่อัปเดต การไฮไลต์อินสแตนซ์ภูมิภาคเดียวกันอีกครั้งจะแทนที่อินสแตนซ์ก่อนหน้า
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง scan = Region(120, 260, 280, 160)
scan.highlight("#FF00BCD4", line_width=3, auto_hide_ms=1500, movable=True)ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
ปิดไฮไลต์สำหรับอินสแตนซ์ภูมิภาคนี้
ค่าที่ส่งกลับ Region — ส่งคืนขอบเขตเดิมหลังจากปิดไฮไลต์
พฤติกรรม / ผลข้างเคียง ปิดไฮไลต์สำหรับอินสแตนซ์ภูมิภาคนี้
การทำงาน รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข ความปลอดภัยเมื่อทำงานพร้อมกัน: ไม่รับประกัน การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข ระยะเวลาประมวลผลและการรอขึ้นอยู่กับการทำงานที่อธิบายไว้ เก็บค่าที่เปลี่ยนแปลงได้ไว้ในโฟลว์เจ้าของ ไม่มีการรับประกันความปลอดภัยทั่วไปเมื่อแชร์ออบเจ็กต์ระหว่างโฟลว์
ตัวอย่าง scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
scan.highlight_off()ข้อผิดพลาด / ข้อจำกัด ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
