FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
f_interleave.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2013 Stefano Sabatini
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  * audio and video interleaver
24  */
25 
26 #include "libavutil/avassert.h"
27 #include "libavutil/avstring.h"
28 #include "libavutil/opt.h"
29 #include "avfilter.h"
30 #include "bufferqueue.h"
31 #include "formats.h"
32 #include "internal.h"
33 #include "audio.h"
34 #include "video.h"
35 
36 typedef struct {
37  const AVClass *class;
38  int nb_inputs;
39  struct FFBufQueue *queues;
41 
42 #define OFFSET(x) offsetof(InterleaveContext, x)
43 
44 #define DEFINE_OPTIONS(filt_name, flags_) \
45 static const AVOption filt_name##_options[] = { \
46  { "nb_inputs", "set number of inputs", OFFSET(nb_inputs), AV_OPT_TYPE_INT, {.i64 = 2}, 1, INT_MAX, .flags = flags_ }, \
47  { "n", "set number of inputs", OFFSET(nb_inputs), AV_OPT_TYPE_INT, {.i64 = 2}, 1, INT_MAX, .flags = flags_ }, \
48  { NULL } \
49 }
50 
51 inline static int push_frame(AVFilterContext *ctx)
52 {
53  InterleaveContext *s = ctx->priv;
54  AVFrame *frame;
55  int i, queue_idx = -1;
56  int64_t pts_min = INT64_MAX;
57 
58  /* look for oldest frame */
59  for (i = 0; i < ctx->nb_inputs; i++) {
60  struct FFBufQueue *q = &s->queues[i];
61 
62  if (!q->available && !ctx->inputs[i]->closed)
63  return 0;
64  if (q->available) {
65  frame = ff_bufqueue_peek(q, 0);
66  if (frame->pts < pts_min) {
67  pts_min = frame->pts;
68  queue_idx = i;
69  }
70  }
71  }
72 
73  /* all inputs are closed */
74  if (queue_idx < 0)
75  return AVERROR_EOF;
76 
77  frame = ff_bufqueue_get(&s->queues[queue_idx]);
78  av_log(ctx, AV_LOG_DEBUG, "queue:%d -> frame time:%f\n",
79  queue_idx, frame->pts * av_q2d(AV_TIME_BASE_Q));
80  return ff_filter_frame(ctx->outputs[0], frame);
81 }
82 
83 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
84 {
85  AVFilterContext *ctx = inlink->dst;
86  InterleaveContext *s = ctx->priv;
87  unsigned in_no = FF_INLINK_IDX(inlink);
88 
89  if (frame->pts == AV_NOPTS_VALUE) {
91  "NOPTS value for input frame cannot be accepted, frame discarded\n");
92  av_frame_free(&frame);
93  return AVERROR_INVALIDDATA;
94  }
95 
96  /* queue frame */
97  frame->pts = av_rescale_q(frame->pts, inlink->time_base, AV_TIME_BASE_Q);
98  av_log(ctx, AV_LOG_DEBUG, "frame pts:%f -> queue idx:%d available:%d\n",
99  frame->pts * av_q2d(AV_TIME_BASE_Q), in_no, s->queues[in_no].available);
100  ff_bufqueue_add(ctx, &s->queues[in_no], frame);
101 
102  return push_frame(ctx);
103 }
104 
105 static av_cold int init(AVFilterContext *ctx)
106 {
107  InterleaveContext *s = ctx->priv;
108  const AVFilterPad *outpad = &ctx->filter->outputs[0];
109  int i;
110 
111  s->queues = av_calloc(s->nb_inputs, sizeof(s->queues[0]));
112  if (!s->queues)
113  return AVERROR(ENOMEM);
114 
115  for (i = 0; i < s->nb_inputs; i++) {
116  AVFilterPad inpad = { 0 };
117 
118  inpad.name = av_asprintf("input%d", i);
119  if (!inpad.name)
120  return AVERROR(ENOMEM);
121  inpad.type = outpad->type;
122  inpad.filter_frame = filter_frame;
123 
124  switch (outpad->type) {
125  case AVMEDIA_TYPE_VIDEO:
127  case AVMEDIA_TYPE_AUDIO:
129  default:
130  av_assert0(0);
131  }
132  ff_insert_inpad(ctx, i, &inpad);
133  }
134 
135  return 0;
136 }
137 
138 static av_cold void uninit(AVFilterContext *ctx)
139 {
140  InterleaveContext *s = ctx->priv;
141  int i;
142 
143  for (i = 0; i < ctx->nb_inputs; i++) {
145  av_freep(&s->queues[i]);
146  av_freep(&ctx->input_pads[i].name);
147  }
148 }
149 
150 static int config_output(AVFilterLink *outlink)
151 {
152  AVFilterContext *ctx = outlink->src;
153  AVFilterLink *inlink0 = ctx->inputs[0];
154  int i;
155 
156  if (outlink->type == AVMEDIA_TYPE_VIDEO) {
157  outlink->time_base = AV_TIME_BASE_Q;
158  outlink->w = inlink0->w;
159  outlink->h = inlink0->h;
160  outlink->sample_aspect_ratio = inlink0->sample_aspect_ratio;
161  outlink->format = inlink0->format;
162  outlink->frame_rate = (AVRational) {1, 0};
163  for (i = 1; i < ctx->nb_inputs; i++) {
164  AVFilterLink *inlink = ctx->inputs[i];
165 
166  if (outlink->w != inlink->w ||
167  outlink->h != inlink->h ||
168  outlink->sample_aspect_ratio.num != inlink->sample_aspect_ratio.num ||
169  outlink->sample_aspect_ratio.den != inlink->sample_aspect_ratio.den) {
170  av_log(ctx, AV_LOG_ERROR, "Parameters for input link %s "
171  "(size %dx%d, SAR %d:%d) do not match the corresponding "
172  "output link parameters (%dx%d, SAR %d:%d)\n",
173  ctx->input_pads[i].name, inlink->w, inlink->h,
174  inlink->sample_aspect_ratio.num,
175  inlink->sample_aspect_ratio.den,
176  outlink->w, outlink->h,
177  outlink->sample_aspect_ratio.num,
178  outlink->sample_aspect_ratio.den);
179  return AVERROR(EINVAL);
180  }
181  }
182  }
183 
184  outlink->flags |= FF_LINK_FLAG_REQUEST_LOOP;
185  return 0;
186 }
187 
188 static int request_frame(AVFilterLink *outlink)
189 {
190  AVFilterContext *ctx = outlink->src;
191  InterleaveContext *s = ctx->priv;
192  int i, ret;
193 
194  for (i = 0; i < ctx->nb_inputs; i++) {
195  if (!s->queues[i].available && !ctx->inputs[i]->closed) {
196  ret = ff_request_frame(ctx->inputs[i]);
197  if (ret != AVERROR_EOF)
198  return ret;
199  }
200  }
201 
202  return push_frame(ctx);
203 }
204 
205 #if CONFIG_INTERLEAVE_FILTER
206 
209 
210 static const AVFilterPad interleave_outputs[] = {
211  {
212  .name = "default",
213  .type = AVMEDIA_TYPE_VIDEO,
214  .config_props = config_output,
215  .request_frame = request_frame,
216  },
217  { NULL }
218 };
219 
220 AVFilter ff_vf_interleave = {
221  .name = "interleave",
222  .description = NULL_IF_CONFIG_SMALL("Temporally interleave video inputs."),
223  .priv_size = sizeof(InterleaveContext),
224  .init = init,
225  .uninit = uninit,
226  .outputs = interleave_outputs,
227  .priv_class = &interleave_class,
229 };
230 
231 #endif
232 
233 #if CONFIG_AINTERLEAVE_FILTER
234 
236 AVFILTER_DEFINE_CLASS(ainterleave);
237 
238 static const AVFilterPad ainterleave_outputs[] = {
239  {
240  .name = "default",
241  .type = AVMEDIA_TYPE_AUDIO,
242  .config_props = config_output,
243  .request_frame = request_frame,
244  },
245  { NULL }
246 };
247 
248 AVFilter ff_af_ainterleave = {
249  .name = "ainterleave",
250  .description = NULL_IF_CONFIG_SMALL("Temporally interleave audio inputs."),
251  .priv_size = sizeof(InterleaveContext),
252  .init = init,
253  .uninit = uninit,
254  .outputs = ainterleave_outputs,
255  .priv_class = &ainterleave_class,
257 };
258 
259 #endif
static AVFrame * ff_bufqueue_get(struct FFBufQueue *queue)
Get the first buffer from the queue and remove it.
Definition: bufferqueue.h:98
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:631
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
This structure describes decoded (raw) audio or video data.
Definition: frame.h:171
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
static const AVFilterPad outputs[]
Definition: af_ashowinfo.c:248
Main libavfilter public API header.
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
Definition: avfilter.h:431
int num
numerator
Definition: rational.h:44
#define AV_OPT_FLAG_AUDIO_PARAM
Definition: opt.h:290
AVFrame * ff_null_get_video_buffer(AVFilterLink *link, int w, int h)
Definition: video.c:35
enum AVMediaType type
AVFilterPad type.
Definition: internal.h:72
static av_always_inline void interleave(IDWTELEM *dst, IDWTELEM *src0, IDWTELEM *src1, int w2, int add, int shift)
Definition: dirac_dwt.c:40
static int config_output(AVFilterLink *outlink)
Definition: f_interleave.c:150
Structure holding the queue.
Definition: bufferqueue.h:49
const char * name
Pad name.
Definition: internal.h:67
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:641
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1145
#define av_cold
Definition: attributes.h:74
AVOptions.
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:257
static AVFrame * frame
static double av_q2d(AVRational a)
Convert rational to double.
Definition: rational.h:80
#define AVERROR_EOF
End of file.
Definition: error.h:55
#define av_log(a,...)
#define DEFINE_OPTIONS(filt_name, flags_)
Definition: f_interleave.c:44
A filter pad used for either input or output.
Definition: internal.h:61
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Definition: mathematics.c:140
AVFilterPad * input_pads
array of input pads
Definition: avfilter.h:640
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
#define AV_OPT_FLAG_FILTERING_PARAM
a generic parameter which can be set by the user for filtering
Definition: opt.h:302
#define AVERROR(e)
Definition: error.h:43
struct FFBufQueue * queues
Definition: f_interleave.c:39
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:148
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:175
void * priv
private data for use by the filter
Definition: avfilter.h:654
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:197
int(* filter_frame)(AVFilterLink *link, AVFrame *frame)
Filtering callback.
Definition: internal.h:100
simple assert() macros that are a bit more flexible than ISO C assert().
char * av_asprintf(const char *fmt,...)
Definition: avstring.c:113
unsigned nb_inputs
number of input pads
Definition: avfilter.h:645
static av_cold void uninit(AVFilterContext *ctx)
Definition: f_interleave.c:138
ret
Definition: avfilter.c:974
static av_cold int init(AVFilterContext *ctx)
Definition: f_interleave.c:105
static void ff_bufqueue_discard_all(struct FFBufQueue *queue)
Unref and remove all buffers from the queue.
Definition: bufferqueue.h:111
AVFrame * ff_null_get_audio_buffer(AVFilterLink *link, int nb_samples)
get_audio_buffer() handler for filters which simply pass audio along
Definition: audio.c:36
AVFrame *(* get_audio_buffer)(AVFilterLink *link, int nb_samples)
Callback function to get an audio buffer.
Definition: internal.h:88
AVFrame *(* get_video_buffer)(AVFilterLink *link, int w, int h)
Callback function to get a video buffer.
Definition: internal.h:80
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:253
unsigned short available
number of available buffers
Definition: bufferqueue.h:52
#define AV_OPT_FLAG_VIDEO_PARAM
Definition: opt.h:291
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:470
rational number numerator/denominator
Definition: rational.h:43
const char * name
Filter name.
Definition: avfilter.h:474
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:648
void * av_calloc(size_t nmemb, size_t size)
Allocate a block of nmemb * size bytes with alignment suitable for all memory accesses (including vec...
Definition: mem.c:258
Frame requests may need to loop in order to be fulfilled.
Definition: internal.h:359
static int flags
Definition: cpu.c:47
#define FF_INLINK_IDX(link)
Find the index of a link.
Definition: internal.h:330
static int request_frame(AVFilterLink *outlink)
Definition: f_interleave.c:188
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: f_interleave.c:83
int den
denominator
Definition: rational.h:45
#define AVFILTER_DEFINE_CLASS(fname)
Definition: internal.h:313
An instance of a filter.
Definition: avfilter.h:633
const AVFilterPad * outputs
List of outputs, terminated by a zeroed element.
Definition: avfilter.h:498
#define av_freep(p)
static void ff_bufqueue_add(void *log, struct FFBufQueue *queue, AVFrame *buf)
Add a buffer to the queue.
Definition: bufferqueue.h:71
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
Definition: avfilter.c:343
internal API functions
const AVFilter * filter
the AVFilter of which this is an instance
Definition: avfilter.h:636
static int push_frame(AVFilterContext *ctx)
Definition: f_interleave.c:51
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:241
static int ff_insert_inpad(AVFilterContext *f, unsigned index, AVFilterPad *p)
Insert a new input pad for the filter.
Definition: internal.h:269
static AVFrame * ff_bufqueue_peek(struct FFBufQueue *queue, unsigned index)
Get a buffer from the queue without altering it.
Definition: bufferqueue.h:87