[FFmpeg-cvslog] avfilter/formats: document ff_default_query_formats

[Niklas Haas]

ffmpeg | branch: master | Niklas Haas <git at haasn.dev> | Fri Oct 20 15:29:33 2023 +0200| [1b0ca47707a01dc5709feeda859658a9d13621b8] | committer: Niklas Haas

avfilter/formats: document ff_default_query_formats

In particular, make it clear that this function will not touch format
lists which were already set by the caller before calling into this
function.

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=1b0ca47707a01dc5709feeda859658a9d13621b8
---

 libavfilter/formats.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/libavfilter/formats.h b/libavfilter/formats.h
index 22224dce2d..d44890109e 100644
--- a/libavfilter/formats.h
+++ b/libavfilter/formats.h
@@ -198,6 +198,10 @@ void ff_channel_layouts_unref(AVFilterChannelLayouts **ref);
 void ff_channel_layouts_changeref(AVFilterChannelLayouts **oldref,
                                   AVFilterChannelLayouts **newref);
 
+/**
+ * Sets all remaining unset filter lists for all inputs/outputs to their
+ * corresponding `ff_all_*()` lists.
+ */
 av_warn_unused_result
 int ff_default_query_formats(AVFilterContext *ctx);