gradient
最后更新
luxonis_ml.utils.color.gradient用于标量场(如热图)的颜色渐变(色图)。Gradient 通过在有序颜色停止点之间进行线性插值,将 [0, 1] 中的标量映射到 Color。它是热图的颜色模型,与 Palette 类分开,因为热图着色的是连续的量级,而不是一组离散的类别。一些现成的渐变已按名称注册在 GRADIENTS 中(如 "viridis"/"turbo" 等感知均匀的渐变,以及 "jet" 和 "hot" 等经典渐变)。使用 resolve_gradient 解析名称或传递您自己的渐变;使用 Gradient.from_colors 构建自定义渐变。只有 Gradient.colorize 需要 NumPy,并且它在调用时导入 NumPy,因此此模块在没有 NumPy 的基本 luxonis-ml 安装上仍然可以导入。类
Gradient
[0, 1] 中的标量 t 通过周围停止点之间的分段线性插值映射到颜色。超出 [0, 1] 的值将被钳制。示例
Pycon
1>>> g = Gradient.from_colors(["#000000", "#ff0000"])
2>>> g.color_at(0.0)
3Color(r=0, g=0, b=0, a=255)
4>>> g.color_at(0.5)
5Color(r=128, g=0, b=0, a=255)
6>>> g.color_at(1.0)
7Color(r=255, g=0, b=0, a=255)方法
color_at
Python
1def color_at(t: float) -> Color:[0, 1] 中标量 t 处的颜色(已钳制)。所有四个通道都进行插值,因此半透明停止点之间的渐变也会在 alpha 通道中淡入淡出。参数t(float): 沿渐变的位置。
Color: 插值的 Color。
colorize
Python
1def colorize(field: npt.ArrayLike) -> np.ndarray:field(npt.ArrayLike): 标量数组,预期在[0, 1]范围内(值将被钳制)。接受任何形状,以及numpy.asarray转换为浮点数组的任何内容。
np.ndarray: 形状为(*field.shape, 3)的uint8数组,按 RGB 顺序排列。
from_colors
Python
1def from_colors(colors: list[ColorLike], *, positions: list[float] | None = None) -> Gradient:colors(list[ColorLike]): 两个或更多颜色(十六进制字符串、元组或 Color),从刻度的低端到高端。positions(list[float] | None): 可选的停止点位置,在[0, 1]范围内,每个颜色一个;当为None时,颜色从0到1均匀分布。
Gradient: Gradient。
ValueError: 如果给定的颜色少于两种,或者positions的长度与colors不同,或者位置超出[0, 1]范围,或者位置重复。
属性
stops
(position, color) 对,位置在 [0, 1] 范围内;第一个应在 0.0 处,最后一个应在 1.0 处。函数
resolve_gradient
Python
1def resolve_gradient(gradient: Gradient | str) -> Gradient:示例
Pycon
1>>> resolve_gradient("grayscale").color_at(1.0)
2Color(r=255, g=255, b=255, a=255)Gradient: Gradient。
KeyError: 如果给定的名称不是已注册的预设。