matplotlib.figure.Figure.savefig#
- Figure.savefig(fname, *, transparent=None, **kwargs)[源代码][源代码]#
将当前图形保存为图像或矢量图形文件。
调用签名:
savefig(fname, *, transparent=None, dpi='figure', format=None, metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto', edgecolor='auto', backend=None, **kwargs )
可用的输出格式取决于所使用的后端。
- 参数:
- fnamestr 或 path-like 或 binary file-like
路径，或类似Python文件的对象，或者是一些依赖于后端的特定对象，例如
matplotlib.backends.backend_pdf.PdfPages。如果设置了 format ，它将决定输出格式，并且文件将保存为 fname 。请注意， fname 是按字面使用的，不会尝试使 fname 的扩展名（如果有）与 format 匹配，也不会附加扩展名。
如果未设置 format ，则格式会从 fname 的扩展名推断，如果有的话。如果未设置 format 且 fname 没有扩展名，则文件将以
rcParams["savefig.format"](default:'png') 保存，并且适当的扩展名会附加到 fname 。
- 其他参数:
- transparent : bool, 默认值:
rcParams["savefig.transparent"](default:False)bool, 默认值: 如果 True，所有 Axes 补丁将是透明的；Figure 补丁也将是透明的，除非通过 kwargs 指定了 facecolor 和/或 edgecolor。
如果 False 没有效果，Axes 和 Figure 补丁的颜色保持不变（除非通过 facecolor 和/或 edgecolor 关键字参数指定了 Figure 补丁的颜色，在这种情况下使用这些颜色）。
这些补丁的透明度将在退出此函数时恢复为其原始值。
这在网页上显示带有彩色背景的图表时非常有用。
- dpi : float 或 'figure', 默认值:
rcParams["savefig.dpi"](default:'figure')浮点数或'figure'，默认值： 每英寸的分辨率点数。如果为 'figure'，则使用图形的 dpi 值。
- 格式str
文件格式，例如 'png', 'pdf', 'svg', ... 当未设置此项时的行为在 fname 下有文档说明。
- 元数据字典, 可选
存储在图像元数据中的键/值对。支持的键和默认值取决于图像格式和后端：
'png' 使用 Agg 后端：参见
print_png的参数metadata。'pdf' 使用 pdf 后端：参见
PdfPages的参数metadata。'svg' 使用 svg 后端：参见
print_svg的参数metadata。'eps' 和 'ps' 使用 PS 后端：仅支持 'Creator'。
不支持 'pgf'、'raw' 和 'rgba' 格式，因为这些格式不支持嵌入元数据。目前不支持 'jpg'、'tiff' 或 'webp'，但未来可能会包含嵌入 EXIF 元数据的功能。
- bbox_inches : str 或
Bbox, 默认值:rcParams["savefig.bbox"](default:None)str 或 以英寸为单位的边界框：仅保存给定部分的图形。如果为 'tight'，则尝试计算图形的紧密边界框。
- pad_inches : float 或 'layout', 默认值:
rcParams["savefig.pad_inches"](default:0.1)浮点数或'布局', 默认: 当 bbox_inches 为 'tight' 时，图像周围的填充量（以英寸为单位）。如果使用 'layout'，则使用受限或压缩布局引擎的填充；如果未使用这些引擎之一，则忽略此设置。
- facecolor : color 或 'auto', 默认:
rcParams["savefig.facecolor"](default:'auto')颜色或 'auto'，默认值：rcParams["savefig.facecolor"]（默认值：'auto'） 图形的面颜色。如果为'auto'，则使用当前图形面颜色。
- edgecolor : color 或 'auto', 默认:
rcParams["savefig.edgecolor"](default:'auto')颜色或 'auto'，默认值：rcParams["savefig.edgecolor"]（默认值：'auto'） 图形的边缘颜色。如果为 'auto'，则使用当前图形的边缘颜色。
- 后端str, 可选
使用非默认的后端来渲染文件，例如使用“cairo”后端而不是默认的“agg”来渲染png文件，或者使用“pgf”后端而不是默认的“pdf”来渲染pdf文件。请注意，默认的后端通常是足够的。有关每种文件格式的有效后端列表，请参阅 内置后端。自定义后端可以引用为“module://...”。
- 方向{'landscape', 'portrait'}
目前仅由postscript后端支持。
- papertypestr
其中之一：'letter', 'legal', 'executive', 'ledger', 'a0' 至 'a10', 'b0' 至 'b10'。仅支持Postscript输出。
- bbox_extra_artists :
Artist的列表, 可选列表 在计算紧密边界框时将考虑的额外艺术家的列表。
- pil_kwargs字典, 可选
在保存图形时传递给
PIL.Image.Image.save的额外关键字参数。
- transparent : bool, 默认值:
