Region

พื้นที่สี่เหลี่ยมบนหน้าจอสำหรับค้นหาภาพหรือสี จับภาพ หรือวาดกรอบ พิกัดเป็นพิกเซลตามแกนนอนและแนวตั้งปัจจุบัน หลังปรับขนาดและระยะเลื่อนจะใช้เฉพาะส่วนที่อยู่ในหน้าจอ อ่านขนาดด้วย x, y, width, height = region

รูปแบบคำสั่ง

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

พารามิเตอร์สำหรับสร้างออบเจ็กต์

ชื่อคำอธิบาย
xNumber
Top-left X coordinate
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
yNumber
Top-left Y coordinate
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
widthNumber
Region width
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
heightNumber
Region height
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
scaleString
การปรับพิกัดระหว่างหน้าจอเต็ม: fixed คงพิกเซล; auto ปรับ X ตามอัตราส่วนความกว้างและ Y ตามความสูง; width หรือ height ปรับทั้งสองแกนตามมิตินั้น ใช้ขนาดหน้าจอต้นฉบับของมาโครโดยไม่หมุนแกนหรือใช้ขนาดหน้าต่างแอป
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: fixed
anchorString
ตำแหน่งอ้างอิงสำหรับปรับพิกัด: none (มุมซ้ายบน), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right ส่วน auto เลือกขอบหรือจุดกึ่งกลางที่ใกล้ที่สุด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: ScaleParam()

ค่าที่ส่งกลับ

ตัวอย่าง

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

ฟิลด์

ชื่อคำอธิบาย
xNumber
Top-left horizontal coordinate.
yNumber
Top-left vertical coordinate.
widthNumber
Region width in pixels.
heightNumber
Region height in pixels.
scaleString
การปรับพิกัดระหว่างหน้าจอเต็ม: fixed คงพิกเซล; auto ปรับ X ตามอัตราส่วนความกว้างและ Y ตามความสูง; width หรือ height ปรับทั้งสองแกนตามมิตินั้น ใช้ขนาดหน้าจอต้นฉบับของมาโครโดยไม่หมุนแกนหรือใช้ขนาดหน้าต่างแอป
ค่าเริ่มต้น: fixed
anchorString
ตำแหน่งอ้างอิงสำหรับปรับพิกัด: none (มุมซ้ายบน), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right ส่วน auto เลือกขอบหรือจุดกึ่งกลางที่ใกล้ที่สุด
ค่าเริ่มต้น: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters used by find/wait methods on this region.
ค่าเริ่มต้น: ScaleParam()
middle_pointPoint
Center point of this region.
ตัวอย่างการอ่านฟิลด์
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_area
ตัวอย่างการสร้างออบเจ็กต์
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"))

เมธอด

30 เมธอด

Region.from_center

สร้าง Region แบบ fixed ไม่มี anchor จากพิกัดศูนย์กลางที่เป็นจำนวนจำกัดและขนาดบวกจำกัด โดยเก็บพิกัดทศนิยมไว้

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
cxNumber
พิกัด X ของจุดศูนย์กลาง
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
cyNumber
พิกัด Y ของจุดศูนย์กลาง
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
widthNumber
ความกว้างที่เป็นบวก
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
heightNumber
ความสูงที่เป็นบวก
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Region — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด

ตัวอย่าง

# สร้างบริเวณรอบจุดศูนย์กลาง
area = Region.from_center(100, 200, 50, 30)

Region.highlighted

คืนพื้นที่หน้าจอที่สคริปต์กำลังวาดกรอบ รวมกรอบสี่เหลี่ยมจัตุรัสจาก Point.highlight()

รูปแบบคำสั่ง

Region.highlighted()

ค่าที่ส่งกลับ

list[Region] — รายการภูมิภาคที่ไฮไลท์ที่ใช้งานอยู่

ตัวอย่าง

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

Region.full_screen

กลับขอบเขตเต็มหน้าจอปัจจุบัน

รูปแบบคำสั่ง

Region.full_screen()

ค่าที่ส่งกลับ

Region — Region ที่ครอบคลุมหน้าจอปัจจุบันทั้งหมด เริ่มจาก (0, 0)

ตัวอย่าง

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

Region.highlight_off

ปิดไฮไลท์ภูมิภาคที่ใช้งานอยู่ทั้งหมด

รูปแบบคำสั่ง

Region.highlight_off()

ค่าที่ส่งกลับ

None — ไม่มีค่า.

ตัวอย่าง

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

Region.macro_width

Return the screen width of the device that created this macro, adapted to current screen orientation, when available.

รูปแบบคำสั่ง

Region.macro_width()

ค่าที่ส่งกลับ

Number? — ความกว้างของหน้าจอแหล่งมาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน

ตัวอย่าง

macro_w = Region.macro_width()

Region.macro_height

Return the screen height of the device that created this macro, adapted to current screen orientation, when available.

รูปแบบคำสั่ง

Region.macro_height()

ค่าที่ส่งกลับ

Number? — ความสูงของหน้าจอที่มาโคร หรือไม่มี เมื่อไม่พร้อมใช้งาน

ตัวอย่าง

macro_h = Region.macro_height()

Region.intersection

คืนส่วนซ้อนทับที่มีพื้นที่บวกเป็น Region ใหม่ หรือ None ขอบที่แตะกันไม่นับว่าซ้อนทับ ใช้พิกัดที่เก็บไว้ในระบบเดียวกันโดยไม่จับภาพ ปรับขนาดหรือตัด และคง scale, anchor และ scale_param ของ Region นี้โดยไม่แก้ไขต้นฉบับ

รูปแบบคำสั่ง

region.intersection(other)

พารามิเตอร์

ชื่อคำอธิบาย
otherRegion
บริเวณอีกบริเวณหนึ่ง
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Region? — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด

ตัวอย่าง

# หาบริเวณที่ซ้อนทับ
overlap = Region(0, 0, 100, 100).intersection(Region(50, 50, 100, 100))

Region.intersects

ตรวจสอบพื้นที่ซ้อนทับที่เป็นบวกด้วยพิกัดที่เก็บไว้ในระบบเดียวกัน ขอบที่แตะกันไม่นับว่าซ้อนทับ โดยไม่จับภาพ ปรับขนาดหรือตัด

รูปแบบคำสั่ง

region.intersects(other)

พารามิเตอร์

ชื่อคำอธิบาย
otherRegion
บริเวณอีกบริเวณหนึ่ง
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด

ตัวอย่าง

# ตรวจสอบว่าสองบริเวณซ้อนทับกันหรือไม่
print(Region(0, 0, 100, 100).intersects(Region(50, 50, 20, 20)))

Region.contains

ตรวจสอบการอยู่ภายในด้วยพิกัดที่เก็บไว้ในระบบเดียวกัน โดยไม่จับภาพ ปรับขนาดหรือตัด จุดบนขอบซ้ายและบนถือว่าอยู่ภายใน แต่ขอบขวาและล่างไม่อยู่ภายใน Region อาจมีขอบร่วมกันได้ ขนาดว่างหรือติดลบคืน False

รูปแบบคำสั่ง

region.contains(point_or_region)

พารามิเตอร์

ชื่อคำอธิบาย
point_or_regionPoint | Region
จุดหรือบริเวณที่ต้องการตรวจสอบ
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean — พิกัดและขอบที่คำนวณได้ต้องเป็นจำนวนจำกัด มิฉะนั้นจะเกิดข้อผิดพลาด

ตัวอย่าง

# ตรวจสอบว่าจุดอยู่ในบริเวณหรือไม่
print(Region(0, 0, 100, 100).contains(Point(10, 10)))

Region.find_text

ค้นหาข้อความด้วย OCR ภายในบริเวณนี้โดยใช้พิกเซลหน้าจอ ผลที่ตรงกันต้องเป็นคำหรือวลีเต็ม โดยไม่ตัดกลางตัวอักษร ตัวเลข หรือขีดล่าง การจับภาพหน้าจอต้องพร้อมใช้งาน ระบบจะลองซ้ำจนพบหรือหมดเวลา โดยรองรับการหยุดชั่วคราวและหยุด การใช้ภาพจับแคชเป็นไปตามการค้นหาด้วยการรู้จำอื่น หาก OCR หรือการจับภาพล้มเหลวจะเกิดข้อผิดพลาด

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
textString
ข้อความที่ต้องการค้นหา ต้องไม่เว้นว่าง
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที ค่า 0 หรือค่าติดลบสแกนครั้งเดียว
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdInteger
เกณฑ์การจับคู่ OCR เป็นจำนวนเต็มตั้งแต่ 0 ถึง 100 ค่า 100 ต้องตรงกันทุกประการหลังปรับรูปแบบ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 100
rateNumber
จำนวนครั้งที่ขอสแกนต่อวินาทีระหว่างรอ หน่วย Hz จำกัดตั้งแต่ 1 ถึง 60
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 5
languageString
ระบบตัวอักษร OCR: latin, chinese, devanagari, japanese หรือ korean ค่าอื่นรวมถึงชื่อแทนตามภาษาและภูมิภาคจะทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: "latin"
preserve_caseBoolean
แยกตัวพิมพ์ใหญ่และเล็กเมื่อเป็น True โดยค่าเริ่มต้นจะไม่แยก
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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)

Region.find

ค้นหาตำแหน่งที่ตรงกับแม่แบบหนึ่งจุดในพื้นที่นี้ ลองซ้ำจนพบหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ ScreenCapture.cache_on() ทำให้ใช้ภาพเดิมจนเรียก cache_off(); โดยปกติจะใช้ภาพซ้ำอัตโนมัติสูงสุด 100 ms ใช้ auto_cache_off() เพื่อรับภาพล่าสุดที่มี แต่ต้องจับภาพเพิ่ม

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateString | Template
ชื่อแม่แบบหรือเส้นทางโฟลเดอร์สัมพัทธ์ที่ไม่ใส่นามสกุลภาพในมาโครปัจจุบัน หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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

สแกนภายในภูมิภาคนี้และส่งคืนรายการที่ตรงกันทั้งหมดสำหรับเทมเพลตเดียวเมื่อพบอย่างน้อยหนึ่งรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateString | Template
ชื่อแม่แบบหรือเส้นทางโฟลเดอร์สัมพัทธ์ที่ไม่ใส่นามสกุลภาพในมาโครปัจจุบัน หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3.0

ค่าที่ส่งกลับ

MatchList — รายการที่ตรงกันทั้งหมดสำหรับเทมเพลต หรือรายการว่างเมื่อหมดเวลา

ตัวอย่าง

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

Region.find_any

สแกนขอบเขตนี้และกลับมาเมื่อพบเทมเพลตในรายการ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateslist[String | Template]
ชื่อแม่แบบ/เส้นทางโฟลเดอร์สัมพัทธ์โดยไม่ใส่นามสกุลภาพ หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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

สแกนขอบเขตนี้และกลับมาเมื่อพบทุกเทมเพลตในรายการเท่านั้น หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateslist[String | Template]
ชื่อแม่แบบ/เส้นทางโฟลเดอร์สัมพัทธ์โดยไม่ใส่นามสกุลภาพ หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3.0

ค่าที่ส่งกลับ

MatchList — Match ที่พบหนึ่งรายการต่อแม่แบบตามลำดับอินพุต หรือ MatchList ว่างหากไม่มีการสแกนใดพบครบก่อนหมดเวลา

ตัวอย่าง

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

Region.find_color

ค้นหาพิกเซลที่ตรวจซึ่งมีสีใกล้เป้าหมายที่สุดในพื้นที่นี้ แต่ละช่องสีแดง เขียว และน้ำเงินต้องต่างไม่เกิน tolerance โดยเลือกจุดที่มีความต่างสูงสุดของช่องสีน้อยที่สุด ลองซ้ำจนพบหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
colorColor | String | Number
Target color.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3
intervalNumber
ระยะห่างที่ขอเป็นพิกเซลระหว่างตำแหน่งที่ตรวจ อย่างน้อย 1 ค่าน้อยตรวจพิกเซลมากขึ้นและอาจใช้เวลานานขึ้น ระยะห่างอาจเพิ่มอัตโนมัติสำหรับพื้นที่ขนาดใหญ่
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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)

Region.find_any_color

ค้นหาสีเป้าหมายใดก็ได้ในพื้นที่นี้ตามกฎความคลาดเคลื่อน RGB ของ find_color คืนจุดที่ตรวจที่ดีที่สุดไม่เกินหนึ่งจุดต่อสีที่พบ ตามลำดับอินพุต ลองซ้ำจนพบอย่างน้อยหนึ่งสีหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
colorslist[Color | String | Number] | tuple[Color | String | Number]
Target colors.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3
intervalNumber
ระยะห่างที่ขอเป็นพิกเซลระหว่างตำแหน่งที่ตรวจ อย่างน้อย 1 ค่าน้อยตรวจพิกเซลมากขึ้นและอาจใช้เวลานานขึ้น ระยะห่างอาจเพิ่มอัตโนมัติสำหรับพื้นที่ขนาดใหญ่
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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)

Region.find_multi_color

ค้นหาพิกเซลที่ตรวจทั้งหมดซึ่งตรงกับสีเป้าหมายหนึ่งสีตามกฎความคลาดเคลื่อน RGB ของ find_color การส่งรายการหรือ tuple ของสีทำให้เกิดข้อผิดพลาด ลองซ้ำจนพบอย่างน้อยหนึ่งจุดหรือหมดเวลา; timeout=0 สแกนครั้งเดียว ต้องพร้อมจับภาพหน้าจอ

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
colorColor | String | Number
Single target color.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3
intervalNumber
ระยะห่างที่ขอเป็นพิกเซลระหว่างตำแหน่งที่ตรวจ อย่างน้อย 1 ค่าน้อยตรวจพิกเซลมากขึ้นและอาจใช้เวลานานขึ้น ระยะห่างอาจเพิ่มอัตโนมัติสำหรับพื้นที่ขนาดใหญ่
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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

รอจนกระทั่งเทมเพลตหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateString | Template
ชื่อแม่แบบหรือเส้นทางโฟลเดอร์สัมพัทธ์ที่ไม่ใส่นามสกุลภาพในมาโครปัจจุบัน หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 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

รอจนกระทั่งเทมเพลตในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateslist[String | Template]
ชื่อแม่แบบ/เส้นทางโฟลเดอร์สัมพัทธ์โดยไม่ใส่นามสกุลภาพ หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3.0

ค่าที่ส่งกลับ

MatchList — Match ล่าสุดของแต่ละแม่แบบตามลำดับอินพุต เมื่อภาพหายไปหรือหมดเวลา ตรวจ found ของแต่ละรายการ; False หมายถึงไม่พบภาพนั้น ต้องพร้อมจับภาพหน้าจอ; หากจับภาพไม่ได้ก็อาจได้ found=False

ตัวอย่าง

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

Region.wait_all

รอจนกระทั่งเทมเพลตทั้งหมดในรายการหายไปจากภูมิภาคนี้ หากละเว้นการหมดเวลา ระบบจะดำเนินการสแกนเพียงครั้งเดียวเท่านั้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
templateslist[String | Template]
ชื่อแม่แบบ/เส้นทางโฟลเดอร์สัมพัทธ์โดยไม่ใส่นามสกุลภาพ หรือออบเจ็กต์ Template ชื่อที่ไม่พบทำให้เกิดข้อผิดพลาด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
timeoutNumber
เวลารอสูงสุดเป็นมิลลิวินาที หากไม่ระบุ เป็นศูนย์ หรือติดลบ จะสแกนครั้งเดียว การสแกนที่เริ่มแล้วอาจเสร็จหลังเวลานี้
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.7
rateNumber
จำนวนสแกนที่ขอต่อวินาทีขณะรอ จำกัดที่ 1-60 ความเร็วจริงขึ้นกับเวลาที่ใช้รู้จำ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 3.0

ค่าที่ส่งกลับ

MatchList — Match ล่าสุดของแต่ละแม่แบบตามลำดับอินพุต เมื่อภาพหายไปหรือหมดเวลา ค่า found ทั้งหมดเป็น False ต่อเมื่อไม่พบทุกภาพ ต้องพร้อมจับภาพหน้าจอ; หากจับภาพไม่ได้ก็อาจได้ found=False

ตัวอย่าง

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

Region.capture

จับภาพพื้นที่หน้าจอนี้เป็น Template ต้องมีเซสชันจับภาพหน้าจอที่ทำงานและผู้ใช้อนุญาตแล้ว เกิดข้อผิดพลาดหากจับภาพไม่ได้หรือพื้นที่อยู่นอกหน้าจอทั้งหมด

รูปแบบคำสั่ง

region.capture(name=None)

พารามิเตอร์

ชื่อคำอธิบาย
nameString?
ระบุชื่อเพื่อบันทึกภาพลงมาโครปัจจุบันทันที; None สร้างภาพชั่วคราว ไม่อนุญาตให้บันทึกภาพที่มีชื่อในมาโครที่ได้รับการป้องกัน
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

Template — Template ที่มีภาพที่เพิ่งจับ

ตัวอย่าง

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

Region.left

ย่อส่วนนี้ไปทางด้านซ้าย ขอบด้านขวาเลื่อนไปทางซ้ายตามจำนวนที่ร้องขอ

รูปแบบคำสั่ง

region.left(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความกว้างที่จะตัดออก: 0-1 เป็นสัดส่วนของความกว้างปัจจุบัน; มากกว่า 1 เป็นพิกเซล ไม่เกินความกว้างทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — ขอบเขตใหม่แคบลงจากขอบด้านขวา

ตัวอย่าง

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

Region.right

ย่อส่วนนี้ไปทางด้านขวา ขอบซ้ายเลื่อนไปทางขวาตามจำนวนที่ร้องขอ

รูปแบบคำสั่ง

region.right(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความกว้างที่จะตัดออก: 0-1 เป็นสัดส่วนของความกว้างปัจจุบัน; มากกว่า 1 เป็นพิกเซล ไม่เกินความกว้างทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — ขอบเขตใหม่แคบลงจากขอบด้านซ้าย

ตัวอย่าง

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

Region.top

ย่อส่วนนี้ไปทางด้านบน ขอบด้านล่างเลื่อนขึ้นตามจำนวนที่ร้องขอ

รูปแบบคำสั่ง

region.top(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความสูงที่จะตัดออก: 0-1 เป็นสัดส่วนของความสูงปัจจุบัน; มากกว่า 1 เป็นพิกเซล ไม่เกินความสูงทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — ขอบเขตใหม่แคบลงจากขอบด้านล่าง

ตัวอย่าง

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

Region.bottom

ย่อส่วนนี้ไปทางด้านล่าง ขอบด้านบนเลื่อนลงตามจำนวนที่ร้องขอ

รูปแบบคำสั่ง

region.bottom(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความสูงที่จะตัดออก: 0-1 เป็นสัดส่วนของความสูงปัจจุบัน; มากกว่า 1 เป็นพิกเซล ไม่เกินความสูงทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — ขอบเขตใหม่แคบลงจากขอบด้านบน

ตัวอย่าง

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

Region.horizontal

ย่อแนวนอนไปทางกึ่งกลางโดยเลื่อนขอบทั้งซ้ายและขวาเข้าด้านใน

รูปแบบคำสั่ง

region.horizontal(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความกว้างรวมที่จะตัดออก แบ่งเท่ากันสองข้าง: 0-1 เป็นสัดส่วน มากกว่า 1 เป็นพิกเซล ไม่เกินความกว้างทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — พื้นที่กึ่งกลางที่มีความกว้างลดลง

ตัวอย่าง

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

Region.vertical

ย่อแนวตั้งเข้าหากึ่งกลางโดยเลื่อนขอบทั้งด้านบนและด้านล่างเข้าด้านใน

รูปแบบคำสั่ง

region.vertical(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ความสูงรวมที่จะตัดออก แบ่งเท่ากันสองข้าง: 0-1 เป็นสัดส่วน มากกว่า 1 เป็นพิกเซล ไม่เกินความสูงทั้งหมด ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — บริเวณกึ่งกลางที่มีความสูงลดลง

ตัวอย่าง

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

Region.middle

ย่อทั้งความกว้างและความสูงเข้าหากึ่งกลาง

รูปแบบคำสั่ง

region.middle(value=0.5)

พารามิเตอร์

ชื่อคำอธิบาย
valueNumber
ขนาดที่จะตัดออกจากแต่ละมิติ: 0-1 เป็นสัดส่วนของมิตินั้น; มากกว่า 1 เป็นพิกเซล แบ่งเท่ากันระหว่างขอบตรงข้ามและไม่เกินขนาดแต่ละมิติ ค่าลบทำให้เกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0.5

ค่าที่ส่งกลับ

Region — บริเวณศูนย์กลางลดลงบนทั้งสองแกน

ตัวอย่าง

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

Region.highlight

วาดกรอบสี่เหลี่ยมรอบพื้นที่นี้ การเรียกซ้ำบน Region เดิมจะแทนที่กรอบเดิม เมธอดคืนค่าก่อนวาดเสร็จ และแสดงเฉพาะการอัปเดตล่าสุดก่อนรีเฟรชหน้าจอครั้งถัดไป

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
colorColor | String | Number
Highlight color.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: green
line_widthNumber
ความหนากรอบเป็น dp; ค่าต่ำกว่า 1 จะเป็น 1
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 2
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
movableBoolean
Allow dragging the highlighted region and write the moved coordinates back into this Region.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False

ค่าที่ส่งกลับ

Region — ส่งคืนขอบเขตเดียวกันหลังจากวาดไฮไลท์

ตัวอย่าง

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

Region.highlight_off

ลบกรอบที่ Region นี้สร้าง

รูปแบบคำสั่ง

region.highlight_off()

ค่าที่ส่งกลับ

Region — ส่งคืนขอบเขตเดิมหลังจากปิดไฮไลต์

ตัวอย่าง

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