Runtime v2.81 · Diperbarui 30 Sep 2026

Point

Sebuah titik di layar, diukur dalam piksel.

Sintaks

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

Parameter konstruktor

NamaDeskripsi
xNumber
X coordinate in pixels
Wajib · Hanya posisi
Tanpa nilai bawaan
yNumber
Y coordinate in pixels
Wajib · Hanya posisi
Tanpa nilai bawaan
scaleString
Coordinate scale mode.
Opsional · Posisi atau nama
Default: fixed
anchorString
Coordinate anchor.
Opsional · Posisi atau nama
Default: none

Nilai yang dikembalikan

Point

Perilaku / efek samping

Sebuah titik di layar, diukur dalam piksel. Pemetaan koordinat kontrol skala/jangkar di seluruh ukuran layar. Setelah pemetaan dan offset, konsumen runtime memasukkan titik akhir ke rentang piksel valid layar saat ini. Titik dapat didestrukturkan menjadi x, y.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Field

NamaDeskripsi
xNumber
Horizontal coordinate in pixels.
yNumber
Vertical coordinate in pixels.
scaleString
Coordinate scale mode. Values: fixed, auto, width, height.
Default: fixed
anchorString
Coordinate anchor. Values: none, center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right, auto.
Default: none
Contoh field
# Baca nilai x, y dari Point
p = Point(500, 900)
x_value = p.x #500
y_value = p.y #900
scale_value = p.scale #FIXED_PIXEL

# Bongkar Point menjadi koordinat x, y
x, y = p
Contoh konstruktor
# Buat Point dengan scale/anchor lalu klik posisi itu
p = Point(500, 900, scale="width", anchor="center")
click(p)

Metode

3 metode

Point.offset

Selesaikan Titik ini pada layar saat ini, kalikan bilangan bulat piksel dx/dy dengan rasio lebar atau tinggi layar penuh yang dipilih tanpa memutar sumbu delta, lalu tambahkan hasilnya dan kembalikan Titik piksel tetap baru dengan tidak ada jangkar.

Sintaks

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

Parameter

NamaDeskripsi
dxInt
Integer pixel delta on the Point X axis. Decimal and normalized values are rejected.
Wajib · Posisi atau nama
Tanpa nilai bawaan
dyInt
Integer pixel delta on the Point Y axis. Decimal and normalized values are rejected.
Wajib · Posisi atau nama
Tanpa nilai bawaan
scaleString?
Offset scale mode using full-screen dimensions. Defaults to this Point's current scale. Values: fixed, auto, width, height.
Opsional · Posisi atau nama
Default: None

Nilai yang dikembalikan

Point — Titik piksel tetap terselesaikan yang dijepit ke layar saat ini, yang skalanya FIXED_PIXEL dan jangkarnya NONE.

Perilaku / efek samping

Selesaikan Titik ini pada layar saat ini, kalikan bilangan bulat piksel dx/dy dengan rasio lebar atau tinggi layar penuh yang dipilih tanpa memutar sumbu delta, lalu tambahkan hasilnya dan kembalikan Titik piksel tetap baru dengan tidak ada jangkar. Ukuran area pandang aplikasi tidak digunakan. Ketika skala dihilangkan, offset mewarisi skala Titik ini. Poin aslinya tidak bermutasi.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

# Skalakan delta piksel menurut lebar layar penuh, lalu tambahkan ke Point
target = Point(500, 900, scale="width", anchor="center").offset(120, -80)
print(target)
target.highlight()

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Point.highlight

Gambarlah sebuah kotak yang disorot di tengah titik ini.

Sintaks

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

Parameter

NamaDeskripsi
colorColor | String | Number
Highlight color.
Opsional · Posisi atau nama
Default: green
line_widthNumber
Stroke thickness in dp.
Opsional · Posisi atau nama
Default: 2
region_widthNumber
Square width/height in pixels.
Opsional · Posisi atau nama
Default: 36
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
Opsional · Posisi atau nama
Default: 0

Nilai yang dikembalikan

Region — Wilayah persegi yang disorot berpusat di sekitar titik tersebut.

Perilaku / efek samping

Gambarlah sebuah kotak yang disorot di tengah titik ini. Menyorot ulang contoh titik yang sama akan menggantikan contoh sebelumnya.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Point.highlight_off

Matikan sorotan untuk contoh titik ini.

Sintaks

point.highlight_off()

Parameter

Tidak ada

Nilai yang dikembalikan

Point — Mengembalikan titik yang sama setelah mematikan sorotan.

Perilaku / efek samping

Matikan sorotan untuk contoh titik ini.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait