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

Color

Class

Kumakatawan sa isang kulay ng ARGB at nagbibigay ng color sampling/comparison helper.

Syntax

Color(value, /)

Mga parameter ng constructor

Pangalan	Paglalarawan
`valueString \| Number`	Hex string (`#AARRGGBB`/`#RRGGBB`) or raw ARGB number. Kailangan · Ayon lang sa posisyon Walang default

Ibinabalik na halaga

Color

Pagkilos / epekto

Kumakatawan sa isang kulay ng ARGB at nagbibigay ng color sampling/comparison helper.

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

cursor = Point(540, 920)
picked = Color.get(cursor)
if picked == "#FFFFFFFF":
    click(cursor, random=6)

Mga error / limitasyon

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

Mga kaugnay na API

Wala

Mga field

Pangalan	Paglalarawan
`argbNumber`	Raw ARGB integer value.
`aInt`	Alpha channel 0-255.
`rInt`	Red channel 0-255.
`gInt`	Green channel 0-255.
`bInt`	Blue channel 0-255.
`hexString`	Hex string `#AARRGGBB`.

Halimbawa ng constructor

c1 = Color("#FFFFFFFF")
c2 = Color(4294967295)

Mga method

7 method

Color.get

Static Method

Basahin ang (mga) kulay mula sa screen: Point -> Color, Region -> 2D Color array, list[Point] -> Color list.

Syntax

Color.get(target, interval=3, default="#00000000")

Mga parameter

Pangalan	Paglalarawan
`targetPoint \| Region \| list[Point]`	Sampling target. Kailangan · Ayon sa posisyon o pangalan Walang default
`intervalNumber`	Grid step (pixels) when target is Region. Opsyonal · Ayon sa posisyon o pangalan Default: `3`
`defaultColor \| String \| Number`	Fallback color returned when screen capture or pixel sampling is unavailable. Opsyonal · Ayon sa posisyon o pangalan Default: `#00000000`

Ibinabalik na halaga

Color | list[list[Color]] | list[Color] — Na-sample na payload ng kulay batay sa uri ng target, na may mga nawawalang sample na napunan bilang default.

Pagkilos / epekto

Basahin ang (mga) kulay mula sa screen: Point -> Color, Region -> 2D Color array, list[Point] -> Color list. Ito ay isang agarang one-shot sample; kung walang available na frame o may nawawalang sample, ibabalik ang default na kulay sa halip na subukang muli o ihinto ang script.

Pagpapatakbo

Naghihintay matapos: Oo
Kaligtasan ng sabayang paggamit: Sunod-sunod
Sabayang pagpapatakbo: May kondisyon

Kumukuha ng sample mula sa shared capture frame sa caller; may oras ang capture at pagproseso. Shared sa ibang flow ang capture/cache policy.

Halimbawa

c = Color.get(Point(100, 200), default="#FF000000")
grid = Color.get(Region(120, 240, 90, 60), interval=3, default="#00000000")
batch = Color.get([Point(10, 10), Point(20, 20)])

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.compare

Static Method

Paghambingin ang dalawang kulay ayon sa per-channel na RGB tolerance.

Syntax

Color.compare(a, b, tolerance=0)

Mga parameter

Pangalan	Paglalarawan
`aColor \| String \| Number`	First color. Kailangan · Ayon sa posisyon o pangalan Walang default
`bColor \| String \| Number`	Second color. Kailangan · Ayon sa posisyon o pangalan Walang default
`toleranceNumber`	Allowed per-channel difference (0-255). Practical start: 4-8 for near-identical UI shades, 10-16 for anti-alias/compression variation. Opsyonal · Ayon sa posisyon o pangalan Default: `0`

Ibinabalik na halaga

Boolean — totoo kapag ang lahat ng RGB channel ay nasa loob ng tolerance. Mabilis na gabay: 0 = eksakto, 4-8 = halos pareho, 10-16 = mapagparaya na tugma, >24 = napakaluwag.

Pagkilos / epekto

Paghambingin ang dalawang kulay ayon sa per-channel na RGB tolerance. Ang laban ay pumasa lamang kapag |R1-R2|, |G1-G2|, at |B1-B2| lahat ay <= pagpaparaya.

Pagpapatakbo

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

Halimbawa

base = Color(\"#FF4CAF50\")
sample = Color.get(Point(620, 340))
is_same = Color.compare(base, sample, tolerance=8)  # halos kaparehong UI shade

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.distance_rgb

Static Method

Compute Euclidean distance sa RGB space sa pagitan ng dalawang kulay.

Syntax

Color.distance_rgb(a, b)

Mga parameter

Pangalan	Paglalarawan
`aColor \| String \| Number`	First color. Kailangan · Ayon sa posisyon o pangalan Walang default
`bColor \| String \| Number`	Second color. Kailangan · Ayon sa posisyon o pangalan Walang default

Ibinabalik na halaga

Number — RGB-space distance sa range 0 -> 441.67 (0 = eksakto). Praktikal na gabay: <=8 halos magkapareho, 9-20 malapit, 21-40 kitang-kitang magkaiba, >40 magkalayo.

Pagkilos / epekto

Compute Euclidean distance sa RGB space sa pagitan ng dalawang kulay.

Pagpapatakbo

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

Halimbawa

actual = Color.get(Point(620, 340))
rgb_gap = Color.distance_rgb(\"#FF4CAF50\", actual)
if rgb_gap <= 15:
    print(\"close in RGB\")

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.delta_e

Static Method

Compute CIE76 Delta E sa pagitan ng dalawang kulay para sa perceptual difference.

Syntax

Color.delta_e(a, b)

Mga parameter

Pangalan	Paglalarawan
`aColor \| String \| Number`	First color. Kailangan · Ayon sa posisyon o pangalan Walang default
`bColor \| String \| Number`	Second color. Kailangan · Ayon sa posisyon o pangalan Walang default

Ibinabalik na halaga

Number — marka ng pagkakaiba ng perceptual. Panuntunan ng hinlalaki: <1 hindi mahahalata, 1-2 halos hindi napapansin, 2-5 kapansin-pansin, 5-10 malinaw na naiiba, >10 iba't ibang kulay.

Pagkilos / epekto

Compute CIE76 Delta E sa pagitan ng dalawang kulay para sa perceptual difference.

Pagpapatakbo

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

Halimbawa

actual = Color.get(Point(620, 340))
d = Color.delta_e(\"#FF4CAF50\", actual)
if d <= 3:
    print(\"looks similar to human eye\")

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.compare

Method

Paghahambing ng bersyon ng halimbawa ng RGB tolerance.

Syntax

color.compare(other, tolerance=0)

Mga parameter

Pangalan	Paglalarawan
`otherColor \| String \| Number`	Color to compare. Kailangan · Ayon sa posisyon o pangalan Walang default
`toleranceNumber`	Allowed per-channel difference (0-255). Typical same-ish range: 4-8; use 10-16 for noisy/compressed captures. Opsyonal · Ayon sa posisyon o pangalan Default: `0`

Ibinabalik na halaga

Boolean — Resulta ng paghahambing. 0 ay nangangahulugan ng eksaktong tugma; mas pinahihintulutan ang pagtutugma.

Pagkilos / epekto

Paghahambing ng bersyon ng halimbawa ng RGB tolerance. Kapaki-pakinabang kapag naka-sample ka na ng isang kulay at kumpara sa mga target na shade.

Pagpapatakbo

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

Halimbawa

picked = Color.get(Point(540, 920))
if picked.compare(\"#FFFFFFFF\", tolerance=5):
    click(Point(540, 920))

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.distance_rgb

Method

Compute Euclidean distansya sa RGB space mula sa kulay na ito sa isa pang kulay.

Syntax

color.distance_rgb(other)

Mga parameter

Pangalan	Paglalarawan
`otherColor \| String \| Number`	Color to compare. Kailangan · Ayon sa posisyon o pangalan Walang default

Ibinabalik na halaga

Number — RGB-space na distansya (0 -> 441.67). Mabilis na pagbabasa: <=8 halos magkapareho, 9-20 malapit, 21-40 kitang-kitang magkaiba, >40 malayo ang pagitan.

Pagkilos / epekto

Compute Euclidean distansya sa RGB space mula sa kulay na ito sa isa pang kulay.

Pagpapatakbo

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

Halimbawa

base = Color(\"#FF4CAF50\")
actual = Color.get(Point(620, 340))
rgb_gap = base.distance_rgb(actual)
if rgb_gap <= 20:
    print(\"close enough in RGB\")

Mga error / limitasyon

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

Mga kaugnay na API

Color

Color.delta_e

Method

Compute CIE76 Delta E mula sa kulay na ito sa isa pang kulay para sa perceptual na paghahambing.

Syntax

color.delta_e(other)

Mga parameter

Pangalan	Paglalarawan
`otherColor \| String \| Number`	Color to compare. Kailangan · Ayon sa posisyon o pangalan Walang default

Ibinabalik na halaga

Number — marka ng pagkakaiba ng kulay ng perceptual. Praktikal na gabay: <1 hindi mahahalata, 1-2 halos hindi nakikita, 2-5 kapansin-pansin, 5-10 malinaw na pagkakaiba, >10 ibang-iba.

Pagkilos / epekto

Compute CIE76 Delta E mula sa kulay na ito sa isa pang kulay para sa perceptual na paghahambing.

Pagpapatakbo

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

Halimbawa

base = Color(\"#FF4CAF50\")
actual = Color.get(Point(620, 340))
perceptual_gap = base.delta_e(actual)
if perceptual_gap <= 2:
    print(\"looks almost the same\")

Mga error / limitasyon

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

Mga kaugnay na API

Color