igraph.drawing.cairo.plot.CairoPlot

类文档

class CairoPlot: (源)

构造函数： CairoPlot(target, bbox, palette, background)

在继承层次结构中查看

表示使用 Cairo 绘图后端绘制任意图形的类。

您可以绘制的对象包括图、矩阵、调色板、聚类、覆盖和树状图。

在 Cairo 中，每个绘图都有一个关联的曲面对象。该曲面是cairo.Surface，一个pycairo库的成员。曲面本身为各种绘图目标提供了统一的 API，例如 SVG 文件、X11 窗口、PostScript 文件、PNG 文件等。igraph通常不知道它在每个时间点正在哪个曲面上绘图，因为pycairo负责实际的绘图。所有受pycairo支持的功能也应受此类的支持。

当前支持的 Cairo 曲面包括

  • cairo.GlitzSurface—— 适用于 X11 窗口系统的 OpenGL 加速曲面。
  • cairo.ImageSurface—— 内存缓冲区曲面。可以写入为PNG图像文件。
  • cairo.PDFSurface—— PDF 文档曲面。
  • cairo.PSSurface—— PostScript 文档曲面。
  • cairo.SVGSurface—— SVG（可伸缩矢量图形）文档曲面。
  • cairo.Win32Surface—— Microsoft Windows 屏幕渲染。
  • cairo.XlibSurface—— X11 窗口系统屏幕渲染。

如果您创建一个Plot对象，并以字符串作为目标曲面，则该字符串将被视为文件名，其扩展名将决定使用哪个曲面类。请注意，并非所有曲面都可用，这取决于您的pycairo安装。

一个Plot拥有一个默认的调色板（参见 igraph.drawing.colors.Palette），用于绘制对象。

一个Plot对象还包含一个待绘制对象的列表，每个对象都有其各自的边界框、调色板和不透明度。分配给对象的调色板会覆盖绘图的默认调色板。对象可以通过 Plot.add 方法添加，并通过 Plot.remove 方法移除。

方法 __init__ 创建一个新绘图。
方法 add 向绘图添加一个对象。
方法 background.setter 设置绘图的背景颜色。None表示透明背景。您可以使用当前调色板的get方法或 igraph.drawing.colors.color_name_to_rgb 理解的任何颜色规范...
方法 mark_dirty 将绘图标记为脏（应重新绘制）
方法 redraw 重新绘制绘图
方法 remove 从绘图中移除一个对象。
方法 save 保存绘图。
实例变量 bbox 未文档化
属性 background 返回绘图的背景颜色。None表示透明背景。
属性 bounding_box 将 Cairo 曲面的边界框作为 BoundingBox 对象返回。
属性 height 返回绘制图的 Cairo 曲面高度。
属性 surface 返回绘制图的 Cairo 曲面。
属性 width 返回绘制图的 Cairo 曲面宽度。
方法 _repr_svg_ 以字符串形式返回此绘图的 SVG 表示。
实例变量 _background 未文档化
实例变量 _ctx 未文档化
实例变量 _filename 未文档化
实例变量 _is_dirty 未文档化
实例变量 _need_tmpfile 未文档化
实例变量 _objects 未文档化
实例变量 _palette 未文档化
实例变量 _surface 未文档化
def __init__(self, target=None, bbox=None, palette=None, background=None): (源)

创建一个新绘图。

参数
target

要写入的目标曲面。它可以是以下类型之一：

  • None—— 将创建一个 Cairo 曲面，并在其上绘制对象。
  • cairo.Surface—— 将使用给定的 Cairo 曲面。
  • string—— 将创建一个具有给定名称的文件，并将适当的 Cairo 曲面附加到该文件。
bbox曲面的边界框。它在不同曲面上解释不同：PDF 和 PS 曲面将其视为点（1 点 = 1/72 英寸）。图像曲面将其视为像素。SVG 曲面将其视为抽象单位，但在 Firefox 中查看 SVG 文件时，它主要被解释为像素。
palette绘图上主要使用的调色板，如果添加的对象未指定私有调色板。它必须是一个 igraph.drawing.colors.Palette 对象，或一个指向igraph.drawing.colors.palettes有效键的字符串（参见模块 igraph.drawing.colors），或None。在后一种情况下，将使用配置键plotting.palette指定的默认调色板。
background给出的默认调色板。None背景颜色。如果为 None，则背景将透明。您可以使用 igraph.drawing.colors.color_name_to_rgba 理解的任何颜色规范。
def add(self, obj, bbox=None, palette=None, opacity=1.0, *args, **kwds): (源)

向绘图添加一个对象。

未在此处指定的参数将被存储并在必要时传递给对象的绘图函数。由于您很可能对图所接受的参数感兴趣，请参阅 Graph.__plot__ 以获取更多详细信息。

参数
obj要添加的对象
bbox对象的边界框。如果为 None，None则对象将填充绘图的整个区域。
palette用于绘制对象的调色板。如果对象尝试获取分配给正整数的颜色，它将使用此调色板。如果为 None，None则默认为绘图的全局调色板。
opacity绘制对象的透明度，范围为 0.0-1.0
*args未文档化
**kwds未文档化
另请参阅
Graph.__plot__
def background(self, color): (源)

设置绘图的背景颜色。None表示透明背景。您可以使用当前调色板的get当前调色板的 `get` 方法或 igraph.drawing.colors.color_name_to_rgb 所理解的颜色规范。

def mark_dirty(self): (源)

将绘图标记为脏（应重新绘制）

def redraw(self, context=None): (源)

重新绘制绘图

def remove(self, obj, bbox=None, idx=1): (源)

从绘图中移除一个对象。

如果对象已被多次添加且未指定边界框，则它将移除在相同对象实例列表中第 idx 次出现的实例。

参数
obj要移除的对象
bbox对象的可选边界框规范。如果给定，则仅考虑具有完全相同边界框的对象。
idx如果多个对象与由 obj 和 bbox 给出的规范匹配，则仅移除第 idx 次出现的实例。
返回
True如果对象已成功移除，False如果对象根本不在绘图上，或者 idx 大于出现次数。
def save(self, fname=None): (源)

保存绘图。

参数
fname要保存到的文件名。如果绘图曲面不是ImageSurface.
，则忽略此参数。

未文档化

background = (源)

返回绘图的背景颜色。None表示透明背景。

bounding_box = (源)

将 Cairo 曲面的边界框作为 BoundingBox 对象返回。

height = (源)

返回绘制图的 Cairo 曲面高度。

surface = (源)

返回绘制图的 Cairo 曲面。

width = (源)

返回绘制图的 Cairo 曲面宽度。

def _repr_svg_(self): (源)

以字符串形式返回此绘图的 SVG 表示。

此方法由 IPython 用于内联显示此绘图。

_background = (源)

未文档化

_ctx = (源)

未文档化

_filename = (源)

未文档化

_is_dirty: bool = (源)

未文档化

_need_tmpfile: bool = (源)

未文档化

_objects: list = (源)

未文档化

_palette = (源)

未文档化

_surface = (源)

未文档化