memory buffer source filter More...

#include <float.h>
#include "libavutil/channel_layout.h"
#include "libavutil/common.h"
#include "libavutil/fifo.h"
#include "libavutil/frame.h"
#include "libavutil/imgutils.h"
#include "libavutil/opt.h"
#include "libavutil/samplefmt.h"
#include "audio.h"
#include "avfilter.h"
#include "buffersrc.h"
#include "formats.h"
#include "internal.h"
#include "video.h"
#include "avcodec.h"

Data Structures
struct	BufferSourceContext

Macros
#define	CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format)

#define	CHECK_AUDIO_PARAM_CHANGE(s, c, srate, ch_layout, ch_count, format)

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

#define	A AV_OPT_FLAG_FILTERING_PARAM\|AV_OPT_FLAG_AUDIO_PARAM

#define	V AV_OPT_FLAG_FILTERING_PARAM\|AV_OPT_FLAG_VIDEO_PARAM

Functions
int	av_buffersrc_write_frame (AVFilterContext ctx, const AVFrame frame)
	Add a frame to the buffer source.

int	av_buffersrc_add_frame (AVFilterContext ctx, AVFrame frame)
	Add a frame to the buffer source.

static int	av_buffersrc_add_frame_internal (AVFilterContext ctx, AVFrame frame, int flags)

int	av_buffersrc_add_frame_flags (AVFilterContext ctx, AVFrame frame, int flags)
	Add a frame to the buffer source.

static av_cold int	init_video (AVFilterContext *ctx)

unsigned	av_buffersrc_get_nb_failed_requests (AVFilterContext *buffer_src)
	Get the number of failed requests.

	AVFILTER_DEFINE_CLASS (buffer)

	AVFILTER_DEFINE_CLASS (abuffer)

static av_cold int	init_audio (AVFilterContext *ctx)

static av_cold void	uninit (AVFilterContext *ctx)

static int	query_formats (AVFilterContext *ctx)

static int	config_props (AVFilterLink *link)

static int	request_frame (AVFilterLink *link)

static int	poll_frame (AVFilterLink *link)

Variables
static const AVOption	buffer_options []

static const AVOption	abuffer_options []

static const AVFilterPad	avfilter_vsrc_buffer_outputs []

AVFilter	avfilter_vsrc_buffer

static const AVFilterPad	avfilter_asrc_abuffer_outputs []

AVFilter	avfilter_asrc_abuffer

Detailed Description

memory buffer source filter

Definition in file buffersrc.c.

Macro Definition Documentation

#define CHECK_VIDEO_PARAM_CHANGE	(	s,
		c,
		width,
		height,
		format
	)

Value:

if (c->w != width || c->h != height || c->pix_fmt != format) {\
        av_log(s, AV_LOG_INFO, "Changing frame properties on the fly is not supported by all filters.\n");\
    }

Definition at line 69 of file buffersrc.c.

Referenced by av_buffersrc_add_frame_internal().

#define CHECK_AUDIO_PARAM_CHANGE	(	s,
		c,
		srate,
		ch_layout,
		ch_count,
		format
	)

Value:

if (c->sample_fmt != format || c->sample_rate != srate ||\
        c->channel_layout != ch_layout || c->channels != ch_count) {\
        av_log(s, AV_LOG_ERROR, "Changing frame properties on the fly is not supported.\n");\
        return AVERROR(EINVAL);\
    }

Definition at line 74 of file buffersrc.c.

Referenced by av_buffersrc_add_frame_internal().

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

Definition at line 319 of file buffersrc.c.

#define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM

Definition at line 320 of file buffersrc.c.

#define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM

Definition at line 321 of file buffersrc.c.

Function Documentation

int av_buffersrc_write_frame	(	AVFilterContext *	s,
		const AVFrame *	frame
	)

Add a frame to the buffer source.

Parameters

s	an instance of the buffersrc filter.
frame	frame to be added. If the frame is reference counted, this function will make a new reference to it. Otherwise the frame data will be copied.

Returns: 0 on success, a negative AVERROR on error

This function is equivalent to av_buffersrc_add_frame_flags() with the AV_BUFFERSRC_FLAG_KEEP_REF flag.

Definition at line 81 of file buffersrc.c.

int av_buffersrc_add_frame	(	AVFilterContext *	ctx,
		AVFrame *	frame
	)

Add a frame to the buffer source.

Parameters

s	an instance of the buffersrc filter.
frame	frame to be added. If the frame is reference counted, this function will take ownership of the reference(s) and reset the frame. Otherwise the frame data will be copied. If this function returns an error, the input frame is not touched.

Returns: 0 on success, a negative AVERROR on error.

Note: the difference between this function and av_buffersrc_write_frame() is that av_buffersrc_write_frame() creates a new reference to the input frame, while this function takes ownership of the reference passed to it.

This function is equivalent to av_buffersrc_add_frame_flags() without the AV_BUFFERSRC_FLAG_KEEP_REF flag.

Definition at line 87 of file buffersrc.c.

Referenced by audio_decode_frame(), decode_audio(), decode_video(), and video_thread().

static int attribute_align_arg av_buffersrc_add_frame_internal	(	AVFilterContext *	ctx,
		AVFrame *	frame,
		int	flags
	)

static

Definition at line 119 of file buffersrc.c.

Referenced by av_buffersrc_add_frame_flags().

int av_buffersrc_add_frame_flags	(	AVFilterContext *	buffer_src,
		AVFrame *	frame,
		int	flags
	)

Add a frame to the buffer source.

By default, if the frame is reference-counted, this function will take ownership of the reference(s) and reset the frame. This can be controled using the flags.

If this function returns an error, the input frame is not touched.

Parameters

buffer_src	pointer to a buffer source context
frame	a frame, or NULL to mark EOF
flags	a combination of AV_BUFFERSRC_FLAG_*

Returns: >= 0 in case of success, a negative AVERROR code in case of failure

Examples:: doc/examples/filtering_audio.c, and doc/examples/filtering_video.c.

Definition at line 95 of file buffersrc.c.

Referenced by av_buffersrc_add_frame(), av_buffersrc_write_frame(), decode_video(), main(), and sub2video_push_ref().

static av_cold int init_video ( AVFilterContext * ctx )

static

Definition at line 294 of file buffersrc.c.

unsigned av_buffersrc_get_nb_failed_requests ( AVFilterContext * buffer_src )

Get the number of failed requests.

A failed request is when the request_frame method is called while no frame is present in the buffer. The number is reset when a frame is added.

Definition at line 314 of file buffersrc.c.

Referenced by sub2video_heartbeat(), and transcode_from_filter().

AVFILTER_DEFINE_CLASS ( buffer )

AVFILTER_DEFINE_CLASS ( abuffer )

static av_cold int init_audio ( AVFilterContext * ctx )

static

Definition at line 357 of file buffersrc.c.

static av_cold void uninit ( AVFilterContext * ctx )

static

Definition at line 410 of file buffersrc.c.

static int query_formats ( AVFilterContext * ctx )

static

Definition at line 422 of file buffersrc.c.

static int config_props ( AVFilterLink * link )

static

Definition at line 453 of file buffersrc.c.

static int request_frame ( AVFilterLink * link )

static

Definition at line 476 of file buffersrc.c.

static int poll_frame ( AVFilterLink * link )

static

Definition at line 492 of file buffersrc.c.

Variable Documentation

const AVOption buffer_options[]

static

Initial value:

= {
    { "width",         NULL,                     OFFSET(w),                AV_OPT_TYPE_INT,      { .i64 = 0 }, 0, INT_MAX, V },
    { "video_size",    NULL,                     OFFSET(w),                AV_OPT_TYPE_IMAGE_SIZE,                .flags = V },
    { "height",        NULL,                     OFFSET(h),                AV_OPT_TYPE_INT,      { .i64 = 0 }, 0, INT_MAX, V },
    { "pix_fmt",       NULL,                     OFFSET(pix_fmt),          AV_OPT_TYPE_PIXEL_FMT,                 .flags = V },
    { "sar",           "sample aspect ratio",    OFFSET(pixel_aspect),     AV_OPT_TYPE_RATIONAL, { .dbl = 1 }, 0, DBL_MAX, V },
    { "pixel_aspect",  "sample aspect ratio",    OFFSET(pixel_aspect),     AV_OPT_TYPE_RATIONAL, { .dbl = 1 }, 0, DBL_MAX, V },
    { "time_base",     NULL,                     OFFSET(time_base),        AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
    { "frame_rate",    NULL,                     OFFSET(frame_rate),       AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
    { "sws_param",     NULL,                     OFFSET(sws_param),        AV_OPT_TYPE_STRING,                    .flags = V },
    { NULL },
}

Definition at line 323 of file buffersrc.c.

const AVOption abuffer_options[]

static

Initial value:

= {
    { "time_base",      NULL, OFFSET(time_base),           AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, INT_MAX, A },
    { "sample_rate",    NULL, OFFSET(sample_rate),         AV_OPT_TYPE_INT,      { .i64 = 0 }, 0, INT_MAX, A },
    { "sample_fmt",     NULL, OFFSET(sample_fmt_str),      AV_OPT_TYPE_STRING,             .flags = A },
    { "channel_layout", NULL, OFFSET(channel_layout_str),  AV_OPT_TYPE_STRING,             .flags = A },
    { "channels",       NULL, OFFSET(channels),            AV_OPT_TYPE_INT,      { .i64 = 0 }, 0, INT_MAX, A },
    { NULL },
}

Definition at line 346 of file buffersrc.c.

const AVFilterPad avfilter_vsrc_buffer_outputs[]

static

Initial value:

= {
    {
        .name          = "default",
        .type          = AVMEDIA_TYPE_VIDEO,
        .request_frame = request_frame,
        .poll_frame    = poll_frame,
        .config_props  = config_props,
    },
    { NULL }
}

Definition at line 501 of file buffersrc.c.

AVFilter avfilter_vsrc_buffer

Initial value:

= {
    .name      = "buffer",
    .description = NULL_IF_CONFIG_SMALL("Buffer video frames, and make them accessible to the filterchain."),
    .priv_size = sizeof(BufferSourceContext),
    .query_formats = query_formats,
    .init      = init_video,
    .uninit    = uninit,
    .inputs    = NULL,
    .outputs   = avfilter_vsrc_buffer_outputs,
    .priv_class = &buffer_class,
}

Definition at line 512 of file buffersrc.c.

const AVFilterPad avfilter_asrc_abuffer_outputs[]

static

Initial value:

= {
    {
        .name          = "default",
        .type          = AVMEDIA_TYPE_AUDIO,
        .request_frame = request_frame,
        .poll_frame    = poll_frame,
        .config_props  = config_props,
    },
    { NULL }
}

Definition at line 526 of file buffersrc.c.

AVFilter avfilter_asrc_abuffer

Initial value:

= {
    .name          = "abuffer",
    .description   = NULL_IF_CONFIG_SMALL("Buffer audio frames, and make them accessible to the filterchain."),
    .priv_size     = sizeof(BufferSourceContext),
    .query_formats = query_formats,
    .init      = init_audio,
    .uninit    = uninit,
    .inputs    = NULL,
    .outputs   = avfilter_asrc_abuffer_outputs,
    .priv_class = &abuffer_class,
}

Definition at line 537 of file buffersrc.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

Function Documentation

Variable Documentation