Runtime v2.81 · Na-update noong Set 30, 2026

Point

Isang punto sa screen, na sinusukat sa mga pixel.

Syntax

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

Mga parameter ng constructor

PangalanPaglalarawan
xNumber
X coordinate in pixels
Kailangan · Ayon lang sa posisyon
Walang default
yNumber
Y coordinate in pixels
Kailangan · Ayon lang sa posisyon
Walang default
scaleString
Coordinate scale mode.
Opsyonal · Ayon sa posisyon o pangalan
Default: fixed
anchorString
Coordinate anchor.
Opsyonal · Ayon sa posisyon o pangalan
Default: none

Ibinabalik na halaga

Point

Pagkilos / epekto

Isang punto sa screen, na sinusukat sa mga pixel. Scale/anchor control coordinate mapping sa mga laki ng screen. Pagkatapos ng pagmamapa at pag-offset, i-clamp ng mga consumer ng runtime ang huling punto sa wastong saklaw ng pixel ng kasalukuyang screen. Point ay maaaring destructured bilang x, y.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga field

PangalanPaglalarawan
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
Halimbawa ng field
# Basahin ang mga value na x, y ng Point
p = Point(500, 900)
x_value = p.x #500
y_value = p.y #900
scale_value = p.scale #FIXED_PIXEL

# I-unpack ang Point bilang mga coordinate na x, y
x, y = p
Halimbawa ng constructor
# Gumawa ng Point na may scale/anchor at i-click ang posisyong iyon
p = Point(500, 900, scale="width", anchor="center")
click(p)

Mga method

3 method

Point.offset

Resolve this Point on the current screen, multiply integer pixel dx/dy by the selected full-screen width or height ratio without rotating the delta axes, then add the result and return a new fixed-pixel Point with anchor none.

Syntax

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

Mga parameter

PangalanPaglalarawan
dxInt
Integer pixel delta on the Point X axis. Decimal and normalized values are rejected.
Kailangan · Ayon sa posisyon o pangalan
Walang default
dyInt
Integer pixel delta on the Point Y axis. Decimal and normalized values are rejected.
Kailangan · Ayon sa posisyon o pangalan
Walang default
scaleString?
Offset scale mode using full-screen dimensions. Defaults to this Point's current scale. Values: fixed, auto, width, height.
Opsyonal · Ayon sa posisyon o pangalan
Default: None

Ibinabalik na halaga

Point — Isang nalutas na fixed-pixel Point na naka-clamp sa kasalukuyang screen, na ang sukat ay FIXED_PIXEL at ang anchor ay WALA.

Pagkilos / epekto

Resolve this Point on the current screen, multiply integer pixel dx/dy by the selected full-screen width or height ratio without rotating the delta axes, then add the result and return a new fixed-pixel Point with anchor none. App viewport size is not used. When scale is omitted, the offset inherits this Point's scale. The original point is not mutated.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

# I-scale ang pixel delta ayon sa buong lapad ng screen, pagkatapos idagdag sa Point
target = Point(500, 900, scale="width", anchor="center").offset(120, -80)
print(target)
target.highlight()

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Point.highlight

Gumuhit ng naka-highlight na parisukat na nakasentro sa puntong ito.

Syntax

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

Mga parameter

PangalanPaglalarawan
colorColor | String | Number
Highlight color.
Opsyonal · Ayon sa posisyon o pangalan
Default: green
line_widthNumber
Stroke thickness in dp.
Opsyonal · Ayon sa posisyon o pangalan
Default: 2
region_widthNumber
Square width/height in pixels.
Opsyonal · Ayon sa posisyon o pangalan
Default: 36
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0

Ibinabalik na halaga

Region — Nakasentro sa paligid ng punto ang naka-highlight na parisukat na rehiyon.

Pagkilos / epekto

Gumuhit ng naka-highlight na parisukat na nakasentro sa puntong ito. Ang muling pag-highlight sa parehong puntong instance ay papalitan ang nauna.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Point.highlight_off

I-off ang highlight para sa point instance na ito.

Syntax

point.highlight_off()

Mga parameter

Wala

Ibinabalik na halaga

Point — Ibinabalik ang parehong punto pagkatapos i-off ang highlight.

Pagkilos / epekto

I-off ang highlight para sa point instance na ito.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API