]> git.sesse.net Git - ffmpeg/blobdiff - libavfilter/avfiltergraph.h
oggenc: check for failed av_mallocz()
[ffmpeg] / libavfilter / avfiltergraph.h
index c5a0641b3958045ccc235087001cc02e219a6c38..c78d53f0a3a3e6e0f152c72706f6173e96f61b6d 100644 (file)
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  */
 
-#ifndef FFMPEG_AVFILTER_GRAPH_H
-#define FFMPEG_AVFILTER_GRAPH_H
+#ifndef AVFILTER_AVFILTERGRAPH_H
+#define AVFILTER_AVFILTERGRAPH_H
 
 #include "avfilter.h"
 
-typedef struct AVFilterGraph AVFilterGraph;
+typedef struct AVFilterGraph {
+    unsigned filter_count;
+    AVFilterContext **filters;
 
-/**
- * Create a new filter graph
- */
-AVFilterGraph *avfilter_create_graph(void);
+    char *scale_sws_opts; ///< sws options to use for the auto-inserted scale filters
+} AVFilterGraph;
 
 /**
- * Destroy a filter graph, and any filters in it.
- * @param graph The filter graph to destroy
+ * Gets a filter instance with name name from graph.
+ *
+ * @return the pointer to the found filter instance or NULL if it
+ * cannot be found.
  */
-void avfilter_destroy_graph(AVFilterGraph *graph);
+AVFilterContext *avfilter_graph_get_filter(AVFilterGraph *graph, char *name);
 
 /**
- * Add an existing filter instance to a filter graph.
+ * Adds an existing filter instance to a filter graph.
  * @param graph  The filter graph
  * @param filter The filter to be added
  */
-void avfilter_graph_add_filter(AVFilterGraph *graph, AVFilterContext *filter);
+int avfilter_graph_add_filter(AVFilterGraph *graphctx, AVFilterContext *filter);
+
+/**
+ * Checks for the validity of graph.
+ *
+ * A graph is considered valid if all its input and output pads are
+ * connected.
+ *
+ * @return 0 in case of success, a negative value otherwise
+ */
+int avfilter_graph_check_validity(AVFilterGraph *graphctx, AVClass *log_ctx);
 
 /**
- * Loads the filter graph with a simple chain described by filters.
- * @param graph   The filter graph to load filters into
- * @param count   The number of filters to be created
- * @param filters_list An array of strings describing the filters to be created.
- *                The format of each string is "name=params".
- * @param first   If non-NULL, will be set to the first filter in the chain.
- * @param last    If non-NULL, will be set to the last filter in the chain.
- * @return 0 on success.  -1 on error.
+ * Configures all the links of graphctx.
+ *
+ * @return 0 in case of success, a negative value otherwise
+ */
+int avfilter_graph_config_links(AVFilterGraph *graphctx, AVClass *log_ctx);
+
+/**
+ * Configures the formats of all the links in the graph.
  */
-int avfilter_graph_load_chain(AVFilterGraph *graph,
-                              unsigned count, char **filter_list, void **opaque,
-                              AVFilterContext **first, AVFilterContext **last);
-#endif  /* FFMPEG_AVFILTER_H */
+int avfilter_graph_config_formats(AVFilterGraph *graphctx);
+
+/**
+ * Frees a graph and destroys its links.
+ */
+void avfilter_graph_destroy(AVFilterGraph *graph);
+
+#endif  /* AVFILTER_AVFILTERGRAPH_H */