模块文档

颜色处理函数。

AdvancedGradientPalette 由两种以上基色组成的高级渐变。
ClusterColoringPalette 适用于在绘制聚类时为顶点着色的调色板。
GradientPalette 渐变调色板的基类
Palette 颜色调色板的基类。
PrecalculatedPalette 从预计算颜色列表中返回颜色的调色板
RainbowPalette 沿刻度变化颜色色调的调色板。
函数 clamp 将给定值限制在最小值和最大值之间
函数 color_name_to_rgb 将给定颜色(采用受支持的颜色格式之一)转换为R-G-B值。
函数 color_name_to_rgba 将给定颜色(采用受支持的颜色格式之一)转换为R-G-B-A值。
函数 color_to_html_format 将给定为3元组或4元组的颜色格式化为HTML格式。
函数 darken 创建由RGB三元组给定的颜色的较暗版本。
函数 hsl_to_rgb 将给定颜色的HSL坐标(色相、饱和度、亮度)转换为RGB坐标。
函数 hsla_to_rgba 将给定颜色的HSLA坐标(色相、饱和度、亮度、Alpha)转换为RGBA坐标。
函数 hsv_to_rgb 将给定颜色的HSV坐标(色相、饱和度、值)转换为RGB坐标。
函数 hsva_to_rgba 将给定颜色的HSVA坐标(色相、饱和度、值、Alpha)转换为RGB坐标。
函数 lighten 创建由RGB三元组给定的颜色的较亮版本。
函数 rgb_to_hsl 将给定颜色的RGB坐标转换为HSL坐标(色相、饱和度、亮度)。
函数 rgb_to_hsv 将给定颜色的RGB坐标转换为HSV坐标(色相、饱和度、值)。
函数 rgba_to_hsla 将给定颜色的RGBA坐标转换为HSLA坐标(色相、饱和度、亮度、Alpha)。
函数 rgba_to_hsva 将给定颜色的RGBA坐标转换为HSVA坐标(色相、饱和度、值、Alpha)。
变量 default_edge_colors 未文档化
变量 known_colors 未文档化
变量 palettes 未文档化
def clamp(value, min_value, max_value): (来源)

将给定值限制在最小值和最大值之间

def color_name_to_rgb(color, palette=None): (来源)

将给定颜色(采用受支持的颜色格式之一)转换为R-G-B值。

这是通过调用 color_name_to_rgba 然后丢弃Alpha值来完成的。

另请参阅
有关此函数支持的格式的更多详细信息,请参阅 color_name_to_rgba。
def color_name_to_rgba(color, palette=None): (来源)

将给定颜色(采用受支持的颜色格式之一)转换为R-G-B-A值。

示例

>>> color_name_to_rgba("red")
(1.0, 0.0, 0.0, 1.0)
>>> color_name_to_rgba("#ff8000") == (1.0, 128/255.0, 0.0, 1.0)
True
>>> color_name_to_rgba("#ff800080") == (1.0, 128/255.0, 0.0, 128/255.0)
True
>>> color_name_to_rgba("#08f") == (0.0, 136/255.0, 1.0, 1.0)
True
>>> color_name_to_rgba("rgb(100%, 50%, 0%)")
(1.0, 0.5, 0.0, 1.0)
>>> color_name_to_rgba("rgba(100%, 50%, 0%, 25%)")
(1.0, 0.5, 0.0, 0.25)
>>> color_name_to_rgba("hsla(120, 100%, 50%, 0.5)")
(0.0, 1.0, 0.0, 0.5)
>>> color_name_to_rgba("hsl(60, 100%, 50%)")
(1.0, 1.0, 0.0, 1.0)
>>> color_name_to_rgba("hsv(60, 100%, 100%)")
(1.0, 1.0, 0.0, 1.0)
参数
color

要转换的颜色,以下列格式之一提供:

  • CSS3 颜色规范: #rrggbb, #rgb, #rrggbbaa, #rgba, rgb(red, green, blue), rgba(red, green, blue, alpha), hsl(hue, saturation, lightness), hsla(hue, saturation, lightness, alpha), hsv(hue, saturation, value)hsva(hue, saturation, value, alpha)其中,在前四种情况下,分量以十六进制数给出,其余情况下则以十进制数或百分比(0%-100%)给出。红色、绿色和蓝色分量介于0和255之间;色相介于0和360之间;饱和度、亮度和值介于0和100之间;Alpha值介于0和1之间。
  • 有效的HTML颜色名称,即HTML 4.0规范中存在的那些名称
  • 有效的X11颜色名称,请参阅 http://en.wikipedia.org/wiki/X11_color_names
  • 红色、绿色、蓝色分量,以逗号、斜杠或空格分隔的字符串、列表或元组形式单独给出,范围为0-255。Alpha值将假定为255(最大不透明度)。
  • 红色、绿色、蓝色、Alpha分量,以逗号、斜杠或空格分隔的字符串、列表或元组形式单独给出,范围为0-255
  • 以字符串或数字形式给出的单个调色板索引。使用在palette方法调用参数中指定的调色板。
palette如果将单个数字传递给方法,则要使用的调色板。必须是 colors.Palette 的一个实例。
返回
给定颜色对应的RGBA值,以4元组形式表示。由于这些颜色主要由Cairo例程使用,因此元组包含0.0-1.0范围内的浮点数。
def color_to_html_format(color): (来源)

将给定为3元组或4元组的颜色格式化为HTML格式。

HTML格式简单表示为#rrggbbaa,其中rr表示红色分量的十六进制格式,gg表示绿色分量bb表示蓝色分量,并且gg表示Alpha级别。Alpha级别是可选的。

def darken(color, ratio=0.5): (来源)

创建由RGB三元组给定的颜色的较暗版本。

这是通过将原始颜色与黑色按给定比例混合来完成的。比例为1.0将生成完全黑色,比例为0.0将生成原始颜色。Alpha值保持不变。

def hsl_to_rgb(h, s, l): (来源)

将给定颜色的HSL坐标(色相、饱和度、亮度)转换为RGB坐标。

每个HSL坐标都必须在[0, 1]范围内。

def hsla_to_rgba(h, s, l, alpha=1.0): (来源)

将给定颜色的HSLA坐标(色相、饱和度、亮度、Alpha)转换为RGBA坐标。

每个HSLA坐标都必须在[0, 1]范围内。

def hsv_to_rgb(h, s, v): (来源)

将给定颜色的HSV坐标(色相、饱和度、值)转换为RGB坐标。

每个HSV坐标都必须在[0, 1]范围内。

def hsva_to_rgba(h, s, v, alpha=1.0): (来源)

将给定颜色的HSVA坐标(色相、饱和度、值、Alpha)转换为RGB坐标。

每个HSVA坐标都必须在[0, 1]范围内。

def lighten(color, ratio=0.5): (来源)

创建由RGB三元组给定的颜色的较亮版本。

这是通过将原始颜色与白色按给定比例混合来完成的。比例为1.0将生成完全白色,比例为0.0将生成原始颜色。

def rgb_to_hsl(r, g, b): (来源)

将给定颜色的RGB坐标转换为HSL坐标(色相、饱和度、亮度)。

每个RGB坐标都必须在[0, 1]范围内。

def rgb_to_hsv(r, g, b): (来源)

将给定颜色的RGB坐标转换为HSV坐标(色相、饱和度、值)。

每个RGB坐标都必须在[0, 1]范围内。

def rgba_to_hsla(r, g, b, alpha=1.0): (来源)

将给定颜色的RGBA坐标转换为HSLA坐标(色相、饱和度、亮度、Alpha)。

每个RGBA坐标都必须在[0, 1]范围内。

def rgba_to_hsva(r, g, b, alpha=1.0): (来源)

将给定颜色的RGBA坐标转换为HSVA坐标(色相、饱和度、值、Alpha)。

每个RGBA坐标都必须在[0, 1]范围内。

default_edge_colors: dict = (来源)

未文档化

known_colors: dict = (来源)

未文档化

未文档化