base
最后更新
luxonis_ml.utils.color.base颜色解析和操作。Color 类是 luxonis-ml 共享的单一颜色基元——可视化层重新导出它,其他子模块(例如增强填充值)也通过它解析颜色,因此没有模块重新实现颜色处理。颜色被标准化为 8 位整数的 (r, g, b, a) 元组。Color.parse 接受用户实际拥有的形状——十六进制字符串、CSS 颜色名称、单个灰度整数、RGB/RGBA 元组或另一个 Color——并公开调色板和样式派生所依赖的 HSL 空间操作。类
Color
示例
Pycon
1>>> Color.parse("#4c8dff")
2Color(r=76, g=141, b=255, a=255)
3>>> Color.parse("#abc")
4Color(r=170, g=187, b=204, a=255)
5>>> Color.parse("white")
6Color(r=255, g=255, b=255, a=255)
7>>> Color.parse(128)
8Color(r=128, g=128, b=128, a=255)
9>>> Color.parse(300) # out-of-range channels are clamped
10Color(r=255, g=255, b=255, a=255)
11>>> Color.parse((255, 0, 0))
12Color(r=255, g=0, b=0, a=255)
13>>> Color.parse("white").rgb
14(255, 255, 255)
15>>> Color(255, 0, 0).with_alpha(0.5)
16Color(r=255, g=0, b=0, a=128)
17>>> Color(1, 2, 3, 4).rgba
18(1, 2, 3, 4)
19>>> Color(255, 255, 255).readable_text_color()
20Color(r=17, g=17, b=17, a=255)
21>>> Color(0, 0, 0).readable_text_color()
22Color(r=255, g=255, b=255, a=255)
23>>> c = Color(120, 120, 120)
24>>> c.lighten(0.5).hls[1] > c.hls[1]
25True
26>>> c.darken(0.5).hls[1] < c.hls[1]
27True
28>>> Color.parse("#12")
29Traceback (most recent call last):
30 ...
31ValueError: invalid hex color '#12'方法
darken
Python
1def darken(amount: float) -> Color:amount(float): 要移除的当前亮度分数,范围为[0, 1]。
Color: 较暗的 Color,alpha 值保持不变。
from_hls
Python
1def from_hls(hue: float, lightness: float, saturation: float, a: int = 255) -> Color:hue(float): 色相,范围为[0, 1]。lightness(float): 亮度,范围为[0, 1]。saturation(float): 饱和度,范围为[0, 1]。a(int): Alpha 通道,0-255。
Color: 对应的 Color。
lighten
Python
1def lighten(amount: float) -> Color:amount(float): 要添加的剩余亮度分数,范围为[0, 1]。
Color: 较亮的 Color,alpha 值保持不变。
parse
Python
1def parse(value: object) -> Color:value(object): 十六进制字符串("#rgb"、"#rrggbb"、"#rrggbbaa",带或不带前导#)、CSS 颜色名称("red")、单个灰度整数(128→ 灰色)、(r, g, b)或(r, g, b, a)元组,或现有的 Color。
Color: 对应的 Color。
ValueError: 如果该值无法解释为颜色。
readable_text_color
Python
1def readable_text_color(self) -> Color:不透明颜色: 在浅色上是柔和的接近黑色,在深色上是白色,因此此颜色芯片上的标签文本保持清晰可辨。
saturate
Python
1def saturate(amount: float) -> Color:amount(float): 要添加的剩余饱和度分数,范围为[-1, 1]。
Color: 饱和度调整后的 Color,alpha 值保持不变。
shift_hue
Python
1def shift_hue(turns: float) -> Color:turns(float): 旋转量,以圈为单位(1.0是一整圈)。
Color: 色相旋转后的 Color,alpha 值保持不变。
with_alpha
Python
1def with_alpha(a: float) -> Color:a(float): Alpha 值,可以是整数 (0-255) 或浮点数[0, 1]。
Color: 具有请求 alpha 值的新 Color。
属性
a
b
g
hls
(hue, lightness, saturation) 元组,范围为 [0, 1]。is_light
r
rgb
(r, g, b) 元组。rgba
(r, g, b, a) 元组。属性
ColorLike
RGB
(r, g, b) 元组 (0-255)。RGBA
(r, g, b, a) 元组 (0-255)。