Ascii art to explain what avfilter_formats_changeref() does.

Originally committed as revision 12176 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h
index 850bf968f34fa1bb76c2877c023af3a4156ddb85..a3b646488aca5965d774d8734b41b25dbfcf23e0 100644 (file)
--- a/libavfilter/avfilter.h
+++ b/libavfilter/avfilter.h
@@ -197,6 +197,19 @@ void avfilter_formats_ref(AVFilterFormats *f, AVFilterFormats **ref);
  */
 void avfilter_formats_unref(AVFilterFormats **ref);
 
+/**
+ *
+ *         Before                                 After
+ *   ________                         ________
+ *  |   f    |<---------.            |   f    |<---------.
+ *  |  ____  |       ___|___         |  ____  |       ___|___
+ *  | |refs| |      |   |   |        | |refs| |      |   |   |   NULL
+ *  | |* *--------->|*oldref|        | |* *--------->|*newref|     ^
+ *  | |* * | |      |_______|        | |* * | |      |_______|  ___|___
+ *  | |____| |                       | |____| |                |   |   |
+ *  |________|                       |________|                |*oldref|
+ *                                                             |_______|
+ */
 void avfilter_formats_changeref(AVFilterFormats **oldref,
                                 AVFilterFormats **newref);