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]->status)
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 
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 
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  return 0;
184 }
185 
186 static int request_frame(AVFilterLink *outlink)
187 {
188  AVFilterContext *ctx = outlink->src;
189  InterleaveContext *s = ctx->priv;
190  int i, ret;
191 
192  for (i = 0; i < ctx->nb_inputs; i++) {
193  if (!s->queues[i].available && !ctx->inputs[i]->status) {
194  ret = ff_request_frame(ctx->inputs[i]);
195  if (ret != AVERROR_EOF)
196  return ret;
197  }
198  }
199 
200  return push_frame(ctx);
201 }
202 
203 #if CONFIG_INTERLEAVE_FILTER
204 
207 
208 static const AVFilterPad interleave_outputs[] = {
209  {
210  .name = "default",
211  .type = AVMEDIA_TYPE_VIDEO,
212  .config_props = config_output,
213  .request_frame = request_frame,
214  },
215  { NULL }
216 };
217 
218 AVFilter ff_vf_interleave = {
219  .name = "interleave",
220  .description = NULL_IF_CONFIG_SMALL("Temporally interleave video inputs."),
221  .priv_size = sizeof(InterleaveContext),
222  .init = init,
223  .uninit = uninit,
224  .outputs = interleave_outputs,
225  .priv_class = &interleave_class,
227 };
228 
229 #endif
230 
231 #if CONFIG_AINTERLEAVE_FILTER
232 
234 AVFILTER_DEFINE_CLASS(ainterleave);
235 
236 static const AVFilterPad ainterleave_outputs[] = {
237  {
238  .name = "default",
239  .type = AVMEDIA_TYPE_AUDIO,
240  .config_props = config_output,
241  .request_frame = request_frame,
242  },
243  { NULL }
244 };
245 
246 AVFilter ff_af_ainterleave = {
247  .name = "ainterleave",
248  .description = NULL_IF_CONFIG_SMALL("Temporally interleave audio inputs."),
249  .priv_size = sizeof(InterleaveContext),
250  .init = init,
251  .uninit = uninit,
252  .outputs = ainterleave_outputs,
253  .priv_class = &ainterleave_class,
255 };
256 
257 #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:768
#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:184
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
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:105
int num
Numerator.
Definition: rational.h:59
#define AV_OPT_FLAG_AUDIO_PARAM
Definition: opt.h:280
AVFrame * ff_null_get_video_buffer(AVFilterLink *link, int w, int h)
Definition: video.c:38
enum AVMediaType type
AVFilterPad type.
Definition: internal.h:64
static int config_output(AVFilterLink *outlink)
Definition: f_interleave.c:150
void * av_calloc(size_t nmemb, size_t size)
Non-inlined equivalent of av_mallocz_array().
Definition: mem.c:260
Structure holding the queue.
Definition: bufferqueue.h:49
const char * name
Pad name.
Definition: internal.h:59
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:315
#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:1189
#define av_cold
Definition: attributes.h:82
AVOptions.
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:268
static AVFrame * frame
static double av_q2d(AVRational a)
Convert an AVRational to a double.
Definition: rational.h:104
#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:53
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Definition: mathematics.c:142
AVFilterPad * input_pads
array of input pads
Definition: avfilter.h:314
#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:292
#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:158
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:176
void * priv
private data for use by the filter
Definition: avfilter.h:322
#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:92
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:316
static av_cold void uninit(AVFilterContext *ctx)
Definition: f_interleave.c:138
AVFormatContext * ctx
Definition: movenc.c:48
static av_cold int init(AVFilterContext *ctx)
Definition: f_interleave.c:105
static const AVFilterPad outputs[]
Definition: af_afftfilt.c:386
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:30
AVFrame *(* get_audio_buffer)(AVFilterLink *link, int nb_samples)
Callback function to get an audio buffer.
Definition: internal.h:80
AVFrame *(* get_video_buffer)(AVFilterLink *link, int w, int h)
Callback function to get a video buffer.
Definition: internal.h:72
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:254
unsigned short available
number of available buffers
Definition: bufferqueue.h:52
#define AV_OPT_FLAG_VIDEO_PARAM
Definition: opt.h:281
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:144
Rational number (pair of numerator and denominator).
Definition: rational.h:58
const char * name
Filter name.
Definition: avfilter.h:148
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:319
static void interleave(short *output, short **input, int channels, int samples)
Definition: resample.c:161
static int flags
Definition: cpu.c:47
#define FF_INLINK_IDX(link)
Find the index of a link.
Definition: internal.h:353
static int request_frame(AVFilterLink *outlink)
Definition: f_interleave.c:186
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: f_interleave.c:83
int den
Denominator.
Definition: rational.h:60
#define AVFILTER_DEFINE_CLASS(fname)
Definition: internal.h:339
An instance of a filter.
Definition: avfilter.h:307
const AVFilterPad * outputs
List of outputs, terminated by a zeroed element.
Definition: avfilter.h:172
#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:369
internal API functions
const AVFilter * filter
the AVFilter of which this is an instance
Definition: avfilter.h:310
static int push_frame(AVFilterContext *ctx)
Definition: f_interleave.c:51
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:242
static int ff_insert_inpad(AVFilterContext *f, unsigned index, AVFilterPad *p)
Insert a new input pad for the filter.
Definition: internal.h:283
static AVFrame * ff_bufqueue_peek(struct FFBufQueue *queue, unsigned index)
Get a buffer from the queue without altering it.
Definition: bufferqueue.h:87