From: Michael Niedermayer <michaelni@gmx.at>
Date: Thu, 21 Feb 2008 22:33:40 +0000 (+0000)
Subject: Ascii art to explain what avfilter_formats_changeref() does.
X-Git-Tag: v0.5~5784
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b9c2fb34445864e2adc7fe766aaae98f365a0a4a;p=platform%2Fupstream%2Flibav.git

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 850bf968f..a3b646488 100644
--- 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);