matplotlib.backends.backend_cairo

Matplotlib 的 Cairo 后端

作者:

史蒂夫·查普林和其他人

此后端依赖于 cairocffi 或 pycairo。

matplotlib.backends.backend_cairo.FigureCanvas

FigureCanvasCairo 的别名

class matplotlib.backends.backend_cairo.FigureCanvasCairo(figure=None)

基类：FigureCanvasBase

copy_from_bbox(bbox)

get_renderer()

print_pdf(fobj, *, orientation='portrait')

print_png(fobj)

print_ps(fobj, *, orientation='portrait')

print_raw(fobj)

print_rgba(fobj)

print_svg(fobj, *, orientation='portrait')

print_svgz(fobj, *, orientation='portrait')

restore_region(region)

class matplotlib.backends.backend_cairo.GraphicsContextCairo(renderer)

基类：GraphicsContextBase

get_antialiased()

返回对象是否应尝试进行抗锯齿渲染。

get_rgb()

返回一个由三个或四个介于0到1之间的浮点数组成的元组。

restore()

从堆栈中恢复图形上下文 - 仅对在堆栈上保存图形上下文的渲染器需要。

set_alpha(alpha)

设置用于混合的 alpha 值 - 并非所有后端都支持。

如果 alpha=None``（默认），前景色和填充色的 alpha 分量将用于设置各自的透明度（如果适用）；否则，``alpha 将覆盖它们。

set_antialiased(b)

设置对象是否应以抗锯齿渲染绘制。

set_capstyle(cs)

设置如何绘制线条的端点。

参数:

cs : CapStyle 或 {'butt', 'projecting', 'round'}CapStyle 或 {'butt', 'projecting', 'round'}

set_clip_path(path)

将剪辑路径设置为 TransformedPath 或 None。

set_clip_rectangle(rectangle)

将剪辑矩形设置为 Bbox 或 None。

set_dashes(offset, dashes)

设置 gc 的破折号样式。

参数:

dash_offset浮动

距离，以点为单位，在虚线图案中开始图案的位置。通常设置为0。

dash_list类数组或 None

开关序列作为点。None 指定一条实线。所有其他值必须为非负数（\(\ge 0\)）。

注释

更多信息请参见 PostScript 语言参考 的第666页。

set_foreground(fg, isRGBA=None)

设置前景色。

参数:

fg颜色

isRGBA布尔

如果 fg 已知是一个 (r, g, b, a) 元组，可以将 isRGBA 设置为 True 以提高性能。

set_joinstyle(js)

设置如何绘制线段之间的连接。

参数:

js : JoinStyle 或 {'miter', 'round', 'bevel'}JoinStyle 或 {'miter', 'round', 'bevel'}

set_linewidth(w)

设置线宽，单位为点。

class matplotlib.backends.backend_cairo.RendererCairo(dpi)

基类：RendererBase

draw_image(gc, x, y, im)

绘制一个RGBA图像。

参数:

gcGraphicsContextBase

带有裁剪信息的图形上下文。

x标量

画布左侧的物理单位距离（即点或像素）。

y标量

画布底部边缘的物理单位（即点或像素）距离。

im : (N, M, 4) 的 numpy.uint8 数组(N, M, 4) 数组

一个RGBA像素数组。

变换 : Affine2DBaseAffine2DBase

仅当具体的后端被编写为 option_scale_image 返回 True 时，一个仿射变换（即 Affine2DBase）*可能* 被传递给 draw_image。变换的平移向量以物理单位（即点或像素）给出。请注意，该变换不会覆盖 x 和 y，并且必须在将结果通过 x 和 y 进行平移之前应用（这可以通过将 x 和 y 添加到由 transform 定义的平移向量来实现）。

draw_markers(gc, marker_path, marker_trans, path, transform, rgbFace=None)

在 path 的每个顶点（不包括控制点）绘制一个标记。

基础（回退）实现会多次调用 draw_path。后端可能希望重写此方法，以便只绘制一次标记并多次重用它。

参数:

gcGraphicsContextBase

图形上下文。

marker_path路径

标记的路径。

marker_trans转换

应用于标记的仿射变换。

路径 : Path路径

绘制标记的位置。

trans转换

应用于路径的仿射变换。

rgbFace : color, 可选颜色，可选

draw_path(gc, path, transform, rgbFace=None)

使用给定的仿射变换绘制一个 Path 实例。

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)

绘制一个文本实例。

参数:

gcGraphicsContextBase

图形上下文。

x浮动

文本在显示坐标中的x位置。

y浮动

文本基线在显示坐标中的y位置。

sstr

文本字符串。

propFontProperties

字体属性。

角度浮动

逆时针方向的旋转角度（以度为单位）。

ismath布尔值或“TeX”

如果为真，使用 mathtext 解析器。

mtext文本

要渲染的原始文本对象。

注释

后端实现者须知：

RendererBase.draw_text 也支持将 "TeX" 传递给 ismath 参数以使用 TeX 渲染，但这对于实际的渲染后端不是必需的，实际上许多内置后端并不支持这一点。相反，TeX 渲染由 draw_tex 提供。

get_canvas_width_height()

返回画布在显示坐标中的宽度和高度。

get_text_width_height_descent(s, prop, ismath)

获取字符串 s 在显示坐标系中的宽度、高度和下降量（从底部到基线的偏移量），使用 FontProperties prop。

在 s 的开头和结尾的空白字符都包含在报告的宽度中。

new_gc()

返回一个 GraphicsContextBase 的实例。

points_to_pixels(points)

将点转换为显示单位。

你需要重写这个函数（除非你的后端没有dpi，例如，postscript或svg）。一些图像系统假设每英寸的像素值为:

points to pixels = points * pixels_per_inch/72 * dpi/72

参数:

点浮点数或类似数组

返回:

点转换为像素

set_context(ctx)