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/frame.h"
31 #include "libavutil/imgutils.h"
32 #include "libavutil/internal.h"
33 #include "libavutil/opt.h"
34 #include "libavutil/samplefmt.h"
35 #include "libavutil/timestamp.h"
36 #include "audio.h"
37 #include "avfilter.h"
38 #include "buffersrc.h"
39 #include "formats.h"
40 #include "internal.h"
41 #include "video.h"
42 
43 typedef struct BufferSourceContext {
44  const AVClass *class;
45  AVRational time_base; ///< time_base to set in the output link
46  AVRational frame_rate; ///< frame_rate to set in the output link
48 
49  /* video only */
50  int w, h;
53 #if FF_API_SWS_PARAM_OPTION
54  char *sws_param;
55 #endif
56 
58 
59  /* audio only */
62  int channels;
65 
66  int eof;
68 
69 #define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)\
70  if (c->w != width || c->h != height || c->pix_fmt != format) {\
71  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",\
72  c->w, c->h, c->pix_fmt, width, height, format, av_ts2timestr(pts, &s->outputs[0]->time_base));\
73  av_log(s, AV_LOG_WARNING, "Changing video frame properties on the fly is not supported by all filters.\n");\
74  }
75 
76 #define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)\
77  if (c->sample_fmt != format || c->sample_rate != srate ||\
78  av_channel_layout_compare(&c->ch_layout, &layout) || c->channels != layout.nb_channels) {\
79  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",\
80  av_get_sample_fmt_name(c->sample_fmt), c->sample_rate, c->ch_layout.order == AV_CHANNEL_ORDER_NATIVE ? c->ch_layout.u.mask : 0, c->channels,\
81  av_get_sample_fmt_name(format), srate, layout.order == AV_CHANNEL_ORDER_NATIVE ? layout.u.mask : 0, layout.nb_channels, av_ts2timestr(pts, &s->outputs[0]->time_base));\
82  av_log(s, AV_LOG_ERROR, "Changing audio frame properties on the fly is not supported.\n");\
83  return AVERROR(EINVAL);\
84  }
85 
87 {
88  AVBufferSrcParameters *par = av_mallocz(sizeof(*par));
89  if (!par)
90  return NULL;
91 
92  par->format = -1;
93 
94  return par;
95 }
96 
98 {
99  BufferSourceContext *s = ctx->priv;
100 
101  if (param->time_base.num > 0 && param->time_base.den > 0)
102  s->time_base = param->time_base;
103 
104  switch (ctx->filter->outputs[0].type) {
105  case AVMEDIA_TYPE_VIDEO:
106  if (param->format != AV_PIX_FMT_NONE) {
107  s->pix_fmt = param->format;
108  }
109  if (param->width > 0)
110  s->w = param->width;
111  if (param->height > 0)
112  s->h = param->height;
113  if (param->sample_aspect_ratio.num > 0 && param->sample_aspect_ratio.den > 0)
114  s->pixel_aspect = param->sample_aspect_ratio;
115  if (param->frame_rate.num > 0 && param->frame_rate.den > 0)
116  s->frame_rate = param->frame_rate;
117  if (param->hw_frames_ctx) {
118  av_buffer_unref(&s->hw_frames_ctx);
119  s->hw_frames_ctx = av_buffer_ref(param->hw_frames_ctx);
120  if (!s->hw_frames_ctx)
121  return AVERROR(ENOMEM);
122  }
123  break;
124  case AVMEDIA_TYPE_AUDIO:
125  if (param->format != AV_SAMPLE_FMT_NONE) {
126  s->sample_fmt = param->format;
127  }
128  if (param->sample_rate > 0)
129  s->sample_rate = param->sample_rate;
130 #if FF_API_OLD_CHANNEL_LAYOUT
132  // if the old/new fields are set inconsistently, prefer the old ones
133  if (param->channel_layout && (param->ch_layout.order != AV_CHANNEL_ORDER_NATIVE ||
134  param->ch_layout.u.mask != param->channel_layout)) {
135  av_channel_layout_uninit(&s->ch_layout);
136  av_channel_layout_from_mask(&s->ch_layout, param->channel_layout);
138  } else
139 #endif
140  if (param->ch_layout.nb_channels) {
141  int ret = av_channel_layout_copy(&s->ch_layout, &param->ch_layout);
142  if (ret < 0)
143  return ret;
144  }
145  break;
146  default:
147  return AVERROR_BUG;
148  }
149 
150  return 0;
151 }
152 
153 int attribute_align_arg av_buffersrc_write_frame(AVFilterContext *ctx, const AVFrame *frame)
154 {
157 }
158 
160 {
162 }
163 
164 static int push_frame(AVFilterGraph *graph)
165 {
166  int ret;
167 
168  while (1) {
169  ret = ff_filter_graph_run_once(graph);
170  if (ret == AVERROR(EAGAIN))
171  break;
172  if (ret < 0)
173  return ret;
174  }
175  return 0;
176 }
177 
179 {
180  BufferSourceContext *s = ctx->priv;
181  AVFrame *copy;
182  int refcounted, ret;
183 
184 #if FF_API_OLD_CHANNEL_LAYOUT
186  if (frame && frame->channel_layout &&
187  av_get_channel_layout_nb_channels(frame->channel_layout) != frame->channels) {
188  av_log(ctx, AV_LOG_ERROR, "Layout indicates a different number of channels than actually present\n");
189  return AVERROR(EINVAL);
190  }
192 #endif
193 
194  s->nb_failed_requests = 0;
195 
196  if (!frame)
198  if (s->eof)
199  return AVERROR(EINVAL);
200 
201  refcounted = !!frame->buf[0];
202 
204 
205  switch (ctx->outputs[0]->type) {
206  case AVMEDIA_TYPE_VIDEO:
207  CHECK_VIDEO_PARAM_CHANGE(ctx, s, frame->width, frame->height,
208  frame->format, frame->pts);
209  break;
210  case AVMEDIA_TYPE_AUDIO:
211  /* For layouts unknown on input but known on link after negotiation. */
212 #if FF_API_OLD_CHANNEL_LAYOUT
214  if (!frame->channel_layout)
215  frame->channel_layout = s->ch_layout.order == AV_CHANNEL_ORDER_NATIVE ?
216  s->ch_layout.u.mask : 0;
218 #endif
219  if (frame->ch_layout.order == AV_CHANNEL_ORDER_UNSPEC) {
220  ret = av_channel_layout_copy(&frame->ch_layout, &s->ch_layout);
221  if (ret < 0)
222  return ret;
223  }
224  CHECK_AUDIO_PARAM_CHANGE(ctx, s, frame->sample_rate, frame->ch_layout,
225  frame->format, frame->pts);
226  break;
227  default:
228  return AVERROR(EINVAL);
229  }
230 
231  }
232 
233  if (!(copy = av_frame_alloc()))
234  return AVERROR(ENOMEM);
235 
236  if (refcounted && !(flags & AV_BUFFERSRC_FLAG_KEEP_REF)) {
238  } else {
240  if (ret < 0) {
242  return ret;
243  }
244  }
245 
246 #if FF_API_PKT_DURATION
248  if (copy->pkt_duration && copy->pkt_duration != copy->duration)
249  copy->duration = copy->pkt_duration;
251 #endif
252 
253  ret = ff_filter_frame(ctx->outputs[0], copy);
254  if (ret < 0)
255  return ret;
256 
257  if ((flags & AV_BUFFERSRC_FLAG_PUSH)) {
258  ret = push_frame(ctx->graph);
259  if (ret < 0)
260  return ret;
261  }
262 
263  return 0;
264 }
265 
267 {
268  BufferSourceContext *s = ctx->priv;
269 
270  s->eof = 1;
272  return (flags & AV_BUFFERSRC_FLAG_PUSH) ? push_frame(ctx->graph) : 0;
273 }
274 
276 {
277  BufferSourceContext *c = ctx->priv;
278 
279  if (c->pix_fmt == AV_PIX_FMT_NONE || !c->w || !c->h ||
280  av_q2d(c->time_base) <= 0) {
281  av_log(ctx, AV_LOG_ERROR, "Invalid parameters provided.\n");
282  return AVERROR(EINVAL);
283  }
284 
285  av_log(ctx, AV_LOG_VERBOSE, "w:%d h:%d pixfmt:%s tb:%d/%d fr:%d/%d sar:%d/%d\n",
286  c->w, c->h, av_get_pix_fmt_name(c->pix_fmt),
287  c->time_base.num, c->time_base.den, c->frame_rate.num, c->frame_rate.den,
288  c->pixel_aspect.num, c->pixel_aspect.den);
289 
290 #if FF_API_SWS_PARAM_OPTION
291  if (c->sws_param)
292  av_log(ctx, AV_LOG_WARNING, "sws_param option is deprecated and ignored\n");
293 #endif
294 
295  return 0;
296 }
297 
299 {
300  return ((BufferSourceContext *)buffer_src->priv)->nb_failed_requests;
301 }
302 
303 #define OFFSET(x) offsetof(BufferSourceContext, x)
304 #define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM
305 #define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
306 
307 static const AVOption buffer_options[] = {
308  { "width", NULL, OFFSET(w), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, V },
309  { "video_size", NULL, OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, .flags = V },
310  { "height", NULL, OFFSET(h), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, V },
311  { "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 },
312  { "sar", "sample aspect ratio", OFFSET(pixel_aspect), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
313  { "pixel_aspect", "sample aspect ratio", OFFSET(pixel_aspect), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
314  { "time_base", NULL, OFFSET(time_base), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
315  { "frame_rate", NULL, OFFSET(frame_rate), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, DBL_MAX, V },
316 #if FF_API_SWS_PARAM_OPTION
317  { "sws_param", NULL, OFFSET(sws_param), AV_OPT_TYPE_STRING, .flags = V },
318 #endif
319  { NULL },
320 };
321 
323 
324 static const AVOption abuffer_options[] = {
325  { "time_base", NULL, OFFSET(time_base), AV_OPT_TYPE_RATIONAL, { .dbl = 0 }, 0, INT_MAX, A },
326  { "sample_rate", NULL, OFFSET(sample_rate), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, A },
327  { "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 },
328  { "channel_layout", NULL, OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, .flags = A },
329  { "channels", NULL, OFFSET(channels), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, A },
330  { NULL },
331 };
332 
333 AVFILTER_DEFINE_CLASS(abuffer);
334 
336 {
337  BufferSourceContext *s = ctx->priv;
338  char buf[128];
339  int ret = 0;
340 
341  if (s->sample_fmt == AV_SAMPLE_FMT_NONE) {
342  av_log(ctx, AV_LOG_ERROR, "Sample format was not set or was invalid\n");
343  return AVERROR(EINVAL);
344  }
345 
346  if (s->channel_layout_str || s->ch_layout.nb_channels) {
347  int n;
348 
349  if (!s->ch_layout.nb_channels) {
350  ret = av_channel_layout_from_string(&s->ch_layout, s->channel_layout_str);
351  if (ret < 0) {
352 #if FF_API_OLD_CHANNEL_LAYOUT
353  uint64_t mask;
355  mask = av_get_channel_layout(s->channel_layout_str);
356  if (!mask) {
357 #endif
358  av_log(ctx, AV_LOG_ERROR, "Invalid channel layout %s.\n",
359  s->channel_layout_str);
360  return AVERROR(EINVAL);
361 #if FF_API_OLD_CHANNEL_LAYOUT
362  }
364  av_log(ctx, AV_LOG_WARNING, "Channel layout '%s' uses a deprecated syntax.\n",
365  s->channel_layout_str);
366  av_channel_layout_from_mask(&s->ch_layout, mask);
367 #endif
368  }
369  }
370 
371  n = s->ch_layout.nb_channels;
372  av_channel_layout_describe(&s->ch_layout, buf, sizeof(buf));
373  if (s->channels) {
374  if (n != s->channels) {
376  "Mismatching channel count %d and layout '%s' "
377  "(%d channels)\n",
378  s->channels, buf, n);
379  return AVERROR(EINVAL);
380  }
381  }
382  s->channels = n;
383  } else if (!s->channels) {
384  av_log(ctx, AV_LOG_ERROR, "Neither number of channels nor "
385  "channel layout specified\n");
386  return AVERROR(EINVAL);
387  } else {
388  s->ch_layout = FF_COUNT2LAYOUT(s->channels);
389  av_channel_layout_describe(&s->ch_layout, buf, sizeof(buf));
390  }
391 
392  if (!s->time_base.num)
393  s->time_base = (AVRational){1, s->sample_rate};
394 
396  "tb:%d/%d samplefmt:%s samplerate:%d chlayout:%s\n",
397  s->time_base.num, s->time_base.den, av_get_sample_fmt_name(s->sample_fmt),
398  s->sample_rate, buf);
399 
400  return ret;
401 }
402 
404 {
405  BufferSourceContext *s = ctx->priv;
406  av_buffer_unref(&s->hw_frames_ctx);
407  av_channel_layout_uninit(&s->ch_layout);
408 }
409 
411 {
412  BufferSourceContext *c = ctx->priv;
415  AVFilterFormats *samplerates = NULL;
416  int ret;
417 
418  switch (ctx->outputs[0]->type) {
419  case AVMEDIA_TYPE_VIDEO:
420  if ((ret = ff_add_format (&formats, c->pix_fmt)) < 0 ||
421  (ret = ff_set_common_formats (ctx , formats )) < 0)
422  return ret;
423  break;
424  case AVMEDIA_TYPE_AUDIO:
425  if ((ret = ff_add_format (&formats , c->sample_fmt )) < 0 ||
426  (ret = ff_set_common_formats (ctx , formats )) < 0 ||
427  (ret = ff_add_format (&samplerates, c->sample_rate)) < 0 ||
428  (ret = ff_set_common_samplerates (ctx , samplerates )) < 0)
429  return ret;
430 
431  if ((ret = ff_add_channel_layout(&channel_layouts, &c->ch_layout)) < 0)
432  return ret;
434  return ret;
435  break;
436  default:
437  return AVERROR(EINVAL);
438  }
439 
440  return 0;
441 }
442 
444 {
445  BufferSourceContext *c = link->src->priv;
446 
447  switch (link->type) {
448  case AVMEDIA_TYPE_VIDEO:
449  link->w = c->w;
450  link->h = c->h;
451  link->sample_aspect_ratio = c->pixel_aspect;
452 
453  if (c->hw_frames_ctx) {
454  link->hw_frames_ctx = av_buffer_ref(c->hw_frames_ctx);
455  if (!link->hw_frames_ctx)
456  return AVERROR(ENOMEM);
457  }
458  break;
459  case AVMEDIA_TYPE_AUDIO:
460  if (!c->ch_layout.nb_channels) {
461  int ret = av_channel_layout_copy(&c->ch_layout, &link->ch_layout);
462  if (ret < 0)
463  return ret;
464  }
465  break;
466  default:
467  return AVERROR(EINVAL);
468  }
469 
470  link->time_base = c->time_base;
471  link->frame_rate = c->frame_rate;
472  return 0;
473 }
474 
476 {
477  BufferSourceContext *c = link->src->priv;
478 
479  if (c->eof)
480  return AVERROR_EOF;
481  c->nb_failed_requests++;
482  return AVERROR(EAGAIN);
483 }
484 
486  {
487  .name = "default",
488  .type = AVMEDIA_TYPE_VIDEO,
489  .request_frame = request_frame,
490  .config_props = config_props,
491  },
492 };
493 
495  .name = "buffer",
496  .description = NULL_IF_CONFIG_SMALL("Buffer video frames, and make them accessible to the filterchain."),
497  .priv_size = sizeof(BufferSourceContext),
498 
499  .init = init_video,
500  .uninit = uninit,
501 
502  .inputs = NULL,
505  .priv_class = &buffer_class,
506 };
507 
509  {
510  .name = "default",
511  .type = AVMEDIA_TYPE_AUDIO,
512  .request_frame = request_frame,
513  .config_props = config_props,
514  },
515 };
516 
518  .name = "abuffer",
519  .description = NULL_IF_CONFIG_SMALL("Buffer audio frames, and make them accessible to the filterchain."),
520  .priv_size = sizeof(BufferSourceContext),
521 
522  .init = init_audio,
523  .uninit = uninit,
524 
525  .inputs = NULL,
528  .priv_class = &abuffer_class,
529 };
formats
formats
Definition: signature.h:48
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:83
AVFilterChannelLayouts
A list of supported channel layouts.
Definition: formats.h:85
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
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:237
AV_BUFFERSRC_FLAG_PUSH
@ AV_BUFFERSRC_FLAG_PUSH
Immediately push the frame to the output.
Definition: buffersrc.h:46
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(buffer)
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:999
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
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:237
A
#define A
Definition: buffersrc.c:304
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:116
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:325
w
uint8_t w
Definition: llviddspenc.c:38
AVOption
AVOption.
Definition: opt.h:251
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:159
FILTER_QUERY_FUNC
#define FILTER_QUERY_FUNC(func)
Definition: internal.h:167
OFFSET
#define OFFSET(x)
Definition: buffersrc.c:303
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:196
float.h
CHECK_AUDIO_PARAM_CHANGE
#define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)
Definition: buffersrc.c:76
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:1340
AVChannelLayout::order
enum AVChannelOrder order
Channel order used in this layout.
Definition: channel_layout.h:295
av_buffer_ref
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
Definition: buffer.c:103
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:175
BufferSourceContext::channels
int channels
Definition: buffersrc.c:62
AVChannelLayout::mask
uint64_t mask
This member must be used for AV_CHANNEL_ORDER_NATIVE, and may be used for AV_CHANNEL_ORDER_AMBISONIC ...
Definition: channel_layout.h:322
AV_OPT_TYPE_RATIONAL
@ AV_OPT_TYPE_RATIONAL
Definition: opt.h:230
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:300
abuffer_options
static const AVOption abuffer_options[]
Definition: buffersrc.c:324
video.h
AVBufferSrcParameters::height
int height
Definition: buffersrc.h:87
sample_rate
sample_rate
Definition: ffmpeg_filter.c:155
av_channel_layout_copy
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
Definition: channel_layout.c:637
AVFilterFormats
A list of supported formats for one end of a filter link.
Definition: formats.h:64
formats.h
init
static int init
Definition: av_tx.c:47
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: buffersrc.c:403
AVFilterContext::priv
void * priv
private data for use by the filter
Definition: avfilter.h:423
AVBufferSrcParameters::sample_aspect_ratio
AVRational sample_aspect_ratio
Video only, the sample (pixel) aspect ratio.
Definition: buffersrc.h:92
AVChannelLayout::u
union AVChannelLayout::@297 u
Details about which channels are present in this layout.
BufferSourceContext::frame_rate
AVRational frame_rate
frame_rate to set in the output link
Definition: buffersrc.c:46
samplefmt.h
ff_vsrc_buffer
const AVFilter ff_vsrc_buffer
Definition: buffersrc.c:494
AVFrame::ch_layout
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition: frame.h:709
pts
static int64_t pts
Definition: transcode_aac.c:654
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:49
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:104
BufferSourceContext::sample_rate
int sample_rate
Definition: buffersrc.c:60
AVBufferSrcParameters::ch_layout
AVChannelLayout ch_layout
Audio only, the audio channel layout.
Definition: buffersrc.h:125
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_cold
#define av_cold
Definition: attributes.h:90
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:749
AV_CHANNEL_ORDER_NATIVE
@ AV_CHANNEL_ORDER_NATIVE
The native channel order, i.e.
Definition: channel_layout.h:112
mask
static const uint16_t mask[17]
Definition: lzw.c:38
s
#define s(width, name)
Definition: cbs_vp9.c:256
BufferSourceContext::h
int h
Definition: buffersrc.c:50
AV_CHANNEL_ORDER_UNSPEC
@ AV_CHANNEL_ORDER_UNSPEC
Only the channel count is specified, without any further information about the channel order.
Definition: channel_layout.h:106
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:164
BufferSourceContext
Definition: buffersrc.c:43
avfilter_vsrc_buffer_outputs
static const AVFilterPad avfilter_vsrc_buffer_outputs[]
Definition: buffersrc.c:485
BufferSourceContext::ch_layout
AVChannelLayout ch_layout
Definition: buffersrc.c:64
ctx
AVFormatContext * ctx
Definition: movenc.c:48
channels
channels
Definition: aptx.h:32
pix_fmt
static enum AVPixelFormat pix_fmt
Definition: demuxing_decoding.c:41
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:51
buffer_options
static const AVOption buffer_options[]
Definition: buffersrc.c:307
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
BufferSourceContext::eof
int eof
Definition: buffersrc.c:66
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
NULL
#define NULL
Definition: coverity.c:32
AV_BUFFERSRC_FLAG_KEEP_REF
@ AV_BUFFERSRC_FLAG_KEEP_REF
Keep a reference to the frame.
Definition: buffersrc.h:53
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:139
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:235
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:449
AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
@ AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
Do not check for format changes.
Definition: buffersrc.h:41
BufferSourceContext::nb_failed_requests
unsigned nb_failed_requests
Definition: buffersrc.c:47
AVFilterGraph
Definition: avfilter.h:871
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
ff_add_channel_layout
int ff_add_channel_layout(AVFilterChannelLayouts **l, const AVChannelLayout *channel_layout)
Definition: formats.c:466
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:52
av_channel_layout_uninit
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
Definition: channel_layout.c:630
AVBufferSrcParameters::frame_rate
AVRational frame_rate
Video only, the frame rate of the input video.
Definition: buffersrc.h:100
av_buffersrc_close
int av_buffersrc_close(AVFilterContext *ctx, int64_t pts, unsigned flags)
Close the buffer source after EOF.
Definition: buffersrc.c:266
V
#define V
Definition: buffersrc.c:305
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:117
copy
static void copy(const float *p1, float *p2, const int length)
Definition: vf_vaguedenoiser.c:187
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:353
AVChannelLayout
An AVChannelLayout holds information about the channel layout of audio data.
Definition: channel_layout.h:290
av_buffersrc_parameters_alloc
AVBufferSrcParameters * av_buffersrc_parameters_alloc(void)
Allocate a new AVBufferSrcParameters instance.
Definition: buffersrc.c:86
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:318
BufferSourceContext::hw_frames_ctx
AVBufferRef * hw_frames_ctx
Definition: buffersrc.c:57
config_props
static int config_props(AVFilterLink *link)
Definition: buffersrc.c:443
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:56
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
AVFrame::time_base
AVRational time_base
Time base for the timestamps in this frame.
Definition: frame.h:447
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:475
init_audio
static av_cold int init_audio(AVFilterContext *ctx)
Definition: buffersrc.c:335
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: buffersrc.c:410
internal.h
CHECK_VIDEO_PARAM_CHANGE
#define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)
Definition: buffersrc.c:69
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:97
BufferSourceContext::w
int w
Definition: buffersrc.c:50
BufferSourceContext::pix_fmt
enum AVPixelFormat pix_fmt
Definition: buffersrc.c:51
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:209
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:178
common.h
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:55
init_video
static av_cold int init_video(AVFilterContext *ctx)
Definition: buffersrc.c:275
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:516
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:264
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:55
AVFilter
Filter definition.
Definition: avfilter.h:171
av_channel_layout_from_mask
FF_ENABLE_DEPRECATION_WARNINGS int av_channel_layout_from_mask(AVChannelLayout *channel_layout, uint64_t mask)
Initialize a native channel layout from a bitmask indicating which channels are present.
Definition: channel_layout.c:389
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:427
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:664
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
av_channel_layout_from_string
int av_channel_layout_from_string(AVChannelLayout *channel_layout, const char *str)
Initialize a channel layout from a given string description.
Definition: channel_layout.c:402
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:225
avfilter.h
av_channel_layout_describe
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
Definition: channel_layout.c:776
AV_OPT_TYPE_PIXEL_FMT
@ AV_OPT_TYPE_PIXEL_FMT
Definition: opt.h:236
AVFilterContext
An instance of a filter.
Definition: avfilter.h:408
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:82
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:298
audio.h
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
BufferSourceContext::channel_layout_str
char * channel_layout_str
Definition: buffersrc.c:63
channel_layouts
static const uint16_t channel_layouts[7]
Definition: dca_lbr.c:111
FILTER_OUTPUTS
#define FILTER_OUTPUTS(array)
Definition: internal.h:191
BufferSourceContext::time_base
AVRational time_base
time_base to set in the output link
Definition: buffersrc.c:45
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:153
imgutils.h
timestamp.h
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
AVERROR_BUG
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:52
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
ff_asrc_abuffer
const AVFilter ff_asrc_abuffer
Definition: buffersrc.c:517
ff_set_common_samplerates
int ff_set_common_samplerates(AVFilterContext *ctx, AVFilterFormats *samplerates)
Definition: formats.c:726
h
h
Definition: vp9dsp_template.c:2038
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:229
buffersrc.h
BufferSourceContext::sample_fmt
enum AVSampleFormat sample_fmt
Definition: buffersrc.c:61
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:2595
avfilter_asrc_abuffer_outputs
static const AVFilterPad avfilter_asrc_abuffer_outputs[]
Definition: buffersrc.c:508
ff_set_common_channel_layouts
int ff_set_common_channel_layouts(AVFilterContext *ctx, AVFilterChannelLayouts *channel_layouts)
Helpers for query_formats() which set all free audio links to the same list of channel layouts/sample...
Definition: formats.c:708