`matplotlib.backends.backend_cairo`#

Matplotlib 的 Cairo 后端#

作者:: Steve Chaplin 等

此后端依赖于 cairocffi 或 pycairo。

matplotlib.backends.backend_cairo.FigureCanvas[source]#: FigureCanvasCairo 的别名

class matplotlib.backends.backend_cairo.FigureCanvasCairo(figure=None)[source]#

基类：FigureCanvasBase

copy_from_bbox(bbox)[source]#

get_renderer()[source]#

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

print_png(fobj)[source]#

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

print_raw(fobj)[source]#

print_rgba(fobj)[source]#

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

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

restore_region(region)[source]#

class matplotlib.backends.backend_cairo.GraphicsContextCairo(renderer)[source]#

基类：GraphicsContextBase

get_antialiased()[source]#: 返回对象是否应尝试进行抗锯齿渲染。

get_rgb()[source]#: 返回一个由三个或四个 0-1 范围内的浮点数组成的元组。

restore()[source]#: 从堆栈中恢复图形上下文 - 仅适用于将图形上下文保存到堆栈的后端。

set_alpha(alpha)[source]#

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

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

set_antialiased(b)[source]#: 设置对象是否应使用抗锯齿渲染进行绘制。

set_capstyle(cs)[source]#

设置线条端点的绘制方式。

参数:

csCapStyle 或 {'butt', 'projecting', 'round'}

set_clip_path(path)[source]#: 将剪裁路径设置为 TransformedPath 或 None。

set_clip_rectangle(rectangle)[source]#: 将剪裁矩形设置为 Bbox 或 None。

set_dashes(offset, dashes)[source]#

设置图形上下文的虚线样式。

参数:

dash_offsetfloat: 在虚线图案中开始图案的距离，以点为单位。通常设置为 0。
dash_listarray-like 或 None: 作为点的开/关序列。None 指定实线。所有其他值必须为非负数（\(\ge 0\)）。

备注

有关更多信息，请参阅 PostScript 语言参考第 666 页。

set_foreground(fg, isRGBA=None)[source]#

设置前景色。

参数:

fg颜色
isRGBAbool: 如果已知 *fg* 是 (r, g, b, a) 元组，则可以将 *isRGBA* 设置为 True 以提高性能。

set_joinstyle(js)[source]#

设置线段之间的连接绘制方式。

参数:

jsJoinStyle 或 {'miter', 'round', 'bevel'}

set_linewidth(w)[source]#: 以点为单位设置线宽。

class matplotlib.backends.backend_cairo.RendererCairo(dpi)[source]#

基类：RendererBase

draw_image(gc, x, y, im)[source]#

绘制 RGBA 图像。

参数:

gcGraphicsContextBase: 带有裁剪信息的图形上下文。
x浮点数: 从画布左侧开始的物理单位（即点或像素）距离。
y浮点数: 从画布底部开始的物理单位（即点或像素）距离。
im(N, M, 4) numpy.uint8 数组: RGBA 像素数组。
transformAffine2DBase: 当且仅当具体后端编写为 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)[source]#

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

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

参数:

gcGraphicsContextBase: 图形上下文。
marker_pathPath: 标记的路径。
marker_transTransform: 应用于标记的仿射变换。
pathPath: 绘制标记的位置。
transTransform: 应用于路径的仿射变换。
rgbFace颜色，可选

draw_path(gc, path, transform, rgbFace=None)[source]#: 使用给定的仿射变换绘制 Path 实例。

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]#

绘制文本实例。

参数:

gcGraphicsContextBase: 图形上下文。
x浮点数: 文本在显示坐标中的 x 位置。
y浮点数: 文本基线在显示坐标中的 y 位置。
sstr: 文本字符串。
propFontProperties: 字体属性。
angle浮点数: 逆时针旋转角度（度）。
ismath布尔值或 "TeX": 如果为 True，则使用 mathtext 解析器。
mtextText: 要渲染的原始文本对象。

备注

后端实现者注意事项

RendererBase.draw_text 还支持将“TeX”传递给 *ismath* 参数以使用 TeX 渲染，但这不是实际渲染后端所必需的，事实上许多内置后端不支持此功能。相反，TeX 渲染由 draw_tex 提供。

get_canvas_width_height()[source]#: 以显示坐标返回画布的宽度和高度。

get_text_width_height_descent(s, prop, ismath)[source]#

获取字符串 *s* 在 FontProperties *prop* 下的宽度、高度和下沉（从底部到基线的偏移量），以显示坐标为单位。

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

new_gc()[source]#: 返回 GraphicsContextBase 的一个实例。

points_to_pixels(points)[source]#

将点转换为显示单位。

您需要覆盖此函数（除非您的后端没有 dpi，例如 postscript 或 svg）。某些成像系统假定每英寸像素的某个值。

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

参数:

points浮点数或类数组

返回:

转换为像素的点

set_context(ctx)[source]#

matplotlib.backends.backend_cairo#

Matplotlib 的 Cairo 后端#

`matplotlib.backends.backend_cairo`#