FFmpeg
buffersrc.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2008 Vitor Sessak
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 /**
22  * @file
23  * memory buffer source filter
24  */
25 
26 #include <float.h>
27 
29 #include "libavutil/common.h"
30 #include "libavutil/fifo.h"
31 #include "libavutil/frame.h"
32 #include "libavutil/imgutils.h"
33 #include "libavutil/internal.h"
34 #include "libavutil/opt.h"
35 #include "libavutil/samplefmt.h"
36 #include "libavutil/timestamp.h"
37 #include "audio.h"
38 #include "avfilter.h"
39 #include "buffersrc.h"
40 #include "formats.h"
41 #include "internal.h"
42 #include "video.h"
43 
44 typedef struct BufferSourceContext {
45  const AVClass *class;
47  AVRational time_base; ///< time_base to set in the output link
48  AVRational frame_rate; ///< frame_rate to set in the output link
50  unsigned warning_limit;
51 
52  /* video only */
53  int w, h;
56  char *sws_param;
57 
59 
60  /* audio only */
63  int channels;
64  uint64_t channel_layout;
66 
68  int eof;
70 
71 #define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)\
72  if (c->w != width || c->h != height || c->pix_fmt != format) {\
73  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",\
74  c->w, c->h, c->pix_fmt, width, height, format, av_ts2timestr(pts, &s->outputs[0]->time_base));\
75  av_log(s, AV_LOG_WARNING, "Changing video frame properties on the fly is not supported by all filters.\n");\
76  }
77 
78 #define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, ch_layout, ch_count, format, pts)\
79  if (c->sample_fmt != format || c->sample_rate != srate ||\
80  c->channel_layout != ch_layout || c->channels != ch_count) {\
81  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",\
82  av_get_sample_fmt_name(c->sample_fmt), c->sample_rate, c->channel_layout, c->channels,\
83  av_get_sample_fmt_name(format), srate, ch_layout, ch_count, av_ts2timestr(pts, &s->outputs[0]->time_base));\
84  av_log(s, AV_LOG_ERROR, "Changing audio frame properties on the fly is not supported.\n");\
85  return AVERROR(EINVAL);\
86  }
87 
89 {
90  AVBufferSrcParameters *par = av_mallocz(sizeof(*par));
91  if (!par)
92  return NULL;
93 
94  par->format = -1;
95 
96  return par;
97 }
98 
100 {
101  BufferSourceContext *s = ctx->priv;
102 
103  if (param->time_base.num > 0 && param->time_base.den > 0)
104  s->time_base = param->time_base;
105 
106  switch (ctx->filter->outputs[0].type) {
107  case AVMEDIA_TYPE_VIDEO:
108  if (param->format != AV_PIX_FMT_NONE) {
109  s->got_format_from_params = 1;
110  s->pix_fmt = param->format;
111  }
112  if (param->width > 0)
113  s->w = param->width;
114  if (param->height > 0)
115  s->h = param->height;
116  if (param->sample_aspect_ratio.num > 0 && param->sample_aspect_ratio.den > 0)
117  s->pixel_aspect = param->sample_aspect_ratio;
118  if (param->frame_rate.num > 0 && param->frame_rate.den > 0)
119  s->frame_rate = param->frame_rate;
120  if (param->hw_frames_ctx) {
121  av_buffer_unref(&s->hw_frames_ctx);
122  s->hw_frames_ctx = av_buffer_ref(param->hw_frames_ctx);
123  if (!s->hw_frames_ctx)
124  return AVERROR(ENOMEM);
125  }
126  break;
127  case AVMEDIA_TYPE_AUDIO:
128  if (param->format != AV_SAMPLE_FMT_NONE) {
129  s->got_format_from_params = 1;
130  s->sample_fmt = param->format;
131  }
132  if (param->sample_rate > 0)
133  s->sample_rate = param->sample_rate;
134  if (param->channel_layout)
135  s->channel_layout = param->channel_layout;
136  break;
137  default:
138  return AVERROR_BUG;
139  }
140 
141  return 0;
142 }
143 
144 int attribute_align_arg av_buffersrc_write_frame(AVFilterContext *ctx, const AVFrame *frame)
145 {
148 }
149 
151 {
153 }
154 
156  AVFrame *frame, int flags);
157 
159 {
160  AVFrame *copy = NULL;
161  int ret = 0;
162 
163  if (frame && frame->channel_layout &&
164  av_get_channel_layout_nb_channels(frame->channel_layout) != frame->channels) {
165  av_log(ctx, AV_LOG_ERROR, "Layout indicates a different number of channels than actually present\n");
166  return AVERROR(EINVAL);
167  }
168 
171 
172  if (!(copy = av_frame_alloc()))
173  return AVERROR(ENOMEM);
175  if (ret >= 0)
177 
179  return ret;
180 }
181 
182 static int push_frame(AVFilterGraph *graph)
183 {
184  int ret;
185 
186  while (1) {
187  ret = ff_filter_graph_run_once(graph);
188  if (ret == AVERROR(EAGAIN))
189  break;
190  if (ret < 0)
191  return ret;
192  }
193  return 0;
194 }
195 
197  AVFrame *frame, int flags)
198 {
199  BufferSourceContext *s = ctx->priv;
200  AVFrame *copy;
201  int refcounted, ret;
202 
203  s->nb_failed_requests = 0;
204 
205  if (!frame)
207  if (s->eof)
208  return AVERROR(EINVAL);
209 
210  refcounted = !!frame->buf[0];
211 
213 
214  switch (ctx->outputs[0]->type) {
215  case AVMEDIA_TYPE_VIDEO:
216  CHECK_VIDEO_PARAM_CHANGE(ctx, s, frame->width, frame->height,
217  frame->format, frame->pts);
218  break;
219  case AVMEDIA_TYPE_AUDIO:
220  /* For layouts unknown on input but known on link after negotiation. */
221  if (!frame->channel_layout)
222  frame->channel_layout = s->channel_layout;
223  CHECK_AUDIO_PARAM_CHANGE(ctx, s, frame->sample_rate, frame->channel_layout,
224  frame->channels, frame->format, frame->pts);
225  break;
226  default:
227  return AVERROR(EINVAL);
228  }
229 
230  }
231 
232  if (!av_fifo_space(s->fifo) &&
233  (ret = av_fifo_realloc2(s->fifo, av_fifo_size(s->fifo) +
234  sizeof(copy))) < 0)
235  return ret;
236 
237  if (!(copy = av_frame_alloc()))
238  return AVERROR(ENOMEM);
239 
240  if (refcounted) {
242  } else {
244  if (ret < 0) {
246  return ret;
247  }
248  }
249 
250  if ((ret = av_fifo_generic_write(s->fifo, &copy, sizeof(copy), NULL)) < 0) {
251  if (refcounted)
254  return ret;
255  }
256 
257  if ((ret = ctx->output_pads[0].request_frame(ctx->outputs[0])) < 0)
258  return ret;
259 
260  if ((flags & AV_BUFFERSRC_FLAG_PUSH)) {
261  ret = push_frame(ctx->graph);
262  if (ret < 0)
263  return ret;
264  }
265 
266  return 0;
267 }
268 
270 {
271  BufferSourceContext *s = ctx->priv;
272 
273  s->eof = 1;
275  return (flags & AV_BUFFERSRC_FLAG_PUSH) ? push_frame(ctx->graph) : 0;
276 }
277 
279 {
280  BufferSourceContext *c = ctx->priv;
281 
282  if (!(c->pix_fmt != AV_PIX_FMT_NONE || c->got_format_from_params) || !c->w || !c->h ||
283  av_q2d(c->time_base) <= 0) {
284  av_log(ctx, AV_LOG_ERROR, "Invalid parameters provided.\n");
285  return AVERROR(EINVAL);
286  }
287 
288  if (!(c->fifo = av_fifo_alloc(sizeof(AVFrame*))))
289  return AVERROR(ENOMEM);
290 
291  av_log(ctx, AV_LOG_VERBOSE, "w:%d h:%d pixfmt:%s tb:%d/%d fr:%d/%d sar:%d/%d sws_param:%s\n",
292  c->w, c->h, av_get_pix_fmt_name(c->pix_fmt),
293  c->time_base.num, c->time_base.den, c->frame_rate.num, c->frame_rate.den,
294  c->pixel_aspect.num, c->pixel_aspect.den, (char *)av_x_if_null(c->sws_param, ""));
295  c->warning_limit = 100;
296  return 0;
297 }
298 
300 {
301  return ((BufferSourceContext *)buffer_src->priv)->nb_failed_requests;
302 }
303 
304 #define OFFSET(x) offsetof(BufferSourceContext, x)
305 #define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM
306 #define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
307 
308 static const AVOption buffer_options[] = {
309  { "width", NULL, OFFSET(w), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, V },
310  { "video_size", NULL, OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, .flags = V },
311  { "height", NULL, OFFSET(h), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, V },
312  { "pix_fmt", NULL, OFFSET(pix_fmt), AV_OPT_TYPE_PIXEL_FMT, { .i64 = AV_PIX_FMT_NONE }, .min = AV_PIX_FMT_NONE, .max = INT_MAX, .flags = V },
313  { "sar", "sample aspect ratio", OFFSET(pixel_aspect), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
314  { "pixel_aspect", "sample aspect ratio", OFFSET(pixel_aspect), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
315  { "time_base", NULL, OFFSET(time_base), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
316  { "frame_rate", NULL, OFFSET(frame_rate), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
317  { "sws_param", NULL, OFFSET(sws_param), AV_OPT_TYPE_STRING, .flags = V },
318  { NULL },
319 };
320 
322 
323 static const AVOption abuffer_options[] = {
324  { "time_base", NULL, OFFSET(time_base), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, INT_MAX, A },
325  { "sample_rate", NULL, OFFSET(sample_rate), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, A },
326  { "sample_fmt", NULL, OFFSET(sample_fmt), AV_OPT_TYPE_SAMPLE_FMT, { .i64 = AV_SAMPLE_FMT_NONE }, .min = AV_SAMPLE_FMT_NONE, .max = INT_MAX, .flags = A },
327  { "channel_layout", NULL, OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, .flags = A },
328  { "channels", NULL, OFFSET(channels), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, A },
329  { NULL },
330 };
331 
332 AVFILTER_DEFINE_CLASS(abuffer);
333 
335 {
336  BufferSourceContext *s = ctx->priv;
337  int ret = 0;
338 
339  if (!(s->sample_fmt != AV_SAMPLE_FMT_NONE || s->got_format_from_params)) {
340  av_log(ctx, AV_LOG_ERROR, "Sample format was not set or was invalid\n");
341  return AVERROR(EINVAL);
342  }
343 
344  if (s->channel_layout_str || s->channel_layout) {
345  int n;
346 
347  if (!s->channel_layout) {
348  s->channel_layout = av_get_channel_layout(s->channel_layout_str);
349  if (!s->channel_layout) {
350  av_log(ctx, AV_LOG_ERROR, "Invalid channel layout %s.\n",
351  s->channel_layout_str);
352  return AVERROR(EINVAL);
353  }
354  }
355  n = av_get_channel_layout_nb_channels(s->channel_layout);
356  if (s->channels) {
357  if (n != s->channels) {
359  "Mismatching channel count %d and layout '%s' "
360  "(%d channels)\n",
361  s->channels, s->channel_layout_str, n);
362  return AVERROR(EINVAL);
363  }
364  }
365  s->channels = n;
366  } else if (!s->channels) {
367  av_log(ctx, AV_LOG_ERROR, "Neither number of channels nor "
368  "channel layout specified\n");
369  return AVERROR(EINVAL);
370  }
371 
372  if (!(s->fifo = av_fifo_alloc(sizeof(AVFrame*))))
373  return AVERROR(ENOMEM);
374 
375  if (!s->time_base.num)
376  s->time_base = (AVRational){1, s->sample_rate};
377 
379  "tb:%d/%d samplefmt:%s samplerate:%d chlayout:%s\n",
380  s->time_base.num, s->time_base.den, av_get_sample_fmt_name(s->sample_fmt),
381  s->sample_rate, s->channel_layout_str);
382  s->warning_limit = 100;
383 
384  return ret;
385 }
386 
388 {
389  BufferSourceContext *s = ctx->priv;
390  while (s->fifo && av_fifo_size(s->fifo)) {
391  AVFrame *frame;
392  av_fifo_generic_read(s->fifo, &frame, sizeof(frame), NULL);
394  }
395  av_buffer_unref(&s->hw_frames_ctx);
396  av_fifo_freep(&s->fifo);
397 }
398 
400 {
401  BufferSourceContext *c = ctx->priv;
404  AVFilterFormats *samplerates = NULL;
405  int ret;
406 
407  switch (ctx->outputs[0]->type) {
408  case AVMEDIA_TYPE_VIDEO:
409  if ((ret = ff_add_format (&formats, c->pix_fmt)) < 0 ||
410  (ret = ff_set_common_formats (ctx , formats )) < 0)
411  return ret;
412  break;
413  case AVMEDIA_TYPE_AUDIO:
414  if ((ret = ff_add_format (&formats , c->sample_fmt )) < 0 ||
415  (ret = ff_set_common_formats (ctx , formats )) < 0 ||
416  (ret = ff_add_format (&samplerates, c->sample_rate)) < 0 ||
417  (ret = ff_set_common_samplerates (ctx , samplerates )) < 0)
418  return ret;
419 
421  c->channel_layout ? c->channel_layout :
422  FF_COUNT2LAYOUT(c->channels))) < 0)
423  return ret;
425  return ret;
426  break;
427  default:
428  return AVERROR(EINVAL);
429  }
430 
431  return 0;
432 }
433 
435 {
436  BufferSourceContext *c = link->src->priv;
437 
438  switch (link->type) {
439  case AVMEDIA_TYPE_VIDEO:
440  link->w = c->w;
441  link->h = c->h;
442  link->sample_aspect_ratio = c->pixel_aspect;
443 
444  if (c->hw_frames_ctx) {
445  link->hw_frames_ctx = av_buffer_ref(c->hw_frames_ctx);
446  if (!link->hw_frames_ctx)
447  return AVERROR(ENOMEM);
448  }
449  break;
450  case AVMEDIA_TYPE_AUDIO:
451  if (!c->channel_layout)
452  c->channel_layout = link->channel_layout;
453  break;
454  default:
455  return AVERROR(EINVAL);
456  }
457 
458  link->time_base = c->time_base;
459  link->frame_rate = c->frame_rate;
460  return 0;
461 }
462 
464 {
465  BufferSourceContext *c = link->src->priv;
466  AVFrame *frame;
467  int ret;
468 
469  if (!av_fifo_size(c->fifo)) {
470  if (c->eof)
471  return AVERROR_EOF;
472  c->nb_failed_requests++;
473  return AVERROR(EAGAIN);
474  }
475  av_fifo_generic_read(c->fifo, &frame, sizeof(frame), NULL);
476 
478 
479  return ret;
480 }
481 
483 {
484  BufferSourceContext *c = link->src->priv;
485  int size = av_fifo_size(c->fifo);
486  if (!size && c->eof)
487  return AVERROR_EOF;
488  return size/sizeof(AVFrame*);
489 }
490 
492  {
493  .name = "default",
494  .type = AVMEDIA_TYPE_VIDEO,
495  .request_frame = request_frame,
496  .poll_frame = poll_frame,
497  .config_props = config_props,
498  },
499  { NULL }
500 };
501 
503  .name = "buffer",
504  .description = NULL_IF_CONFIG_SMALL("Buffer video frames, and make them accessible to the filterchain."),
505  .priv_size = sizeof(BufferSourceContext),
507 
508  .init = init_video,
509  .uninit = uninit,
510 
511  .inputs = NULL,
513  .priv_class = &buffer_class,
514 };
515 
517  {
518  .name = "default",
519  .type = AVMEDIA_TYPE_AUDIO,
520  .request_frame = request_frame,
521  .poll_frame = poll_frame,
522  .config_props = config_props,
523  },
524  { NULL }
525 };
526 
528  .name = "abuffer",
529  .description = NULL_IF_CONFIG_SMALL("Buffer audio frames, and make them accessible to the filterchain."),
530  .priv_size = sizeof(BufferSourceContext),
532 
533  .init = init_audio,
534  .uninit = uninit,
535 
536  .inputs = NULL,
538  .priv_class = &abuffer_class,
539 };
AV_BUFFERSRC_FLAG_PUSH
@ AV_BUFFERSRC_FLAG_PUSH
Immediately push the frame to the output.
Definition: buffersrc.h:46
formats
formats
Definition: signature.h:48
AVFilterChannelLayouts
A list of supported channel layouts.
Definition: formats.h:85
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
init
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
AVERROR
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
opt.h
AV_OPT_TYPE_SAMPLE_FMT
@ AV_OPT_TYPE_SAMPLE_FMT
Definition: opt.h:235
av_fifo_generic_write
int av_fifo_generic_write(AVFifoBuffer *f, void *src, int size, int(*func)(void *, void *, int))
Feed data from a user-supplied callback to an AVFifoBuffer.
Definition: fifo.c:122
n
int n
Definition: avisynth_c.h:760
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(buffer)
ff_set_common_channel_layouts
int ff_set_common_channel_layouts(AVFilterContext *ctx, AVFilterChannelLayouts *layouts)
A helper for query_formats() which sets all links to the same list of channel layouts/sample rates.
Definition: formats.c:549
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1080
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:55
A
#define A
Definition: buffersrc.c:305
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:202
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
w
uint8_t w
Definition: llviddspenc.c:38
BufferSourceContext::sws_param
char * sws_param
Definition: buffersrc.c:56
AVOption
AVOption.
Definition: opt.h:246
av_buffersrc_add_frame
int attribute_align_arg av_buffersrc_add_frame(AVFilterContext *ctx, AVFrame *frame)
Add a frame to the buffer source.
Definition: buffersrc.c:150
OFFSET
#define OFFSET(x)
Definition: buffersrc.c:304
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:192
float.h
ff_asrc_abuffer
AVFilter ff_asrc_abuffer
Definition: buffersrc.c:527
channels
channels
Definition: aptx.c:30
av_get_channel_layout
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
Definition: channel_layout.c:139
ff_filter_graph_run_once
int ff_filter_graph_run_once(AVFilterGraph *graph)
Run one round of processing on a filter graph.
Definition: avfiltergraph.c:1442
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:148
BufferSourceContext::channels
int channels
Definition: buffersrc.c:63
av_fifo_generic_read
int av_fifo_generic_read(AVFifoBuffer *f, void *dest, int buf_size, void(*func)(void *, void *, int))
Feed data from an AVFifoBuffer to a user-supplied callback.
Definition: fifo.c:213
AV_OPT_TYPE_RATIONAL
@ AV_OPT_TYPE_RATIONAL
Definition: opt.h:228
abuffer_options
static const AVOption abuffer_options[]
Definition: buffersrc.c:323
video.h
AVBufferSrcParameters::height
int height
Definition: buffersrc.h:87
AV_BUFFERSRC_FLAG_KEEP_REF
@ AV_BUFFERSRC_FLAG_KEEP_REF
Keep a reference to the frame.
Definition: buffersrc.h:53
sample_rate
sample_rate
Definition: ffmpeg_filter.c:191
AVFilterFormats
A list of supported formats for one end of a filter link.
Definition: formats.h:64
formats.h
AVFifoBuffer
Definition: fifo.h:31
poll_frame
static int poll_frame(AVFilterLink *link)
Definition: buffersrc.c:482
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: buffersrc.c:387
fifo.h
AVFilterContext::priv
void * priv
private data for use by the filter
Definition: avfilter.h:353
AVBufferSrcParameters::sample_aspect_ratio
AVRational sample_aspect_ratio
Video only, the sample (pixel) aspect ratio.
Definition: buffersrc.h:92
BufferSourceContext::frame_rate
AVRational frame_rate
frame_rate to set in the output link
Definition: buffersrc.c:48
samplefmt.h
CHECK_AUDIO_PARAM_CHANGE
#define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, ch_layout, ch_count, format, pts)
Definition: buffersrc.c:78
pts
static int64_t pts
Definition: transcode_aac.c:647
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:54
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:189
BufferSourceContext::sample_rate
int sample_rate
Definition: buffersrc.c:61
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
av_fifo_space
int av_fifo_space(const AVFifoBuffer *f)
Return the amount of space in bytes in the AVFifoBuffer, that is the amount of data you can write int...
Definition: fifo.c:82
av_cold
#define av_cold
Definition: attributes.h:84
ff_set_common_formats
int ff_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
A helper for query_formats() which sets all links to the same list of formats.
Definition: formats.c:568
AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
@ AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
Do not check for format changes.
Definition: buffersrc.h:41
ff_add_channel_layout
int ff_add_channel_layout(AVFilterChannelLayouts **l, uint64_t channel_layout)
Definition: formats.c:343
s
#define s(width, name)
Definition: cbs_vp9.c:257
BufferSourceContext::h
int h
Definition: buffersrc.c:53
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
av_q2d
static double av_q2d(AVRational a)
Convert an AVRational to a double.
Definition: rational.h:104
push_frame
static int push_frame(AVFilterGraph *graph)
Definition: buffersrc.c:182
BufferSourceContext
Definition: buffersrc.c:44
avfilter_vsrc_buffer_outputs
static const AVFilterPad avfilter_vsrc_buffer_outputs[]
Definition: buffersrc.c:491
outputs
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
ctx
AVFormatContext * ctx
Definition: movenc.c:48
pix_fmt
static enum AVPixelFormat pix_fmt
Definition: demuxing_decoding.c:40
av_get_sample_fmt_name
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.
Definition: samplefmt.c:49
buffer_options
static const AVOption buffer_options[]
Definition: buffersrc.c:308
av_fifo_realloc2
int av_fifo_realloc2(AVFifoBuffer *f, unsigned int new_size)
Resize an AVFifoBuffer.
Definition: fifo.c:87
link
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
Definition: filter_design.txt:23
AVBufferSrcParameters::channel_layout
uint64_t channel_layout
Audio only, the audio channel layout.
Definition: buffersrc.h:116
BufferSourceContext::eof
int eof
Definition: buffersrc.c:68
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
av_buffer_unref
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
Definition: buffer.c:125
ff_vsrc_buffer
AVFilter ff_vsrc_buffer
Definition: buffersrc.c:502
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AV_OPT_TYPE_IMAGE_SIZE
@ AV_OPT_TYPE_IMAGE_SIZE
offset must point to two consecutive integers
Definition: opt.h:233
ff_add_format
int ff_add_format(AVFilterFormats **avff, int64_t fmt)
Add fmt to the list of media formats contained in *avff.
Definition: formats.c:337
BufferSourceContext::nb_failed_requests
unsigned nb_failed_requests
Definition: buffersrc.c:49
AVFilterGraph
Definition: avfilter.h:840
inputs
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
Definition: filter_design.txt:243
c
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
Definition: undefined.txt:32
BufferSourceContext::pixel_aspect
AVRational pixel_aspect
Definition: buffersrc.c:55
av_get_channel_layout_nb_channels
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
Definition: channel_layout.c:220
AVBufferSrcParameters::frame_rate
AVRational frame_rate
Video only, the frame rate of the input video.
Definition: buffersrc.h:100
BufferSourceContext::fifo
AVFifoBuffer * fifo
Definition: buffersrc.c:46
av_buffersrc_close
int av_buffersrc_close(AVFilterContext *ctx, int64_t pts, unsigned flags)
Close the buffer source after EOF.
Definition: buffersrc.c:269
V
#define V
Definition: buffersrc.c:306
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:188
BufferSourceContext::channel_layout
uint64_t channel_layout
Definition: buffersrc.c:64
copy
static void copy(const float *p1, float *p2, const int length)
Definition: vf_vaguedenoiser.c:185
av_frame_ref
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
Definition: frame.c:443
av_buffersrc_parameters_alloc
AVBufferSrcParameters * av_buffersrc_parameters_alloc(void)
Allocate a new AVBufferSrcParameters instance.
Definition: buffersrc.c:88
BufferSourceContext::hw_frames_ctx
AVBufferRef * hw_frames_ctx
Definition: buffersrc.c:58
config_props
static int config_props(AVFilterLink *link)
Definition: buffersrc.c:434
AVBufferSrcParameters::hw_frames_ctx
AVBufferRef * hw_frames_ctx
Video with a hwaccel pixel format only.
Definition: buffersrc.h:106
AVBufferSrcParameters::sample_rate
int sample_rate
Audio only, the audio sampling rate in samples per second.
Definition: buffersrc.h:111
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:59
size
int size
Definition: twinvq_data.h:11134
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
frame.h
AVBufferSrcParameters::time_base
AVRational time_base
The timebase to be used for the timestamps on the input frames.
Definition: buffersrc.h:82
request_frame
static int request_frame(AVFilterLink *link)
Definition: buffersrc.c:463
AVFrame::channel_layout
uint64_t channel_layout
Channel layout of the audio data.
Definition: frame.h:472
init_audio
static av_cold int init_audio(AVFilterContext *ctx)
Definition: buffersrc.c:334
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: buffersrc.c:399
internal.h
CHECK_VIDEO_PARAM_CHANGE
#define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)
Definition: buffersrc.c:71
av_buffersrc_parameters_set
int av_buffersrc_parameters_set(AVFilterContext *ctx, AVBufferSrcParameters *param)
Initialize the buffersrc or abuffersrc filter with the provided parameters.
Definition: buffersrc.c:99
BufferSourceContext::w
int w
Definition: buffersrc.c:53
BufferSourceContext::pix_fmt
enum AVPixelFormat pix_fmt
Definition: buffersrc.c:54
AVBufferSrcParameters::width
int width
Video only, the display dimensions of the input frames.
Definition: buffersrc.h:87
ff_avfilter_link_set_in_status
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.
Definition: avfilter.c:211
internal.h
av_buffersrc_add_frame_flags
int attribute_align_arg av_buffersrc_add_frame_flags(AVFilterContext *ctx, AVFrame *frame, int flags)
Add a frame to the buffer source.
Definition: buffersrc.c:158
common.h
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
init_video
static av_cold int init_video(AVFilterContext *ctx)
Definition: buffersrc.c:278
av_frame_move_ref
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
Definition: frame.c:582
av_mallocz
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:236
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:60
AVFilter
Filter definition.
Definition: avfilter.h:144
ret
ret
Definition: filter_design.txt:187
frame
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
Definition: filter_design.txt:264
FF_COUNT2LAYOUT
#define FF_COUNT2LAYOUT(c)
Encode a channel count as a channel layout.
Definition: formats.h:102
AVFrame::sample_aspect_ratio
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:383
AVFrame::hw_frames_ctx
AVBufferRef * hw_frames_ctx
For hwaccel-format frames, this should be a reference to the AVHWFramesContext describing the frame.
Definition: frame.h:634
channel_layout.h
AVBufferSrcParameters
This structure contains the parameters describing the frames that will be passed to this filter.
Definition: buffersrc.h:73
AVBufferSrcParameters::format
int format
video: the pixel format, value corresponds to enum AVPixelFormat audio: the sample format,...
Definition: buffersrc.h:78
buffer
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
Definition: filter_design.txt:49
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:223
avfilter.h
BufferSourceContext::got_format_from_params
int got_format_from_params
Definition: buffersrc.c:67
BufferSourceContext::warning_limit
unsigned warning_limit
Definition: buffersrc.c:50
AV_OPT_TYPE_PIXEL_FMT
@ AV_OPT_TYPE_PIXEL_FMT
Definition: opt.h:234
av_buffer_ref
AVBufferRef * av_buffer_ref(AVBufferRef *buf)
Create a new reference to an AVBuffer.
Definition: buffer.c:93
AVFilterContext
An instance of a filter.
Definition: avfilter.h:338
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
av_buffersrc_get_nb_failed_requests
unsigned av_buffersrc_get_nb_failed_requests(AVFilterContext *buffer_src)
Get the number of failed requests.
Definition: buffersrc.c:299
audio.h
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:81
av_fifo_size
int av_fifo_size(const AVFifoBuffer *f)
Return the amount of data in bytes in the AVFifoBuffer, that is the amount of data you can read from ...
Definition: fifo.c:77
av_fifo_freep
void av_fifo_freep(AVFifoBuffer **f)
Free an AVFifoBuffer and reset pointer to NULL.
Definition: fifo.c:63
BufferSourceContext::channel_layout_str
char * channel_layout_str
Definition: buffersrc.c:65
channel_layouts
static const uint16_t channel_layouts[7]
Definition: dca_lbr.c:113
BufferSourceContext::time_base
AVRational time_base
time_base to set in the output link
Definition: buffersrc.c:47
av_buffersrc_write_frame
int attribute_align_arg av_buffersrc_write_frame(AVFilterContext *ctx, const AVFrame *frame)
Add a frame to the buffer source.
Definition: buffersrc.c:144
av_fifo_alloc
AVFifoBuffer * av_fifo_alloc(unsigned int size)
Initialize an AVFifoBuffer.
Definition: fifo.c:43
imgutils.h
timestamp.h
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:565
AVERROR_BUG
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:50
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
ff_set_common_samplerates
int ff_set_common_samplerates(AVFilterContext *ctx, AVFilterFormats *samplerates)
Definition: formats.c:556
h
h
Definition: vp9dsp_template.c:2038
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:227
buffersrc.h
av_buffersrc_add_frame_internal
static int av_buffersrc_add_frame_internal(AVFilterContext *ctx, AVFrame *frame, int flags)
Definition: buffersrc.c:196
av_x_if_null
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.
Definition: avutil.h:308
BufferSourceContext::sample_fmt
enum AVSampleFormat sample_fmt
Definition: buffersrc.c:62
av_get_pix_fmt_name
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.
Definition: pixdesc.c:2438
avfilter_asrc_abuffer_outputs
static const AVFilterPad avfilter_asrc_abuffer_outputs[]
Definition: buffersrc.c:516