matplotlib.animation.FileMovieWriter#

class matplotlib.animation.FileMovieWriter(*args, **kwargs)[源码]#

MovieWriter 用于写入单个文件并在最后拼接。

此项必须被子类化才能有用。

参数:
fpsint,默认值: 5

电影帧率(每秒)。

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

要使用的编解码器。

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

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

extra_argsstr 列表或 None,可选

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

metadatadict[str, str],默认值: {}

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

__init__(*args, **kwargs)[源码]#
参数:
fpsint,默认值: 5

电影帧率(每秒)。

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

要使用的编解码器。

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

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

extra_argsstr 列表或 None,可选

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

metadatadict[str, str],默认值: {}

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

方法

__init__(*args, **kwargs)

bin_path()

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

finish()

完成电影写入的任何处理。

grab_frame(**savefig_kwargs)

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

isAvailable()

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

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

上下文管理器,用于方便地写入电影文件。

setup(fig, outfile[, dpi, frame_prefix])

设置电影文件的写入。

属性

frame_format

用于保存帧的格式(png、jpeg等),可由各个子类决定。

frame_size

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

supported_formats

finish()[源码]#

完成电影写入的任何处理。

property frame_format#

用于保存帧的格式(png、jpeg等),可由各个子类决定。

grab_frame(**savefig_kwargs)[源码]#

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

savefig_kwargs 中的所有关键字参数都将传递给用于保存图形的 savefig 调用。但是,savefig 支持的几个关键字参数可能无法传递,因为它们由 MovieWriter 控制。

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

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

  • format:此参数由 MovieWriter 控制。

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

设置电影文件的写入。

参数:
figFigure

要从中获取渲染帧的图形。

outfilestr

生成电影文件的文件名。

dpifloat, 默认值: fig.dpi

输出文件的 DPI。此参数与图形大小一起控制生成影片文件的像素大小。

frame_prefixstr,可选

用于临时文件的文件名前缀。如果为 *None*(默认值),文件将写入一个临时目录,该目录由 finish 删除;如果不是 *None*,则不删除任何临时文件。