FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Macros | Enumerations | Functions | Variables
avfilter.c File Reference
#include "libavutil/atomic.h"
#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "libavutil/buffer.h"
#include "libavutil/channel_layout.h"
#include "libavutil/common.h"
#include "libavutil/eval.h"
#include "libavutil/hwcontext.h"
#include "libavutil/imgutils.h"
#include "libavutil/internal.h"
#include "libavutil/opt.h"
#include "libavutil/pixdesc.h"
#include "libavutil/rational.h"
#include "libavutil/samplefmt.h"
#include "framequeue.h"
#include "audio.h"
#include "avfilter.h"
#include "filters.h"
#include "formats.h"
#include "internal.h"
#include "libavutil/ffversion.h"

Go to the source code of this file.

Macros

#define FF_INTERNAL_FIELDS   1
 
#define LICENSE_PREFIX   "libavfilter license: "
 
#define OFFSET(x)   offsetof(AVFilterContext, x)
 
#define FLAGS   AV_OPT_FLAG_FILTERING_PARAM
 

Enumerations

enum  {
  VAR_T, VAR_N, VAR_POS, VAR_W,
  VAR_H, VAR_VARS_NB
}
 

Functions

void ff_tlog_ref (void *ctx, AVFrame *ref, int end)
 
unsigned avfilter_version (void)
 Return the LIBAVFILTER_VERSION_INT constant. More...
 
const char * avfilter_configuration (void)
 Return the libavfilter build-time configuration. More...
 
const char * avfilter_license (void)
 Return the libavfilter license. More...
 
void ff_command_queue_pop (AVFilterContext *filter)
 
int ff_insert_pad (unsigned idx, unsigned *count, size_t padidx_off, AVFilterPad **pads, AVFilterLink ***links, AVFilterPad *newpad)
 Insert a new pad. More...
 
int avfilter_link (AVFilterContext *src, unsigned srcpad, AVFilterContext *dst, unsigned dstpad)
 Link two filters together. More...
 
void avfilter_link_free (AVFilterLink **link)
 Free the link in *link, and set its pointer to NULL. More...
 
int avfilter_link_get_channels (AVFilterLink *link)
 Get the number of channels of a link. More...
 
void ff_filter_set_ready (AVFilterContext *filter, unsigned priority)
 Mark a filter ready and schedule it for activation. More...
 
static void filter_unblock (AVFilterContext *filter)
 Clear frame_blocked_in on all outputs. More...
 
void ff_avfilter_link_set_in_status (AVFilterLink *link, int status, int64_t pts)
 Set the status field of a link from the source filter. More...
 
void ff_avfilter_link_set_out_status (AVFilterLink *link, int status, int64_t pts)
 Set the status field of a link from the destination filter. More...
 
void avfilter_link_set_closed (AVFilterLink *link, int closed)
 Set the closed field of a link. More...
 
int avfilter_insert_filter (AVFilterLink *link, AVFilterContext *filt, unsigned filt_srcpad_idx, unsigned filt_dstpad_idx)
 Insert a filter in the middle of an existing link. More...
 
int avfilter_config_links (AVFilterContext *filter)
 Negotiate the media format, dimensions, etc of all inputs to a filter. More...
 
void ff_tlog_link (void *ctx, AVFilterLink *link, int end)
 
int ff_request_frame (AVFilterLink *link)
 Request an input frame from the filter at the other end of the link. More...
 
static int64_t guess_status_pts (AVFilterContext *ctx, int status, AVRational link_time_base)
 
static int ff_request_frame_to_filter (AVFilterLink *link)
 
int ff_poll_frame (AVFilterLink *link)
 Poll a frame from the filter chain. More...
 
static int set_enable_expr (AVFilterContext *ctx, const char *expr)
 
void ff_update_link_current_pts (AVFilterLink *link, int64_t pts)
 
int avfilter_process_command (AVFilterContext *filter, const char *cmd, const char *arg, char *res, int res_len, int flags)
 Make the filter instance process a command. More...
 
const AVFilteravfilter_get_by_name (const char *name)
 Get a filter definition matching the given name. More...
 
int avfilter_register (AVFilter *filter)
 Register a filter. More...
 
const AVFilteravfilter_next (const AVFilter *prev)
 Iterate over all registered filters. More...
 
int avfilter_pad_count (const AVFilterPad *pads)
 Get the number of elements in a NULL-terminated array of AVFilterPads (e.g. More...
 
static const char * default_filter_name (void *filter_ctx)
 
static voidfilter_child_next (void *obj, void *prev)
 
static const AVClassfilter_child_class_next (const AVClass *prev)
 
static int default_execute (AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
 
AVFilterContextff_filter_alloc (const AVFilter *filter, const char *inst_name)
 Allocate a new filter context and return it. More...
 
static void free_link (AVFilterLink *link)
 
void avfilter_free (AVFilterContext *filter)
 Free a filter context. More...
 
int ff_filter_get_nb_threads (AVFilterContext *ctx)
 Get number of threads for current filter instance. More...
 
static int process_options (AVFilterContext *ctx, AVDictionary **options, const char *args)
 
int avfilter_init_dict (AVFilterContext *ctx, AVDictionary **options)
 Initialize a filter with the supplied dictionary of options. More...
 
int avfilter_init_str (AVFilterContext *filter, const char *args)
 Initialize a filter with the supplied parameters. More...
 
const char * avfilter_pad_get_name (const AVFilterPad *pads, int pad_idx)
 Get the name of an AVFilterPad. More...
 
enum AVMediaType avfilter_pad_get_type (const AVFilterPad *pads, int pad_idx)
 Get the type of an AVFilterPad. More...
 
static int default_filter_frame (AVFilterLink *link, AVFrame *frame)
 
static int ff_filter_frame_framed (AVFilterLink *link, AVFrame *frame)
 
int ff_filter_frame (AVFilterLink *link, AVFrame *frame)
 Send a frame of data to the next filter. More...
 
static int samples_ready (AVFilterLink *link, unsigned min)
 
static int take_samples (AVFilterLink *link, unsigned min, unsigned max, AVFrame **rframe)
 
static int ff_filter_frame_to_filter (AVFilterLink *link)
 
static int forward_status_change (AVFilterContext *filter, AVFilterLink *in)
 
static int ff_filter_activate_default (AVFilterContext *filter)
 
int ff_filter_activate (AVFilterContext *filter)
 
int ff_inlink_acknowledge_status (AVFilterLink *link, int *rstatus, int64_t *rpts)
 Test and acknowledge the change of status on the link. More...
 
int ff_inlink_check_available_frame (AVFilterLink *link)
 Test if a frame is available on the link. More...
 
int ff_inlink_check_available_samples (AVFilterLink *link, unsigned min)
 Test if enough samples are available on the link. More...
 
static void consume_update (AVFilterLink *link, const AVFrame *frame)
 
int ff_inlink_consume_frame (AVFilterLink *link, AVFrame **rframe)
 Take a frame from the link's FIFO and update the link's stats. More...
 
int ff_inlink_consume_samples (AVFilterLink *link, unsigned min, unsigned max, AVFrame **rframe)
 Take samples from the link's FIFO and update the link's stats. More...
 
int ff_inlink_make_frame_writable (AVFilterLink *link, AVFrame **rframe)
 Make sure a frame is writable. More...
 
int ff_inlink_process_commands (AVFilterLink *link, const AVFrame *frame)
 Process the commands queued in the link up to the time of the frame. More...
 
int ff_inlink_evaluate_timeline_at_frame (AVFilterLink *link, const AVFrame *frame)
 Evaluate the timeline expression of the link for the time and properties of the frame. More...
 
void ff_inlink_request_frame (AVFilterLink *link)
 Mark that a frame is wanted on the link. More...
 
void ff_inlink_set_status (AVFilterLink *link, int status)
 Set the status on an input link. More...
 
int ff_outlink_get_status (AVFilterLink *link)
 Get the status on an output link. More...
 
const AVClassavfilter_get_class (void)
 

Variables

const char av_filter_ffversion [] = "FFmpeg version " FFMPEG_VERSION
 
static const char *const var_names []
 
static AVFilterfirst_filter
 
static AVFilter ** last_filter = &first_filter
 
static const AVOption avfilter_options []
 
static const AVClass avfilter_class
 

Macro Definition Documentation

#define FF_INTERNAL_FIELDS   1

Definition at line 37 of file avfilter.c.

#define LICENSE_PREFIX   "libavfilter license: "

Referenced by avfilter_license().

#define OFFSET (   x)    offsetof(AVFilterContext, x)

Definition at line 675 of file avfilter.c.

#define FLAGS   AV_OPT_FLAG_FILTERING_PARAM

Definition at line 676 of file avfilter.c.

Enumeration Type Documentation

anonymous enum
Enumerator
VAR_T 
VAR_N 
VAR_POS 
VAR_W 
VAR_H 
VAR_VARS_NB 

Definition at line 495 of file avfilter.c.

Function Documentation

void ff_tlog_ref ( void ctx,
AVFrame ref,
int  end 
)

Definition at line 49 of file avfilter.c.

Referenced by ff_filter_frame().

void ff_command_queue_pop ( AVFilterContext filter)

Definition at line 94 of file avfilter.c.

Referenced by avfilter_free(), and ff_inlink_process_commands().

int ff_insert_pad ( unsigned  idx,
unsigned *  count,
size_t  padidx_off,
AVFilterPad **  pads,
AVFilterLink ***  links,
AVFilterPad newpad 
)

Insert a new pad.

Parameters
idxInsertion point. Pad is inserted at the end if this point is beyond the end of the list of pads.
countPointer to the number of pads in the list
padidx_offOffset within an AVFilterLink structure to the element to increment when inserting a new pad causes link numbering to change
padsPointer to the pointer to the beginning of the list of pads
linksPointer to the pointer to the beginning of the list of links
newpadThe new pad to add. A copy is made when adding.
Returns
>= 0 in case of success, a negative AVERROR code on error

Definition at line 103 of file avfilter.c.

Referenced by ff_insert_inpad(), and ff_insert_outpad().

void ff_filter_set_ready ( AVFilterContext filter,
unsigned  priority 
)

Mark a filter ready and schedule it for activation.

This is automatically done when something happens to the filter (queued frame, status change, request on output). Filters implementing the activate callback can call it directly to perform one more round of processing later. It is also useful for filters reacting to external or asynchronous events.

Definition at line 191 of file avfilter.c.

Referenced by ff_avfilter_link_set_in_status(), ff_avfilter_link_set_out_status(), ff_filter_frame(), ff_filter_frame_to_filter(), ff_inlink_request_frame(), ff_request_frame(), and forward_status_change().

static void filter_unblock ( AVFilterContext filter)
static

Clear frame_blocked_in on all outputs.

This is necessary whenever something changes on input.

Definition at line 200 of file avfilter.c.

Referenced by ff_avfilter_link_set_in_status(), ff_avfilter_link_set_out_status(), ff_filter_frame(), and ff_filter_frame_to_filter().

void ff_avfilter_link_set_in_status ( AVFilterLink link,
int  status,
int64_t  pts 
)

Set the status field of a link from the source filter.

The pts should reflect the timestamp of the status change, in link time base and relative to the frames timeline. In particular, for AVERROR_EOF, it should reflect the end time of the last frame.

Definition at line 209 of file avfilter.c.

Referenced by av_buffersrc_close(), ff_outlink_set_status(), and ff_request_frame_to_filter().

void ff_avfilter_link_set_out_status ( AVFilterLink link,
int  status,
int64_t  pts 
)

Set the status field of a link from the destination filter.

The pts should probably be left unset (AV_NOPTS_VALUE).

Definition at line 222 of file avfilter.c.

Referenced by avfilter_link_set_closed(), ff_filter_frame_to_filter(), ff_inlink_set_status(), ff_request_frame(), and forward_status_change().

void ff_tlog_link ( void ctx,
AVFilterLink link,
int  end 
)
int ff_request_frame ( AVFilterLink link)

Request an input frame from the filter at the other end of the link.

This function must not be used by filters using the activate callback, use ff_link_set_frame_wanted() instead.

The input filter may pass the request on to its inputs, fulfill the request from an internal buffer or any other means specific to its function.

When the end of a stream is reached AVERROR_EOF is returned and no further frames are returned after that.

When a filter is unable to output a frame for example due to its sources being unable to do so or because it depends on external means pushing data into it then AVERROR(EAGAIN) is returned. It is important that a AVERROR(EAGAIN) return is returned all the way to the caller (generally eventually a user application) as this step may (but does not have to be) necessary to provide the input with the next frame.

If a request is successful then some progress has been made towards providing a frame on the link (through ff_filter_frame()). A filter that needs several frames to produce one is allowed to return success if one more frame has been processed but no output has been produced yet. A filter is also allowed to simply forward a success return value.

Parameters
linkthe input link
Returns
zero on success AVERROR_EOF on end of file AVERROR(EAGAIN) if the previous filter cannot output a frame currently and can neither guarantee that EOF has been reached.

Definition at line 405 of file avfilter.c.

Referenced by avfilter_graph_request_oldest(), ff_request_frame_to_filter(), join_request_frame(), qsvdeint_request_frame(), request_frame(), request_frame_ref(), request_inlink(), and return_audio_frame().

static int64_t guess_status_pts ( AVFilterContext ctx,
int  status,
AVRational  link_time_base 
)
static

Definition at line 430 of file avfilter.c.

Referenced by ff_request_frame_to_filter().

static int ff_request_frame_to_filter ( AVFilterLink link)
static

Definition at line 448 of file avfilter.c.

Referenced by ff_filter_activate_default(), and forward_status_change().

int ff_poll_frame ( AVFilterLink link)

Poll a frame from the filter chain.

Parameters
linkthe input link
Returns
the number of immediately available frames, a negative number in case of error

Definition at line 468 of file avfilter.c.

Referenced by ff_poll_frame().

static int set_enable_expr ( AVFilterContext ctx,
const char *  expr 
)
static

Definition at line 504 of file avfilter.c.

Referenced by avfilter_process_command(), and process_options().

void ff_update_link_current_pts ( AVFilterLink link,
int64_t  pts 
)
static const char* default_filter_name ( void filter_ctx)
static

Definition at line 640 of file avfilter.c.

static void* filter_child_next ( void obj,
void prev 
)
static

Definition at line 646 of file avfilter.c.

static const AVClass* filter_child_class_next ( const AVClass prev)
static

Definition at line 654 of file avfilter.c.

static int default_execute ( AVFilterContext ctx,
avfilter_action_func func,
void arg,
int ret,
int  nb_jobs 
)
static

Definition at line 697 of file avfilter.c.

Referenced by ff_filter_alloc().

AVFilterContext* ff_filter_alloc ( const AVFilter filter,
const char *  inst_name 
)

Allocate a new filter context and return it.

Parameters
filterwhat filter to create an instance of
inst_namename to give to the new filter context
Returns
newly created filter context or NULL on failure

Definition at line 710 of file avfilter.c.

Referenced by avfilter_graph_alloc_filter().

static void free_link ( AVFilterLink link)
static

Definition at line 794 of file avfilter.c.

Referenced by avfilter_free().

int ff_filter_get_nb_threads ( AVFilterContext ctx)

Get number of threads for current filter instance.

This number is always same or less than graph->nb_threads.

Definition at line 857 of file avfilter.c.

Referenced by apply_lut(), averageiir2d(), blend_frame(), config_input(), config_props(), filter(), filter_frame(), filter_frame16(), filter_frame8(), gaussianiir2d(), and nlmeans_plane().

static int process_options ( AVFilterContext ctx,
AVDictionary **  options,
const char *  args 
)
static

Definition at line 864 of file avfilter.c.

Referenced by avfilter_init_str().

static int default_filter_frame ( AVFilterLink link,
AVFrame frame 
)
static

Definition at line 1115 of file avfilter.c.

Referenced by ff_filter_frame_framed().

static int ff_filter_frame_framed ( AVFilterLink link,
AVFrame frame 
)
static

Definition at line 1120 of file avfilter.c.

Referenced by ff_filter_frame_to_filter().

int ff_filter_frame ( AVFilterLink link,
AVFrame frame 
)
static int samples_ready ( AVFilterLink link,
unsigned  min 
)
static

Definition at line 1202 of file avfilter.c.

Referenced by ff_filter_activate_default(), and take_samples().

static int take_samples ( AVFilterLink link,
unsigned  min,
unsigned  max,
AVFrame **  rframe 
)
static

Definition at line 1209 of file avfilter.c.

Referenced by ff_inlink_consume_samples().

static int ff_filter_frame_to_filter ( AVFilterLink link)
static

Definition at line 1269 of file avfilter.c.

Referenced by ff_filter_activate_default().

static int forward_status_change ( AVFilterContext filter,
AVFilterLink in 
)
static

Definition at line 1301 of file avfilter.c.

Referenced by ff_filter_activate_default().

static int ff_filter_activate_default ( AVFilterContext filter)
static

Definition at line 1333 of file avfilter.c.

Referenced by ff_filter_activate().

int ff_filter_activate ( AVFilterContext filter)

Definition at line 1492 of file avfilter.c.

Referenced by ff_filter_graph_run_once().

int ff_inlink_acknowledge_status ( AVFilterLink link,
int rstatus,
int64_t *  rpts 
)

Test and acknowledge the change of status on the link.

Status means EOF or an error condition; a change from the normal (0) status to a non-zero status can be queued in a filter's input link, it becomes relevant after the frames queued in the link's FIFO are processed. This function tests if frames are still queued and if a queued status change has not yet been processed. In that case it performs basic treatment (updating the link's timestamp) and returns a positive value to let the filter do its own treatments (flushing...).

Filters implementing the activate callback should call this function when they think it might succeed (usually after checking unsuccessfully for a queued frame). Filters implementing the filter_frame and request_frame callbacks do not need to call that since the same treatment happens in ff_filter_frame().

Parameters
[out]rstatusnew or current status
[out]rptscurrent timestamp of the link in link time base
Returns
>0 if status changed, <0 if status already acked, 0 otherwise

Definition at line 1507 of file avfilter.c.

Referenced by activate(), consume_from_fifos(), and get_frame_internal().

int ff_inlink_check_available_frame ( AVFilterLink link)

Test if a frame is available on the link.

Returns
>0 if a frame is available

Definition at line 1522 of file avfilter.c.

Referenced by ff_inlink_consume_frame().

int ff_inlink_check_available_samples ( AVFilterLink link,
unsigned  min 
)

Test if enough samples are available on the link.

Returns
>0 if enough samples are available
Note
on EOF and error, min becomes 1

Definition at line 1527 of file avfilter.c.

Referenced by ff_inlink_consume_samples().

static void consume_update ( AVFilterLink link,
const AVFrame frame 
)
static

Definition at line 1534 of file avfilter.c.

Referenced by ff_inlink_consume_frame(), and ff_inlink_consume_samples().

int ff_inlink_consume_frame ( AVFilterLink link,
AVFrame **  rframe 
)

Take a frame from the link's FIFO and update the link's stats.

If ff_inlink_check_available_frame() was previously called, the preferred way of expressing it is "av_assert1(ret);" immediately after ff_inlink_consume_frame(). Negative error codes must still be checked.

Note
May trigger process_command() and/or update is_disabled.
Returns
>0 if a frame is available, 0 and set rframe to NULL if no frame available, or AVERROR code

Definition at line 1542 of file avfilter.c.

Referenced by activate(), consume_from_fifos(), ff_filter_frame_to_filter(), and get_frame_internal().

int ff_inlink_consume_samples ( AVFilterLink link,
unsigned  min,
unsigned  max,
AVFrame **  rframe 
)

Take samples from the link's FIFO and update the link's stats.

If ff_inlink_check_available_samples() was previously called, the preferred way of expressing it is "av_assert1(ret);" immediately after ff_inlink_consume_samples(). Negative error codes must still be checked.

Note
May trigger process_command() and/or update is_disabled.
Returns
>0 if a frame is available, 0 and set rframe to NULL if no frame available, or AVERROR code

Definition at line 1561 of file avfilter.c.

Referenced by ff_filter_frame_to_filter(), ff_inlink_consume_frame(), and get_frame_internal().

int ff_inlink_make_frame_writable ( AVFilterLink link,
AVFrame **  rframe 
)

Make sure a frame is writable.

This is similar to av_frame_make_writable() except it uses the link's buffer allocation callback, and therefore allows direct rendering.

Definition at line 1581 of file avfilter.c.

Referenced by ff_filter_frame_framed(), and ff_framesync_dualinput_get_writable().

int ff_inlink_process_commands ( AVFilterLink link,
const AVFrame frame 
)

Process the commands queued in the link up to the time of the frame.

Commands will trigger the process_command() callback.

Returns
>= 0 or AVERROR code.

Definition at line 1630 of file avfilter.c.

Referenced by consume_update(), and ff_filter_frame_framed().

int ff_inlink_evaluate_timeline_at_frame ( AVFilterLink link,
const AVFrame frame 
)

Evaluate the timeline expression of the link for the time and properties of the frame.

Returns
>0 if enabled, 0 if disabled
Note
It does not update link->dst->is_disabled.

Definition at line 1645 of file avfilter.c.

Referenced by consume_update(), and ff_filter_frame_framed().

void ff_inlink_request_frame ( AVFilterLink link)

Mark that a frame is wanted on the link.

Unlike ff_filter_frame(), it must not be called when the link has a non-zero status, and thus does not acknowledge it. Also it cannot fail.

Definition at line 1663 of file avfilter.c.

Referenced by activate(), consume_from_fifos(), get_frame_internal(), and request_samples().

void ff_inlink_set_status ( AVFilterLink link,
int  status 
)

Set the status on an input link.

Also discard all frames in the link's FIFO.

Definition at line 1671 of file avfilter.c.

int ff_outlink_get_status ( AVFilterLink link)

Get the status on an output link.

Definition at line 1686 of file avfilter.c.

Variable Documentation

const char av_filter_ffversion[] = "FFmpeg version " FFMPEG_VERSION

Definition at line 47 of file avfilter.c.

const char* const var_names[]
static
Initial value:
= {
"t",
"n",
"pos",
"w",
"h",
}
#define NULL
Definition: coverity.c:32

Definition at line 486 of file avfilter.c.

Referenced by set_enable_expr().

AVFilter* first_filter
static

Definition at line 576 of file avfilter.c.

Referenced by avfilter_next().

AVFilter** last_filter = &first_filter
static
const AVOption avfilter_options[]
static
Initial value:
= {
{ "thread_type", "Allowed thread types", OFFSET(thread_type), AV_OPT_TYPE_FLAGS,
{ .i64 = AVFILTER_THREAD_SLICE }, 0, INT_MAX, FLAGS, "thread_type" },
{ "slice", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = AVFILTER_THREAD_SLICE }, .unit = "thread_type" },
{ "enable", "set enable expression", OFFSET(enable_str), AV_OPT_TYPE_STRING, {.str=NULL}, .flags = FLAGS },
{ "threads", "Allowed number of threads", OFFSET(nb_threads), AV_OPT_TYPE_INT,
{ .i64 = 0 }, 0, INT_MAX, FLAGS },
{ NULL },
}
#define NULL
Definition: coverity.c:32
#define AVFILTER_THREAD_SLICE
Process multiple parts of the frame concurrently.
Definition: avfilter.h:333
#define FLAGS
Definition: avfilter.c:676
#define OFFSET(x)
Definition: avfilter.c:675

Definition at line 677 of file avfilter.c.

const AVClass avfilter_class
static
Initial value:
= {
.class_name = "AVFilter",
.item_name = default_filter_name,
.child_next = filter_child_next,
.child_class_next = filter_child_class_next,
}
#define LIBAVUTIL_VERSION_INT
Definition: version.h:86
const struct AVOption * option
a pointer to the first option specified in the class if any or NULL
Definition: log.h:85
static const char * default_filter_name(void *filter_ctx)
Definition: avfilter.c:640
static void * filter_child_next(void *obj, void *prev)
Definition: avfilter.c:646
static const AVOption avfilter_options[]
Definition: avfilter.c:677
static const AVClass * filter_child_class_next(const AVClass *prev)
Definition: avfilter.c:654

Definition at line 687 of file avfilter.c.

Referenced by avfilter_get_class(), and ff_filter_alloc().