#include "libavutil/pixdesc.h"
#include "libavutil/rational.h"
#include "libavutil/audioconvert.h"
#include "libavutil/imgutils.h"
#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "avfilter.h"
#include "internal.h"
Go to the source code of this file.
Defines | |
#define | LICENSE_PREFIX "libavfilter license: " |
#define | FF_DPRINTF_START(ctx, func) av_dlog(NULL, "%-16s: ", #func) |
#define | MAX_REGISTERED_AVFILTERS_NB 128 |
Functions | |
unsigned | avfilter_version (void) |
Return the LIBAVFILTER_VERSION_INT constant. | |
const char * | avfilter_configuration (void) |
Return the libavfilter build-time configuration. | |
const char * | avfilter_license (void) |
Return the libavfilter license. | |
static void | command_queue_pop (AVFilterContext *filter) |
AVFilterBufferRef * | avfilter_ref_buffer (AVFilterBufferRef *ref, int pmask) |
Add a new reference to a buffer. | |
static void | store_in_pool (AVFilterBufferRef *ref) |
void | avfilter_unref_buffer (AVFilterBufferRef *ref) |
Remove a reference to a buffer. | |
void | avfilter_insert_pad (unsigned idx, unsigned *count, size_t padidx_off, AVFilterPad **pads, AVFilterLink ***links, AVFilterPad *newpad) |
Insert a new pad. | |
int | avfilter_link (AVFilterContext *src, unsigned srcpad, AVFilterContext *dst, unsigned dstpad) |
Link two filters together. | |
void | avfilter_link_free (AVFilterLink **link) |
Free the link in *link, and set its pointer to NULL. | |
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. | |
int | avfilter_config_links (AVFilterContext *filter) |
Negotiate the media format, dimensions, etc of all inputs to a filter. | |
static char * | ff_get_ref_perms_string (char *buf, size_t buf_size, int perms) |
static void | ff_dlog_ref (void *ctx, AVFilterBufferRef *ref, int end) |
static void | ff_dlog_link (void *ctx, AVFilterLink *link, int end) |
AVFilterBufferRef * | avfilter_get_video_buffer (AVFilterLink *link, int perms, int w, int h) |
Request a picture buffer with a specific set of permissions. | |
AVFilterBufferRef * | avfilter_get_video_buffer_ref_from_arrays (uint8_t *const data[4], const int linesize[4], int perms, int w, int h, enum PixelFormat format) |
Create a buffer reference wrapped around an already allocated image buffer. | |
AVFilterBufferRef * | avfilter_get_audio_buffer (AVFilterLink *link, int perms, int nb_samples) |
Request an audio samples buffer with a specific set of permissions. | |
AVFilterBufferRef * | avfilter_get_audio_buffer_ref_from_arrays (uint8_t *data[8], int linesize[8], int perms, int nb_samples, enum AVSampleFormat sample_fmt, uint64_t channel_layout, int planar) |
Create an audio buffer reference wrapped around an already allocated samples buffer. | |
int | avfilter_request_frame (AVFilterLink *link) |
Request an input frame from the filter at the other end of the link. | |
int | avfilter_poll_frame (AVFilterLink *link) |
Poll a frame from the filter chain. | |
void | avfilter_start_frame (AVFilterLink *link, AVFilterBufferRef *picref) |
Notify the next filter of the start of a frame. | |
void | avfilter_end_frame (AVFilterLink *link) |
Notify the next filter that the current frame has finished. | |
void | avfilter_draw_slice (AVFilterLink *link, int y, int h, int slice_dir) |
Send a slice to the next filter. | |
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. | |
void | avfilter_filter_samples (AVFilterLink *link, AVFilterBufferRef *samplesref) |
Send a buffer of audio samples to the next filter. | |
AVFilter * | avfilter_get_by_name (const char *name) |
Get a filter definition matching the given name. | |
int | avfilter_register (AVFilter *filter) |
Register a filter. | |
AVFilter ** | av_filter_next (AVFilter **filter) |
If filter is NULL, returns a pointer to the first registered filter pointer, if filter is non-NULL, returns the next pointer after filter. | |
void | avfilter_uninit (void) |
Uninitialize the filter system. | |
static int | pad_count (const AVFilterPad *pads) |
static const char * | filter_name (void *p) |
int | avfilter_open (AVFilterContext **filter_ctx, AVFilter *filter, const char *inst_name) |
Create a filter instance. | |
void | avfilter_free (AVFilterContext *filter) |
Free a filter context. | |
int | avfilter_init_filter (AVFilterContext *filter, const char *args, void *opaque) |
Initialize a filter. | |
Variables | |
static AVFilter * | registered_avfilters [MAX_REGISTERED_AVFILTERS_NB+1] |
static int | next_registered_avfilter_idx = 0 |
static const AVClass | avfilter_class |
Definition at line 392 of file avfilter.c.
Referenced by avfilter_draw_slice(), avfilter_filter_samples(), avfilter_get_video_buffer(), avfilter_request_frame(), and avfilter_start_frame().
#define LICENSE_PREFIX "libavfilter license: " |
#define MAX_REGISTERED_AVFILTERS_NB 128 |
If filter is NULL, returns a pointer to the first registered filter pointer, if filter is non-NULL, returns the next pointer after filter.
If the returned pointer points to NULL, the last registered filter was already reached.
Definition at line 721 of file avfilter.c.
Referenced by opt_filters().
int avfilter_config_links | ( | AVFilterContext * | filter | ) |
Negotiate the media format, dimensions, etc of all inputs to a filter.
filter | the filter to negotiate the properties for its inputs |
Definition at line 241 of file avfilter.c.
Referenced by avfilter_config_links(), and ff_avfilter_graph_config_links().
const char* avfilter_configuration | ( | void | ) |
void avfilter_draw_slice | ( | AVFilterLink * | link, | |
int | y, | |||
int | h, | |||
int | slice_dir | |||
) |
Send a slice to the next filter.
Slices have to be provided in sequential order, either in top-bottom or bottom-top order. If slices are provided in non-sequential order the behavior of the function is undefined.
link | the output link over which the frame is being sent | |
y | offset in pixels from the top of the image for this slice | |
h | height of this slice in pixels | |
slice_dir | the assumed direction for sending slices, from the top slice to the bottom slice if the value is 1, from the bottom slice to the top slice if the value is -1, for other values the behavior of the function is undefined. |
Definition at line 603 of file avfilter.c.
Referenced by avfilter_default_draw_slice(), avfilter_null_draw_slice(), color_request_frame(), draw_send_bar_slice(), draw_slice(), end_frame(), request_frame(), return_frame(), and vf_next_put_image().
void avfilter_end_frame | ( | AVFilterLink * | link | ) |
Notify the next filter that the current frame has finished.
link | the output link the frame was sent over |
Definition at line 586 of file avfilter.c.
Referenced by avfilter_default_end_frame(), avfilter_null_end_frame(), color_request_frame(), end_frame(), request_frame(), return_frame(), and vf_next_put_image().
void avfilter_filter_samples | ( | AVFilterLink * | link, | |
AVFilterBufferRef * | samplesref | |||
) |
Send a buffer of audio samples to the next filter.
link | the output link over which the audio samples are being sent | |
samplesref | a reference to the buffer of audio samples being sent. The receiving filter will free this reference when it no longer needs it or pass it on to the next filter. |
Definition at line 655 of file avfilter.c.
Referenced by avfilter_default_filter_samples(), avfilter_null_filter_samples(), filter_samples(), and request_frame().
void avfilter_free | ( | AVFilterContext * | filter | ) |
Free a filter context.
filter | the filter to free |
Definition at line 811 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), avfilter_graph_create_filter(), avfilter_graph_free(), avfilter_graph_parse(), create_filter(), insert_filter(), main(), and remove_filter().
AVFilterBufferRef* avfilter_get_audio_buffer | ( | AVFilterLink * | link, | |
int | perms, | |||
int | nb_samples | |||
) |
Request an audio samples buffer with a specific set of permissions.
link | the output link to the filter from which the buffer will be requested | |
perms | the required access permissions | |
nb_samples | the number of samples per channel |
Definition at line 456 of file avfilter.c.
Referenced by avfilter_null_get_audio_buffer(), filter_samples(), init_buffers(), and request_frame().
AVFilterBufferRef* avfilter_get_audio_buffer_ref_from_arrays | ( | uint8_t * | data[8], | |
int | linesize[8], | |||
int | perms, | |||
int | nb_samples, | |||
enum AVSampleFormat | sample_fmt, | |||
uint64_t | channel_layout, | |||
int | planar | |||
) |
Create an audio buffer reference wrapped around an already allocated samples buffer.
data | pointers to the samples plane buffers | |
linesize | linesize for the samples plane buffers | |
perms | the required access permissions | |
nb_samples | number of samples per channel | |
sample_fmt | the format of each sample in the buffer to allocate | |
channel_layout | the channel layout of the buffer | |
planar | audio data layout - planar or packed |
Definition at line 474 of file avfilter.c.
Referenced by av_asrc_buffer_add_samples(), avfilter_default_get_audio_buffer(), and init_buffers().
AVFilter* avfilter_get_by_name | ( | const char * | name | ) |
Get a filter definition matching the given name.
name | the filter name to find |
Definition at line 696 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), create_filter(), init_filters(), insert_conv_filter(), insert_filter(), lavfi_read_header(), and main().
AVFilterBufferRef* avfilter_get_video_buffer | ( | AVFilterLink * | link, | |
int | perms, | |||
int | w, | |||
int | h | |||
) |
Request a picture buffer with a specific set of permissions.
link | the output link to the filter from which the buffer will be requested | |
perms | the required access permissions | |
w | the minimum width of the buffer to allocate | |
h | the minimum height of the buffer to allocate |
Definition at line 394 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), avfilter_default_start_frame(), avfilter_null_get_video_buffer(), avfilter_start_frame(), color_request_frame(), get_video_buffer(), request_frame(), return_frame(), source_request_frame(), and start_frame().
AVFilterBufferRef* avfilter_get_video_buffer_ref_from_arrays | ( | uint8_t *const | data[4], | |
const int | linesize[4], | |||
int | perms, | |||
int | w, | |||
int | h, | |||
enum PixelFormat | format | |||
) |
Create a buffer reference wrapped around an already allocated image buffer.
data | pointers to the planes of the image to reference | |
linesize | linesizes for the planes of the image to reference | |
perms | the required access permissions | |
w | the width of the image specified by the data and linesize arrays | |
h | the height of the image specified by the data and linesize arrays | |
format | the pixel format of the image specified by the data and linesize arrays |
Definition at line 417 of file avfilter.c.
Referenced by avfilter_default_get_video_buffer(), and avfilter_get_video_buffer_ref_from_frame().
int avfilter_init_filter | ( | AVFilterContext * | filter, | |
const char * | args, | |||
void * | opaque | |||
) |
Initialize a filter.
filter | the filter to initialize | |
args | A string of parameters to use when initializing the filter. The format and meaning of this string varies by filter. | |
opaque | Any extra non-string data needed by the filter. The meaning of this parameter varies by filter. |
Definition at line 850 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), avfilter_graph_create_filter(), create_filter(), and main().
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.
link | the link into which the filter should be inserted | |
filt | the filter to be inserted | |
filt_srcpad_idx | the input pad on the filter to connect | |
filt_dstpad_idx | the output pad on the filter to connect |
Definition at line 204 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), and insert_conv_filter().
void avfilter_insert_pad | ( | unsigned | idx, | |
unsigned * | count, | |||
size_t | padidx_off, | |||
AVFilterPad ** | pads, | |||
AVFilterLink *** | links, | |||
AVFilterPad * | newpad | |||
) |
Insert a new pad.
idx | Insertion point. Pad is inserted at the end if this point is beyond the end of the list of pads. | |
count | Pointer to the number of pads in the list | |
padidx_off | Offset within an AVFilterLink structure to the element to increment when inserting a new pad causes link numbering to change | |
pads | Pointer to the pointer to the beginning of the list of pads | |
links | Pointer to the pointer to the beginning of the list of links | |
newpad | The new pad to add. A copy is made when adding. |
Definition at line 127 of file avfilter.c.
Referenced by avfilter_insert_inpad(), and avfilter_insert_outpad().
const char* avfilter_license | ( | void | ) |
int avfilter_link | ( | AVFilterContext * | src, | |
unsigned | srcpad, | |||
AVFilterContext * | dst, | |||
unsigned | dstpad | |||
) |
Link two filters together.
src | the source filter | |
srcpad | index of the output pad on the source filter | |
dst | the destination filter | |
dstpad | index of the input pad on the destination filter |
Definition at line 148 of file avfilter.c.
Referenced by avfilter_insert_filter(), insert_filter(), lavfi_read_header(), and link_filter().
void avfilter_link_free | ( | AVFilterLink ** | link | ) |
Free the link in *link, and set its pointer to NULL.
Definition at line 178 of file avfilter.c.
Referenced by avfilter_free().
int avfilter_open | ( | AVFilterContext ** | filter_ctx, | |
AVFilter * | filter, | |||
const char * | inst_name | |||
) |
Create a filter instance.
filter_ctx | put here a pointer to the created filter context on success, NULL on failure | |
filter | the filter to create an instance of | |
inst_name | Name to give to the new instance. Can be NULL for none. |
Definition at line 753 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), avfilter_graph_create_filter(), create_filter(), insert_filter(), and main().
int avfilter_poll_frame | ( | AVFilterLink * | link | ) |
Poll a frame from the filter chain.
link | the input link |
Definition at line 526 of file avfilter.c.
Referenced by av_buffersink_poll_frame(), avfilter_poll_frame(), main(), poll_frame(), and transcode_video().
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.
It is recommended to use avfilter_graph_send_command().
Definition at line 644 of file avfilter.c.
Referenced by avfilter_graph_send_command(), and avfilter_start_frame().
AVFilterBufferRef* avfilter_ref_buffer | ( | AVFilterBufferRef * | ref, | |
int | pmask | |||
) |
Add a new reference to a buffer.
ref | an existing reference to the buffer | |
pmask | a bitmask containing the allowable permissions in the new reference |
Definition at line 57 of file avfilter.c.
Referenced by avfilter_default_filter_samples(), avfilter_default_start_frame(), color_request_frame(), filter_samples(), request_frame(), source_request_frame(), start_frame(), and vf_next_put_image().
int avfilter_register | ( | AVFilter * | filter | ) |
Register a filter.
This is only needed if you plan to use avfilter_get_by_name later to lookup the AVFilter structure by name. A filter can still by instantiated with avfilter_open even if it is not registered.
filter | the filter to register |
Definition at line 707 of file avfilter.c.
int avfilter_request_frame | ( | AVFilterLink * | link | ) |
Request an input frame from the filter at the other end of the link.
link | the input link |
Definition at line 515 of file avfilter.c.
Referenced by av_buffersink_get_buffer_ref(), avfilter_request_frame(), poll_frame(), request_frame(), and start_frame().
void avfilter_start_frame | ( | AVFilterLink * | link, | |
AVFilterBufferRef * | picref | |||
) |
Notify the next filter of the start of a frame.
link | the output link the frame will be sent over | |
picref | A reference to the frame about to be sent. The data for this frame need only be valid once draw_slice() is called for that portion. The receiving filter will free this reference when it no longer needs it. |
Definition at line 546 of file avfilter.c.
Referenced by avfilter_default_start_frame(), avfilter_null_start_frame(), color_request_frame(), request_frame(), return_frame(), source_request_frame(), start_frame(), and vf_next_put_image().
void avfilter_uninit | ( | void | ) |
Uninitialize the filter system.
Unregister all filters.
Definition at line 726 of file avfilter.c.
Referenced by do_exit(), and exit_program().
void avfilter_unref_buffer | ( | AVFilterBufferRef * | ref | ) |
Remove a reference to a buffer.
If this is the last reference to the buffer, the buffer itself is also automatically freed.
ref | reference to the buffer, may be NULL |
Definition at line 111 of file avfilter.c.
Referenced by alloc_picture(), av_vsrc_buffer_add_video_buffer_ref(), avfilter_default_end_frame(), avfilter_default_filter_samples(), avfilter_end_frame(), avfilter_filter_samples(), color_request_frame(), common_uninit(), end_frame(), filter_samples(), lavfi_read_packet(), main(), movie_common_uninit(), queue_picture(), request_frame(), start_frame(), stream_close(), transcode_video(), uninit(), and vf_next_put_image().
unsigned avfilter_version | ( | void | ) |
static void command_queue_pop | ( | AVFilterContext * | filter | ) | [static] |
Definition at line 48 of file avfilter.c.
Referenced by avfilter_free(), and avfilter_start_frame().
static void ff_dlog_link | ( | void * | ctx, | |
AVFilterLink * | link, | |||
int | end | |||
) | [static] |
Definition at line 368 of file avfilter.c.
Referenced by avfilter_draw_slice(), avfilter_filter_samples(), avfilter_get_video_buffer(), avfilter_request_frame(), and avfilter_start_frame().
static void ff_dlog_ref | ( | void * | ctx, | |
AVFilterBufferRef * | ref, | |||
int | end | |||
) | [static] |
Definition at line 339 of file avfilter.c.
Referenced by avfilter_get_video_buffer(), and avfilter_start_frame().
static char* ff_get_ref_perms_string | ( | char * | buf, | |
size_t | buf_size, | |||
int | perms | |||
) | [static] |
Definition at line 327 of file avfilter.c.
Referenced by avfilter_get_video_buffer(), and ff_dlog_ref().
static const char* filter_name | ( | void * | p | ) | [static] |
static int pad_count | ( | const AVFilterPad * | pads | ) | [static] |
static void store_in_pool | ( | AVFilterBufferRef * | ref | ) | [static] |
const AVClass avfilter_class [static] |
Initial value:
{ "AVFilter", filter_name, NULL, LIBAVUTIL_VERSION_INT, }
Definition at line 746 of file avfilter.c.
int next_registered_avfilter_idx = 0 [static] |
Definition at line 694 of file avfilter.c.
Referenced by avfilter_register(), and avfilter_uninit().
AVFilter* registered_avfilters[MAX_REGISTERED_AVFILTERS_NB+1] [static] |
Definition at line 692 of file avfilter.c.