FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Public Types | Data Fields

A link between two filters. More...

#include <avfilter.h>

Public Types

enum  { AVLINK_UNINIT = 0, AVLINK_STARTINIT, AVLINK_INIT }
 stage of the initialization of the link properties (dimensions, etc) More...
 

Data Fields

AVFilterContextsrc
 source filter More...
 
AVFilterPadsrcpad
 output pad on the source filter More...
 
AVFilterContextdst
 dest filter More...
 
AVFilterPaddstpad
 input pad on the dest filter More...
 
enum AVMediaType type
 filter media type More...
 
int w
 agreed upon image width More...
 
int h
 agreed upon image height More...
 
AVRational sample_aspect_ratio
 agreed upon sample aspect ratio More...
 
uint64_t channel_layout
 channel layout of current buffer (see libavutil/channel_layout.h) More...
 
int sample_rate
 samples per second More...
 
int format
 agreed upon media format More...
 
AVRational time_base
 Define the time base used by the PTS of the frames/samples which will pass through this link. More...
 
AVFilterFormatsin_formats
 Lists of formats and channel layouts supported by the input and output filters respectively. More...
 
AVFilterFormatsout_formats
 
AVFilterFormatsin_samplerates
 Lists of channel layouts and sample rates used for automatic negotiation. More...
 
AVFilterFormatsout_samplerates
 
struct AVFilterChannelLayoutsin_channel_layouts
 
struct AVFilterChannelLayoutsout_channel_layouts
 
int request_samples
 Audio only, the destination filter sets this to a non-zero value to request that buffers with the given number of samples should be sent to it. More...
 
enum AVFilterLink:: { ... }  init_state
 stage of the initialization of the link properties (dimensions, etc) More...
 
struct AVFilterGraphgraph
 Graph the filter belongs to. More...
 
int64_t current_pts
 Current timestamp of the link, as defined by the most recent frame(s), in link time_base units. More...
 
int64_t current_pts_us
 Current timestamp of the link, as defined by the most recent frame(s), in AV_TIME_BASE units. More...
 
int age_index
 Index in the age array. More...
 
AVRational frame_rate
 Frame rate of the stream on the link, or 1/0 if unknown or variable; if left to 0/0, will be automatically copied from the first input of the source filter if it exists. More...
 
AVBufferRefhw_frames_ctx
 For hwaccel pixel formats, this should be a reference to the AVHWFramesContext describing the frames. More...
 
AVFramepartial_buf
 Buffer partially filled with samples to achieve a fixed/minimum size. More...
 
int partial_buf_size
 Size of the partial buffer to allocate. More...
 
int min_samples
 Minimum number of samples to filter at once. More...
 
int max_samples
 Maximum number of samples to filter at once. More...
 
int status
 Link status. More...
 
int channels
 Number of channels. More...
 
unsigned flags
 Link processing flags. More...
 
int64_t frame_count
 Number of past frames sent through the link. More...
 
voidvideo_frame_pool
 A pointer to a FFVideoFramePool struct. More...
 
int frame_wanted_in
 True if a frame is currently wanted on the input of this filter. More...
 
int frame_wanted_out
 True if a frame is currently wanted on the output of this filter. More...
 

Detailed Description

A link between two filters.

This contains pointers to the source and destination filters between which this link exists, and the indexes of the pads involved. In addition, this link also contains the parameters which have been negotiated and agreed upon between the filter, such as image dimensions, format, etc.

Examples:
filtering_audio.c.

Definition at line 371 of file avfilter.h.

Member Enumeration Documentation

anonymous enum

stage of the initialization of the link properties (dimensions, etc)

Enumerator
AVLINK_UNINIT 

not started

AVLINK_STARTINIT 

started, but incomplete

AVLINK_INIT 

complete

Definition at line 435 of file avfilter.h.

Field Documentation

AVFilterContext* AVFilterLink::src
AVFilterPad* AVFilterLink::srcpad
AVFilterContext* AVFilterLink::dst
AVFilterPad* AVFilterLink::dstpad
enum AVMediaType AVFilterLink::type
int AVFilterLink::w
int AVFilterLink::h

agreed upon image height

Definition at line 382 of file avfilter.h.

Referenced by alloc_out_frame(), apply_lut(), apply_palette(), apply_unsharp_c(), avfilter_config_links(), blend_frame(), blend_frames16(), blend_frames8(), calc_persp_luts(), config_input(), config_input_overlay(), config_input_palette(), config_input_props(), config_input_ref(), config_out_props(), config_output(), config_output_props(), config_props(), config_props_input(), config_props_output(), config_props_ref(), config_video(), config_video_output(), copy_picture_field(), create_weave_frame(), cudaupload_config_output(), draw_background(), draw_blank_frame(), ff_filter_frame(), ff_filter_frame_framed(), ff_opencl_apply_unsharp(), ff_opencl_deshake_process_inout_buf(), ff_opencl_unsharp_process_inout_buf(), ff_tlog_link(), filter(), filter_color(), filter_color2(), filter_frame(), filter_mono(), geq_filter_frame(), get_aspect_ratio(), get_current_tile_pos(), get_frame(), get_palette_frame(), hwdownload_config_output(), hwdownload_filter_frame(), hwupload_config_output(), lavfi_read_header(), movie_config_output_props(), nppscale_config_props(), nppscale_filter_frame(), output_single_frame(), plot_cqt(), plot_freq(), plot_freqs(), plot_spectrum_column(), pp_config_props(), pp_filter_frame(), print_digraph(), print_link_prop(), process_frame(), push_single_pic(), return_frame(), scale_vaapi_config_output(), source_config_props(), source_request_frame(), transcode_init(), try_push_frame(), and update_context().

AVRational AVFilterLink::sample_aspect_ratio
uint64_t AVFilterLink::channel_layout
int AVFilterLink::sample_rate
int AVFilterLink::format
AVRational AVFilterLink::time_base
AVFilterFormats* AVFilterLink::in_formats

Lists of formats and channel layouts supported by the input and output filters respectively.

These lists are used for negotiating the format to actually be used, which will be loaded into the format and channel_layout members, above, when chosen.

Definition at line 413 of file avfilter.h.

Referenced by cudaupload_query_formats(), formats_declared(), free_link(), hwdownload_query_formats(), hwupload_query_formats(), movie_query_formats(), pick_format(), pick_formats(), query_formats(), query_formats_src(), scale_vaapi_query_formats(), and swap_sample_fmts_on_filter().

AVFilterFormats* AVFilterLink::out_formats
AVFilterFormats* AVFilterLink::in_samplerates

Lists of channel layouts and sample rates used for automatic negotiation.

Definition at line 420 of file avfilter.h.

Referenced by formats_declared(), free_link(), movie_query_formats(), pick_format(), query_formats(), and swap_samplerates_on_filter().

AVFilterFormats* AVFilterLink::out_samplerates
struct AVFilterChannelLayouts* AVFilterLink::in_channel_layouts
struct AVFilterChannelLayouts* AVFilterLink::out_channel_layouts
int AVFilterLink::request_samples

Audio only, the destination filter sets this to a non-zero value to request that buffers with the given number of samples should be sent to it.

AVFilterPad.needs_fifo must also be set on the corresponding input pad. Last buffer before EOF will be padded with silence.

Definition at line 432 of file avfilter.h.

Referenced by filter_frame(), request_frame(), and return_audio_frame().

enum { ... } AVFilterLink::init_state

stage of the initialization of the link properties (dimensions, etc)

Referenced by avfilter_config_links().

struct AVFilterGraph* AVFilterLink::graph

Graph the filter belongs to.

Definition at line 444 of file avfilter.h.

Referenced by ff_filter_graph_remove_filter(), ff_update_link_current_pts(), filter_frame(), and graph_config_pointers().

int64_t AVFilterLink::current_pts

Current timestamp of the link, as defined by the most recent frame(s), in link time_base units.

Definition at line 450 of file avfilter.h.

Referenced by avfilter_config_links(), and ff_update_link_current_pts().

int64_t AVFilterLink::current_pts_us

Current timestamp of the link, as defined by the most recent frame(s), in AV_TIME_BASE units.

Definition at line 456 of file avfilter.h.

Referenced by avfilter_config_links(), ff_update_link_current_pts(), heap_bubble_down(), and heap_bubble_up().

int AVFilterLink::age_index
AVRational AVFilterLink::frame_rate

Frame rate of the stream on the link, or 1/0 if unknown or variable; if left to 0/0, will be automatically copied from the first input of the source filter if it exists.

Sources should set it to the best estimation of the real frame rate. If the source frame rate is unknown or variable, set this to 1/0. Filters should update it if necessary depending on their function. Sinks can use it to set a default output frame rate. It is similar to the r_frame_rate field in AVStream.

Definition at line 474 of file avfilter.h.

Referenced by av_buffersink_get_frame_rate(), avfilter_config_links(), config_input(), config_out_props(), config_output(), config_output_props(), config_props(), config_props_output(), do_video_out(), movie_config_output_props(), source_config_props(), update_pts(), and video_thread().

AVBufferRef* AVFilterLink::hw_frames_ctx
AVFrame* AVFilterLink::partial_buf

Buffer partially filled with samples to achieve a fixed/minimum size.

Definition at line 485 of file avfilter.h.

Referenced by ff_filter_frame(), ff_filter_frame_needs_framing(), and ff_request_frame_to_filter().

int AVFilterLink::partial_buf_size

Size of the partial buffer to allocate.

Must be between min_samples and max_samples.

Definition at line 491 of file avfilter.h.

Referenced by av_buffersink_set_frame_size(), config_audio_input(), config_input(), ff_filter_frame_needs_framing(), and filter_frame().

int AVFilterLink::min_samples

Minimum number of samples to filter at once.

If filter_frame() is called with fewer samples, it will accumulate them in partial_buf. This field and the related ones must not be changed after filtering has started. If 0, all related fields are ignored.

Definition at line 500 of file avfilter.h.

Referenced by av_buffersink_set_frame_size(), config_audio_input(), config_input(), ff_filter_frame(), ff_filter_frame_needs_framing(), and filter_frame().

int AVFilterLink::max_samples

Maximum number of samples to filter at once.

If filter_frame() is called with more samples, it will split them.

Definition at line 506 of file avfilter.h.

Referenced by av_buffersink_set_frame_size(), config_audio_input(), config_input(), ff_filter_frame(), and filter_frame().

int AVFilterLink::status

Link status.

If not zero, all attempts of filter_frame or request_frame will fail with the corresponding code, and if necessary the reference will be destroyed. If request_frame returns an error, the status is set on the corresponding link. It can be set also be set by either the source or the destination filter.

Definition at line 518 of file avfilter.h.

Referenced by av_buffersink_get_frame_flags(), ff_avfilter_link_set_out_status(), ff_filter_frame_framed(), ff_request_frame(), ff_request_frame_to_filter(), filter_frame(), push_frame(), and request_frame().

int AVFilterLink::channels
unsigned AVFilterLink::flags

Link processing flags.

Definition at line 528 of file avfilter.h.

int64_t AVFilterLink::frame_count
void* AVFilterLink::video_frame_pool

A pointer to a FFVideoFramePool struct.

Definition at line 538 of file avfilter.h.

Referenced by ff_default_get_video_buffer().

int AVFilterLink::frame_wanted_in

True if a frame is currently wanted on the input of this filter.

Set when ff_request_frame() is called by the output, cleared when the request is handled or forwarded.

Definition at line 545 of file avfilter.h.

Referenced by ff_avfilter_link_set_out_status(), ff_filter_frame_needs_framing(), ff_request_frame(), ff_request_frame_to_filter(), and graph_run_once_find_filter().

int AVFilterLink::frame_wanted_out

True if a frame is currently wanted on the output of this filter.

Set when ff_request_frame() is called by the output, cleared when a frame is filtered.

Definition at line 552 of file avfilter.h.

Referenced by av_buffersink_get_frame_flags(), avfilter_graph_request_oldest(), ff_avfilter_link_set_out_status(), ff_filter_frame(), ff_filter_frame_needs_framing(), ff_request_frame(), ff_request_frame_to_filter(), and graph_run_once_find_filter().


The documentation for this struct was generated from the following file: