[FFmpeg-devel] [PATCH 2/2] lavfi: deprecate avfilter_config_links()

[Anton Khirnov]

It never makes sense for this function to be called by users.
---
 libavfilter/avfilter.c       | 8 ++++++--
 libavfilter/avfilter.h       | 8 +++-----
 libavfilter/avfiltergraph.c  | 2 +-
 libavfilter/f_streamselect.c | 2 +-
 libavfilter/internal.h       | 8 ++++++++
 5 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/libavfilter/avfilter.c b/libavfilter/avfilter.c
index cb2128252b..859a6f9d16 100644
--- a/libavfilter/avfilter.c
+++ b/libavfilter/avfilter.c
@@ -212,6 +212,10 @@ void avfilter_link_free(AVFilterLink **link)
 {
     link_free(link);
 }
+int avfilter_config_links(AVFilterContext *filter)
+{
+    return ff_filter_config_links(EINVAL);
+}
 #endif
 
 static void update_link_current_pts(FilterLinkInternal *li, int64_t pts)
@@ -322,7 +326,7 @@ int avfilter_insert_filter(AVFilterLink *link, AVFilterContext *filt,
     return 0;
 }
 
-int avfilter_config_links(AVFilterContext *filter)
+int ff_filter_config_links(AVFilterContext *filter)
 {
     int (*config_link)(AVFilterLink *);
     unsigned i;
@@ -353,7 +357,7 @@ int avfilter_config_links(AVFilterContext *filter)
         case AVLINK_UNINIT:
             li->init_state = AVLINK_STARTINIT;
 
-            if ((ret = avfilter_config_links(link->src)) < 0)
+            if ((ret = ff_filter_config_links(link->src)) < 0)
                 return ret;
 
             if (!(config_link = link->srcpad->config_props)) {
diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h
index 0949870de4..08f185c4d2 100644
--- a/libavfilter/avfilter.h
+++ b/libavfilter/avfilter.h
@@ -698,15 +698,13 @@ int avfilter_link(AVFilterContext *src, unsigned srcpad,
  */
 attribute_deprecated
 void avfilter_link_free(AVFilterLink **link);
-#endif
 
 /**
- * Negotiate the media format, dimensions, etc of all inputs to a filter.
- *
- * @param filter the filter to negotiate the properties for its inputs
- * @return       zero on successful negotiation
+ * @deprecated this function should never be called by users
  */
+attribute_deprecated
 int avfilter_config_links(AVFilterContext *filter);
+#endif
 
 #define AVFILTER_CMD_FLAG_ONE   1 ///< Stop once a filter understood the command (for target=all for example), fast filters are favored automatically
 #define AVFILTER_CMD_FLAG_FAST  2 ///< Only execute command when its fast (like a video out that supports contrast adjustment in hw)
diff --git a/libavfilter/avfiltergraph.c b/libavfilter/avfiltergraph.c
index 674711ec35..ac491ee89b 100644
--- a/libavfilter/avfiltergraph.c
+++ b/libavfilter/avfiltergraph.c
@@ -251,7 +251,7 @@ static int graph_config_links(AVFilterGraph *graph, void *log_ctx)
         filt = graph->filters[i];
 
         if (!filt->nb_outputs) {
-            if ((ret = avfilter_config_links(filt)))
+            if ((ret = ff_filter_config_links(filt)))
                 return ret;
         }
     }
diff --git a/libavfilter/f_streamselect.c b/libavfilter/f_streamselect.c
index 1328a842f9..fb96a46862 100644
--- a/libavfilter/f_streamselect.c
+++ b/libavfilter/f_streamselect.c
@@ -250,7 +250,7 @@ static int process_command(AVFilterContext *ctx, const char *cmd, const char *ar
 
         if (ret < 0)
             return ret;
-        return avfilter_config_links(ctx);
+        return ff_filter_config_links(ctx);
     }
     return AVERROR(ENOSYS);
 }
diff --git a/libavfilter/internal.h b/libavfilter/internal.h
index 0e3f68d1f4..000f94cb16 100644
--- a/libavfilter/internal.h
+++ b/libavfilter/internal.h
@@ -246,6 +246,14 @@ int ff_parse_channel_layout(AVChannelLayout *ret, int *nret, const char *arg,
  */
 void ff_avfilter_link_set_in_status(AVFilterLink *link, int status, int64_t pts);
 
+/**
+ * Negotiate the media format, dimensions, etc of all inputs to a filter.
+ *
+ * @param filter the filter to negotiate the properties for its inputs
+ * @return       zero on successful negotiation
+ */
+int ff_filter_config_links(AVFilterContext *filter);
+
 #define D2TS(d)      (isnan(d) ? AV_NOPTS_VALUE : (int64_t)(d))
 #define TS2D(ts)     ((ts) == AV_NOPTS_VALUE ? NAN : (double)(ts))
 #define TS2T(ts, tb) ((ts) == AV_NOPTS_VALUE ? NAN : (double)(ts) * av_q2d(tb))
-- 
2.43.0