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: 
   33: struct audio_pcm_ops;
   34: 
   35: typedef enum {
   36:     AUD_OPT_INT,
   37:     AUD_OPT_FMT,
   38:     AUD_OPT_STR,
   39:     AUD_OPT_BOOL
   40: } audio_option_tag_e;
   41: 
   42: struct 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: 
   51: struct audio_callback {
   52:     void *opaque;
   53:     audio_callback_fn_t fn;
   54: };
   55: 
   56: struct 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: 
   67: typedef struct SWVoiceCap SWVoiceCap;
   68: 
   69: typedef 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:     st_sample_t *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: 
   88: typedef 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:     st_sample_t *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: 
  106: struct SWVoiceOut {
  107:     struct audio_pcm_info info;
  108:     t_sample *conv;
  109:     int64_t ratio;
  110:     st_sample_t *buf;
  111:     void *rate;
  112:     int total_hw_samples_mixed;
  113:     int active;
  114:     int empty;
  115:     HWVoiceOut *hw;
  116:     char *name;
  117:     volume_t vol;
  118:     struct audio_callback callback;
  119:     LIST_ENTRY (SWVoiceOut) entries;
  120: };
  121: 
  122: struct SWVoiceIn {
  123:     int active;
  124:     struct audio_pcm_info info;
  125:     int64_t ratio;
  126:     void *rate;
  127:     int total_hw_samples_acquired;
  128:     st_sample_t *buf;
  129:     f_sample *clip;
  130:     HWVoiceIn *hw;
  131:     char *name;
  132:     volume_t vol;
  133:     struct audio_callback callback;
  134:     LIST_ENTRY (SWVoiceIn) entries;
  135: };
  136: 
  137: struct 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: 
  151: struct audio_pcm_ops {
  152:     int  (*init_out)(HWVoiceOut *hw, audsettings_t *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, audsettings_t *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: 
  165: struct capture_callback {
  166:     struct audio_capture_ops ops;
  167:     void *opaque;
  168:     LIST_ENTRY (capture_callback) entries;
  169: };
  170: 
  171: struct CaptureVoiceOut {
  172:     HWVoiceOut hw;
  173:     void *buf;
  174:     LIST_HEAD (cb_listhead, capture_callback) cb_head;
  175:     LIST_ENTRY (CaptureVoiceOut) entries;
  176: };
  177: 
  178: struct SWVoiceCap {
  179:     SWVoiceOut sw;
  180:     CaptureVoiceOut *cap;
  181:     LIST_ENTRY (SWVoiceCap) entries;
  182: };
  183: 
  184: struct 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: };
  196: 
  197: extern struct audio_driver no_audio_driver;
  198: extern struct audio_driver oss_audio_driver;
  199: extern struct audio_driver sdl_audio_driver;
  200: extern struct audio_driver wav_audio_driver;
  201: extern struct audio_driver fmod_audio_driver;
  202: extern struct audio_driver alsa_audio_driver;
  203: extern struct audio_driver coreaudio_audio_driver;
  204: extern struct audio_driver dsound_audio_driver;
  205: extern volume_t nominal_volume;
  206: 
  207: void audio_pcm_init_info (struct audio_pcm_info *info, audsettings_t *as);
  208: void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
  209: 
  210: int  audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len);
  211: int  audio_pcm_hw_get_live_in (HWVoiceIn *hw);
  212: 
  213: int  audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len);
  214: int  audio_pcm_hw_get_live_out (HWVoiceOut *hw);
  215: int  audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live);
  216: 
  217: int audio_bug (const char *funcname, int cond);
  218: void *audio_calloc (const char *funcname, int nmemb, size_t size);
  219: 
  220: #define VOICE_ENABLE 1
  221: #define VOICE_DISABLE 2
  222: 
  223: static inline int audio_ring_dist (int dst, int src, int len)
  224: {
  225:     return (dst >= src) ? (dst - src) : (len - src + dst);
  226: }
  227: 
  228: #if defined __GNUC__
  229: #define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2)))
  230: #define INIT_FIELD(f) . f
  231: #define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m)))
  232: #else
  233: #define GCC_ATTR /**/
  234: #define INIT_FIELD(f) /**/
  235: #define GCC_FMT_ATTR(n, m)
  236: #endif
  237: 
  238: static void GCC_ATTR dolog (const char *fmt, ...)
  239: {
  240:     va_list ap;
  241: 
  242:     va_start (ap, fmt);
  243:     AUD_vlog (AUDIO_CAP, fmt, ap);
  244:     va_end (ap);
  245: }
  246: 
  247: #ifdef DEBUG
  248: static void GCC_ATTR ldebug (const char *fmt, ...)
  249: {
  250:     va_list ap;
  251: 
  252:     va_start (ap, fmt);
  253:     AUD_vlog (AUDIO_CAP, fmt, ap);
  254:     va_end (ap);
  255: }
  256: #else
  257: #if defined NDEBUG && defined __GNUC__
  258: #define ldebug(...)
  259: #elif defined NDEBUG && defined _MSC_VER
  260: #define ldebug __noop
  261: #else
  262: static void GCC_ATTR ldebug (const char *fmt, ...)
  263: {
  264:     (void) fmt;
  265: }
  266: #endif
  267: #endif
  268: 
  269: #undef GCC_ATTR
  270: 
  271: #define AUDIO_STRINGIFY_(n) #n
  272: #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
  273: 
  274: #if defined _MSC_VER || defined __GNUC__
  275: #define AUDIO_FUNC __FUNCTION__
  276: #else
  277: #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__)
  278: #endif
  279: 
  280: #endif /* audio_int.h */