Home | History | Annotate | Download | only in audio
      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 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     struct st_sample *mix_buf;
     82 
     83     int samples;
     84     QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
     85     QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
     86     struct audio_pcm_ops *pcm_ops;
     87     QLIST_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     struct st_sample *conv_buf;
    101 
    102     int samples;
    103     QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
    104     struct audio_pcm_ops *pcm_ops;
    105     QLIST_ENTRY (HWVoiceIn) entries;
    106 } HWVoiceIn;
    107 
    108 struct SWVoiceOut {
    109     QEMUSoundCard *card;
    110     struct audio_pcm_info info;
    111     t_sample *conv;
    112     int64_t ratio;
    113     struct st_sample *buf;
    114     void *rate;
    115     int total_hw_samples_mixed;
    116     int active;
    117     int empty;
    118     HWVoiceOut *hw;
    119     char *name;
    120     struct mixeng_volume vol;
    121     struct audio_callback callback;
    122     QLIST_ENTRY (SWVoiceOut) entries;
    123 };
    124 
    125 struct SWVoiceIn {
    126     QEMUSoundCard *card;
    127     int active;
    128     struct audio_pcm_info info;
    129     int64_t ratio;
    130     void *rate;
    131     int total_hw_samples_acquired;
    132     struct st_sample *buf;
    133     f_sample *clip;
    134     HWVoiceIn *hw;
    135     char *name;
    136     struct mixeng_volume vol;
    137     struct audio_callback callback;
    138     QLIST_ENTRY (SWVoiceIn) entries;
    139 };
    140 
    141 struct audio_driver {
    142     const char *name;
    143     const char *descr;
    144     struct audio_option *options;
    145     void *(*init) (void);
    146     void (*fini) (void *);
    147     struct audio_pcm_ops *pcm_ops;
    148     int can_be_default;
    149     int max_voices_out;
    150     int max_voices_in;
    151     int voice_size_out;
    152     int voice_size_in;
    153 };
    154 
    155 struct audio_pcm_ops {
    156     int  (*init_out)(HWVoiceOut *hw, struct audsettings *as);
    157     void (*fini_out)(HWVoiceOut *hw);
    158     int  (*run_out) (HWVoiceOut *hw);
    159     int  (*write)   (SWVoiceOut *sw, void *buf, int size);
    160     int  (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
    161 
    162     int  (*init_in) (HWVoiceIn *hw, struct audsettings *as);
    163     void (*fini_in) (HWVoiceIn *hw);
    164     int  (*run_in)  (HWVoiceIn *hw);
    165     int  (*read)    (SWVoiceIn *sw, void *buf, int size);
    166     int  (*ctl_in)  (HWVoiceIn *hw, int cmd, ...);
    167 };
    168 
    169 struct capture_callback {
    170     struct audio_capture_ops ops;
    171     void *opaque;
    172     QLIST_ENTRY (capture_callback) entries;
    173 };
    174 
    175 struct CaptureVoiceOut {
    176     HWVoiceOut hw;
    177     void *buf;
    178     QLIST_HEAD (cb_listhead, capture_callback) cb_head;
    179     QLIST_ENTRY (CaptureVoiceOut) entries;
    180 };
    181 
    182 struct SWVoiceCap {
    183     SWVoiceOut sw;
    184     CaptureVoiceOut *cap;
    185     QLIST_ENTRY (SWVoiceCap) entries;
    186 };
    187 
    188 struct AudioState {
    189     struct audio_driver*  drv_in;
    190     void*                 drv_in_opaque;
    191     struct audio_driver*  drv_out;
    192     void*                 drv_out_opaque;
    193 
    194     QEMUTimer *ts;
    195     QLIST_HEAD (card_listhead, QEMUSoundCard) card_head;
    196     QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
    197     QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
    198     QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
    199     int nb_hw_voices_out;
    200     int nb_hw_voices_in;
    201     int vm_running;
    202 };
    203 
    204 extern struct audio_driver no_audio_driver;
    205 extern struct audio_driver oss_audio_driver;
    206 extern struct audio_driver win_audio_driver;
    207 extern struct audio_driver wav_audio_driver;
    208 extern struct audio_driver fmod_audio_driver;
    209 extern struct audio_driver alsa_audio_driver;
    210 extern struct audio_driver coreaudio_audio_driver;
    211 extern struct audio_driver dsound_audio_driver;
    212 extern struct audio_driver esd_audio_driver;
    213 extern struct audio_driver pa_audio_driver;
    214 extern struct mixeng_volume nominal_volume;
    215 
    216 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as);
    217 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
    218 
    219 int  audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len);
    220 int  audio_pcm_hw_get_live_in (HWVoiceIn *hw);
    221 
    222 int  audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len);
    223 int  audio_pcm_hw_get_live_out (HWVoiceOut *hw);
    224 int  audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live);
    225 
    226 int audio_bug (const char *funcname, int cond);
    227 void *audio_calloc (const char *funcname, int nmemb, size_t size);
    228 
    229 #define VOICE_ENABLE 1
    230 #define VOICE_DISABLE 2
    231 
    232 static inline int audio_ring_dist (int dst, int src, int len)
    233 {
    234     return (dst >= src) ? (dst - src) : (len - src + dst);
    235 }
    236 
    237 #if defined __GNUC__
    238 #define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2)))
    239 #define INIT_FIELD(f) . f
    240 #define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m)))
    241 #else
    242 #define GCC_ATTR /**/
    243 #define INIT_FIELD(f) /**/
    244 #define GCC_FMT_ATTR(n, m)
    245 #endif
    246 
    247 static void GCC_ATTR dolog (const char *fmt, ...)
    248 {
    249     va_list ap;
    250 
    251     va_start (ap, fmt);
    252     AUD_vlog (AUDIO_CAP, fmt, ap);
    253     va_end (ap);
    254 }
    255 
    256 #ifdef DEBUG
    257 static void GCC_ATTR ldebug (const char *fmt, ...)
    258 {
    259     va_list ap;
    260 
    261     va_start (ap, fmt);
    262     AUD_vlog (AUDIO_CAP, fmt, ap);
    263     va_end (ap);
    264 }
    265 #else
    266 #if defined NDEBUG && defined __GNUC__
    267 #define ldebug(...)
    268 #elif defined NDEBUG && defined _MSC_VER
    269 #define ldebug __noop
    270 #else
    271 static void GCC_ATTR ldebug (const char *fmt, ...)
    272 {
    273     (void) fmt;
    274 }
    275 #endif
    276 #endif
    277 
    278 #undef GCC_ATTR
    279 
    280 #define AUDIO_STRINGIFY_(n) #n
    281 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
    282 
    283 #if defined _MSC_VER || defined __GNUC__
    284 #define AUDIO_FUNC __FUNCTION__
    285 #else
    286 #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__)
    287 #endif
    288 
    289 #endif /* audio_int.h */
    290