matplotlib.animation.MovieWriter#

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

用于写入电影的基本类。

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

属性:
frame_formatstr

写入帧数据时使用的格式,默认为“rgba”。

figFigure

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

参数:
fpsint,默认值:5

影片帧率(每秒)。

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

要使用的编解码器。

bitrateint, 默认值: rcParams["animation.bitrate"] (默认值: -1)

电影的比特率,单位为千比特每秒。值越高意味着电影质量越高,但会增加文件大小。值为 -1 表示底层电影编码器将选择比特率。

extra_args字符串列表或 None,可选

传递给底层电影编码器的额外命令行参数。这些参数在文件名之前最后传递给编码器。默认值 None 表示对内置写入器使用 rcParams["animation.[name-of-encoder]_args"]

metadatadict[字符串, 字符串],默认值: {}

一个包含要包含在输出文件中的元数据键值对的字典。可能有用的一些键包括:title(标题)、artist(艺术家)、genre(流派)、subject(主题)、copyright(版权)、srcform(源格式)、comment(评论)。

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

影片帧率(每秒)。

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

要使用的编解码器。

bitrateint, 默认值: rcParams["animation.bitrate"] (默认值: -1)

电影的比特率,单位为千比特每秒。值越高意味着电影质量越高,但会增加文件大小。值为 -1 表示底层电影编码器将选择比特率。

extra_args字符串列表或 None,可选

传递给底层电影编码器的额外命令行参数。这些参数在文件名之前最后传递给编码器。默认值 None 表示对内置写入器使用 rcParams["animation.[name-of-encoder]_args"]

metadatadict[字符串, 字符串],默认值: {}

一个包含要包含在输出文件中的元数据键值对的字典。可能有用的一些键包括: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 控制。

  • dpibbox_inches:这些参数可能无法传递,因为动画的每一帧

    必须具有完全相同的像素大小。

  • format:此参数由 MovieWriter 控制。

classmethod isAvailable()[源代码]#

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

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

设置电影文件的写入。

参数:
figFigure

包含帧信息的图形对象。

outfilestr

生成电影文件的文件名。

dpifloat, 默认值: fig.dpi

文件的 DPI(或分辨率)。这控制了生成电影文件的像素大小。

supported_formats = ['rgba']#