matplotlib.animation.MovieWriter#

class matplotlib.animation.MovieWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)[源代码][源代码]#

编写电影的基类。

这是用于将电影帧数据写入管道的 MovieWriter 子类的基类。您不能直接实例化此类。请参阅示例以了解如何使用其子类。

属性:
frame_formatstr

用于编写帧数据的格式,默认为 'rgba'。

fig

要从中捕获数据的图形。这必须由子类提供。

参数:
帧率int, 默认值: 5

电影帧率(每秒)。

codec : str 或 None, 默认值: rcParams["animation.codec"] (default: 'h264')str 或 None, 默认:

要使用的编解码器。

比特率 : int, 默认值: rcParams["animation.bitrate"] (default: -1)int, 默认值:

电影的比特率,以每秒千比特为单位。较高的值意味着更高的电影质量,但会增加文件大小。值为 -1 时,允许底层电影编码器选择比特率。

extra_argslist of str or None, 可选

传递给底层视频编码器的额外命令行参数。这些参数在文件名之前最后传递给编码器。默认值 None 表示使用 rcParams["animation.[编码器名称]_args"] 作为内置编写器的参数。

元数据dict[str, str], 默认: {}

包含要在输出文件中包含的元数据的键和值的字典。一些可能有用的键包括:title, artist, genre, subject, copyright, srcform, comment。

__init__(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)[源代码][源代码]#
参数:
帧率int, 默认值: 5

电影帧率(每秒)。

codec : str 或 None, 默认值: rcParams["animation.codec"] (default: 'h264')str 或 None, 默认:

要使用的编解码器。

比特率 : int, 默认值: rcParams["animation.bitrate"] (default: -1)int, 默认值:

电影的比特率,以每秒千比特为单位。较高的值意味着更高的电影质量,但会增加文件大小。值为 -1 时,允许底层电影编码器选择比特率。

extra_argslist of str or None, 可选

传递给底层视频编码器的额外命令行参数。这些参数在文件名之前最后传递给编码器。默认值 None 表示使用 rcParams["animation.[编码器名称]_args"] 作为内置编写器的参数。

元数据dict[str, str], 默认: {}

包含要在输出文件中包含的元数据的键和值的字典。一些可能有用的键包括:title, artist, genre, subject, copyright, srcform, comment。

方法

__init__([fps, codec, bitrate, extra_args, ...])

bin_path()

返回特定子类使用的命令行工具的二进制路径。

finish()

完成电影的任何处理工作。

grab_frame(**savefig_kwargs)

从图形中获取图像信息并保存为电影帧。

isAvailable()

返回一个 MovieWriter 子类是否实际可用。

saving(fig, outfile, dpi, *args, **kwargs)

用于简化编写电影文件的上下文管理器。

setup(fig, outfile[, dpi])

设置以编写电影文件。

属性

frame_size

电影帧的像素 (宽度, 高度) 元组。

supported_formats

classmethod bin_path()[源代码][源代码]#

返回特定子类使用的命令行工具的二进制路径。这是一个类方法,以便在使特定 MovieWriter 子类可用之前可以查找该工具。

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

完成电影的任何处理工作。

grab_frame(**savefig_kwargs)[源代码][源代码]#

从图形中获取图像信息并保存为电影帧。

savefig_kwargs 中的所有关键字参数都会传递给保存图像的 savefig 调用。然而,savefig 支持的几个关键字参数可能不会被传递,因为它们由 MovieWriter 控制:

  • dpi, bbox_inches: 这些可能不会被传递,因为每一帧的

    动画必须完全相同大小的像素。

  • 格式: 这是由 MovieWriter 控制的。

classmethod isAvailable()[源代码][源代码]#

返回一个 MovieWriter 子类是否实际可用。

setup(fig, outfile, dpi=None)[源代码][源代码]#

设置以编写电影文件。

参数:
fig

包含帧信息的图形对象。

输出文件str

生成的电影文件的文件名。

dpi : float, 默认值: fig.dpifloat, 默认值:

文件的DPI(或分辨率)。这将控制最终电影文件的像素大小。

supported_formats = ['rgba']#