Document avfilter_formats_ref() with some ascii art.
authorMichael Niedermayer <michaelni@gmx.at>
Thu, 21 Feb 2008 22:02:53 +0000 (22:02 +0000)
committerMichael Niedermayer <michaelni@gmx.at>
Thu, 21 Feb 2008 22:02:53 +0000 (22:02 +0000)
Originally committed as revision 12172 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavfilter/avfilter.h

index 911cdd6..49d90cf 100644 (file)
@@ -177,7 +177,18 @@ 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 f.
+ * That is the pointers will point like in the ascii art below:
+ *   ________
+ *  |   f    |<--------.
+ *  |  ____  |         |
+ *  | |refs| |       __|_
+ *  | |* * | |      |  | |
+ *  | |* *--------->|*ref|
+ *  | |____| |      |____|
+ *  |________|
+ */
 void avfilter_formats_ref(AVFilterFormats *f, AVFilterFormats **ref);
 
 /**