backend_cairo#

Matplotlib 的 Cairo后端

作者

史蒂夫卓别林等人

这个后端依赖于 cairocffi 或 pycairo。

matplotlib.backends.backend_cairo。FigureCanvas [来源] #

的别名FigureCanvasCairo

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

基地: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 ) [来源] #
matplotlib.backends.backend_cairo。GraphicsContextCairo (渲染器) [来源] #

基地:GraphicsContextBase

get_rgb ( ) [来源] #

从 0-1 返回一个由三个或四个浮点数组成的元组。

恢复( ) [来源] #

从堆栈中恢复图形上下文 - 仅需要在堆栈上保存图形上下文的后端。

set_alpha ( alpha ) [来源] #

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

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

set_antialiased ( b ) [来源] #

设置是否应使用抗锯齿渲染来绘制对象。

set_capstyle ( cs ) [来源] #

设置如何绘制线的端点。

参数
csCapStyle或 {'butt', 'projecting', 'round'}
set_clip_path (路径) [来源] #

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

set_clip_rectangle (矩形) [来源] #

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

set_dashes ( offset , dashes ) [source] #

为 gc 设置破折号样式。

参数
dash_offset浮点数

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

dash_list类数组或无

开关顺序为点。无指定实线。否则,所有值必须为非负数 (\(\ge 0\))。

笔记

见第 PostScript 语言参考的 666 以 获取更多信息。

set_foreground ( fg , isRGBA = None ) [来源] #

设置前景色。

参数
fg颜色
isRGBA布尔值

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

set_joinstyle ( js ) [来源] #

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

参数
jsJoinStyle或 {'miter', 'round', 'bevel'}
set_linewidth ( w ) [来源] #

以点为单位设置线宽。

matplotlib.backends.backend_cairo。RendererCairo ( dpi ) [来源] #

基地:RendererBase

draw_image ( gc , x , y , im ) [来源] #

绘制 RGBA 图像。

参数
GCGraphicsContextBase

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

x标量

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

y标量

距离画布底部的物理单位(即点或像素)的距离。

im (N, M, 4) 类似于 np.uint8 的数组

一组 RGBA 像素。

转换matplotlib.transforms.Affine2DBase

当且仅当具体后端被编写为 option_scale_image返回True时,仿射变换(即 an Affine2DBase可以传递给draw_image。变换的平移向量以物理单位(即点或像素)给出。请注意,转换不会覆盖xy,并且必须在通过xy转换结果之前应用(这可以通过将xy添加到由transform定义的平移向量来完成)。

draw_markers ( gc , marker_path , marker_trans , path , transform , rgbFace = None ) [来源] #

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

基本(后备)实现多次调用draw_path. 后端可能希望覆盖此方法,以便仅绘制一次标记并多次重复使用它。

参数
GCGraphicsContextBase

图形上下文。

marker_transmatplotlib.transforms.Transform

应用于标记的仿射变换。

反式matplotlib.transforms.Transform

应用于路径的仿射变换。

draw_path ( gc , path , transform , rgbFace = None ) [source] #

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

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

绘制一个文本实例。

参数
GCGraphicsContextBase

图形上下文。

x浮动

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

y浮动

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

字符串_

文本字符串。

支柱matplotlib.font_manager.FontProperties

字体属性。

角度浮动

以度为单位的逆时针旋转角度。

多行文字matplotlib.text.Text

要渲染的原始文本对象。

笔记

后端实施者的注意事项:

当您尝试确定您的边界框是否正确(这使文本布局/对齐能够正常工作)时,它有助于更​​改 text.py 中的行:

if 0: bbox_artist(self, renderer)

到 if 1,然后实际的边界框将与您的文本一起绘制。

get_canvas_width_height ( ) [来源] #

以显示坐标返回画布宽度和高度。

get_text_width_height_descent ( s , prop , ismath ) [来源] #

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

new_gc ( ) [来源] #

返回 a 的一个实例GraphicsContextBase

points_to_pixels () [来源] #

将点转换为显示单位。

您需要覆盖此函数(除非您的后端没有 dpi,例如 postscript 或 svg)。一些成像系统假定每英寸像素有一些值:

points to pixels = points * pixels_per_inch/72 * dpi/72
参数
浮点数或类似数组

一个浮点数或一个 numpy 浮点数数组

返回
点转换为像素
set_context ( ctx ) [来源] #
set_ctx_from_surface (表面) [来源] #

[已弃用]

笔记

3.6 版后已弃用:改用 set_context。

set_width_height (宽度,高度) [来源] #

[已弃用]

笔记

自 3.6 版起已弃用: