Runtime v2.81 · อัปเดต 30 ก.ย. 2569

ScaleParam

พารามิเตอร์การจับคู่เทมเพลตสำหรับ Region โดย fast_matching จะลดขนาดทั้งภาพ Region และเทมเพลต

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

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

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

ชื่อคำอธิบาย
grayscaleBoolean
**Applies to templates**. Convert template matching to grayscale.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: True
auto_scaleBoolean
ลองขนาดเทมเพลตในช่วงขอบแบบปรับได้ 0.70x-1.30x หลังจากใช้สเกลเทมเพลตที่กำหนด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False
cache_scaleBoolean
บันทึกค่า auto-scale ที่จับคู่สำเร็จ
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: True
template_scaleString
ค่าที่ใช้ได้: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: SHORT_EDGE
fast_matchingBoolean
ลดขนาดทั้งภาพ Region และเทมเพลตลงเหลือสองในสามก่อนจับคู่ วิธีนี้เร็วขึ้นแต่อาจลดความแม่นยำเล็กน้อย โดยเฉพาะไอคอนขนาดเล็ก
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False

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

ScaleParam

พฤติกรรม / ผลข้างเคียง

พารามิเตอร์การจับคู่เทมเพลตสำหรับ Region โดย fast_matching จะลดขนาดทั้งภาพ Region และเทมเพลต

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

# ตั้งค่าการเตรียมภาพสำหรับการจับคู่บน Region นี้
settings = ScaleParam(grayscale=True, fast_matching=True)
region = Region(100, 200, 300, 400, scale_param=settings)
print(region.find("start", timeout=0).found)

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

ไม่มี

ฟิลด์

ชื่อคำอธิบาย
grayscaleBoolean
**Applies to templates**. Convert screenshot/template to grayscale before template matching.
ค่าเริ่มต้น: True
auto_scaleBoolean
ลองขนาดเทมเพลตรอบสเกลที่กำหนดด้วยช่วงแบบปรับตามอุปกรณ์: DPI/ความละเอียดสูงจะตรวจตัวเลือกที่เล็กลงถึง 0.70x ส่วน DPI/ความละเอียดต่ำจะตรวจตัวเลือกที่ใหญ่ขึ้นถึง 1.30x
ค่าเริ่มต้น: False
cache_scaleBoolean
บันทึกค่า auto-scale แรกที่จับคู่สำเร็จไว้สำหรับการรันครั้งถัดไป มีผลเฉพาะเมื่อ auto_scale เป็น True
ค่าเริ่มต้น: True
template_scaleString
โหมดสเกลพื้นฐานของเทมเพลต ค่าที่ใช้ได้: SHORT_EDGE, LONG_EDGE, DPI, SMALLEST_WIDTH_DP, NONE
ค่าเริ่มต้น: SHORT_EDGE
fast_matchingBoolean
ลดขนาดทั้งภาพ Region และเทมเพลตลงเหลือสองในสามก่อนจับคู่ วิธีนี้เร็วขึ้นแต่อาจลดความแม่นยำเล็กน้อย โดยเฉพาะไอคอนขนาดเล็ก
ค่าเริ่มต้น: False
ตัวอย่างการอ่านฟิลด์
param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE", fast_matching=True)
param.cache_scale = False
template_mode = param.template_scale
ตัวอย่างการสร้างออบเจ็กต์
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)