Point

ตำแหน่งบนหน้าจอในหน่วยพิกเซล ใช้สำหรับคลิก ปัด และทำเครื่องหมาย Scale และ anchor ปรับตำแหน่งตามขนาดหน้าจอ โดยจำกัดตำแหน่งสุดท้ายให้อยู่ในหน้าจอ อ่านพิกัดทั้งสองด้วย x, y = point

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

Point(x, y, /, scale="fixed", anchor="none")

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

ชื่อคำอธิบาย
xNumber
X coordinate in pixels
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
yNumber
Y coordinate in pixels
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
scaleString
การปรับพิกัดจากหน้าจอต้นฉบับของมาโคร: fixed คงพิกเซล; auto ปรับ X ตามอัตราส่วนความกว้างและ Y ตามความสูง; width หรือ height ปรับทั้งสองแกนตามมิตินั้น พิกัดที่ไม่ใช่ fixed หรือมี anchor จะปรับตามการหมุนหน้าจอและพื้นที่แอปของมาโครด้วย
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: fixed
anchorString
ตำแหน่งอ้างอิงสำหรับปรับพิกัด: none (มุมซ้ายบน), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right ส่วน auto เลือกขอบหรือจุดกึ่งกลางที่ใกล้ที่สุด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: none

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

ตัวอย่าง

origin = Point(0, 0)
target = Point(500, 900)
swipe([
    SwipePoint(origin, speed="NORMAL"),
    SwipePoint(target)
])

ฟิลด์

ชื่อคำอธิบาย
xNumber
Horizontal coordinate in pixels.
yNumber
Vertical coordinate in pixels.
scaleString
การปรับพิกัดจากหน้าจอต้นฉบับของมาโคร: fixed คงพิกเซล; auto ปรับ X ตามอัตราส่วนความกว้างและ Y ตามความสูง; width หรือ height ปรับทั้งสองแกนตามมิตินั้น พิกัดที่ไม่ใช่ fixed หรือมี anchor จะปรับตามการหมุนหน้าจอและพื้นที่แอปของมาโครด้วย
ค่าเริ่มต้น: fixed
anchorString
ตำแหน่งอ้างอิงสำหรับปรับพิกัด: none (มุมซ้ายบน), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right ส่วน auto เลือกขอบหรือจุดกึ่งกลางที่ใกล้ที่สุด
ค่าเริ่มต้น: none
ตัวอย่างการอ่านฟิลด์
# อ่านค่า x, y ของ Point
p = Point(500, 900)
x_value = p.x #500
y_value = p.y #900
scale_value = p.scale #FIXED_PIXEL

# แยก Point เป็นพิกัด x, y
x, y = p
ตัวอย่างการสร้างออบเจ็กต์
# สร้าง Point ที่มี scale/anchor แล้วแตะตำแหน่งนั้น
p = Point(500, 900, scale="width", anchor="center")
click(p)

เมธอด

4 เมธอด

Point.distance_to

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

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

point.distance_to(other)

พารามิเตอร์

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

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

Number — ระยะทางที่เป็นจำนวนจำกัด พิกัดหรือระยะทางที่ไม่จำกัดทำให้เกิดข้อผิดพลาด

ตัวอย่าง

# วัดระยะระหว่างสองจุด
print(Point(0, 0).distance_to(Point(3, 4)))

Point.offset

คืน Point ใหม่ที่เลื่อนตาม dx และ dy หลังปรับจุดนี้ให้เข้ากับหน้าจอปัจจุบัน ปรับระยะเลื่อนตามขนาดเต็มหน้าจอ โดย X ยังคงเป็นแนวนอนและ Y เป็นแนวตั้ง Point เดิมไม่เปลี่ยน

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

point.offset(dx, dy, scale=None)

พารามิเตอร์

ชื่อคำอธิบาย
dxInt
ระยะเลื่อนแนวนอนเป็นจำนวนเต็มพิกเซล: บวกไปขวา ลบไปซ้าย ไม่รับเศษส่วน
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
dyInt
ระยะเลื่อนแนวตั้งเป็นจำนวนเต็มพิกเซล: บวกลงล่าง ลบขึ้นบน ไม่รับเศษส่วน
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
scaleString?
Offset scale mode using full-screen dimensions. Defaults to this Point's current scale. Values: fixed, auto, width, height.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

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

Point — Point ใหม่ภายในหน้าจอปัจจุบัน โดย scale เป็น FIXED_PIXEL และ anchor เป็น NONE

ตัวอย่าง

# สเกลค่าเลื่อนพิกเซลตามความกว้างเต็มหน้าจอ แล้วบวกเข้ากับ Point
target = Point(500, 900, scale="width", anchor="center").offset(120, -80)
print(target)
target.highlight()

Point.highlight

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

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

point.highlight(color="green", line_width=2, region_width=36, auto_hide_ms=0)

พารามิเตอร์

ชื่อคำอธิบาย
colorColor | String | Number
Highlight color.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: green
line_widthNumber
ความหนากรอบเป็น dp; ค่าต่ำกว่า 1 จะเป็น 1
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 2
region_widthNumber
ความกว้างและสูงของสี่เหลี่ยมจัตุรัสเป็นพิกเซล; ค่าต่ำกว่า 1 จะเป็น 1
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 36
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0

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

Region — พื้นที่สี่เหลี่ยมจัตุรัสที่ไฮไลต์อยู่ตรงกลางรอบจุด

ตัวอย่าง

p = Point(500, 900)
p.highlight()

Point.highlight_off

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

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

point.highlight_off()

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

Point — ส่งคืนจุดเดิมหลังจากปิดไฮไลต์

ตัวอย่าง

p = Point(500, 900)
p.highlight("red", 3)
wait(1000)
p.highlight_off()