From 8d6eed7b56ee83e6e0a7d6c1fe4c87754fd88560 Mon Sep 17 00:00:00 2001 From: Nicolas George Date: Sun, 29 Jul 2012 18:58:42 +0200 Subject: [PATCH] lavfi: document the constraints on incoming frames. --- libavfilter/avfilter.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h index 0e7111d53b..54a0b97897 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