FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavfilter/af_amerge.c
Date: 2025-10-26 07:25:09
Exec Total Coverage
Lines: 120 160 75.0%
Functions: 8 8 100.0%
Branches: 71 106 67.0%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2011 Nicolas George <nicolas.george@normalesup.org>
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
14 * GNU 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 merging filter
24 */
25
26 #include "libavutil/avstring.h"
27 #include "libavutil/bprint.h"
28 #include "libavutil/channel_layout.h"
29 #include "libavutil/mem.h"
30 #include "libavutil/opt.h"
31 #include "avfilter.h"
32 #include "filters.h"
33 #include "audio.h"
34 #include "formats.h"
35
36 #define SWR_CH_MAX 64
37
38 typedef struct AMergeContext {
39 const AVClass *class;
40 int nb_inputs;
41 int route[SWR_CH_MAX]; /**< channels routing, see copy_samples */
42 int bps;
43 struct amerge_input {
44 int nb_ch; /**< number of channels for the input */
45 } *in;
46 } AMergeContext;
47
48 #define OFFSET(x) offsetof(AMergeContext, x)
49 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
50
51 static const AVOption amerge_options[] = {
52 { "inputs", "specify the number of inputs", OFFSET(nb_inputs),
53 AV_OPT_TYPE_INT, { .i64 = 2 }, 1, SWR_CH_MAX, FLAGS },
54 { NULL }
55 };
56
57 AVFILTER_DEFINE_CLASS(amerge);
58
59 2 static av_cold void uninit(AVFilterContext *ctx)
60 {
61 2 AMergeContext *s = ctx->priv;
62
63 2 av_freep(&s->in);
64 2 }
65
66 2 static int query_formats(AVFilterContext *ctx)
67 {
68 static const enum AVSampleFormat packed_sample_fmts[] = {
69 AV_SAMPLE_FMT_U8,
70 AV_SAMPLE_FMT_S16,
71 AV_SAMPLE_FMT_S32,
72 AV_SAMPLE_FMT_FLT,
73 AV_SAMPLE_FMT_DBL,
74 AV_SAMPLE_FMT_NONE
75 };
76 2 AMergeContext *s = ctx->priv;
77 2 AVChannelLayout *inlayout[SWR_CH_MAX] = { NULL }, outlayout = { 0 };
78 2 uint64_t outmask = 0;
79 AVFilterChannelLayouts *layouts;
80 2 int i, ret, overlap = 0, nb_ch = 0;
81
82
2/2
✓ Branch 0 taken 3 times.
✓ Branch 1 taken 1 times.
 4 for (i = 0; i < s->nb_inputs; i++) {
83
2/2
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
 3 if (!ctx->inputs[i]->incfg.channel_layouts ||
84
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 2 times.
 2 !ctx->inputs[i]->incfg.channel_layouts->nb_channel_layouts) {
85 1 av_log(ctx, AV_LOG_WARNING,
86 "No channel layout for input %d\n", i + 1);
87 1 return AVERROR(EAGAIN);
88 }
89 2 inlayout[i] = &ctx->inputs[i]->incfg.channel_layouts->channel_layouts[0];
90
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 2 times.
 2 if (ctx->inputs[i]->incfg.channel_layouts->nb_channel_layouts > 1) {
91 char buf[256];
92 ✗ av_channel_layout_describe(inlayout[i], buf, sizeof(buf));
93 ✗ av_log(ctx, AV_LOG_INFO, "Using \"%s\" for input %d\n", buf, i + 1);
94 }
95
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 2 times.
 2 s->in[i].nb_ch = FF_LAYOUT2COUNT(inlayout[i]);
96
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 2 times.
 2 if (s->in[i].nb_ch) {
97 ✗ overlap++;
98 } else {
99 2 s->in[i].nb_ch = inlayout[i]->nb_channels;
100
2/2
✓ Branch 1 taken 1 times.
✓ Branch 2 taken 1 times.
 2 if (av_channel_layout_subset(inlayout[i], outmask))
101 1 overlap++;
102 2 outmask |= inlayout[i]->order == AV_CHANNEL_ORDER_NATIVE ?
103
1/2
✓ Branch 0 taken 2 times.
✗ Branch 1 not taken.
 2 inlayout[i]->u.mask : 0;
104 }
105 2 nb_ch += s->in[i].nb_ch;
106 }
107
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
 1 if (nb_ch > SWR_CH_MAX) {
108 ✗ av_log(ctx, AV_LOG_ERROR, "Too many channels (max %d)\n", SWR_CH_MAX);
109 ✗ return AVERROR(EINVAL);
110 }
111
1/2
✓ Branch 0 taken 1 times.
✗ Branch 1 not taken.
 1 if (overlap) {
112 1 av_log(ctx, AV_LOG_WARNING,
113 "Input channel layouts overlap: "
114 "output layout will be determined by the number of distinct input channels\n");
115
2/2
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
 3 for (i = 0; i < nb_ch; i++)
116 2 s->route[i] = i;
117 1 av_channel_layout_default(&outlayout, nb_ch);
118
1/6
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
✗ Branch 4 not taken.
✗ Branch 5 not taken.
 1 if (!KNOWN(&outlayout) && nb_ch)
119 ✗ av_channel_layout_from_mask(&outlayout, 0xFFFFFFFFFFFFFFFFULL >> (64 - nb_ch));
120 } else {
121 int *route[SWR_CH_MAX];
122 ✗ int c, out_ch_number = 0;
123
124 ✗ av_channel_layout_from_mask(&outlayout, outmask);
125 ✗ route[0] = s->route;
126 ✗ for (i = 1; i < s->nb_inputs; i++)
127 ✗ route[i] = route[i - 1] + s->in[i - 1].nb_ch;
128 ✗ for (c = 0; c < 64; c++)
129 ✗ for (i = 0; i < s->nb_inputs; i++)
130 ✗ if (av_channel_layout_index_from_channel(inlayout[i], c) >= 0)
131 ✗ *(route[i]++) = out_ch_number++;
132 }
133
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 1 times.
 1 if ((ret = ff_set_common_formats_from_list(ctx, packed_sample_fmts)) < 0)
134 ✗ return ret;
135
2/2
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
 3 for (i = 0; i < s->nb_inputs; i++) {
136 2 layouts = NULL;
137
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 2 times.
 2 if ((ret = ff_add_channel_layout(&layouts, inlayout[i])) < 0)
138 ✗ return ret;
139
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 2 times.
 2 if ((ret = ff_channel_layouts_ref(layouts, &ctx->inputs[i]->outcfg.channel_layouts)) < 0)
140 ✗ return ret;
141 }
142 1 layouts = NULL;
143
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 1 times.
 1 if ((ret = ff_add_channel_layout(&layouts, &outlayout)) < 0)
144 ✗ return ret;
145
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 1 times.
 1 if ((ret = ff_channel_layouts_ref(layouts, &ctx->outputs[0]->incfg.channel_layouts)) < 0)
146 ✗ return ret;
147
148 1 return ff_set_common_all_samplerates(ctx);
149 }
150
151 1 static int config_output(AVFilterLink *outlink)
152 {
153 1 AVFilterContext *ctx = outlink->src;
154 1 AMergeContext *s = ctx->priv;
155 AVBPrint bp;
156 int i;
157
158 1 s->bps = av_get_bytes_per_sample(outlink->format);
159 1 outlink->time_base = ctx->inputs[0]->time_base;
160
161 1 av_bprint_init(&bp, 0, AV_BPRINT_SIZE_AUTOMATIC);
162
2/2
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
 3 for (i = 0; i < s->nb_inputs; i++) {
163
2/2
✓ Branch 0 taken 1 times.
✓ Branch 1 taken 1 times.
 2 av_bprintf(&bp, "%sin%d:", i ? " + " : "", i);
164 2 av_channel_layout_describe_bprint(&ctx->inputs[i]->ch_layout, &bp);
165 }
166 1 av_bprintf(&bp, " -> out:");
167 1 av_channel_layout_describe_bprint(&outlink->ch_layout, &bp);
168 1 av_log(ctx, AV_LOG_VERBOSE, "%s\n", bp.str);
169
170 1 return 0;
171 }
172
173 /**
174 * Copy samples from several input streams to one output stream.
175 * @param nb_inputs number of inputs
176 * @param in inputs; used only for the nb_ch field;
177 * @param route routing values;
178 * input channel i goes to output channel route[i];
179 * i < in[0].nb_ch are the channels from the first output;
180 * i >= in[0].nb_ch are the channels from the second output
181 * @param ins pointer to the samples of each inputs, in packed format;
182 * will be left at the end of the copied samples
183 * @param outs pointer to the samples of the output, in packet format;
184 * must point to a buffer big enough;
185 * will be left at the end of the copied samples
186 * @param ns number of samples to copy
187 * @param bps bytes per sample
188 */
189 65 static inline void copy_samples(int nb_inputs, struct amerge_input in[],
190 int *route, uint8_t *ins[],
191 uint8_t **outs, int ns, int bps)
192 {
193 int *route_cur;
194 65 int i, c, nb_ch = 0;
195
196
2/2
✓ Branch 0 taken 130 times.
✓ Branch 1 taken 65 times.
 195 for (i = 0; i < nb_inputs; i++)
197 130 nb_ch += in[i].nb_ch;
198
2/2
✓ Branch 0 taken 264600 times.
✓ Branch 1 taken 65 times.
 264665 while (ns--) {
199 264600 route_cur = route;
200
2/2
✓ Branch 0 taken 529200 times.
✓ Branch 1 taken 264600 times.
 793800 for (i = 0; i < nb_inputs; i++) {
201
2/2
✓ Branch 0 taken 529200 times.
✓ Branch 1 taken 529200 times.
 1058400 for (c = 0; c < in[i].nb_ch; c++) {
202 529200 memcpy((*outs) + bps * *(route_cur++), ins[i], bps);
203 529200 ins[i] += bps;
204 }
205 }
206 264600 *outs += nb_ch * bps;
207 }
208 65 }
209
210 65 static void free_frames(int nb_inputs, AVFrame **input_frames)
211 {
212 int i;
213
2/2
✓ Branch 0 taken 130 times.
✓ Branch 1 taken 65 times.
 195 for (i = 0; i < nb_inputs; i++)
214 130 av_frame_free(&input_frames[i]);
215 65 }
216
217 65 static int try_push_frame(AVFilterContext *ctx, int nb_samples)
218 {
219 65 AMergeContext *s = ctx->priv;
220 65 AVFilterLink *outlink = ctx->outputs[0];
221 int i, ret;
222 65 AVFrame *outbuf, *inbuf[SWR_CH_MAX] = { NULL };
223 uint8_t *outs, *ins[SWR_CH_MAX];
224
225
2/2
✓ Branch 0 taken 130 times.
✓ Branch 1 taken 65 times.
 195 for (i = 0; i < ctx->nb_inputs; i++) {
226 130 ret = ff_inlink_consume_samples(ctx->inputs[i], nb_samples, nb_samples, &inbuf[i]);
227
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 130 times.
 130 if (ret < 0) {
228 ✗ free_frames(i, inbuf);
229 ✗ return ret;
230 }
231 130 ins[i] = inbuf[i]->data[0];
232 }
233
234 65 outbuf = ff_get_audio_buffer(outlink, nb_samples);
235
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 65 times.
 65 if (!outbuf) {
236 ✗ free_frames(s->nb_inputs, inbuf);
237 ✗ return AVERROR(ENOMEM);
238 }
239
240 65 outs = outbuf->data[0];
241 65 outbuf->pts = inbuf[0]->pts;
242
243 65 outbuf->nb_samples = nb_samples;
244 65 outbuf->duration = av_rescale_q(outbuf->nb_samples,
245 av_make_q(1, outlink->sample_rate),
246 outlink->time_base);
247
248
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 65 times.
 65 if ((ret = av_channel_layout_copy(&outbuf->ch_layout, &outlink->ch_layout)) < 0) {
249 ✗ free_frames(s->nb_inputs, inbuf);
250 ✗ av_frame_free(&outbuf);
251 ✗ return ret;
252 }
253
254
2/2
✓ Branch 0 taken 65 times.
✓ Branch 1 taken 65 times.
 130 while (nb_samples) {
255 /* Unroll the most common sample formats: speed +~350% for the loop,
256 +~13% overall (including two common decoders) */
257
1/4
✗ Branch 0 not taken.
✓ Branch 1 taken 65 times.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
 65 switch (s->bps) {
258 ✗ case 1:
259 ✗ copy_samples(s->nb_inputs, s->in, s->route, ins, &outs, nb_samples, 1);
260 ✗ break;
261 65 case 2:
262 65 copy_samples(s->nb_inputs, s->in, s->route, ins, &outs, nb_samples, 2);
263 65 break;
264 ✗ case 4:
265 ✗ copy_samples(s->nb_inputs, s->in, s->route, ins, &outs, nb_samples, 4);
266 ✗ break;
267 ✗ default:
268 ✗ copy_samples(s->nb_inputs, s->in, s->route, ins, &outs, nb_samples, s->bps);
269 ✗ break;
270 }
271
272 65 nb_samples = 0;
273 }
274
275 65 free_frames(s->nb_inputs, inbuf);
276 65 return ff_filter_frame(outlink, outbuf);
277 }
278
279 258 static int activate(AVFilterContext *ctx)
280 {
281 int i, status;
282 int ret, nb_samples;
283 int64_t pts;
284
285
4/4
✓ Branch 1 taken 1 times.
✓ Branch 2 taken 257 times.
✓ Branch 4 taken 2 times.
✓ Branch 5 taken 1 times.
 260 FF_FILTER_FORWARD_STATUS_BACK_ALL(ctx->outputs[0], ctx);
286
287 257 nb_samples = ff_inlink_queued_samples(ctx->inputs[0]);
288
4/4
✓ Branch 0 taken 257 times.
✓ Branch 1 taken 159 times.
✓ Branch 2 taken 159 times.
✓ Branch 3 taken 98 times.
 416 for (i = 1; i < ctx->nb_inputs && nb_samples > 0; i++) {
289
2/2
✓ Branch 1 taken 140 times.
✓ Branch 2 taken 19 times.
 159 nb_samples = FFMIN(ff_inlink_queued_samples(ctx->inputs[i]), nb_samples);
290 }
291
292
2/2
✓ Branch 0 taken 65 times.
✓ Branch 1 taken 192 times.
 257 if (nb_samples) {
293 65 ret = try_push_frame(ctx, nb_samples);
294
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 65 times.
 65 if (ret < 0)
295 ✗ return ret;
296 }
297
298
2/2
✓ Branch 0 taken 416 times.
✓ Branch 1 taken 64 times.
 480 for (i = 0; i < ctx->nb_inputs; i++) {
299
2/2
✓ Branch 1 taken 139 times.
✓ Branch 2 taken 277 times.
 416 if (ff_inlink_queued_samples(ctx->inputs[i]))
300 139 continue;
301
302
2/2
✓ Branch 1 taken 1 times.
✓ Branch 2 taken 276 times.
 277 if (ff_inlink_acknowledge_status(ctx->inputs[i], &status, &pts)) {
303 1 ff_outlink_set_status(ctx->outputs[0], status, pts);
304 1 return 0;
305
2/2
✓ Branch 1 taken 192 times.
✓ Branch 2 taken 84 times.
 276 } else if (ff_outlink_frame_wanted(ctx->outputs[0])) {
306 192 ff_inlink_request_frame(ctx->inputs[i]);
307 192 return 0;
308 }
309 }
310
311 64 return 0;
312 }
313
314 2 static av_cold int init(AVFilterContext *ctx)
315 {
316 2 AMergeContext *s = ctx->priv;
317 int i, ret;
318
319 2 s->in = av_calloc(s->nb_inputs, sizeof(*s->in));
320
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 2 times.
 2 if (!s->in)
321 ✗ return AVERROR(ENOMEM);
322
2/2
✓ Branch 0 taken 4 times.
✓ Branch 1 taken 2 times.
 6 for (i = 0; i < s->nb_inputs; i++) {
323 4 char *name = av_asprintf("in%d", i);
324 4 AVFilterPad pad = {
325 .name = name,
326 .type = AVMEDIA_TYPE_AUDIO,
327 };
328
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 4 times.
 4 if (!name)
329 ✗ return AVERROR(ENOMEM);
330
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 4 times.
 4 if ((ret = ff_append_inpad_free_name(ctx, &pad)) < 0)
331 ✗ return ret;
332 }
333 2 return 0;
334 }
335
336 static const AVFilterPad amerge_outputs[] = {
337 {
338 .name = "default",
339 .type = AVMEDIA_TYPE_AUDIO,
340 .config_props = config_output,
341 },
342 };
343
344 const FFFilter ff_af_amerge = {
345 .p.name = "amerge",
346 .p.description = NULL_IF_CONFIG_SMALL("Merge two or more audio streams into "
347 "a single multi-channel stream."),
348 .p.inputs = NULL,
349 .p.priv_class = &amerge_class,
350 .p.flags = AVFILTER_FLAG_DYNAMIC_INPUTS,
351 .priv_size = sizeof(AMergeContext),
352 .init = init,
353 .uninit = uninit,
354 .activate = activate,
355 FILTER_OUTPUTS(amerge_outputs),
356 FILTER_QUERY_FUNC(query_formats),
357 };
358