rich.color

class rich.color.Color(name, type, number=None, triplet=None)

终端颜色定义。

参数

• name (str) –

• type (ColorType) –

• number (Optional[int]) –

• triplet (Optional[ColorTriplet]) –

classmethod default()

获取一个表示默认颜色的 Color 实例。

返回值

默认颜色。

返回类型

Color

downgrade(system)

将颜色系统降级到颜色更少的系统。

参数

system (ColorSystem) –

返回类型

Color

classmethod from_ansi(number)

从其 8 位 ansi 编号创建颜色编号。

参数

number (int) – 0-255 之间的数字（包含 0 和 255）。

返回值

一个新的 Color 实例。

返回类型

Color

classmethod from_rgb(red, green, blue)

从 0-255 范围内的三个颜色分量创建一个真彩色。

参数

• red (float) – 红色分量，范围为 0-255。

• green (float) – 绿色分量，范围为 0-255。

• blue (float) – 蓝色分量，范围为 0-255。

返回值

一个新的颜色对象。

返回类型

Color

classmethod from_triplet(triplet)

从三个值的元组创建 RGB 真彩色。

参数

triplet (ColorTriplet) – 包含红色、绿色和蓝色分量的颜色元组。

返回值

一个新的颜色对象。

返回类型

Color

get_ansi_codes(foreground=True)

获取此颜色的 ANSI 转义码。

参数

foreground (bool) –

返回类型

Tuple[str, …]

get_truecolor(theme=None, foreground=True)

获取此颜色的等效颜色元组。

参数

• theme (TerminalTheme, optional) – 可选的终端主题，或 None 以使用默认值。默认为 None。

• foreground (bool, optional) – 前景色为 True，背景色为 False。默认为 True。

返回值

一个包含 RGB 分量的颜色元组。

返回类型

ColorTriplet

property is_default: bool

检查颜色是否为默认颜色。

property is_system_defined: bool

检查颜色是否最终由系统定义。

property name

颜色的名称（通常是 Color.parse 的输入）。

property number

颜色编号，如果是标准颜色，则为 None。

classmethod parse(color)

解析颜色定义。

参数

color (str) –

返回类型

Color

property system: ColorSystem

获取此颜色的原生颜色系统。

property triplet

颜色分量的元组，如果是 RGB 颜色。

property type

颜色的类型。

exception rich.color.ColorParseError

无法解析颜色。

class rich.color.ColorSystem(value)

终端支持的 3 种颜色系统之一。

class rich.color.ColorType(value)

存储在 Color 类中的颜色类型。

rich.color.blend_rgb(color1, color2, cross_fade=0.5)

将一个 RGB 颜色混合到另一个颜色中。

参数

• color1 (ColorTriplet) –

• color2 (ColorTriplet) –

• cross_fade (float) –

返回类型

ColorTriplet

rich.color.parse_rgb_hex(hex_color)

将六个十六进制字符解析为 RGB 三元组。

参数

hex_color (str) –

返回类型

ColorTriplet