backend_pdf
#
PDF Matplotlib 后端。
作者:Jouni K Seppänen < jks @ iki 。fi > 等。
- 类 matplotlib.backends.backend_pdf。FigureCanvasPdf (图=无) [来源] #
-
- filetypes = {'pdf': '可移植文档格式'} #
- fixed_dpi = 72 #
- get_default_filetype ( ) [来源] #
rcParams["savefig.format"]
返回在(默认值:)中指定的默认 savefig 文件格式'png'
。返回的字符串不包含句点。此方法在仅支持单一文件类型的后端被覆盖。
- 类 matplotlib.backends.backend_pdf。GraphicsContextPdf (文件) [来源] #
-
- capstyles = {'butt': 0, 'projecting': 2, 'round': 1} #
- commands = ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <function GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <function GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <function GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <function GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <函数GraphicsContextPdf.dash_cmd>), (('_rgb',), <函数 GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>)) #
- joinstyles = {'bevel': 2, 'miter': 0, 'round': 1} #
- 类 matplotlib.backends.backend_pdf。PdfFile (文件名, metadata = None ) [source] #
基地:
object
PDF 文件对象。
- 参数:
- 文件名str 或 path-like 或 file-like
输出目标;如果是字符串,将打开一个文件进行写入。
- 从字符串到字符串和日期的元数据字典
信息字典对象(参见 PDF 参考第 10.2.1 节“文档信息字典”),例如: .
{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}
标准键是“Title”、“Author”、“Subject”、“Keywords”、“Creator”、“Producer”、“CreationDate”、“ModDate”和“Trapped”。已经为“Creator”、“Producer”和“CreationDate”预定义了值。可以通过将它们设置为 来删除它们
None
。
- addGouraudTriangles (点,颜色) [来源] #
添加 Gouraud 三角形阴影。
- 参数:
- 点np.ndarray
三角形顶点,形状 (n, 3, 2) 其中 n = 三角形数,3 = 顶点,2 = x, y。
- 颜色np.ndarray
顶点颜色、形状 (n, 3, 1) 或 (n, 3, 4) 与点一样,但最后一个维度是 (gray,) 或 (r, g, b, alpha)。
- 返回:
- 名称,参考
- dviFontName ( dvifont ) [来源] #
给定一个 dvi 字体对象,返回一个适合 Op.selectfont 的名称。
self.dviFontInfo
如果尚未注册,这将注册字体信息。
- 类 matplotlib.backends.backend_pdf。PdfPages (文件名, keep_empty = True , metadata = None ) [来源] #
基地:
object
多页 PDF 文件。
笔记
实际上
PdfPages
是一个薄包装器PdfFile
,以避免在使用savefig
和忘记格式参数时产生混淆。例子
>>> import matplotlib.pyplot as plt >>> # Initialize: >>> with PdfPages('foo.pdf') as pdf: ... # As many times as you like, create a figure fig and save it: ... fig = plt.figure() ... pdf.savefig(fig) ... # When no figure is specified the current figure is saved ... pdf.savefig()
创建一个新的 PdfPages 对象。
- 参数:
- 文件名str 或 path-like 或 file-like
使用的绘图
PdfPages.savefig
将被写入此位置的文件。该文件会立即打开,并且任何具有相同名称的旧文件都会被覆盖。- keep_empty布尔值,可选
如果设置为 False,则在关闭时将自动删除空的 pdf 文件。
- 元数据字典,可选
信息字典对象(参见 PDF 参考第 10.2.1 节“文档信息字典”),例如: .
{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}
标准键是“Title”、“Author”、“Subject”、“Keywords”、“Creator”、“Producer”、“CreationDate”、“ModDate”和“Trapped”。已经为“Creator”、“Producer”和“CreationDate”预定义了值。可以通过将它们设置为 来删除它们
None
。
- attach_note ( text , positionRect = [-100, -100, 0, 0] ) [source] #
将新的文本注释添加到要保存的页面中。可选的 positionRect 指定新笔记在页面上的位置。默认情况下,它位于页面之外,以确保它在打印输出中不可见。
- keep_empty #
- 类 matplotlib.backends.backend_pdf。参考( id ) [来源] #
基地:
object
PDF 参考对象。
使用 PdfFile.reserveObject() 创建引用。
- 类 matplotlib.backends.backend_pdf。RendererPdf ( file , image_dpi , height , width ) [source] #
基地:
RendererPDFPSBase
- draw_gouraud_triangle ( gc , points , colors , trans ) [source] #
绘制一个 Gouraud 阴影三角形。
- 参数:
- GC
GraphicsContextBase
图形上下文。
- 点(3, 2) 类似数组
三角形的 (x, y) 点数组。
- 颜色(3, 4) 类似数组
三角形每个点的 RGBA 颜色。
- 转换
matplotlib.transforms.Transform
应用于点的仿射变换。
- GC
- draw_gouraud_triangles ( gc , points , colors , trans ) [source] #
绘制一系列 Gouraud 三角形。
- 参数:
- 点(N, 3, 2) 类似数组
三角形的N (x, y) 点数组。
- 颜色(N, 3, 4) 类似数组
三角形每个点的N RGBA 颜色数组。
- 转换
matplotlib.transforms.Transform
应用于点的仿射变换。
- draw_image ( gc , x , y , im , transform = None ) [来源] #
绘制 RGBA 图像。
- 参数:
- GC
GraphicsContextBase
带有剪辑信息的图形上下文。
- x标量
距画布左侧的物理单位(即点或像素)的距离。
- y标量
距离画布底部的物理单位(即点或像素)的距离。
- im (N, M, 4) 类似于 np.uint8 的数组
一组 RGBA 像素。
- 转换
matplotlib.transforms.Affine2DBase
当且仅当具体后端被编写为
option_scale_image
返回True
时,仿射变换(即 anAffine2DBase
)可以传递给draw_image
。变换的平移向量以物理单位(即点或像素)给出。请注意,转换不会覆盖x和y,并且必须在通过x和y转换结果之前应用(这可以通过将x 和y添加到由transform定义的平移向量来完成)。
- GC
- draw_markers ( gc , marker_path , marker_trans , path , trans , rgbFace = None ) [来源] #
在每个path的顶点(不包括控制点)绘制一个标记。
基本(后备)实现多次调用
draw_path
. 后端可能希望覆盖此方法,以便仅绘制一次标记并多次重复使用它。- 参数:
- GC
GraphicsContextBase
图形上下文。
- marker_trans
matplotlib.transforms.Transform
应用于标记的仿射变换。
- 反式
matplotlib.transforms.Transform
应用于路径的仿射变换。
- GC
- draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiaseds , urls , offset_position ) [source] #
绘制路径集合。
每个路径首先由 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_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [来源] #
绘制一个文本实例。
- 参数:
- GC
GraphicsContextBase
图形上下文。
- x浮动
显示坐标中文本的 x 位置。
- y浮动
显示坐标中文本基线的 y 位置。
- 字符串_
文本字符串。
- 支柱
matplotlib.font_manager.FontProperties
字体属性。
- 角度浮动
以度为单位的逆时针旋转角度。
- 多行文字
matplotlib.text.Text
要渲染的原始文本对象。
- GC
笔记
后端实施者的注意事项:
当您尝试确定您的边界框是否正确(这使文本布局/对齐能够正常工作)时,它有助于更改 text.py 中的行:
if 0: bbox_artist(self, renderer)
到 if 1,然后实际的边界框将与您的文本一起绘制。
- get_image_magnification ( ) [来源] #
获取放大传递给的图像的因子
draw_image
。允许后端拥有与其他艺术家不同的分辨率的图像。
- new_gc ( ) [来源] #
返回 a 的一个实例
GraphicsContextBase
。
- 类 matplotlib.backends.backend_pdf。Stream ( id , len , file , extra = None , png = None ) [source] #
基地:
object
PDF 流对象。
这没有 pdfRepr 方法。而是调用begin(),然后调用write()输出流的内容,最后调用end()。
- 参数:
- id int
流的对象 ID。
- len参考或无
流长度的未使用引用对象;None 表示使用内存缓冲区,因此可以内联长度。
- 文件PdfFile
要将流写入的基础对象。
- 从名称到任何东西的额外字典,或无
要包含在流标头中的额外键值对。
- png dict 或无
如果数据已经被 png 编码,则解码参数。
- 压缩对象#
- 额外的#
- 文件#
- 编号#
- 连#
- pdf文件#
- 位置#