class Palette
已知子类:igraph.drawing.colors.AdvancedGradientPalette
, igraph.drawing.colors.GradientPalette
, igraph.drawing.colors.PrecalculatedPalette
, igraph.drawing.colors.RainbowPalette
颜色调色板的基类。
颜色调色板是将 0..n − 1 范围内的整数分配给颜色(4 元组)的映射。n 称为调色板的大小或长度。igraph附带了许多预定义的调色板,因此只有当您想定义自己的调色板时,此类才对您有用。这可以通过对此类进行子类化并根据需要实现 Palette._get
方法来完成。
调色板也可以用作列表或字典,因为__getitem__方法被正确覆盖以调用 Palette.get
。
方法 | __init__ |
未归档 |
方法 | __len__ |
返回此调色板中的颜色数量 |
方法 | __plot__ |
在给定的 Cairo 上下文中绘制调色板的颜色 |
方法 | __repr__ |
未归档 |
方法 | clear |
清除结果缓存。 |
方法 | get |
从调色板返回给定的颜色。 |
方法 | get |
从调色板返回多种颜色。 |
属性 | length |
返回此调色板中的颜色数量 |
方法 | _get |
在子类中覆盖此方法以创建自定义调色板。 |
实例变量 | _cache |
未归档 |
实例变量 | _length |
未归档 |
在给定的 Cairo 上下文中绘制调色板的颜色
支持的关键字参数有
- border_width:调色板周围显示的边框的线条宽度。如果为零或负数,则关闭边框。默认为1.
- grid_width:分隔调色板单元格的网格的线条宽度。如果为零或负数,则关闭网格。如果单元格的大小小于给定线条宽度的三倍,则也会关闭网格。默认为0。也允许使用小数宽度。
- orientation:调色板的方向。必须是以下值之一left-right, bottom-top, right-left之一或top-bottom。可能的别名horizontal = left-right, vertical = bottom-top, lr = left-right, rl = right-left, tb = top-bottom, bt = bottom-top。默认是left-right.
从调色板返回给定的颜色。
值会被缓存:如果给定的特定值已经被查找过,它的值将从缓存中返回,而不是重新计算。如有必要,使用 Palette.clear_cache
清除缓存。
参数 | |
v | 要检索的颜色。如果它是一个整数,它将被传递给 Palette._get 以转换为 RGBA 四元组。否则,它将被传递给 color_name_to_rgb() 以确定 RGBA 值。 |
返回值 | |
颜色作为 RGBA 四元组 | |
注意 | |
您不应该在子类中覆盖此方法,而是覆盖 _get 。如果您覆盖此方法,则在 known_colors 字典中的查找将不起作用,因此您将无法通过名称或 RGBA 四元组来引用颜色,只能通过整数索引。缓存功能也会消失。但是,如果您想要完全相同的行为,请随意覆盖此方法。 |
从调色板返回多种颜色。
值会被缓存:如果给定的特定值已经被查找过,它的值将从缓存中返回,而不是重新计算。如有必要,使用 Palette.clear_cache
清除缓存。
参数 | |
colors | 要检索的颜色列表。调色板类会尝试在此处进行有根据的猜测:如果无法将您在此处传递的值解释为颜色列表,则该类将简单地尝试通过将该值转发到 Palette.get 来将其解释为单一颜色。 |
返回值 | |
颜色作为 RGBA 四元组的列表。即使您传递了单一颜色索引或颜色名称,结果也将是一个列表。 |
igraph.drawing.colors.AdvancedGradientPalette
, igraph.drawing.colors.GradientPalette
, igraph.drawing.colors.PrecalculatedPalette
, igraph.drawing.colors.RainbowPalette
中覆盖在子类中覆盖此方法以创建自定义调色板。
您可以安全地假设 v 是 0..n − 1 范围内的整数,其中 n 是调色板的大小。
参数 | |
v | 要检索的颜色的数值索引 |
返回值 | |
包含 RGBA 值的 4 元组 |