#include "libavutil/pixdesc.h"
#include "libavutil/rational.h"
#include "libavutil/audioconvert.h"
#include "libavutil/imgutils.h"
#include "libavutil/avassert.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 64 |
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. | |
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, enum AVSampleFormat sample_fmt, int nb_samples, int64_t channel_layout, int planar) |
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, int64_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) |
Notifie the next filter of the start of a frame. | |
void | avfilter_end_frame (AVFilterLink *link) |
Notifie 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. | |
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 346 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 64 |
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 653 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 228 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 548 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 | ) |
Notifie the next filter that the current frame has finished.
link | the output link the frame was sent over |
Definition at line 531 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 589 of file avfilter.c.
Referenced by avfilter_default_filter_samples(), and avfilter_null_filter_samples().
void avfilter_free | ( | AVFilterContext * | filter | ) |
Free a filter context.
filter | the filter to free |
Definition at line 743 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(), and main().
AVFilterBufferRef* avfilter_get_audio_buffer | ( | AVFilterLink * | link, | |
int | perms, | |||
enum AVSampleFormat | sample_fmt, | |||
int | nb_samples, | |||
int64_t | channel_layout, | |||
int | planar | |||
) |
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 | |
sample_fmt | the format of each sample in the buffer to allocate | |
nb_samples | the number of samples per channel | |
channel_layout | the number and type of channels per sample in the buffer to allocate | |
planar | audio data layout - planar or packed |
Definition at line 410 of file avfilter.c.
Referenced by avfilter_null_get_audio_buffer().
AVFilterBufferRef* avfilter_get_audio_buffer_ref_from_arrays | ( | uint8_t * | data[8], | |
int | linesize[8], | |||
int | perms, | |||
int | nb_samples, | |||
enum AVSampleFormat | sample_fmt, | |||
int64_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 429 of file avfilter.c.
Referenced by avfilter_default_get_audio_buffer().
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 633 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), create_filter(), main(), and query_formats().
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 348 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(), movie_get_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 371 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 779 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 194 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), and query_formats().
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 117 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 138 of file avfilter.c.
Referenced by avfilter_insert_filter(), and link_filter().
void avfilter_link_free | ( | AVFilterLink ** | link | ) |
Free the link in *link, and set its pointer to NULL.
Definition at line 168 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 685 of file avfilter.c.
Referenced by av_vsrc_buffer_add_video_buffer_ref(), avfilter_graph_create_filter(), create_filter(), and main().
int avfilter_poll_frame | ( | AVFilterLink * | link | ) |
Poll a frame from the filter chain.
link | the input link |
Definition at line 481 of file avfilter.c.
Referenced by avfilter_poll_frame(), output_packet(), and poll_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 47 of file avfilter.c.
Referenced by avfilter_default_filter_samples(), avfilter_default_start_frame(), color_request_frame(), 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 644 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 470 of file avfilter.c.
Referenced by av_vsink_buffer_get_video_buffer_ref(), avfilter_request_frame(), poll_frame(), request_frame(), and start_frame().
void avfilter_start_frame | ( | AVFilterLink * | link, | |
AVFilterBufferRef * | picref | |||
) |
Notifie 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 501 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 658 of file avfilter.c.
Referenced by do_exit(), and ffmpeg_exit().
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 101 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(), end_frame(), output_packet(), queue_picture(), request_frame(), start_frame(), stream_close(), uninit(), and vf_next_put_image().
unsigned avfilter_version | ( | void | ) |
static void ff_dlog_link | ( | void * | ctx, | |
AVFilterLink * | link, | |||
int | end | |||
) | [static] |
Definition at line 322 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 293 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 281 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 678 of file avfilter.c.
int next_registered_avfilter_idx = 0 [static] |
Definition at line 631 of file avfilter.c.
Referenced by avfilter_register(), and avfilter_uninit().
AVFilter* registered_avfilters[MAX_REGISTERED_AVFILTERS_NB+1] [static] |
Definition at line 629 of file avfilter.c.