Improve AVFilterFormats doxy.

Originally committed as revision 12672 to svn://svn.ffmpeg.org/ffmpeg/trunk
This commit is contained in:
Michael Niedermayer 2008-04-02 22:07:21 +00:00
parent 7bfacd4e75
commit a27c8d5fa9
1 changed files with 19 additions and 9 deletions

View File

@ -188,22 +188,32 @@ AVFilterFormats *avfilter_all_colorspaces(void);
AVFilterFormats *avfilter_merge_formats(AVFilterFormats *a, AVFilterFormats *b); 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: * That is the pointers will point like in the ascii art below:
* ________ * ________
* | f |<--------. * |formats |<--------.
* | ____ | | * | ____ | ____|___________________
* | |refs| | __|_ * | |refs| | | __|_
* | |* * | | | | | * | |* * | | | | | | AVFilterLink
* | |* *--------->|*ref| * | |* *--------->|*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, * 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. * 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); void avfilter_formats_unref(AVFilterFormats **ref);
@ -211,7 +221,7 @@ void avfilter_formats_unref(AVFilterFormats **ref);
* *
* Before After * Before After
* ________ ________ * ________ ________
* | f |<---------. | f |<---------. * |formats |<---------. |formats |<---------.
* | ____ | ___|___ | ____ | ___|___ * | ____ | ___|___ | ____ | ___|___
* | |refs| | | | | | |refs| | | | | NULL * | |refs| | | | | | |refs| | | | | NULL
* | |* *--------->|*oldref| | |* *--------->|*newref| ^ * | |* *--------->|*oldref| | |* *--------->|*newref| ^