Color

Lưu một màu, lấy màu trên màn hình hoặc so sánh các màu. ARGB gồm độ đục (A), đỏ (R), xanh lá (G) và xanh dương (B); compare(), distance_rgb() và delta_e() bỏ qua độ đục.

Cú pháp

Color(value, /)

Tham số khởi tạo

TênMô tả
valueString | Number
Chuỗi hex (`#AARRGGBB`/`#RRGGBB`) hoặc số ARGB.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Ví dụ

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

Thuộc tính

TênMô tả
argbNumber
Giá trị ARGB dạng số nguyên.
aInt
Độ đục từ 0 (trong suốt) đến 255 (hoàn toàn không trong suốt).
rInt
Kênh đỏ 0-255.
gInt
Kênh xanh lá 0-255.
bInt
Kênh xanh dương 0-255.
hexString
Chuỗi hex `#AARRGGBB`.
Ví dụ khởi tạo
c1 = Color("#FFFFFFFF")
c2 = Color(4294967295)

Phương thức

9 phương thức

Color.get

Lấy màu màn hình một lần: Point trả về một Color, Region trả về các hàng màu, list[Point] trả về list màu theo đúng thứ tự. Các điểm dùng cùng một ảnh màn hình. Khi chưa thể chụp màn hình hoặc thiếu mẫu, trả về default mà không thử lại; nên chọn default phân biệt được với màu cần tìm.

Cú pháp

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

Tham số

TênMô tả
targetPoint | Region | list[Point]
Mục tiêu lấy mẫu.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
intervalNumber
Khoảng cách giữa các điểm lấy màu theo đơn vị tọa độ của Region; giá trị dưới 1 được nâng lên 1. Giá trị nhỏ hơn trả về nhiều màu hơn. Không dùng cho Point và list[Point].
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 3
defaultColor | String | Number
Màu mặc định trả về khi không chụp được màn hình hoặc không lấy được pixel.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: #00000000

Giá trị trả về

Color | list[list[Color]] | list[Color] — Các màu theo cấu trúc target, thay mẫu không lấy được bằng default. Với Region, đọc grid[hàng][cột], từ trên xuống dưới và trái sang phải. List điểm rỗng trả về list rỗng.

Ví dụ

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)])

Color.compare

So sánh hai màu theo sai số từng kênh RGB. Chỉ true khi |R1-R2|, |G1-G2| và |B1-B2| đều <= tolerance.

Cú pháp

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

Tham số

TênMô tả
aColor | String | Number
Màu thứ nhất.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
bColor | String | Number
Màu thứ hai.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
toleranceNumber
Chênh lệch tối đa cho phép trên từng kênh RGB. 0 yêu cầu các kênh bằng nhau; 255 chấp nhận mọi màu RGB. Giá trị âm được đưa về 0. Tăng dần dựa trên mẫu màu màn hình thật.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0

Giá trị trả về

Boolean — true nếu cả ba kênh RGB đều nằm trong tolerance; ngược lại là false.

Ví dụ

base = Color("#FF4CAF50")
sample = Color.get(Point(620, 340))
is_same = Color.compare(base, sample, tolerance=8)  # sắc độ UI gần giống

Color.distance_rgb

Đo chênh lệch tổng hợp của ba kênh đỏ, xanh lá và xanh dương giữa hai màu. Giá trị nhỏ hơn nghĩa là các kênh RGB gần nhau hơn; bỏ qua độ trong suốt.

Cú pháp

Color.distance_rgb(a, b)

Tham số

TênMô tả
aColor | String | Number
Màu thứ nhất.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
bColor | String | Number
Màu thứ hai.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Number — Khoảng cách từ 0 đến khoảng 441.67; 0 nghĩa là các kênh RGB giống hệt nhau. Chọn ngưỡng bằng các mẫu màu trên màn hình của bạn.

Ví dụ

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

Color.delta_e

Ước lượng hai màu trông khác nhau đến mức nào bằng CIE76 Delta E, một phép đo chênh lệch màu. Giá trị nhỏ hơn nghĩa là màu gần nhau hơn; bỏ qua độ trong suốt.

Cú pháp

Color.delta_e(a, b)

Tham số

TênMô tả
aColor | String | Number
Màu thứ nhất.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
bColor | String | Number
Màu thứ hai.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Number — Điểm chênh lệch không âm; 0 nghĩa là các kênh RGB giống hệt nhau. Hãy thử ngưỡng trên màn hình của bạn vì cảm nhận độ giống màu có thể khác nhau.

Ví dụ

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

Color.in_range

Kiểm tra từng kênh RGB nằm trong khoảng gồm cả hai đầu; bỏ qua alpha. Cận dưới lớn hơn cận trên ở bất kỳ kênh nào gây lỗi.

Cú pháp

color.in_range(min_color, max_color)

Tham số

TênMô tả
min_colorColor | String | Number
Cận màu dưới.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
max_colorColor | String | Number
Cận màu trên.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean

Ví dụ

# Kiểm tra màu có nằm trong khoảng RGB
print(Color("#808080").in_range("#606060", "#A0A0A0"))

Color.is_gray

Kiểm tra max(R, G, B) - min(R, G, B) không vượt quá spread; bỏ qua alpha.

Cú pháp

color.is_gray(spread=15)

Tham số

TênMô tả
spreadInt
Số nguyên hữu hạn từ 0 đến 255, tính cả hai đầu.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 15

Giá trị trả về

Boolean

Ví dụ

# Kiểm tra màu có gần xám
print(Color("#808080").is_gray())

Color.compare

Kiểm tra màu này có gần màu khác hay không. Chênh lệch từng kênh RGB phải không vượt quá tolerance; bỏ qua độ trong suốt.

Cú pháp

color.compare(other, tolerance=0)

Tham số

TênMô tả
otherColor | String | Number
Màu cần so sánh.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
toleranceNumber
Chênh lệch tối đa cho phép trên từng kênh RGB. 0 yêu cầu các kênh bằng nhau; 255 chấp nhận mọi màu RGB. Giá trị âm được đưa về 0. Tăng dần dựa trên mẫu màu màn hình thật.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0

Giá trị trả về

Boolean — true nếu cả ba kênh RGB đều nằm trong tolerance; ngược lại là false.

Ví dụ

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

Color.distance_rgb

Đo chênh lệch tổng hợp của các kênh RGB giữa màu này và màu khác, bỏ qua độ trong suốt.

Cú pháp

color.distance_rgb(other)

Tham số

TênMô tả
otherColor | String | Number
Màu cần so sánh.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Number — Khoảng cách từ 0 đến khoảng 441.67; 0 nghĩa là các kênh RGB giống hệt nhau. Chọn ngưỡng bằng các mẫu màu trên màn hình của bạn.

Ví dụ

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

Color.delta_e

Ước lượng màu này trông khác màu kia đến mức nào bằng CIE76 Delta E, bỏ qua độ trong suốt.

Cú pháp

color.delta_e(other)

Tham số

TênMô tả
otherColor | String | Number
Màu cần so sánh.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Number — Điểm chênh lệch không âm; 0 nghĩa là các kênh RGB giống hệt nhau. Hãy thử ngưỡng trên màn hình của bạn vì cảm nhận độ giống màu có thể khác nhau.

Ví dụ

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