From a27c8d5fa9839edbae0a73e48809ce88f138b073 Mon Sep 17 00:00:00 2001 From: Michael Niedermayer Date: Wed, 2 Apr 2008 22:07:21 +0000 Subject: Improve AVFilterFormats doxy. Originally committed as revision 12672 to svn://svn.ffmpeg.org/ffmpeg/trunk --- libavfilter/avfilter.h | 28 +++++++++++++++++++--------- 1 file changed, 19 insertions(+), 9 deletions(-) (limited to 'libavfilter/avfilter.h') diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h index ab3214825a..2f0e6abdb4 100644 --- a/libavfilter/avfilter.h +++ b/libavfilter/avfilter.h @@ -188,22 +188,32 @@ AVFilterFormats *avfilter_all_colorspaces(void); AVFilterFormats *avfilter_merge_formats(AVFilterFormats *a, AVFilterFormats *b); /** - * Adds *ref as a new reference to f. + * Adds *ref as a new reference to formats. * That is the pointers will point like in the ascii art below: * ________ - * | f |<--------. - * | ____ | | - * | |refs| | __|_ - * | |* * | | | | | + * |formats |<--------. + * | ____ | ____|___________________ + * | |refs| | | __|_ + * | |* * | | | | | | AVFilterLink * | |* *--------->|*ref| - * | |____| | |____| - * |________| + * | |____| | | |____| + * |________| |________________________ */ -void avfilter_formats_ref(AVFilterFormats *f, AVFilterFormats **ref); +void avfilter_formats_ref(AVFilterFormats *formats, AVFilterFormats **ref); /** * Remove *ref as a reference to the format list it currently points to, * deallocate that list if this was the last reference, and set *ref to NULL. + * + * Before After + * ________ ________ NULL + * |formats |<--------. |formats | ^ + * | ____ | ____|________________ | ____ | ____|________________ + * | |refs| | | __|_ | |refs| | | __|_ + * | |* * | | | | | | AVFilterLink | |* * | | | | | | AVFilterLink + * | |* *--------->|*ref| | |* | | | |*ref| + * | |____| | | |____| | |____| | | |____| + * |________| |_____________________ |________| |_____________________ */ void avfilter_formats_unref(AVFilterFormats **ref); @@ -211,7 +221,7 @@ void avfilter_formats_unref(AVFilterFormats **ref); * * Before After * ________ ________ - * | f |<---------. | f |<---------. + * |formats |<---------. |formats |<---------. * | ____ | ___|___ | ____ | ___|___ * | |refs| | | | | | |refs| | | | | NULL * | |* *--------->|*oldref| | |* *--------->|*newref| ^ -- cgit v1.2.3