From d43c1ec684ced58e2d4288c850ea774f06df9d23 Mon Sep 17 00:00:00 2001 From: Stefano Sabatini Date: Tue, 27 Jan 2015 13:22:48 +0100 Subject: examples/filtering: extend comments about setting the filter graph endpoints That part is a constant source of confusions for readers, this should help clarify the apparently inverted logic. --- doc/examples/filtering_audio.c | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'doc/examples/filtering_audio.c') diff --git a/doc/examples/filtering_audio.c b/doc/examples/filtering_audio.c index 46595fb3b8..f5cb8eb8a1 100644 --- a/doc/examples/filtering_audio.c +++ b/doc/examples/filtering_audio.c @@ -145,12 +145,28 @@ static int init_filters(const char *filters_descr) goto end; } - /* Endpoints for the filter graph. */ + /* + * Set the endpoints for the filter graph. The filter_graph will + * be linked to the graph described by filters_descr. + */ + + /* + * The buffer source output must be connected to the input pad of + * the first filter described by filters_descr; since the first + * filter input label is not specified, it is set to "in" by + * default. + */ outputs->name = av_strdup("in"); outputs->filter_ctx = buffersrc_ctx; outputs->pad_idx = 0; outputs->next = NULL; + /* + * The buffer sink input must be connected to the output pad of + * the last filter described by filters_descr; since the last + * filter output label is not specified, it is set to "out" by + * default. + */ inputs->name = av_strdup("out"); inputs->filter_ctx = buffersink_ctx; inputs->pad_idx = 0; -- cgit v1.2.3