rtaudio_c.h

   1 #ifndef RTAUDIO_C_H
   2 #define RTAUDIO_C_H
   3
   4 #if defined(RTAUDIO_EXPORT)
   5 #ifdef WIN32
   6 #define RTAUDIOAPI __declspec(dllexport)
   7 #else
   8 #define RTAUDIOAPI __attribute__((visibility("default")))
   9 #endif
  10 #else
  11 #define RTAUDIOAPI //__declspec(dllimport)
  12 #endif
  13
  14 #ifdef __cplusplus
  15 extern "C" {
  16 #endif
  17
  18 typedef unsigned long rtaudio_format_t;
  19
  20 #define RTAUDIO_FORMAT_SINT8 0x01
  21 #define RTAUDIO_FORMAT_SINT16 0x02
  22 #define RTAUDIO_FORMAT_SINT24 0x04
  23 #define RTAUDIO_FORMAT_SINT32 0x08
  24 #define RTAUDIO_FORMAT_FLOAT32 0x10
  25 #define RTAUDIO_FORMAT_FLOAT64 0x20
  26
  27 typedef unsigned int rtaudio_stream_flags_t;
  28
  29 #define RTAUDIO_FLAGS_NONINTERLEAVED 0x1
  30 #define RTAUDIO_FLAGS_MINIMIZE_LATENCY 0x2
  31 #define RTAUDIO_FLAGS_HOG_DEVICE 0x4
  32 #define RTAUDIO_FLAGS_SCHEDULE_REALTIME 0x8
  33 #define RTAUDIO_FLAGS_ALSA_USE_DEFAULT 0x10
  34
  35 typedef unsigned int rtaudio_stream_status_t;
  36
  37 #define RTAUDIO_STATUS_INPUT_OVERFLOW 0x1
  38 #define RTAUDIO_STATUS_OUTPUT_UNDERFLOW 0x2
  39
  40 typedef int (*rtaudio_cb_t)(void *out, void *in, unsigned int nFrames,
  41                             double stream_time, rtaudio_stream_status_t status,
  42                             void *userdata);
  43
  44 typedef enum rtaudio_error {
  45   RTAUDIO_ERROR_WARNING,
  46   RTAUDIO_ERROR_DEBUG_WARNING,
  47   RTAUDIO_ERROR_UNSPECIFIED,
  48   RTAUDIO_ERROR_NO_DEVICES_FOUND,
  49   RTAUDIO_ERROR_INVALID_DEVICE,
  50   RTAUDIO_ERROR_MEMORY_ERROR,
  51   RTAUDIO_ERROR_INVALID_PARAMETER,
  52   RTAUDIO_ERROR_INVALID_USE,
  53   RTAUDIO_ERROR_DRIVER_ERROR,
  54   RTAUDIO_ERROR_SYSTEM_ERROR,
  55   RTAUDIO_ERROR_THREAD_ERROR,
  56 } rtaudio_error_t;
  57
  58 typedef void (*rtaudio_error_cb_t)(rtaudio_error_t err, const char *msg);
  59
  60 typedef enum rtaudio_api {
  61   RTAUDIO_API_UNSPECIFIED,
  62   RTAUDIO_API_LINUX_ALSA,
  63   RTAUDIO_API_LINUX_PULSE,
  64   RTAUDIO_API_LINUX_OSS,
  65   RTAUDIO_API_UNIX_JACK,
  66   RTAUDIO_API_MACOSX_CORE,
  67   RTAUDIO_API_WINDOWS_WASAPI,
  68   RTAUDIO_API_WINDOWS_ASIO,
  69   RTAUDIO_API_WINDOWS_DS,
  70   RTAUDIO_API_DUMMY,
  71 } rtaudio_api_t;
  72
  73 #define NUM_SAMPLE_RATES 16
  74 #define MAX_NAME_LENGTH 512
  75 typedef struct rtaudio_device_info {
  76   int probed;
  77   unsigned int output_channels;
  78   unsigned int input_channels;
  79   unsigned int duplex_channels;
  80
  81   int is_default_output;
  82   int is_default_input;
  83
  84   rtaudio_format_t native_formats;
  85
  86   unsigned int preferred_sample_rate;
  87   int sample_rates[NUM_SAMPLE_RATES];
  88
  89   char name[MAX_NAME_LENGTH];
  90 } rtaudio_device_info_t;
  91
  92 typedef struct rtaudio_stream_parameters {
  93   unsigned int device_id;
  94   unsigned int num_channels;
  95   unsigned int first_channel;
  96 } rtaudio_stream_parameters_t;
  97
  98 typedef struct rtaudio_stream_options {
  99   rtaudio_stream_flags_t flags;
 100   unsigned int num_buffers;
 101   int priority;
 102   char name[MAX_NAME_LENGTH];
 103 } rtaudio_stream_options_t;
 104
 105 typedef struct rtaudio *rtaudio_t;
 106
 107 RTAUDIOAPI const char *rtaudio_version(void);
 108 RTAUDIOAPI const rtaudio_api_t *rtaudio_compiled_api(void);
 109 RTAUDIOAPI const char *rtaudio_compiled_api_name(rtaudio_api_t api);
 110 RTAUDIOAPI const char *rtaudio_compiled_api_display_name(rtaudio_api_t api);
 111 RTAUDIOAPI rtaudio_api_t rtaudio_compiled_api_by_name(const char *name);
 112
 113 RTAUDIOAPI const char *rtaudio_error(rtaudio_t audio);
 114
 115 RTAUDIOAPI rtaudio_t rtaudio_create(rtaudio_api_t api);
 116 RTAUDIOAPI void rtaudio_destroy(rtaudio_t audio);
 117
 118 RTAUDIOAPI rtaudio_api_t rtaudio_current_api(rtaudio_t audio);
 119
 120 RTAUDIOAPI int rtaudio_device_count(rtaudio_t audio);
 121 RTAUDIOAPI rtaudio_device_info_t rtaudio_get_device_info(rtaudio_t audio,
 122                                                          int i);
 123 RTAUDIOAPI unsigned int rtaudio_get_default_output_device(rtaudio_t audio);
 124 RTAUDIOAPI unsigned int rtaudio_get_default_input_device(rtaudio_t audio);
 125
 126 RTAUDIOAPI int
 127 rtaudio_open_stream(rtaudio_t audio, rtaudio_stream_parameters_t *output_params,
 128                     rtaudio_stream_parameters_t *input_params,
 129                     rtaudio_format_t format, unsigned int sample_rate,
 130                     unsigned int *buffer_frames, rtaudio_cb_t cb,
 131                     void *userdata, rtaudio_stream_options_t *options,
 132                     rtaudio_error_cb_t errcb);
 133 RTAUDIOAPI void rtaudio_close_stream(rtaudio_t audio);
 134 RTAUDIOAPI int rtaudio_start_stream(rtaudio_t audio);
 135 RTAUDIOAPI int rtaudio_stop_stream(rtaudio_t audio);
 136 RTAUDIOAPI int rtaudio_abort_stream(rtaudio_t audio);
 137
 138 RTAUDIOAPI int rtaudio_is_stream_open(rtaudio_t audio);
 139 RTAUDIOAPI int rtaudio_is_stream_running(rtaudio_t audio);
 140
 141 RTAUDIOAPI double rtaudio_get_stream_time(rtaudio_t audio);
 142 RTAUDIOAPI void rtaudio_set_stream_time(rtaudio_t audio, double time);
 143 RTAUDIOAPI int rtaudio_get_stream_latency(rtaudio_t audio);
 144 RTAUDIOAPI unsigned int rtaudio_get_stream_sample_rate(rtaudio_t audio);
 145
 146 RTAUDIOAPI void rtaudio_show_warnings(rtaudio_t audio, int show);
 147
 148 #ifdef __cplusplus
 149 }
 150 #endif
 151 #endif /* RTAUDIO_C_H */