54 #if FF_API_SWS_PARAM_OPTION 70 #define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)\ 71 if (c->w != width || c->h != height || c->pix_fmt != format) {\ 72 av_log(s, AV_LOG_INFO, "filter context - w: %d h: %d fmt: %d, incoming frame - w: %d h: %d fmt: %d pts_time: %s\n",\ 73 c->w, c->h, c->pix_fmt, width, height, format, av_ts2timestr(pts, &s->outputs[0]->time_base));\ 74 av_log(s, AV_LOG_WARNING, "Changing video frame properties on the fly is not supported by all filters.\n");\ 77 #define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, ch_layout, ch_count, format, pts)\ 78 if (c->sample_fmt != format || c->sample_rate != srate ||\ 79 c->channel_layout != ch_layout || c->channels != ch_count) {\ 80 av_log(s, AV_LOG_INFO, "filter context - fmt: %s r: %d layout: %"PRIX64" ch: %d, incoming frame - fmt: %s r: %d layout: %"PRIX64" ch: %d pts_time: %s\n",\ 81 av_get_sample_fmt_name(c->sample_fmt), c->sample_rate, c->channel_layout, c->channels,\ 82 av_get_sample_fmt_name(format), srate, ch_layout, ch_count, av_ts2timestr(pts, &s->outputs[0]->time_base));\ 83 av_log(s, AV_LOG_ERROR, "Changing audio frame properties on the fly is not supported.\n");\ 84 return AVERROR(EINVAL);\ 110 if (param->
width > 0)
174 av_log(ctx,
AV_LOG_ERROR,
"Layout indicates a different number of channels than actually present\n");
185 refcounted = !!frame->
buf[0];
257 #if FF_API_SWS_PARAM_OPTION 270 #define OFFSET(x) offsetof(BufferSourceContext, x) 271 #define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM 272 #define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM 283 #if FF_API_SWS_PARAM_OPTION 327 "Mismatching channel count %d and layout '%s' " 336 "channel layout specified\n");
344 "tb:%d/%d samplefmt:%s samplerate:%d chlayout:%s\n",
396 switch (link->
type) {
443 .description =
NULL_IF_CONFIG_SMALL(
"Buffer video frames, and make them accessible to the filterchain."),
451 .
outputs = avfilter_vsrc_buffer_outputs,
452 .priv_class = &buffer_class,
467 .description =
NULL_IF_CONFIG_SMALL(
"Buffer audio frames, and make them accessible to the filterchain."),
475 .
outputs = avfilter_asrc_abuffer_outputs,
476 .priv_class = &abuffer_class,
static void copy(const float *p1, float *p2, const int length)
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it...
This structure describes decoded (raw) audio or video data.
#define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, ch_layout, ch_count, format, pts)
#define AV_LOG_WARNING
Something somehow does not look correct.
Main libavfilter public API header.
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
Memory buffer source API.
static av_cold int init(AVCodecContext *avctx)
int h
agreed upon image height
Do not check for format changes.
static av_cold int init_video(AVFilterContext *ctx)
static const AVFilterPad avfilter_vsrc_buffer_outputs[]
enum AVMediaType type
AVFilterPad type.
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
enum AVPixelFormat pix_fmt
static av_cold void uninit(AVFilterContext *ctx)
AVRational frame_rate
Video only, the frame rate of the input video.
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
struct AVFilterGraph * graph
filtergraph this filter belongs to
const char * name
Pad name.
AVRational sample_aspect_ratio
Video only, the sample (pixel) aspect ratio.
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
int ff_filter_graph_run_once(AVFilterGraph *graph)
Run one round of processing on a filter graph.
static const AVOption abuffer_options[]
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
timestamp utils, mostly useful for debugging/logging purposes
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
AVRational time_base
The timebase to be used for the timestamps on the input frames.
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
#define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)
static double av_q2d(AVRational a)
Convert an AVRational to a double.
#define AVERROR_EOF
End of file.
#define AV_LOG_VERBOSE
Detailed information.
int sample_rate
Audio only, the audio sampling rate in samples per second.
static const AVFilterPad avfilter_asrc_abuffer_outputs[]
A filter pad used for either input or output.
A link between two filters.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
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.
uint64_t channel_layout
Audio only, the audio channel layout.
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
static int request_frame(AVFilterLink *link)
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
void * priv
private data for use by the filter
int av_buffersrc_close(AVFilterContext *ctx, int64_t pts, unsigned flags)
Close the buffer source after EOF.
AVRational time_base
Define the time base used by the PTS of the frames/samples which will pass through this link...
simple assert() macros that are a bit more flexible than ISO C assert().
AVRational time_base
time_base to set in the output link
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
int format
video: the pixel format, value corresponds to enum AVPixelFormat audio: the sample format...
AVRational frame_rate
frame_rate to set in the output link
reference-counted frame API
uint64_t channel_layout
Channel layout of the audio data.
int w
agreed upon image width
common internal API header
AVFILTER_DEFINE_CLASS(buffer)
int channels
number of audio channels, only used for audio.
audio channel layout utility functions
This structure contains the parameters describing the frames that will be passed to this filter...
AVBufferRef * hw_frames_ctx
For hwaccel pixel formats, this should be a reference to the AVHWFramesContext describing the frames...
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
AVFilterContext * src
source filter
static av_cold int init_audio(AVFilterContext *ctx)
static const AVFilterPad outputs[]
A list of supported channel layouts.
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
AVBufferRef * hw_frames_ctx
Video with a hwaccel pixel format only.
AVSampleFormat
Audio sample formats.
static const AVOption buffer_options[]
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
Immediately push the frame to the output.
static int push_frame(AVFilterGraph *graph)
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
static const uint16_t channel_layouts[7]
Describe the class of an AVClass context structure.
int sample_rate
Sample rate of the audio data.
Rational number (pair of numerator and denominator).
static int config_props(AVFilterLink *link)
const char * name
Filter name.
AVRational sample_aspect_ratio
agreed upon sample aspect ratio
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a link
offset must point to two consecutive integers
unsigned av_buffersrc_get_nb_failed_requests(AVFilterContext *buffer_src)
Get the number of failed requests.
AVFilterLink ** outputs
array of pointers to output links
Keep a reference to the frame.
#define flags(name, subs,...)
enum AVMediaType type
filter media type
AVBufferRef * hw_frames_ctx
int attribute_align_arg av_buffersrc_write_frame(AVFilterContext *ctx, const AVFrame *frame)
Add a frame to the buffer source.
A reference to a data buffer.
common internal and external API header
int av_buffersrc_parameters_set(AVFilterContext *ctx, AVBufferSrcParameters *param)
Initialize the buffersrc or abuffersrc filter with the provided parameters.
AVBufferRef * av_buffer_ref(AVBufferRef *buf)
Create a new reference to an AVBuffer.
uint64_t channel_layout
channel layout of current buffer (see libavutil/channel_layout.h)
int attribute_align_arg av_buffersrc_add_frame_flags(AVFilterContext *ctx, AVFrame *frame, int flags)
Add a frame to the buffer source.
unsigned nb_failed_requests
enum AVSampleFormat sample_fmt
static int query_formats(AVFilterContext *ctx)
AVBufferSrcParameters * av_buffersrc_parameters_alloc(void)
Allocate a new AVBufferSrcParameters instance.
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.
const AVFilterPad * outputs
List of outputs, terminated by a zeroed element.
int width
Video only, the display dimensions of the input frames.
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Frame references ownership and permissions
AVPixelFormat
Pixel format.
const AVFilter * filter
the AVFilter of which this is an instance
#define AV_NOPTS_VALUE
Undefined timestamp value.
int attribute_align_arg av_buffersrc_add_frame(AVFilterContext *ctx, AVFrame *frame)
Add a frame to the buffer source.
char * channel_layout_str