blob: 0187d0f9e0bbbb1d28e0c5eec6575e8f58a6b984
1 | /* |
2 | * Copyright (c) 2012 Justin Ruggles <justin.ruggles@gmail.com> |
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 | #ifndef AVRESAMPLE_AUDIO_MIX_H |
22 | #define AVRESAMPLE_AUDIO_MIX_H |
23 | |
24 | #include <stdint.h> |
25 | |
26 | #include "libavutil/samplefmt.h" |
27 | #include "avresample.h" |
28 | #include "internal.h" |
29 | #include "audio_data.h" |
30 | |
31 | typedef void (mix_func)(uint8_t **src, void **matrix, int len, int out_ch, |
32 | int in_ch); |
33 | |
34 | /** |
35 | * Set mixing function if the parameters match. |
36 | * |
37 | * This compares the parameters of the mixing function to the parameters in the |
38 | * AudioMix context. If the parameters do not match, no changes are made to the |
39 | * active functions. If the parameters do match and the alignment is not |
40 | * constrained, the function is set as the generic mixing function. If the |
41 | * parameters match and the alignment is constrained, the function is set as |
42 | * the optimized mixing function. |
43 | * |
44 | * @param am AudioMix context |
45 | * @param fmt input/output sample format |
46 | * @param coeff_type mixing coefficient type |
47 | * @param in_channels number of input channels, or 0 for any number of channels |
48 | * @param out_channels number of output channels, or 0 for any number of channels |
49 | * @param ptr_align buffer pointer alignment, in bytes |
50 | * @param samples_align buffer size alignment, in samples |
51 | * @param descr function type description (e.g. "C" or "SSE") |
52 | * @param mix_func mixing function pointer |
53 | */ |
54 | void ff_audio_mix_set_func(AudioMix *am, enum AVSampleFormat fmt, |
55 | enum AVMixCoeffType coeff_type, int in_channels, |
56 | int out_channels, int ptr_align, int samples_align, |
57 | const char *descr, void *mix_func); |
58 | |
59 | /** |
60 | * Allocate and initialize an AudioMix context. |
61 | * |
62 | * The parameters in the AVAudioResampleContext are used to initialize the |
63 | * AudioMix context. |
64 | * |
65 | * @param avr AVAudioResampleContext |
66 | * @return newly-allocated AudioMix context. |
67 | */ |
68 | AudioMix *ff_audio_mix_alloc(AVAudioResampleContext *avr); |
69 | |
70 | /** |
71 | * Free an AudioMix context. |
72 | */ |
73 | void ff_audio_mix_free(AudioMix **am); |
74 | |
75 | /** |
76 | * Apply channel mixing to audio data using the current mixing matrix. |
77 | */ |
78 | int ff_audio_mix(AudioMix *am, AudioData *src); |
79 | |
80 | /** |
81 | * Get the current mixing matrix. |
82 | */ |
83 | int ff_audio_mix_get_matrix(AudioMix *am, double *matrix, int stride); |
84 | |
85 | /** |
86 | * Set the current mixing matrix. |
87 | */ |
88 | int ff_audio_mix_set_matrix(AudioMix *am, const double *matrix, int stride); |
89 | |
90 | /* arch-specific initialization functions */ |
91 | |
92 | void ff_audio_mix_init_x86(AudioMix *am); |
93 | |
94 | #endif /* AVRESAMPLE_AUDIO_MIX_H */ |
95 |