Skip to content

DOC: clarify parameters of FFMpegFileWriter#31253

Open
monika-2906-git wants to merge 1 commit intomatplotlib:mainfrom
monika-2906-git:improve-pdf-doc-download
Open

DOC: clarify parameters of FFMpegFileWriter#31253
monika-2906-git wants to merge 1 commit intomatplotlib:mainfrom
monika-2906-git:improve-pdf-doc-download

Conversation

@monika-2906-git
Copy link

@monika-2906-git monika-2906-git commented Mar 7, 2026

PR summary

This PR improves the documentation of FFMpegFileWriter by expanding the parameter section of the docstring . The previous documentation only forwarde parameters to FileMovieWriter without describing them.
This change clarifies commonly used parameters such as fps, codec, bitrate, metadata, and extra_args to make the documentation easier to understand for users.

AI Disclosure

AI assistance was used to help understand the documentation structure and draft improved parameter descriptions. The final code and wording were reviewed and edited by the contributor.

PR checklist

@github-actions
Copy link

github-actions bot commented Mar 7, 2026

Thank you for opening your first PR into Matplotlib!

If you have not heard from us in a week or so, please leave a new comment below and that should bring it to our attention. Most of our reviewers are volunteers and sometimes things fall through the cracks.

You can also join us on gitter for real-time discussion.

For details on testing, writing docs, and our review process, please see the developer guide.
Please let us know if (and how) you use AI, it will help us give you better feedback on your PR.

We strive to be a welcoming and open project. Please follow our Code of Conduct.

Copy link
Contributor

@scottshambaugh scottshambaugh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think these are good arguments to more explicitly document, but please match the more detailed descriptions at https://matplotlib.org/devdocs/api/_as_gen/matplotlib.animation.FileMovieWriter.html

Frames are written to temporary files on disk and then stitched
together at the end.

.. _their notes on frame rates: https://trac.ffmpeg.org/wiki/Slideshow#Framerates
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please state why this link is no longer relevant.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Waiting for author

Development

Successfully merging this pull request may close these issues.

4 participants