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

Point

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

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

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

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

ชื่อคำอธิบาย
xNumber
X coordinate in pixels
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
yNumber
Y coordinate in pixels
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
scaleString
Coordinate scale mode.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: fixed
anchorString
Coordinate anchor.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: none

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

Point

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

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

การทำงาน

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

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

ตัวอย่าง

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

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

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

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

ไม่มี

ฟิลด์

ชื่อคำอธิบาย
xNumber
Horizontal coordinate in pixels.
yNumber
Vertical coordinate in pixels.
scaleString
Coordinate scale mode. Values: fixed, auto, width, height.
ค่าเริ่มต้น: fixed
anchorString
Coordinate anchor. Values: 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)

เมธอด

3 เมธอด

Point.offset

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

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

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

พารามิเตอร์

ชื่อคำอธิบาย
dxInt
Integer pixel delta on the Point X axis. Decimal and normalized values are rejected.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
dyInt
Integer pixel delta on the Point Y axis. Decimal and normalized values are rejected.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
scaleString?
Offset scale mode using full-screen dimensions. Defaults to this Point's current scale. Values: fixed, auto, width, height.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

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

Point — จุดพิกเซลคงที่ที่แก้ไขแล้วซึ่งยึดกับหน้าจอปัจจุบัน ซึ่งมีขนาด FIXED_PIXEL และจุดยึดคือ NONE

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

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

การทำงาน

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

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

ตัวอย่าง

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

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

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

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

Point.highlight

วาดสี่เหลี่ยมจัตุรัสที่ไฮไลต์ไว้ตรงกลางจุดนี้ การไฮไลต์อินสแตนซ์จุดเดิมอีกครั้งจะแทนที่อินสแตนซ์ก่อนหน้า

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

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

พารามิเตอร์

ชื่อคำอธิบาย
colorColor | String | Number
Highlight color.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: green
line_widthNumber
Stroke thickness in dp.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 2
region_widthNumber
Square width/height in pixels.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 36
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0

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

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

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

วาดสี่เหลี่ยมจัตุรัสที่ไฮไลต์ไว้ตรงกลางจุดนี้ การไฮไลต์อินสแตนซ์จุดเดิมอีกครั้งจะแทนที่อินสแตนซ์ก่อนหน้า

การทำงาน

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

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

ตัวอย่าง

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

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

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

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

Point.highlight_off

ปิดไฮไลต์สำหรับอินสแตนซ์จุดนี้

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

point.highlight_off()

พารามิเตอร์

ไม่มี

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

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

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

ปิดไฮไลต์สำหรับอินสแตนซ์จุดนี้

การทำงาน

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

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

ตัวอย่าง

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

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

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

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