[FFmpeg-devel] [PATCH] lavu/frame: extend AVFrame.opaque documentation

[Anton Khirnov]

---
 libavutil/frame.h | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/libavutil/frame.h b/libavutil/frame.h
index 392315f40f..f3e664bbc9 100644
--- a/libavutil/frame.h
+++ b/libavutil/frame.h
@@ -437,7 +437,12 @@ typedef struct AVFrame {
     int quality;
 
     /**
-     * for some private data of the user
+     * Frame owner's private data.
+     *
+     * This field may be set by the code that allocates/owns the frame data.
+     * It is then not touched by any library functions, except:
+     * - it is copied to other references by av_frame_ref()
+     * - it is set to NULL when the frame is cleared by av_frame_unref()
      */
     void *opaque;
 
-- 
2.28.0