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.
# 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
Method
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
Nama
Deskripsi
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.
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.
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.