qemu/audio/audio_int.h
<<
>>
Prefs
   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#ifdef CONFIG_COREAUDIO
  28#define FLOAT_MIXENG
  29/* #define RECIPROCAL */
  30#endif
  31#include "mixeng.h"
  32
  33struct audio_pcm_ops;
  34
  35typedef enum {
  36    AUD_OPT_INT,
  37    AUD_OPT_FMT,
  38    AUD_OPT_STR,
  39    AUD_OPT_BOOL
  40} audio_option_tag_e;
  41
  42struct audio_option {
  43    const char *name;
  44    audio_option_tag_e tag;
  45    void *valp;
  46    const char *descr;
  47    int *overriddenp;
  48    int overridden;
  49};
  50
  51struct audio_callback {
  52    void *opaque;
  53    audio_callback_fn_t fn;
  54};
  55
  56struct audio_pcm_info {
  57    int bits;
  58    int sign;
  59    int freq;
  60    int nchannels;
  61    int align;
  62    int shift;
  63    int bytes_per_second;
  64    int swap_endianness;
  65};
  66
  67typedef struct SWVoiceCap SWVoiceCap;
  68
  69typedef struct HWVoiceOut {
  70    int enabled;
  71    int pending_disable;
  72    struct audio_pcm_info info;
  73
  74    f_sample *clip;
  75
  76    int rpos;
  77    uint64_t ts_helper;
  78
  79    struct st_sample *mix_buf;
  80
  81    int samples;
  82    LIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
  83    LIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
  84    struct audio_pcm_ops *pcm_ops;
  85    LIST_ENTRY (HWVoiceOut) entries;
  86} HWVoiceOut;
  87
  88typedef struct HWVoiceIn {
  89    int enabled;
  90    struct audio_pcm_info info;
  91
  92    t_sample *conv;
  93
  94    int wpos;
  95    int total_samples_captured;
  96    uint64_t ts_helper;
  97
  98    struct st_sample *conv_buf;
  99
 100    int samples;
 101    LIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
 102    struct audio_pcm_ops *pcm_ops;
 103    LIST_ENTRY (HWVoiceIn) entries;
 104} HWVoiceIn;
 105
 106struct SWVoiceOut {
 107    struct audio_pcm_info info;
 108    t_sample *conv;
 109    int64_t ratio;
 110    struct st_sample *buf;
 111    void *rate;
 112    int total_hw_samples_mixed;
 113    int active;
 114    int empty;
 115    HWVoiceOut *hw;
 116    char *name;
 117    struct mixeng_volume vol;
 118    struct audio_callback callback;
 119    LIST_ENTRY (SWVoiceOut) entries;
 120};
 121
 122struct SWVoiceIn {
 123    int active;
 124    struct audio_pcm_info info;
 125    int64_t ratio;
 126    void *rate;
 127    int total_hw_samples_acquired;
 128    struct st_sample *buf;
 129    f_sample *clip;
 130    HWVoiceIn *hw;
 131    char *name;
 132    struct mixeng_volume vol;
 133    struct audio_callback callback;
 134    LIST_ENTRY (SWVoiceIn) entries;
 135};
 136
 137struct audio_driver {
 138    const char *name;
 139    const char *descr;
 140    struct audio_option *options;
 141    void *(*init) (void);
 142    void (*fini) (void *);
 143    struct audio_pcm_ops *pcm_ops;
 144    int can_be_default;
 145    int max_voices_out;
 146    int max_voices_in;
 147    int voice_size_out;
 148    int voice_size_in;
 149};
 150
 151struct audio_pcm_ops {
 152    int  (*init_out)(HWVoiceOut *hw, struct audsettings *as);
 153    void (*fini_out)(HWVoiceOut *hw);
 154    int  (*run_out) (HWVoiceOut *hw);
 155    int  (*write)   (SWVoiceOut *sw, void *buf, int size);
 156    int  (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
 157
 158    int  (*init_in) (HWVoiceIn *hw, struct audsettings *as);
 159    void (*fini_in) (HWVoiceIn *hw);
 160    int  (*run_in)  (HWVoiceIn *hw);
 161    int  (*read)    (SWVoiceIn *sw, void *buf, int size);
 162    int  (*ctl_in)  (HWVoiceIn *hw, int cmd, ...);
 163};
 164
 165struct capture_callback {
 166    struct audio_capture_ops ops;
 167    void *opaque;
 168    LIST_ENTRY (capture_callback) entries;
 169};
 170
 171struct CaptureVoiceOut {
 172    HWVoiceOut hw;
 173    void *buf;
 174    LIST_HEAD (cb_listhead, capture_callback) cb_head;
 175    LIST_ENTRY (CaptureVoiceOut) entries;
 176};
 177
 178struct SWVoiceCap {
 179    SWVoiceOut sw;
 180    CaptureVoiceOut *cap;
 181    LIST_ENTRY (SWVoiceCap) entries;
 182};
 183
 184struct AudioState {
 185    struct audio_driver *drv;
 186    void *drv_opaque;
 187
 188    QEMUTimer *ts;
 189    LIST_HEAD (card_listhead, QEMUSoundCard) card_head;
 190    LIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
 191    LIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
 192    LIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
 193    int nb_hw_voices_out;
 194    int nb_hw_voices_in;
 195    int vm_running;
 196};
 197
 198extern struct audio_driver no_audio_driver;
 199extern struct audio_driver oss_audio_driver;
 200extern struct audio_driver sdl_audio_driver;
 201extern struct audio_driver wav_audio_driver;
 202extern struct audio_driver fmod_audio_driver;
 203extern struct audio_driver alsa_audio_driver;
 204extern struct audio_driver coreaudio_audio_driver;
 205extern struct audio_driver dsound_audio_driver;
 206extern struct audio_driver esd_audio_driver;
 207extern struct audio_driver pa_audio_driver;
 208extern struct mixeng_volume nominal_volume;
 209
 210void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as);
 211void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
 212
 213int  audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len);
 214int  audio_pcm_hw_get_live_in (HWVoiceIn *hw);
 215
 216int  audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len);
 217int  audio_pcm_hw_get_live_out (HWVoiceOut *hw);
 218int  audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live);
 219
 220int audio_bug (const char *funcname, int cond);
 221void *audio_calloc (const char *funcname, int nmemb, size_t size);
 222
 223#define VOICE_ENABLE 1
 224#define VOICE_DISABLE 2
 225
 226static inline int audio_ring_dist (int dst, int src, int len)
 227{
 228    return (dst >= src) ? (dst - src) : (len - src + dst);
 229}
 230
 231#if defined __GNUC__
 232#define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2)))
 233#define INIT_FIELD(f) . f
 234#define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m)))
 235#else
 236#define GCC_ATTR /**/
 237#define INIT_FIELD(f) /**/
 238#define GCC_FMT_ATTR(n, m)
 239#endif
 240
 241static void GCC_ATTR dolog (const char *fmt, ...)
 242{
 243    va_list ap;
 244
 245    va_start (ap, fmt);
 246    AUD_vlog (AUDIO_CAP, fmt, ap);
 247    va_end (ap);
 248}
 249
 250#ifdef DEBUG
 251static void GCC_ATTR ldebug (const char *fmt, ...)
 252{
 253    va_list ap;
 254
 255    va_start (ap, fmt);
 256    AUD_vlog (AUDIO_CAP, fmt, ap);
 257    va_end (ap);
 258}
 259#else
 260#if defined NDEBUG && defined __GNUC__
 261#define ldebug(...)
 262#elif defined NDEBUG && defined _MSC_VER
 263#define ldebug __noop
 264#else
 265static void GCC_ATTR ldebug (const char *fmt, ...)
 266{
 267    (void) fmt;
 268}
 269#endif
 270#endif
 271
 272#undef GCC_ATTR
 273
 274#define AUDIO_STRINGIFY_(n) #n
 275#define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
 276
 277#if defined _MSC_VER || defined __GNUC__
 278#define AUDIO_FUNC __FUNCTION__
 279#else
 280#define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__)
 281#endif
 282
 283#endif /* audio_int.h */
 284