libavfilter/avfiltergraph.h File Reference

#include "avfilter.h"

Go to the source code of this file.

Data Structures
struct	AVFilterGraph
struct	AVFilterInOut
	A linked-list of the inputs/outputs of the filter chain. More...
Typedefs
typedef struct AVFilterGraph	AVFilterGraph
typedef struct AVFilterInOut	AVFilterInOut
	A linked-list of the inputs/outputs of the filter chain.
Functions
AVFilterGraph *	avfilter_graph_alloc (void)
	Allocate a filter graph.
AVFilterContext *	avfilter_graph_get_filter (AVFilterGraph *graph, char *name)
	Get a filter instance with name name from graph.
int	avfilter_graph_add_filter (AVFilterGraph *graphctx, AVFilterContext *filter)
	Add an existing filter instance to a filter graph.
int	avfilter_graph_create_filter (AVFilterContext **filt_ctx, AVFilter *filt, const char *name, const char *args, void *opaque, AVFilterGraph *graph_ctx)
	Create and add a filter instance into an existing graph.
int	avfilter_graph_config (AVFilterGraph *graphctx, void *log_ctx)
	Check validity and configure all the links and formats in the graph.
void	avfilter_graph_free (AVFilterGraph **graph)
	Free a graph, destroy its links, and set *graph to NULL.
int	avfilter_graph_parse (AVFilterGraph *graph, const char *filters, AVFilterInOut *inputs, AVFilterInOut *outputs, void *log_ctx)
	Add a graph described by a string to a graph.

---

Typedef Documentation

typedef struct AVFilterGraph AVFilterGraph

typedef struct AVFilterInOut AVFilterInOut

A linked-list of the inputs/outputs of the filter chain.

This is mainly useful for avfilter_graph_parse(), since this function may accept a description of a graph with not connected input/output pads. This struct specifies, per each not connected pad contained in the graph, the filter context and the pad index required for establishing a link.

---

Function Documentation

int avfilter_graph_add_filter	(	AVFilterGraph *	graphctx,
		AVFilterContext *	filter
	)

Add an existing filter instance to a filter graph.

Parameters:

	graphctx	the filter graph
	filter	the filter to be added

Definition at line 46 of file avfiltergraph.c.

Referenced by avfilter_graph_create_filter(), and create_filter().

AVFilterGraph* avfilter_graph_alloc

(

void

)

Allocate a filter graph.

Definition at line 30 of file avfiltergraph.c.

Referenced by configure_video_filters(), and video_thread().

int avfilter_graph_config	(	AVFilterGraph *	graphctx,
		void *	log_ctx
	)

Check validity and configure all the links and formats in the graph.

Parameters:

	graphctx	the filter graph
	log_ctx	context used for logging

Returns:

0 in case of success, a negative AVERROR code otherwise

Definition at line 232 of file avfiltergraph.c.

Referenced by configure_video_filters(), and main().

int avfilter_graph_create_filter	(	AVFilterContext **	filt_ctx,
		AVFilter *	filt,
		const char *	name,
		const char *	args,
		void *	opaque,
		AVFilterGraph *	graph_ctx
	)

Create and add a filter instance into an existing graph.

The filter instance is created from the filter filt and inited with the parameters args and opaque.

In case of success put in *filt_ctx the pointer to the created filter instance, otherwise set *filt_ctx to NULL.

Parameters:

	name	the instance name to give to the created filter instance
	graph_ctx	the filter graph

Returns:

a negative AVERROR error code in case of failure, a non negative value otherwise

Definition at line 59 of file avfiltergraph.c.

Referenced by configure_video_filters(), and query_formats().

void avfilter_graph_free

(

AVFilterGraph **

graph

)

Free a graph, destroy its links, and set *graph to NULL.

If *graph is NULL, do nothing.

Definition at line 35 of file avfiltergraph.c.

Referenced by transcode(), transcode_video(), and video_thread().

AVFilterContext* avfilter_graph_get_filter	(	AVFilterGraph *	graph,
		char *	name
	)

Get a filter instance with name name from graph.

Returns:

the pointer to the found filter instance or NULL if it cannot be found.

Definition at line 127 of file avfiltergraph.c.

int avfilter_graph_parse	(	AVFilterGraph *	graph,
		const char *	filters,
		AVFilterInOut *	inputs,
		AVFilterInOut *	outputs,
		void *	log_ctx
	)

Add a graph described by a string to a graph.

Parameters:

	graph	the filter graph where to link the parsed graph context
	filters	string to be parsed
	inputs	linked list to the inputs of the graph
	outputs	linked list to the outputs of the graph

Returns:

zero on success, a negative AVERROR code on error

Definition at line 332 of file graphparser.c.

Referenced by configure_video_filters(), and main().