2 * Copyright (c) 2012 Justin Ruggles <justin.ruggles@gmail.com>
4 * This file is part of Libav.
6 * Libav 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.
11 * Libav 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.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with Libav; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 #include "libavutil/libm.h"
24 #include "libavutil/samplefmt.h"
25 #include "avresample.h"
27 #include "audio_data.h"
28 #include "audio_mix.h"
30 static const char *coeff_type_names[] = { "q8", "q15", "flt" };
32 void ff_audio_mix_set_func(AudioMix *am, enum AVSampleFormat fmt,
33 enum AVMixCoeffType coeff_type, int in_channels,
34 int out_channels, int ptr_align, int samples_align,
35 const char *descr, void *mix_func)
37 if (fmt == am->fmt && coeff_type == am->coeff_type &&
38 ( in_channels == am->in_channels || in_channels == 0) &&
39 (out_channels == am->out_channels || out_channels == 0)) {
42 am->func_descr = descr;
43 am->ptr_align = ptr_align;
44 am->samples_align = samples_align;
45 if (ptr_align == 1 && samples_align == 1) {
46 am->mix_generic = mix_func;
47 am->func_descr_generic = descr;
49 am->has_optimized_func = 1;
53 snprintf(chan_str, sizeof(chan_str), "[%d to %d] ",
54 in_channels, out_channels);
56 snprintf(chan_str, sizeof(chan_str), "[%d to any] ",
58 } else if (out_channels) {
59 snprintf(chan_str, sizeof(chan_str), "[any to %d] ",
62 av_log(am->avr, AV_LOG_DEBUG, "audio_mix: found function: [fmt=%s] "
63 "[c=%s] %s(%s)\n", av_get_sample_fmt_name(fmt),
64 coeff_type_names[coeff_type],
65 (in_channels || out_channels) ? chan_str : "", descr);
69 #define MIX_FUNC_NAME(fmt, cfmt) mix_any_ ## fmt ##_## cfmt ##_c
71 #define MIX_FUNC_GENERIC(fmt, cfmt, stype, ctype, sumtype, expr) \
72 static void MIX_FUNC_NAME(fmt, cfmt)(stype **samples, ctype **matrix, \
73 int len, int out_ch, int in_ch) \
76 stype temp[AVRESAMPLE_MAX_CHANNELS]; \
77 for (i = 0; i < len; i++) { \
78 for (out = 0; out < out_ch; out++) { \
80 for (in = 0; in < in_ch; in++) \
81 sum += samples[in][i] * matrix[out][in]; \
84 for (out = 0; out < out_ch; out++) \
85 samples[out][i] = temp[out]; \
89 MIX_FUNC_GENERIC(FLTP, FLT, float, float, float, sum)
90 MIX_FUNC_GENERIC(S16P, FLT, int16_t, float, float, av_clip_int16(lrintf(sum)))
91 MIX_FUNC_GENERIC(S16P, Q15, int16_t, int32_t, int64_t, av_clip_int16(sum >> 15))
92 MIX_FUNC_GENERIC(S16P, Q8, int16_t, int16_t, int32_t, av_clip_int16(sum >> 8))
94 /* TODO: templatize the channel-specific C functions */
96 static void mix_2_to_1_fltp_flt_c(float **samples, float **matrix, int len,
97 int out_ch, int in_ch)
99 float *src0 = samples[0];
100 float *src1 = samples[1];
102 float m0 = matrix[0][0];
103 float m1 = matrix[0][1];
106 *dst++ = *src0++ * m0 + *src1++ * m1;
107 *dst++ = *src0++ * m0 + *src1++ * m1;
108 *dst++ = *src0++ * m0 + *src1++ * m1;
109 *dst++ = *src0++ * m0 + *src1++ * m1;
113 *dst++ = *src0++ * m0 + *src1++ * m1;
118 static void mix_2_to_1_s16p_flt_c(int16_t **samples, float **matrix, int len,
119 int out_ch, int in_ch)
121 int16_t *src0 = samples[0];
122 int16_t *src1 = samples[1];
124 float m0 = matrix[0][0];
125 float m1 = matrix[0][1];
128 *dst++ = av_clip_int16(lrintf(*src0++ * m0 + *src1++ * m1));
129 *dst++ = av_clip_int16(lrintf(*src0++ * m0 + *src1++ * m1));
130 *dst++ = av_clip_int16(lrintf(*src0++ * m0 + *src1++ * m1));
131 *dst++ = av_clip_int16(lrintf(*src0++ * m0 + *src1++ * m1));
135 *dst++ = av_clip_int16(lrintf(*src0++ * m0 + *src1++ * m1));
140 static void mix_2_to_1_s16p_q8_c(int16_t **samples, int16_t **matrix, int len,
141 int out_ch, int in_ch)
143 int16_t *src0 = samples[0];
144 int16_t *src1 = samples[1];
146 int16_t m0 = matrix[0][0];
147 int16_t m1 = matrix[0][1];
150 *dst++ = (*src0++ * m0 + *src1++ * m1) >> 8;
151 *dst++ = (*src0++ * m0 + *src1++ * m1) >> 8;
152 *dst++ = (*src0++ * m0 + *src1++ * m1) >> 8;
153 *dst++ = (*src0++ * m0 + *src1++ * m1) >> 8;
157 *dst++ = (*src0++ * m0 + *src1++ * m1) >> 8;
162 static void mix_1_to_2_fltp_flt_c(float **samples, float **matrix, int len,
163 int out_ch, int in_ch)
166 float *dst0 = samples[0];
167 float *dst1 = samples[1];
169 float m0 = matrix[0][0];
170 float m1 = matrix[1][0];
195 static void mix_6_to_2_fltp_flt_c(float **samples, float **matrix, int len,
196 int out_ch, int in_ch)
199 float *src0 = samples[0];
200 float *src1 = samples[1];
201 float *src2 = samples[2];
202 float *src3 = samples[3];
203 float *src4 = samples[4];
204 float *src5 = samples[5];
207 float *m0 = matrix[0];
208 float *m1 = matrix[1];
213 *dst0++ = v0 * m0[0] +
219 *dst1++ = v0 * m1[0] +
229 static void mix_2_to_6_fltp_flt_c(float **samples, float **matrix, int len,
230 int out_ch, int in_ch)
233 float *dst0 = samples[0];
234 float *dst1 = samples[1];
235 float *dst2 = samples[2];
236 float *dst3 = samples[3];
237 float *dst4 = samples[4];
238 float *dst5 = samples[5];
245 *dst0++ = v0 * matrix[0][0] + v1 * matrix[0][1];
246 *dst1++ = v0 * matrix[1][0] + v1 * matrix[1][1];
247 *dst2++ = v0 * matrix[2][0] + v1 * matrix[2][1];
248 *dst3++ = v0 * matrix[3][0] + v1 * matrix[3][1];
249 *dst4++ = v0 * matrix[4][0] + v1 * matrix[4][1];
250 *dst5++ = v0 * matrix[5][0] + v1 * matrix[5][1];
255 static int mix_function_init(AudioMix *am)
257 /* any-to-any C versions */
259 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_FLTP, AV_MIX_COEFF_TYPE_FLT,
260 0, 0, 1, 1, "C", MIX_FUNC_NAME(FLTP, FLT));
262 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_S16P, AV_MIX_COEFF_TYPE_FLT,
263 0, 0, 1, 1, "C", MIX_FUNC_NAME(S16P, FLT));
265 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_S16P, AV_MIX_COEFF_TYPE_Q15,
266 0, 0, 1, 1, "C", MIX_FUNC_NAME(S16P, Q15));
268 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_S16P, AV_MIX_COEFF_TYPE_Q8,
269 0, 0, 1, 1, "C", MIX_FUNC_NAME(S16P, Q8));
271 /* channel-specific C versions */
273 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_FLTP, AV_MIX_COEFF_TYPE_FLT,
274 2, 1, 1, 1, "C", mix_2_to_1_fltp_flt_c);
276 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_S16P, AV_MIX_COEFF_TYPE_FLT,
277 2, 1, 1, 1, "C", mix_2_to_1_s16p_flt_c);
279 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_S16P, AV_MIX_COEFF_TYPE_Q8,
280 2, 1, 1, 1, "C", mix_2_to_1_s16p_q8_c);
282 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_FLTP, AV_MIX_COEFF_TYPE_FLT,
283 1, 2, 1, 1, "C", mix_1_to_2_fltp_flt_c);
285 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_FLTP, AV_MIX_COEFF_TYPE_FLT,
286 6, 2, 1, 1, "C", mix_6_to_2_fltp_flt_c);
288 ff_audio_mix_set_func(am, AV_SAMPLE_FMT_FLTP, AV_MIX_COEFF_TYPE_FLT,
289 2, 6, 1, 1, "C", mix_2_to_6_fltp_flt_c);
292 ff_audio_mix_init_x86(am);
295 av_log(am->avr, AV_LOG_ERROR, "audio_mix: NO FUNCTION FOUND: [fmt=%s] "
296 "[c=%s] [%d to %d]\n", av_get_sample_fmt_name(am->fmt),
297 coeff_type_names[am->coeff_type], am->in_channels,
299 return AVERROR_PATCHWELCOME;
304 int ff_audio_mix_init(AVAudioResampleContext *avr)
308 if (avr->internal_sample_fmt != AV_SAMPLE_FMT_S16P &&
309 avr->internal_sample_fmt != AV_SAMPLE_FMT_FLTP) {
310 av_log(avr, AV_LOG_ERROR, "Unsupported internal format for "
312 av_get_sample_fmt_name(avr->internal_sample_fmt));
313 return AVERROR(EINVAL);
316 /* build matrix if the user did not already set one */
317 if (!avr->am->matrix) {
319 char in_layout_name[128];
320 char out_layout_name[128];
321 double *matrix_dbl = av_mallocz(avr->out_channels * avr->in_channels *
322 sizeof(*matrix_dbl));
324 return AVERROR(ENOMEM);
326 ret = avresample_build_matrix(avr->in_channel_layout,
327 avr->out_channel_layout,
328 avr->center_mix_level,
329 avr->surround_mix_level,
330 avr->lfe_mix_level, 1, matrix_dbl,
332 avr->matrix_encoding);
338 av_get_channel_layout_string(in_layout_name, sizeof(in_layout_name),
339 avr->in_channels, avr->in_channel_layout);
340 av_get_channel_layout_string(out_layout_name, sizeof(out_layout_name),
341 avr->out_channels, avr->out_channel_layout);
342 av_log(avr, AV_LOG_DEBUG, "audio_mix: %s to %s\n",
343 in_layout_name, out_layout_name);
344 for (i = 0; i < avr->out_channels; i++) {
345 for (j = 0; j < avr->in_channels; j++) {
346 av_log(avr, AV_LOG_DEBUG, " %0.3f ",
347 matrix_dbl[i * avr->in_channels + j]);
349 av_log(avr, AV_LOG_DEBUG, "\n");
352 ret = avresample_set_matrix(avr, matrix_dbl, avr->in_channels);
360 avr->am->fmt = avr->internal_sample_fmt;
361 avr->am->coeff_type = avr->mix_coeff_type;
362 avr->am->in_layout = avr->in_channel_layout;
363 avr->am->out_layout = avr->out_channel_layout;
364 avr->am->in_channels = avr->in_channels;
365 avr->am->out_channels = avr->out_channels;
367 ret = mix_function_init(avr->am);
374 void ff_audio_mix_close(AudioMix *am)
379 av_free(am->matrix[0]);
382 memset(am->matrix_q8, 0, sizeof(am->matrix_q8 ));
383 memset(am->matrix_q15, 0, sizeof(am->matrix_q15));
384 memset(am->matrix_flt, 0, sizeof(am->matrix_flt));
387 int ff_audio_mix(AudioMix *am, AudioData *src)
390 int len = src->nb_samples;
392 /* determine whether to use the optimized function based on pointer and
393 samples alignment in both the input and output */
394 if (am->has_optimized_func) {
395 int aligned_len = FFALIGN(len, am->samples_align);
396 if (!(src->ptr_align % am->ptr_align) &&
397 src->samples_align >= aligned_len) {
402 av_dlog(am->avr, "audio_mix: %d samples - %d to %d channels (%s)\n",
403 src->nb_samples, am->in_channels, am->out_channels,
404 use_generic ? am->func_descr_generic : am->func_descr);
407 am->mix_generic(src->data, am->matrix, len, am->out_channels,
410 am->mix(src->data, am->matrix, len, am->out_channels, am->in_channels);
412 ff_audio_data_set_channels(src, am->out_channels);