[FFmpeg-cvslog] avutil/frame: clarify AV_FRAME_DATA_FILM_GRAIN_PARAMS usage

[Niklas Haas]

ffmpeg | branch: master | Niklas Haas <git at haasn.dev> | Fri Mar 15 12:14:31 2024 +0100| [ea147f3b50c6826134926f176bc51ba1c5924c60] | committer: Niklas Haas

avutil/frame: clarify AV_FRAME_DATA_FILM_GRAIN_PARAMS usage

To allow for AFGS1 usage, which can expose multiple parameter sets for
a single frame.

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

 libavutil/frame.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/libavutil/frame.h b/libavutil/frame.h
index 373866c600..8aa05ec127 100644
--- a/libavutil/frame.h
+++ b/libavutil/frame.h
@@ -180,6 +180,10 @@ enum AVFrameSideDataType {
     /**
      * Film grain parameters for a frame, described by AVFilmGrainParams.
      * Must be present for every frame which should have film grain applied.
+     *
+     * May be present multiple times, for example when there are multiple
+     * alternative parameter sets for different video signal characteristics.
+     * The user should select the most appropriate set for the application.
      */
     AV_FRAME_DATA_FILM_GRAIN_PARAMS,