matplotlib.animation.MovieWriter
- classmatplotlib.animation.MovieWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)[исходный код]
-
Базовый класс для записи видео.
Это базовый класс для подклассов MovieWriter, которые записывают данные кадров видео в канал. Нельзя создать экземпляр этого класса напрямую. Примеры использования его подклассов см. в примерах.
- Атрибуты:
-
- frame_formatstr
-
Формат, используемый для записи данных кадра; по умолчанию — 'rgba'.
-
fig
Figure -
Объект figure, из которого извлекаются данные. Он должен быть предоставлен подклассами.
- Параметры:
-
- fpsint, default: 5
-
Частота кадров видео (в секунду).
-
codecstr or None, default:
rcParams["animation.codec"](default:'h264') -
Используемый кодек.
-
bitrateint, default:
rcParams["animation.bitrate"](default:-1) -
Битрейт видео в килобитах в секунду. Чем выше значение, тем лучше качество видео, но тем больше размер файла. Значение -1 позволяет используемому кодировщику видео самостоятельно выбрать битрейт.
- extra_argslist of str or None, optional
-
Дополнительные аргументы командной строки, передаваемые используемому кодировщику видео. Эти аргументы передаются кодировщику последними, непосредственно перед именем файла. Значение по умолчанию None означает, что для встроенных средств записи используется
rcParams["animation.[name-of-encoder]_args"]. - metadatadict[str, str], default: {}
-
Словарь ключей и значений метаданных, включаемых в выходной файл. Могут быть полезны такие ключи, как: title, artist, genre, subject, copyright, srcform, comment.
- __init__(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)[исходный код]
-
- Параметры:
-
- fpsint, default: 5
-
Частота кадров видео (в секунду).
-
codecstr or None, default:
rcParams["animation.codec"](default:'h264') -
Используемый кодек.
-
bitrateint, default:
rcParams["animation.bitrate"](default:-1) -
Битрейт видео в килобитах в секунду. Чем выше значение, тем лучше качество видео, но тем больше размер файла. Значение -1 позволяет используемому кодировщику видео самостоятельно выбрать битрейт.
- extra_argslist of str or None, optional
-
Дополнительные аргументы командной строки, передаваемые используемому кодировщику видео. Эти аргументы передаются кодировщику последними, непосредственно перед именем файла. Значение по умолчанию None означает, что для встроенных средств записи используется
rcParams["animation.[name-of-encoder]_args"]. - metadatadict[str, str], default: {}
-
Словарь ключей и значений метаданных, включаемых в выходной файл. Могут быть полезны такие ключи, как: title, artist, genre, subject, copyright, srcform, comment.
Методы
__init__([fps, codec, bitrate, extra_args, ...])bin_path()Возвращает путь к исполняемому файлу командной строки, используемому конкретным подклассом.
finish()Завершает обработку для записи видео.
grab_frame(**savefig_kwargs)Получает данные изображения из объекта figure и сохраняет их как кадр видео.
Возвращает сведения о том, доступен ли подкласс MovieWriter.
saving(fig, outfile, dpi, *args, **kwargs)Менеджер контекста для удобной записи видеофайла.
setup(fig, outfile[, dpi])Подготавливает запись видеофайла.
Атрибуты
frame_sizeКортеж
(width, height)в пикселях для кадра видео.- classmethodbin_path()[исходный код]
-
Возвращает путь к исполняемому файлу командной строки, используемому конкретным подклассом. Это метод класса, поэтому инструмент можно найти до того, как конкретный подкласс MovieWriter станет доступен.
- finish()[исходный код]
-
Завершает обработку для записи видео.
- grab_frame(**savefig_kwargs)[исходный код]
-
Получает данные изображения из объекта figure и сохраняет их как кадр видео.
Все именованные аргументы из savefig_kwargs передаются вызову
savefig, который сохраняет объект figure. Однако некоторые именованные аргументы, поддерживаемыеsavefig, передавать нельзя, поскольку ими управляет MovieWriter:-
- dpi, bbox_inches: эти параметры нельзя передавать, поскольку каждый кадр
-
анимации должен иметь одинаковый размер в пикселях.
- format: этим параметром управляет MovieWriter.
-
- classmethodisAvailable()[исходный код]
-
Возвращает сведения о том, доступен ли подкласс MovieWriter.
- setup(fig, outfile, dpi=None)[исходный код]
-
Подготавливает запись видеофайла.
- Параметры:
-
-
fig
Figure -
Объект figure, содержащий данные для кадров.
- outfilestr
-
Имя создаваемого видеофайла.
-
dpifloat, default:
fig.dpi -
DPI (или разрешение) файла. Этот параметр определяет размер создаваемого видеофайла в пикселях.
-
fig
- supported_formats=['rgba']
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.animation.MovieWriter.html