matplotlib.backends.backend_ps#

一个PostScript后端,可以生成PostScript .ps 和 .eps 文件。

matplotlib.backends.backend_ps.FigureCanvas[源代码]#

FigureCanvasPS 的别名

class matplotlib.backends.backend_ps.FigureCanvasPS(figure=None)[源代码][源代码]#

基类:FigureCanvasBase

draw()[源代码][源代码]#

渲染 Figure

此方法必须遍历艺术家树,即使没有产生输出,因为它触发了用户可能在保存输出到磁盘之前想要访问的延迟工作。例如计算极限、自动极限和刻度值。

filetypes = {'eps': 'Encapsulated Postscript', 'ps': 'Postscript'}#
fixed_dpi = 72#
get_default_filetype()[源代码][源代码]#

返回在 rcParams["savefig.format"] (default: 'png') 中指定的默认 savefig 文件格式。

返回的字符串不包含句号。此方法在仅支持单一文件类型的后端中被重写。

print_eps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)#
print_ps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)#
class matplotlib.backends.backend_ps.RendererPS(width, height, pswriter, imagedpi=72)[源代码][源代码]#

基类:RendererPDFPSBase

渲染器使用一个图形上下文实例来处理所有的绘图原语,该实例控制颜色/样式。

create_hatch(hatch)[源代码][源代码]#
draw_gouraud_triangles(gc, points, colors, trans)[源代码][源代码]#

绘制一系列 Gouraud 三角形。

参数:
gcGraphicsContextBase

图形上下文。

三角形数组(N, 3, 2) 数组类

三角形的 N 个 (x, y) 点数组。

颜色数组(N, 3, 4) 数组类

每个三角形点的 N 个 RGBA 颜色数组。

变换 : Transform转换

应用于点的仿射变换。

draw_image(gc, x, y, im, transform=None)[源代码][源代码]#

绘制一个RGBA图像。

参数:
gcGraphicsContextBase

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

x标量

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

y标量

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

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

一个RGBA像素数组。

变换 : Affine2DBaseAffine2DBase

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

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[源代码][源代码]#

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

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

参数:
gcGraphicsContextBase

图形上下文。

marker_path路径

标记的路径。

marker_trans转换

应用于标记的仿射变换。

路径 : Path路径

绘制标记的位置。

trans转换

应用于路径的仿射变换。

rgbFace : color, 可选颜色,可选
draw_mathtext(gc, x, y, s, prop, angle)[源代码][源代码]#

使用 matplotlib.mathtext 绘制数学文本。

draw_path(gc, path, transform, rgbFace=None)[源代码][源代码]#

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

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offset_trans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[源代码][源代码]#

绘制一系列 路径

每个路径首先由 all_transforms 中的相应条目(一个 (3, 3) 矩阵列表)进行变换,然后由 master_transform 进行变换。之后,它们由 offsets 中的相应条目进行平移,该条目首先由 offset_trans 进行变换。

facecolors, edgecolors, linewidths, linestyles, 和 antialiased 是设置相应属性的列表。

offset_position 现在未使用,但保留该参数以保持向后兼容性。

基础(回退)实现会多次调用 draw_path。后端可能希望重写此方法,以便仅渲染一次路径数据集,然后通过不同的偏移、颜色、样式等多次引用该路径。提供了生成器方法 _iter_collection_raw_paths_iter_collection 来帮助(并标准化)后端之间的实现。强烈建议使用这些生成器,以便可以全局更改 draw_path_collection 的行为。

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[源代码][源代码]#

绘制一个 TeX 实例。

参数:
gcGraphicsContextBase

图形上下文。

x浮动

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

y浮动

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

sstr

TeX 文本字符串。

propFontProperties

字体属性。

角度浮动

逆时针方向的旋转角度(以度为单位)。

mtext文本

要渲染的原始文本对象。

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_image_magnification()[源代码][源代码]#

获取传递给 draw_image 的图像的放大倍数。允许后端以不同于其他艺术家的分辨率显示图像。

set_color(r, g, b, store=True)[源代码][源代码]#
set_font(fontname, fontsize, store=True)[源代码][源代码]#
set_linecap(linecap, store=True)[源代码][源代码]#
set_linedash(offset, seq, store=True)[源代码][源代码]#
set_linejoin(linejoin, store=True)[源代码][源代码]#
set_linewidth(linewidth, store=True)[源代码][源代码]#
matplotlib.backends.backend_ps.get_bbox_header(lbrt, rotated=False)[源代码][源代码]#

[已弃用] 返回给定 bbox lbrt=(l, b, r, t) 的 postscript 标题字符串。可选地,返回旋转命令。

注释

自 3.9 版本弃用.

matplotlib.backends.backend_ps.gs_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)[源代码][源代码]#

使用 ghostscript 的 pswrite 或 epswrite 设备来提取文件。这样可以生成没有非法封装 PostScript 操作符的小文件。输出是低级别的,将文本转换为轮廓。

matplotlib.backends.backend_ps.pstoeps(tmpfile, bbox=None, rotated=False)[源代码][源代码]#

将PostScript转换为封装PostScript。eps文件的边界框将被替换为给定的*bbox*参数。如果为None,将使用原始边界框。

matplotlib.backends.backend_ps.xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)[源代码][源代码]#

使用 ghostscript 的 ps2pdf 和 xpdf/poppler 的 pdftops 来提取文件。这样可以生成没有非法嵌入式 PostScript 操作符的较小文件。这个提取器是首选,它生成将文本视为文本的高级 PostScript 输出。