[FFmpeg-cvslog] lavfi: document the constraints on incoming frames.

[Nicolas George]

ffmpeg | branch: master | Nicolas George <nicolas.george at normalesup.org> | Sun Jul 29 18:58:42 2012 +0200| [8d6eed7b56ee83e6e0a7d6c1fe4c87754fd88560] | committer: Nicolas George

lavfi: document the constraints on incoming frames.

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

 libavfilter/avfilter.h |    6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h
index 0e7111d..54a0b97 100644
--- a/libavfilter/avfilter.h
+++ b/libavfilter/avfilter.h
@@ -260,6 +260,12 @@ struct AVFilterPad {
      * NULL, the filter layer will default to storing a reference to the
      * picture inside the link structure.
      *
+     * The reference given as argument is also available in link->cur_buf.
+     * It can be stored elsewhere or given away, but then clearing
+     * link->cur_buf is advised, as it is automatically unreferenced.
+     * The reference must not be unreferenced before end_frame(), as it may
+     * still be in use by the automatic copy mechanism.
+     *
      * Input video pads only.
      *
      * @return >= 0 on success, a negative AVERROR on error. picref will be