1 /*
2 * QEMU Audio subsystem header
3 *
4 * Copyright (c) 2003-2005 Vassili Karpov (malc)
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
23 */
24 #ifndef QEMU_AUDIO_INT_H
25 #define QEMU_AUDIO_INT_H
26
27 #include "audio/audio.h"
28
29 #ifdef CONFIG_COREAUDIO
30 #define FLOAT_MIXENG
31 /* #define RECIPROCAL */
32 #endif
33 #include "mixeng.h"
34
35 struct audio_pcm_ops;
36
37 typedef enum {
38 AUD_OPT_INT,
39 AUD_OPT_FMT,
40 AUD_OPT_STR,
41 AUD_OPT_BOOL
42 } audio_option_tag_e;
43
44 struct audio_option {
45 const char *name;
46 audio_option_tag_e tag;
47 void *valp;
48 const char *descr;
49 int *overriddenp;
50 int overridden;
51 };
52
53 struct audio_callback {
54 void *opaque;
55 audio_callback_fn_t fn;
56 };
57
58 struct audio_pcm_info {
59 int bits;
60 int sign;
61 int freq;
62 int nchannels;
63 int align;
64 int shift;
65 int bytes_per_second;
66 int swap_endianness;
67 };
68
69 typedef struct SWVoiceCap SWVoiceCap;
70
71 typedef struct HWVoiceOut {
72 int enabled;
73 int pending_disable;
74 struct audio_pcm_info info;
75
76 f_sample *clip;
77
78 int rpos;
79 uint64_t ts_helper;
80
81 st_sample_t *mix_buf;
82
83 int samples;
84 LIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
85 LIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
86 struct audio_pcm_ops *pcm_ops;
87 LIST_ENTRY (HWVoiceOut) entries;
88 } HWVoiceOut;
89
90 typedef struct HWVoiceIn {
91 int enabled;
92 struct audio_pcm_info info;
93
94 t_sample *conv;
95
96 int wpos;
97 int total_samples_captured;
98 uint64_t ts_helper;
99
100 st_sample_t *conv_buf;
101
102 int samples;
103 LIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
104 struct audio_pcm_ops *pcm_ops;
105 LIST_ENTRY (HWVoiceIn) entries;
106 } HWVoiceIn;
107
108 struct SWVoiceOut {
109 struct audio_pcm_info info;
110 t_sample *conv;
111 int64_t ratio;
112 st_sample_t *buf;
113 void *rate;
114 int total_hw_samples_mixed;
115 int active;
116 int empty;
117 HWVoiceOut *hw;
118 char *name;
119 volume_t vol;
120 struct audio_callback callback;
121 LIST_ENTRY (SWVoiceOut) entries;
122 };
123
124 struct SWVoiceIn {
125 int active;
126 struct audio_pcm_info info;
127 int64_t ratio;
128 void *rate;
129 int total_hw_samples_acquired;
130 st_sample_t *buf;
131 f_sample *clip;
132 HWVoiceIn *hw;
133 char *name;
134 volume_t vol;
135 struct audio_callback callback;
136 LIST_ENTRY (SWVoiceIn) entries;
137 };
138
139 struct audio_driver {
140 const char *name;
141 const char *descr;
142 struct audio_option *options;
143 void *(*init) (void);
144 void (*fini) (void *);
145 struct audio_pcm_ops *pcm_ops;
146 int can_be_default;
147 int max_voices_out;
148 int max_voices_in;
149 int voice_size_out;
150 int voice_size_in;
151 };
152
153 struct audio_pcm_ops {
154 int (*init_out)(HWVoiceOut *hw, audsettings_t *as);
155 void (*fini_out)(HWVoiceOut *hw);
156 int (*run_out) (HWVoiceOut *hw);
157 int (*write) (SWVoiceOut *sw, void *buf, int size);
158 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
159
160 int (*init_in) (HWVoiceIn *hw, audsettings_t *as);
161 void (*fini_in) (HWVoiceIn *hw);
162 int (*run_in) (HWVoiceIn *hw);
163 int (*read) (SWVoiceIn *sw, void *buf, int size);
164 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...);
165 };
166
167 struct capture_callback {
168 struct audio_capture_ops ops;
169 void *opaque;
170 LIST_ENTRY (capture_callback) entries;
171 };
172
173 struct CaptureVoiceOut {
174 HWVoiceOut hw;
175 void *buf;
176 LIST_HEAD (cb_listhead, capture_callback) cb_head;
177 LIST_ENTRY (CaptureVoiceOut) entries;
178 };
179
180 struct SWVoiceCap {
181 SWVoiceOut sw;
182 CaptureVoiceOut *cap;
183 LIST_ENTRY (SWVoiceCap) entries;
184 };
185
186 struct AudioState {
187 struct audio_driver* drv_in;
188 void* drv_in_opaque;
189 struct audio_driver* drv_out;
190 void* drv_out_opaque;
191
192 QEMUTimer *ts;
193 LIST_HEAD (card_listhead, QEMUSoundCard) card_head;
194 LIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
195 LIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
196 LIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
197 int nb_hw_voices_out;
198 int nb_hw_voices_in;
199 };
200
201 extern struct audio_driver no_audio_driver;
202 extern struct audio_driver oss_audio_driver;
203 extern struct audio_driver sdl_audio_driver;
204 extern struct audio_driver win_audio_driver;
205 extern struct audio_driver wav_audio_driver;
206 extern struct audio_driver fmod_audio_driver;
207 extern struct audio_driver esd_audio_driver;
208 extern struct audio_driver alsa_audio_driver;
209 extern struct audio_driver coreaudio_audio_driver;
210 extern struct audio_driver dsound_audio_driver;
211 extern struct audio_driver esd_audio_driver;
212 extern volume_t nominal_volume;
213
214 void audio_pcm_init_info (struct audio_pcm_info *info, audsettings_t *as);
215 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
216
217 int audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len);
218 int audio_pcm_hw_get_live_in (HWVoiceIn *hw);
219
220 int audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len);
221 int audio_pcm_hw_get_live_out (HWVoiceOut *hw);
222 int audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live);
223
224 int audio_bug (const char *funcname, int cond);
225 void *audio_calloc (const char *funcname, int nmemb, size_t size);
226
227 #define VOICE_ENABLE 1
228 #define VOICE_DISABLE 2
229
audio_ring_dist(int dst,int src,int len)230 static inline int audio_ring_dist (int dst, int src, int len)
231 {
232 return (dst >= src) ? (dst - src) : (len - src + dst);
233 }
234
235 #if defined __GNUC__
236 #define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2)))
237 #define INIT_FIELD(f) . f
238 #define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m)))
239 #else
240 #define GCC_ATTR /**/
241 #define INIT_FIELD(f) /**/
242 #define GCC_FMT_ATTR(n, m)
243 #endif
244
dolog(const char * fmt,...)245 static void GCC_ATTR dolog (const char *fmt, ...)
246 {
247 va_list ap;
248
249 va_start (ap, fmt);
250 AUD_vlog (AUDIO_CAP, fmt, ap);
251 va_end (ap);
252 }
253
254 #ifdef DEBUG
ldebug(const char * fmt,...)255 static void GCC_ATTR ldebug (const char *fmt, ...)
256 {
257 va_list ap;
258
259 va_start (ap, fmt);
260 AUD_vlog (AUDIO_CAP, fmt, ap);
261 va_end (ap);
262 }
263 #else
264 #if defined NDEBUG && defined __GNUC__
265 #define ldebug(...)
266 #elif defined NDEBUG && defined _MSC_VER
267 #define ldebug __noop
268 #else
ldebug(const char * fmt,...)269 static void GCC_ATTR ldebug (const char *fmt, ...)
270 {
271 (void) fmt;
272 }
273 #endif
274 #endif
275
276 #undef GCC_ATTR
277
278 #define AUDIO_STRINGIFY_(n) #n
279 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
280
281 #if defined _MSC_VER || defined __GNUC__
282 #define AUDIO_FUNC __FUNCTION__
283 #else
284 #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__)
285 #endif
286
287 #endif /* audio_int.h */
288