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 上下文/mpl 轴上绘制调色板的颜色 |
方法 | __repr__ |
未归档 |
方法 | clear |
清除结果缓存。 |
方法 | get |
从调色板返回给定的颜色。 |
方法 | get |
从调色板返回多种颜色。 |
属性 | length |
返回此调色板中的颜色数量 |
方法 | _get |
在子类中重写此方法以创建自定义调色板。 |
实例变量 | _cache |
未归档 |
实例变量 | _length |
未归档 |
在给定的 Cairo 上下文/mpl 轴上绘制调色板的颜色
在 Cairo 和 matplotlib 中支持的关键字参数是
- 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.
在 Cairo 中额外支持的关键字参数是
- border_width:调色板周围边框的线宽。如果为零或负数,则边框关闭。默认为1.
- grid_width:分隔调色板单元格的网格的线宽。如果为零或负数,则网格关闭。如果单元格的大小小于给定线宽的三倍,网格也会关闭。默认为0。也允许使用小数宽度。
matplotlib 中的关键字参数将传递给 Axes.imshow。
从调色板返回给定的颜色。
值被缓存:如果给定的特定值已被查找,则其值将从缓存中返回,而不是再次计算。如有必要,使用 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 元组 |