libsoundio  1.1.0
soundio.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Andrew Kelley
3  *
4  * This file is part of libsoundio, which is MIT licensed.
5  * See http://opensource.org/licenses/MIT
6  */
7 
8 #ifndef SOUNDIO_SOUNDIO_H
9 #define SOUNDIO_SOUNDIO_H
10 
11 #include "endian.h"
12 #include <stdbool.h>
13 
15 #ifdef __cplusplus
16 #define SOUNDIO_EXTERN_C extern "C"
17 #else
18 #define SOUNDIO_EXTERN_C
19 #endif
20 
21 #if defined(SOUNDIO_STATIC_LIBRARY)
22 # define SOUNDIO_EXPORT SOUNDIO_EXTERN_C
23 #else
24 # if defined(_WIN32)
25 # if defined(SOUNDIO_BUILDING_LIBRARY)
26 # define SOUNDIO_EXPORT SOUNDIO_EXTERN_C __declspec(dllexport)
27 # else
28 # define SOUNDIO_EXPORT SOUNDIO_EXTERN_C __declspec(dllimport)
29 # endif
30 # else
31 # define SOUNDIO_EXPORT SOUNDIO_EXTERN_C __attribute__((visibility ("default")))
32 # endif
33 #endif
34 
71 enum SoundIoError {
103 };
104 
108 
127 
145 
149 
155 
159 
168 
186 };
187 
216 };
217 
226 };
227 
231 };
232 
255 };
256 
257 #if defined(SOUNDIO_OS_BIG_ENDIAN)
258 #define SoundIoFormatS16NE SoundIoFormatS16BE
259 #define SoundIoFormatU16NE SoundIoFormatU16BE
260 #define SoundIoFormatS24NE SoundIoFormatS24BE
261 #define SoundIoFormatU24NE SoundIoFormatU24BE
262 #define SoundIoFormatS32NE SoundIoFormatS32BE
263 #define SoundIoFormatU32NE SoundIoFormatU32BE
264 #define SoundIoFormatFloat32NE SoundIoFormatFloat32BE
265 #define SoundIoFormatFloat64NE SoundIoFormatFloat64BE
266 
267 #define SoundIoFormatS16FE SoundIoFormatS16LE
268 #define SoundIoFormatU16FE SoundIoFormatU16LE
269 #define SoundIoFormatS24FE SoundIoFormatS24LE
270 #define SoundIoFormatU24FE SoundIoFormatU24LE
271 #define SoundIoFormatS32FE SoundIoFormatS32LE
272 #define SoundIoFormatU32FE SoundIoFormatU32LE
273 #define SoundIoFormatFloat32FE SoundIoFormatFloat32LE
274 #define SoundIoFormatFloat64FE SoundIoFormatFloat64LE
275 
276 #elif defined(SOUNDIO_OS_LITTLE_ENDIAN)
277 
278 #define SoundIoFormatS16NE SoundIoFormatS16LE
279 #define SoundIoFormatU16NE SoundIoFormatU16LE
280 #define SoundIoFormatS24NE SoundIoFormatS24LE
281 #define SoundIoFormatU24NE SoundIoFormatU24LE
282 #define SoundIoFormatS32NE SoundIoFormatS32LE
283 #define SoundIoFormatU32NE SoundIoFormatU32LE
284 #define SoundIoFormatFloat32NE SoundIoFormatFloat32LE
285 #define SoundIoFormatFloat64NE SoundIoFormatFloat64LE
286 
287 #define SoundIoFormatS16FE SoundIoFormatS16BE
288 #define SoundIoFormatU16FE SoundIoFormatU16BE
289 #define SoundIoFormatS24FE SoundIoFormatS24BE
290 #define SoundIoFormatU24FE SoundIoFormatU24BE
291 #define SoundIoFormatS32FE SoundIoFormatS32BE
292 #define SoundIoFormatU32FE SoundIoFormatU32BE
293 #define SoundIoFormatFloat32FE SoundIoFormatFloat32BE
294 #define SoundIoFormatFloat64FE SoundIoFormatFloat64BE
295 
296 #else
297 #error unknown byte order
298 #endif
299 
300 #define SOUNDIO_MAX_CHANNELS 24
301 struct SoundIoChannelLayout {
303  const char *name;
306 };
307 
310  int min;
311  int max;
312 };
313 
317  char *ptr;
320  int step;
321 };
322 
324 struct SoundIo {
326  void *userdata;
329  void (*on_devices_change)(struct SoundIo *);
346  void (*on_backend_disconnect)(struct SoundIo *, int err);
350  void (*on_events_signal)(struct SoundIo *);
351 
355 
360  const char *app_name;
361 
368  void (*emit_rtprio_warning)(void);
369 
376  void (*jack_info_callback)(const char *msg);
379  void (*jack_error_callback)(const char *msg);
380 };
381 
385  struct SoundIo *soundio;
386 
395  char *id;
397  char *name;
398 
400  enum SoundIoDeviceAim aim;
401 
411 
436 
451 
468 
474  bool is_raw;
475 
479 
490 };
491 
496 
499  enum SoundIoFormat format;
500 
504 
508 
535 
537  void *userdata;
555  int frame_count_min, int frame_count_max);
567  void (*error_callback)(struct SoundIoOutStream *, int err);
568 
575  const char *name;
576 
581 
582 
587 
592 };
593 
598 
601  enum SoundIoFormat format;
602 
606 
610 
624 
626  void *userdata;
639  void (*read_callback)(struct SoundIoInStream *, int frame_count_min, int frame_count_max);
651  void (*error_callback)(struct SoundIoInStream *, int err);
652 
659  const char *name;
660 
665 
670 
674 };
675 
677 SOUNDIO_EXPORT const char *soundio_version_string(void);
679 SOUNDIO_EXPORT int soundio_version_major(void);
681 SOUNDIO_EXPORT int soundio_version_minor(void);
683 SOUNDIO_EXPORT int soundio_version_patch(void);
684 
689 SOUNDIO_EXPORT struct SoundIo *soundio_create(void);
690 SOUNDIO_EXPORT void soundio_destroy(struct SoundIo *soundio);
691 
692 
700 SOUNDIO_EXPORT int soundio_connect(struct SoundIo *soundio);
712 SOUNDIO_EXPORT int soundio_connect_backend(struct SoundIo *soundio, enum SoundIoBackend backend);
713 SOUNDIO_EXPORT void soundio_disconnect(struct SoundIo *soundio);
714 
716 SOUNDIO_EXPORT const char *soundio_strerror(int error);
718 SOUNDIO_EXPORT const char *soundio_backend_name(enum SoundIoBackend backend);
719 
721 SOUNDIO_EXPORT int soundio_backend_count(struct SoundIo *soundio);
724 SOUNDIO_EXPORT enum SoundIoBackend soundio_get_backend(struct SoundIo *soundio, int index);
725 
727 SOUNDIO_EXPORT bool soundio_have_backend(enum SoundIoBackend backend);
728 
751 SOUNDIO_EXPORT void soundio_flush_events(struct SoundIo *soundio);
752 
755 SOUNDIO_EXPORT void soundio_wait_events(struct SoundIo *soundio);
756 
758 SOUNDIO_EXPORT void soundio_wakeup(struct SoundIo *soundio);
759 
760 
775 SOUNDIO_EXPORT void soundio_force_device_scan(struct SoundIo *soundio);
776 
777 
778 // Channel Layouts
779 
782 SOUNDIO_EXPORT bool soundio_channel_layout_equal(
783  const struct SoundIoChannelLayout *a,
784  const struct SoundIoChannelLayout *b);
785 
786 SOUNDIO_EXPORT const char *soundio_get_channel_name(enum SoundIoChannelId id);
790 SOUNDIO_EXPORT enum SoundIoChannelId soundio_parse_channel_id(const char *str, int str_len);
791 
793 SOUNDIO_EXPORT int soundio_channel_layout_builtin_count(void);
798 SOUNDIO_EXPORT const struct SoundIoChannelLayout *soundio_channel_layout_get_builtin(int index);
799 
802 
805  const struct SoundIoChannelLayout *layout, enum SoundIoChannelId channel);
806 
810 
815  const struct SoundIoChannelLayout *preferred_layouts, int preferred_layout_count,
816  const struct SoundIoChannelLayout *available_layouts, int available_layout_count);
817 
819 SOUNDIO_EXPORT void soundio_sort_channel_layouts(struct SoundIoChannelLayout *layouts, int layout_count);
820 
821 
822 // Sample Formats
823 
825 SOUNDIO_EXPORT int soundio_get_bytes_per_sample(enum SoundIoFormat format);
826 
828 static inline int soundio_get_bytes_per_frame(enum SoundIoFormat format, int channel_count) {
830 }
831 
833 static inline int soundio_get_bytes_per_second(enum SoundIoFormat format,
834  int channel_count, int sample_rate)
835 {
836  return soundio_get_bytes_per_frame(format, channel_count) * sample_rate;
837 }
838 
840 SOUNDIO_EXPORT const char * soundio_format_string(enum SoundIoFormat format);
841 
842 
843 
844 
845 // Devices
846 
853 
856 SOUNDIO_EXPORT int soundio_input_device_count(struct SoundIo *soundio);
859 SOUNDIO_EXPORT int soundio_output_device_count(struct SoundIo *soundio);
860 
865 SOUNDIO_EXPORT struct SoundIoDevice *soundio_get_input_device(struct SoundIo *soundio, int index);
870 SOUNDIO_EXPORT struct SoundIoDevice *soundio_get_output_device(struct SoundIo *soundio, int index);
871 
876 
881 
883 SOUNDIO_EXPORT void soundio_device_ref(struct SoundIoDevice *device);
886 SOUNDIO_EXPORT void soundio_device_unref(struct SoundIoDevice *device);
887 
890 SOUNDIO_EXPORT bool soundio_device_equal(
891  const struct SoundIoDevice *a,
892  const struct SoundIoDevice *b);
893 
895 SOUNDIO_EXPORT void soundio_device_sort_channel_layouts(struct SoundIoDevice *device);
896 
899 SOUNDIO_EXPORT bool soundio_device_supports_format(struct SoundIoDevice *device,
900  enum SoundIoFormat format);
901 
904 SOUNDIO_EXPORT bool soundio_device_supports_layout(struct SoundIoDevice *device,
905  const struct SoundIoChannelLayout *layout);
906 
909 SOUNDIO_EXPORT bool soundio_device_supports_sample_rate(struct SoundIoDevice *device,
910  int sample_rate);
911 
914 SOUNDIO_EXPORT int soundio_device_nearest_sample_rate(struct SoundIoDevice *device,
915  int sample_rate);
916 
917 
918 
919 // Output Streams
926 SOUNDIO_EXPORT void soundio_outstream_destroy(struct SoundIoOutStream *outstream);
927 
950 SOUNDIO_EXPORT int soundio_outstream_open(struct SoundIoOutStream *outstream);
951 
961 SOUNDIO_EXPORT int soundio_outstream_start(struct SoundIoOutStream *outstream);
962 
993 SOUNDIO_EXPORT int soundio_outstream_begin_write(struct SoundIoOutStream *outstream,
994  struct SoundIoChannelArea **areas, int *frame_count);
995 
1005 SOUNDIO_EXPORT int soundio_outstream_end_write(struct SoundIoOutStream *outstream);
1006 
1020 SOUNDIO_EXPORT int soundio_outstream_clear_buffer(struct SoundIoOutStream *outstream);
1021 
1041 SOUNDIO_EXPORT int soundio_outstream_pause(struct SoundIoOutStream *outstream, bool pause);
1042 
1054 SOUNDIO_EXPORT int soundio_outstream_get_latency(struct SoundIoOutStream *outstream,
1055  double *out_latency);
1056 
1057 
1058 
1059 // Input Streams
1066 SOUNDIO_EXPORT void soundio_instream_destroy(struct SoundIoInStream *instream);
1067 
1086 SOUNDIO_EXPORT int soundio_instream_open(struct SoundIoInStream *instream);
1087 
1095 SOUNDIO_EXPORT int soundio_instream_start(struct SoundIoInStream *instream);
1096 
1126 SOUNDIO_EXPORT int soundio_instream_begin_read(struct SoundIoInStream *instream,
1127  struct SoundIoChannelArea **areas, int *frame_count);
1136 SOUNDIO_EXPORT int soundio_instream_end_read(struct SoundIoInStream *instream);
1137 
1149 SOUNDIO_EXPORT int soundio_instream_pause(struct SoundIoInStream *instream, bool pause);
1150 
1159 SOUNDIO_EXPORT int soundio_instream_get_latency(struct SoundIoInStream *instream,
1160  double *out_latency);
1161 
1162 
1167 struct SoundIoRingBuffer;
1173 SOUNDIO_EXPORT struct SoundIoRingBuffer *soundio_ring_buffer_create(struct SoundIo *soundio, int requested_capacity);
1174 SOUNDIO_EXPORT void soundio_ring_buffer_destroy(struct SoundIoRingBuffer *ring_buffer);
1175 
1178 SOUNDIO_EXPORT int soundio_ring_buffer_capacity(struct SoundIoRingBuffer *ring_buffer);
1179 
1181 SOUNDIO_EXPORT char *soundio_ring_buffer_write_ptr(struct SoundIoRingBuffer *ring_buffer);
1183 SOUNDIO_EXPORT void soundio_ring_buffer_advance_write_ptr(struct SoundIoRingBuffer *ring_buffer, int count);
1184 
1186 SOUNDIO_EXPORT char *soundio_ring_buffer_read_ptr(struct SoundIoRingBuffer *ring_buffer);
1188 SOUNDIO_EXPORT void soundio_ring_buffer_advance_read_ptr(struct SoundIoRingBuffer *ring_buffer, int count);
1189 
1191 SOUNDIO_EXPORT int soundio_ring_buffer_fill_count(struct SoundIoRingBuffer *ring_buffer);
1192 
1194 SOUNDIO_EXPORT int soundio_ring_buffer_free_count(struct SoundIoRingBuffer *ring_buffer);
1195 
1197 SOUNDIO_EXPORT void soundio_ring_buffer_clear(struct SoundIoRingBuffer *ring_buffer);
1198 
1199 #endif
soundio_flush_events
void soundio_flush_events(struct SoundIo *soundio)
Atomically update information for all connected devices.
SoundIoChannelIdHeadphonesLeft
@ SoundIoChannelIdHeadphonesLeft
First of the "other" channel ids.
Definition: soundio.h:160
SoundIoErrorSystemResources
@ SoundIoErrorSystemResources
A system resource other than memory was not available.
Definition: soundio.h:79
SoundIoErrorBackendUnavailable
@ SoundIoErrorBackendUnavailable
libsoundio was compiled without support for that backend.
Definition: soundio.h:86
SoundIoChannelLayoutIdHexagonal
@ SoundIoChannelLayoutIdHexagonal
Definition: soundio.h:206
SoundIo::app_name
const char * app_name
Optional: Application name.
Definition: soundio.h:360
soundio_ring_buffer_read_ptr
char * soundio_ring_buffer_read_ptr(struct SoundIoRingBuffer *ring_buffer)
Do not read more than capacity.
soundio_instream_pause
int soundio_instream_pause(struct SoundIoInStream *instream, bool pause)
If the underyling device supports pausing, this pauses the stream and prevents SoundIoInStream::read_...
SoundIoChannelLayoutIdMono
@ SoundIoChannelLayoutIdMono
Definition: soundio.h:190
soundio_instream_get_latency
int soundio_instream_get_latency(struct SoundIoInStream *instream, double *out_latency)
Obtain the number of seconds that the next frame of sound being captured will take to arrive in the b...
SoundIoChannelIdFrontRight
@ SoundIoChannelIdFrontRight
Definition: soundio.h:110
SoundIoChannelLayoutId5Point0Back
@ SoundIoChannelLayoutId5Point0Back
Definition: soundio.h:200
SoundIo::jack_error_callback
void(* jack_error_callback)(const char *msg)
Optional: JACK error callback.
Definition: soundio.h:379
SoundIoDevice::soundio
struct SoundIo * soundio
Read-only. Set automatically.
Definition: soundio.h:385
SoundIoInStream::read_callback
void(* read_callback)(struct SoundIoInStream *, int frame_count_min, int frame_count_max)
In this function call soundio_instream_begin_read and soundio_instream_end_read as many times as nece...
Definition: soundio.h:639
SoundIoChannelIdLfe
@ SoundIoChannelIdLfe
Definition: soundio.h:112
SoundIoChannelIdBottomCenter
@ SoundIoChannelIdBottomCenter
Definition: soundio.h:142
SoundIoErrorBackendDisconnected
@ SoundIoErrorBackendDisconnected
Backend server shutdown or became inactive.
Definition: soundio.h:97
soundio_ring_buffer_free_count
int soundio_ring_buffer_free_count(struct SoundIoRingBuffer *ring_buffer)
Returns how many bytes of the buffer is free, ready for writing.
SoundIoChannelIdMsMid
@ SoundIoChannelIdMsMid
Mid/side recording.
Definition: soundio.h:147
SoundIoChannelIdForeignLanguage
@ SoundIoChannelIdForeignLanguage
Definition: soundio.h:163
SoundIo::on_devices_change
void(* on_devices_change)(struct SoundIo *)
Optional callback.
Definition: soundio.h:329
SoundIoErrorNoSuchClient
@ SoundIoErrorNoSuchClient
When JACK returns JackNoSuchClient
Definition: soundio.h:93
SoundIoChannelIdFrontCenterHigh
@ SoundIoChannelIdFrontCenterHigh
Definition: soundio.h:133
soundio_get_input_device
struct SoundIoDevice * soundio_get_input_device(struct SoundIo *soundio, int index)
Always returns a device.
soundio_channel_layout_detect_builtin
bool soundio_channel_layout_detect_builtin(struct SoundIoChannelLayout *layout)
Populates the name field of layout if it matches a builtin one.
soundio_format_string
const char * soundio_format_string(enum SoundIoFormat format)
Returns string representation of format.
SoundIoChannelIdFrontLeft
@ SoundIoChannelIdFrontLeft
First of the more commonly supported ids.
Definition: soundio.h:109
SoundIoChannelIdTopSideRight
@ SoundIoChannelIdTopSideRight
Definition: soundio.h:138
SoundIoChannelIdNarration
@ SoundIoChannelIdNarration
Definition: soundio.h:165
SoundIoSampleRateRange::min
int min
Definition: soundio.h:310
SoundIoErrorStreaming
@ SoundIoErrorStreaming
An open stream had an error that can only be recovered from by destroying the stream and creating it ...
Definition: soundio.h:89
SoundIoFormatU24LE
@ SoundIoFormatU24LE
Unsigned 24 bit Little Endian using low three bytes in 32-bit word.
Definition: soundio.h:245
SoundIoDevice::software_latency_min
double software_latency_min
Software latency minimum in seconds.
Definition: soundio.h:456
SoundIoChannelLayoutId6Point0Front
@ SoundIoChannelLayoutId6Point0Front
Definition: soundio.h:205
SoundIoInStream::device
struct SoundIoDevice * device
Populated automatically when you call soundio_outstream_create.
Definition: soundio.h:597
SoundIoChannelIdBackRight
@ SoundIoChannelIdBackRight
Definition: soundio.h:114
soundio_device_supports_format
bool soundio_device_supports_format(struct SoundIoDevice *device, enum SoundIoFormat format)
Convenience function.
SoundIoChannelIdAux1
@ SoundIoChannelIdAux1
Definition: soundio.h:171
SoundIoOutStream::non_terminal_hint
bool non_terminal_hint
Optional: Hint that this output stream is nonterminal.
Definition: soundio.h:580
SoundIoChannelLayoutId2Point1
@ SoundIoChannelLayoutId2Point1
Definition: soundio.h:192
SoundIoChannelLayout
The size of this struct is OK to use.
Definition: soundio.h:302
soundio_device_equal
bool soundio_device_equal(const struct SoundIoDevice *a, const struct SoundIoDevice *b)
Return true if and only if the devices have the same SoundIoDevice::id, SoundIoDevice::is_raw,...
SoundIoOutStream::software_latency
double software_latency
Ignoring hardware latency, this is the number of seconds it takes for the last sample in a full buffe...
Definition: soundio.h:534
SoundIoChannelIdHaptic
@ SoundIoChannelIdHaptic
Definition: soundio.h:166
SoundIoChannelIdFrontRightCenter
@ SoundIoChannelIdFrontRightCenter
Definition: soundio.h:116
SoundIoDevice::format_count
int format_count
How many formats are available in SoundIoDevice::formats.
Definition: soundio.h:416
soundio_parse_channel_id
enum SoundIoChannelId soundio_parse_channel_id(const char *str, int str_len)
Given UTF-8 encoded text which is the name of a channel such as "Front Left", "FL",...
soundio_best_matching_channel_layout
const struct SoundIoChannelLayout * soundio_best_matching_channel_layout(const struct SoundIoChannelLayout *preferred_layouts, int preferred_layout_count, const struct SoundIoChannelLayout *available_layouts, int available_layout_count)
Iterates over preferred_layouts.
SoundIoChannelIdXyY
@ SoundIoChannelIdXyY
Definition: soundio.h:158
SoundIoBackendJack
@ SoundIoBackendJack
Definition: soundio.h:220
soundio_ring_buffer_advance_read_ptr
void soundio_ring_buffer_advance_read_ptr(struct SoundIoRingBuffer *ring_buffer, int count)
count in bytes.
soundio_instream_begin_read
int soundio_instream_begin_read(struct SoundIoInStream *instream, struct SoundIoChannelArea **areas, int *frame_count)
Call this function when you are ready to begin reading from the device buffer.
SoundIoInStream::non_terminal_hint
bool non_terminal_hint
Optional: Hint that this input stream is nonterminal.
Definition: soundio.h:664
SoundIoFormatU16BE
@ SoundIoFormatU16BE
Unsigned 16 bit Little Endian.
Definition: soundio.h:242
SoundIoDevice::name
char * name
User-friendly UTF-8 encoded text to describe the device.
Definition: soundio.h:397
soundio_sort_channel_layouts
void soundio_sort_channel_layouts(struct SoundIoChannelLayout *layouts, int layout_count)
Sorts by channel count, descending.
SoundIoDevice::current_format
enum SoundIoFormat current_format
A device is either a raw device or it is a virtual device that is provided by a software mixing servi...
Definition: soundio.h:435
SoundIoChannelIdAux2
@ SoundIoChannelIdAux2
Definition: soundio.h:172
SoundIo::emit_rtprio_warning
void(* emit_rtprio_warning)(void)
Optional: Real time priority warning.
Definition: soundio.h:368
soundio_channel_layout_builtin_count
int soundio_channel_layout_builtin_count(void)
Returns the number of builtin channel layouts.
SoundIoChannelIdTopSideLeft
@ SoundIoChannelIdTopSideLeft
Definition: soundio.h:137
SoundIoChannelIdTopBackRight
@ SoundIoChannelIdTopBackRight
Last of the more commonly supported ids.
Definition: soundio.h:126
SoundIoChannelIdFrontCenter
@ SoundIoChannelIdFrontCenter
Definition: soundio.h:111
SoundIoChannelIdAux9
@ SoundIoChannelIdAux9
Definition: soundio.h:179
soundio_get_output_device
struct SoundIoDevice * soundio_get_output_device(struct SoundIo *soundio, int index)
Always returns a device.
SoundIoChannelIdTopFrontLeftCenter
@ SoundIoChannelIdTopFrontLeftCenter
Definition: soundio.h:135
soundio_get_bytes_per_second
static int soundio_get_bytes_per_second(enum SoundIoFormat format, int channel_count, int sample_rate)
Sample rate is the number of frames per second.
Definition: soundio.h:833
SoundIoChannelIdTopFrontLeft
@ SoundIoChannelIdTopFrontLeft
Definition: soundio.h:121
soundio_ring_buffer_capacity
int soundio_ring_buffer_capacity(struct SoundIoRingBuffer *ring_buffer)
When you create a ring buffer, capacity might be more than the requested capacity for alignment purpo...
SoundIoSampleRateRange
The size of this struct is OK to use.
Definition: soundio.h:309
soundio_default_output_device_index
int soundio_default_output_device_index(struct SoundIo *soundio)
returns the index of the default output device returns -1 if there are no devices or if you never cal...
SoundIoChannelLayoutId7Point1WideBack
@ SoundIoChannelLayoutId7Point1WideBack
Definition: soundio.h:214
soundio_channel_layout_get_builtin
const struct SoundIoChannelLayout * soundio_channel_layout_get_builtin(int index)
Returns a builtin channel layout.
SoundIoInStream::layout_error
int layout_error
If setting the channel layout fails for some reason, this field is set to an error code.
Definition: soundio.h:673
SoundIoChannelIdAux14
@ SoundIoChannelIdAux14
Definition: soundio.h:184
SoundIoFormatS24BE
@ SoundIoFormatS24BE
Signed 24 bit Big Endian using low three bytes in 32-bit word.
Definition: soundio.h:244
SoundIoChannelIdTopFrontRightCenter
@ SoundIoChannelIdTopFrontRightCenter
Definition: soundio.h:136
SoundIoChannelLayoutId7Point1Wide
@ SoundIoChannelLayoutId7Point1Wide
Definition: soundio.h:213
SoundIoChannelIdAux0
@ SoundIoChannelIdAux0
Definition: soundio.h:170
SoundIoChannelIdAux
@ SoundIoChannelIdAux
Definition: soundio.h:169
soundio_connect_backend
int soundio_connect_backend(struct SoundIo *soundio, enum SoundIoBackend backend)
Instead of calling soundio_connect you may call this function to try a specific backend.
SoundIoFormatInvalid
@ SoundIoFormatInvalid
Definition: soundio.h:236
soundio_get_channel_name
const char * soundio_get_channel_name(enum SoundIoChannelId id)
SoundIoFormatU32LE
@ SoundIoFormatU32LE
Unsigned 32 bit Little Endian.
Definition: soundio.h:249
SoundIoChannelLayoutId5Point1
@ SoundIoChannelLayoutId5Point1
Definition: soundio.h:202
SoundIoOutStream::write_callback
void(* write_callback)(struct SoundIoOutStream *, int frame_count_min, int frame_count_max)
In this callback, you call soundio_outstream_begin_write and soundio_outstream_end_write as many time...
Definition: soundio.h:554
SoundIoInStream::sample_rate
int sample_rate
Sample rate is the number of frames per second.
Definition: soundio.h:605
SoundIoChannelIdHeadphonesRight
@ SoundIoChannelIdHeadphonesRight
Definition: soundio.h:161
SoundIoChannelLayoutId6Point1Front
@ SoundIoChannelLayoutId6Point1Front
Definition: soundio.h:209
SoundIoErrorInitAudioBackend
@ SoundIoErrorInitAudioBackend
The backend does not appear to be active or running.
Definition: soundio.h:77
soundio_version_major
int soundio_version_major(void)
See also soundio_version_string, soundio_version_minor, soundio_version_patch.
soundio_outstream_get_latency
int soundio_outstream_get_latency(struct SoundIoOutStream *outstream, double *out_latency)
Obtain the total number of seconds that the next frame written after the last frame written with soun...
SoundIoErrorOpeningDevice
@ SoundIoErrorOpeningDevice
Attempted to open a device and failed.
Definition: soundio.h:81
SoundIoChannelIdAux11
@ SoundIoChannelIdAux11
Definition: soundio.h:181
SoundIoChannelIdTopFrontCenter
@ SoundIoChannelIdTopFrontCenter
Definition: soundio.h:122
SoundIoFormatU32BE
@ SoundIoFormatU32BE
Unsigned 32 bit Big Endian.
Definition: soundio.h:250
SoundIoInStream::layout
struct SoundIoChannelLayout layout
Defaults to Stereo, if available, followed by the first layout supported.
Definition: soundio.h:609
SoundIoChannelIdBackLeft
@ SoundIoChannelIdBackLeft
Definition: soundio.h:113
soundio_default_input_device_index
int soundio_default_input_device_index(struct SoundIo *soundio)
returns the index of the default input device returns -1 if there are no devices or if you never call...
SoundIoChannelIdAux6
@ SoundIoChannelIdAux6
Definition: soundio.h:176
SoundIoChannelLayoutId6Point1Back
@ SoundIoChannelLayoutId6Point1Back
Definition: soundio.h:208
soundio_device_unref
void soundio_device_unref(struct SoundIoDevice *device)
Remove 1 to the reference count of device.
soundio_outstream_end_write
int soundio_outstream_end_write(struct SoundIoOutStream *outstream)
Commits the write that you began with soundio_outstream_begin_write.
SoundIoChannelIdFrontLeftHigh
@ SoundIoChannelIdFrontLeftHigh
Definition: soundio.h:132
SOUNDIO_MAX_CHANNELS
#define SOUNDIO_MAX_CHANNELS
Definition: soundio.h:300
SoundIo::current_backend
enum SoundIoBackend current_backend
Read-only.
Definition: soundio.h:354
SoundIoChannelIdTopBackCenter
@ SoundIoChannelIdTopBackCenter
Definition: soundio.h:125
soundio_outstream_clear_buffer
int soundio_outstream_clear_buffer(struct SoundIoOutStream *outstream)
Clears the output stream buffer.
SoundIoFormat
SoundIoFormat
For your convenience, Native Endian and Foreign Endian constants are defined which point to the respe...
Definition: soundio.h:235
soundio_connect
int soundio_connect(struct SoundIo *soundio)
Tries soundio_connect_backend on all available backends in order.
SoundIoDevice::probe_error
int probe_error
This is set to a SoundIoError representing the result of the device probe.
Definition: soundio.h:489
SoundIoChannelLayoutId6Point0Side
@ SoundIoChannelLayoutId6Point0Side
Definition: soundio.h:204
SoundIoDevice::formats
enum SoundIoFormat * formats
List of formats this device supports.
Definition: soundio.h:414
soundio_ring_buffer_destroy
void soundio_ring_buffer_destroy(struct SoundIoRingBuffer *ring_buffer)
SoundIoChannelIdMsSide
@ SoundIoChannelIdMsSide
Definition: soundio.h:148
SoundIoChannelIdAux8
@ SoundIoChannelIdAux8
Definition: soundio.h:178
SoundIoFormatFloat32BE
@ SoundIoFormatFloat32BE
Float 32 bit Big Endian, Range -1.0 to 1.0.
Definition: soundio.h:252
SoundIoChannelIdFrontLeftCenter
@ SoundIoChannelIdFrontLeftCenter
Definition: soundio.h:115
SoundIoInStream::name
const char * name
Optional: Name of the stream.
Definition: soundio.h:659
SoundIo::userdata
void * userdata
Optional. Put whatever you want here. Defaults to NULL.
Definition: soundio.h:326
SoundIoDevice::id
char * id
A string of bytes that uniquely identifies this device.
Definition: soundio.h:395
SoundIoChannelIdFrontLeftWide
@ SoundIoChannelIdFrontLeftWide
Definition: soundio.h:130
soundio_outstream_destroy
void soundio_outstream_destroy(struct SoundIoOutStream *outstream)
You may not call this function from the SoundIoOutStream::write_callback thread context.
SoundIoFormatFloat32LE
@ SoundIoFormatFloat32LE
Float 32 bit Little Endian, Range -1.0 to 1.0.
Definition: soundio.h:251
SoundIoChannelLayoutId3Point0
@ SoundIoChannelLayoutId3Point0
Definition: soundio.h:193
SoundIoSampleRateRange::max
int max
Definition: soundio.h:311
SoundIoInStream::software_latency
double software_latency
Ignoring hardware latency, this is the number of seconds it takes for a captured sample to become ava...
Definition: soundio.h:623
SoundIoChannelIdBackRightCenter
@ SoundIoChannelIdBackRightCenter
Definition: soundio.h:129
SoundIoErrorIncompatibleDevice
@ SoundIoErrorIncompatibleDevice
Attempted to use a device with parameters it cannot support.
Definition: soundio.h:91
SoundIoFormatS24LE
@ SoundIoFormatS24LE
Signed 24 bit Little Endian using low three bytes in 32-bit word.
Definition: soundio.h:243
SoundIo
The size of this struct is not part of the API or ABI.
Definition: soundio.h:324
SoundIoInStream
The size of this struct is not part of the API or ABI.
Definition: soundio.h:595
SoundIoChannelIdBackLeftCenter
@ SoundIoChannelIdBackLeftCenter
First of the less commonly supported ids.
Definition: soundio.h:128
SoundIo::jack_info_callback
void(* jack_info_callback)(const char *msg)
Optional: JACK info callback.
Definition: soundio.h:376
SoundIoChannelIdAmbisonicY
@ SoundIoChannelIdAmbisonicY
Definition: soundio.h:153
soundio_ring_buffer_clear
void soundio_ring_buffer_clear(struct SoundIoRingBuffer *ring_buffer)
Must be called by the writer.
soundio_output_device_count
int soundio_output_device_count(struct SoundIo *soundio)
Get the number of output devices.
SoundIoChannelLayoutId5Point1Back
@ SoundIoChannelLayoutId5Point1Back
Definition: soundio.h:203
SoundIoChannelIdAux13
@ SoundIoChannelIdAux13
Definition: soundio.h:183
SoundIoOutStream::layout
struct SoundIoChannelLayout layout
Defaults to Stereo, if available, followed by the first layout supported.
Definition: soundio.h:507
SoundIoErrorNone
@ SoundIoErrorNone
Definition: soundio.h:73
SoundIoChannelArea::ptr
char * ptr
Base address of buffer.
Definition: soundio.h:317
SoundIoBackendNone
@ SoundIoBackendNone
Definition: soundio.h:219
soundio_outstream_begin_write
int soundio_outstream_begin_write(struct SoundIoOutStream *outstream, struct SoundIoChannelArea **areas, int *frame_count)
Call this function when you are ready to begin writing to the device buffer.
soundio_wakeup
void soundio_wakeup(struct SoundIo *soundio)
Makes soundio_wait_events stop blocking.
soundio_channel_layout_equal
bool soundio_channel_layout_equal(const struct SoundIoChannelLayout *a, const struct SoundIoChannelLayout *b)
Returns whether the channel count field and each channel id matches in the supplied channel layouts.
soundio_device_nearest_sample_rate
int soundio_device_nearest_sample_rate(struct SoundIoDevice *device, int sample_rate)
Convenience function.
SoundIoDevice::sample_rates
struct SoundIoSampleRateRange * sample_rates
Sample rate is the number of frames per second.
Definition: soundio.h:443
soundio_ring_buffer_write_ptr
char * soundio_ring_buffer_write_ptr(struct SoundIoRingBuffer *ring_buffer)
Do not write more than capacity.
SoundIoDevice::layout_count
int layout_count
Definition: soundio.h:408
SoundIoOutStream::layout_error
int layout_error
If setting the channel layout fails for some reason, this field is set to an error code.
Definition: soundio.h:591
SoundIoOutStream::bytes_per_frame
int bytes_per_frame
computed automatically when you call soundio_outstream_open
Definition: soundio.h:584
SoundIoFormatS8
@ SoundIoFormatS8
Signed 8 bit.
Definition: soundio.h:237
SoundIoOutStream::underflow_callback
void(* underflow_callback)(struct SoundIoOutStream *)
This optional callback happens when the sound device runs out of buffered audio data to play.
Definition: soundio.h:560
SoundIoDevice::layouts
struct SoundIoChannelLayout * layouts
Channel layouts are handled similarly to SoundIoDevice::formats.
Definition: soundio.h:407
SoundIoChannelIdAmbisonicZ
@ SoundIoChannelIdAmbisonicZ
Definition: soundio.h:154
SoundIoChannelId
SoundIoChannelId
Specifies where a channel is physically located.
Definition: soundio.h:106
SoundIoChannelLayout::name
const char * name
Definition: soundio.h:303
SoundIoChannelIdSideRight
@ SoundIoChannelIdSideRight
Definition: soundio.h:119
soundio_outstream_pause
int soundio_outstream_pause(struct SoundIoOutStream *outstream, bool pause)
If the underlying backend and device support pausing, this pauses the stream.
SoundIoChannelLayoutId4Point0
@ SoundIoChannelLayoutId4Point0
Definition: soundio.h:196
soundio_backend_name
const char * soundio_backend_name(enum SoundIoBackend backend)
Get a string representation of a SoundIoBackend.
SoundIoInStream::bytes_per_frame
int bytes_per_frame
computed automatically when you call soundio_instream_open
Definition: soundio.h:667
soundio_device_supports_layout
bool soundio_device_supports_layout(struct SoundIoDevice *device, const struct SoundIoChannelLayout *layout)
Convenience function.
SoundIoChannelLayout::channel_count
int channel_count
Definition: soundio.h:304
soundio_instream_create
struct SoundIoInStream * soundio_instream_create(struct SoundIoDevice *device)
Allocates memory and sets defaults.
soundio_instream_destroy
void soundio_instream_destroy(struct SoundIoInStream *instream)
You may not call this function from SoundIoInStream::read_callback.
SoundIoErrorIncompatibleBackend
@ SoundIoErrorIncompatibleBackend
Attempted to use parameters that the backend cannot support.
Definition: soundio.h:95
SoundIoChannelLayoutId7Point0Front
@ SoundIoChannelLayoutId7Point0Front
Definition: soundio.h:211
SoundIoChannelLayoutId3Point1
@ SoundIoChannelLayoutId3Point1
Definition: soundio.h:195
SoundIoErrorNoSuchDevice
@ SoundIoErrorNoSuchDevice
Definition: soundio.h:82
SoundIoFormatFloat64LE
@ SoundIoFormatFloat64LE
Float 64 bit Little Endian, Range -1.0 to 1.0.
Definition: soundio.h:253
SoundIoFormatS32LE
@ SoundIoFormatS32LE
Signed 32 bit Little Endian.
Definition: soundio.h:247
soundio_backend_count
int soundio_backend_count(struct SoundIo *soundio)
Returns the number of available backends.
SoundIoOutStream::userdata
void * userdata
Defaults to NULL. Put whatever you want here.
Definition: soundio.h:537
SoundIoBackendAlsa
@ SoundIoBackendAlsa
Definition: soundio.h:222
soundio_wait_events
void soundio_wait_events(struct SoundIo *soundio)
This function calls soundio_flush_events then blocks until another event is ready or you call soundio...
SoundIoChannelLayoutId3Point0Back
@ SoundIoChannelLayoutId3Point0Back
Definition: soundio.h:194
SoundIoDevice
The size of this struct is not part of the API or ABI.
Definition: soundio.h:383
SoundIoDevice::current_layout
struct SoundIoChannelLayout current_layout
See SoundIoDevice::current_format.
Definition: soundio.h:410
soundio_instream_end_read
int soundio_instream_end_read(struct SoundIoInStream *instream)
This will drop all of the frames from when you called soundio_instream_begin_read.
SoundIoChannelLayout::channels
enum SoundIoChannelId channels[SOUNDIO_MAX_CHANNELS]
Definition: soundio.h:305
SoundIoChannelLayoutId6Point1
@ SoundIoChannelLayoutId6Point1
Definition: soundio.h:207
SoundIoChannelIdTopBackLeft
@ SoundIoChannelIdTopBackLeft
Definition: soundio.h:124
soundio_ring_buffer_advance_write_ptr
void soundio_ring_buffer_advance_write_ptr(struct SoundIoRingBuffer *ring_buffer, int count)
count in bytes.
soundio_strerror
const char * soundio_strerror(int error)
Get a string representation of a SoundIoError.
soundio_get_backend
enum SoundIoBackend soundio_get_backend(struct SoundIo *soundio, int index)
get the available backend at the specified index (0 <= index < soundio_backend_count)
SoundIoFormatU24BE
@ SoundIoFormatU24BE
Unsigned 24 bit Big Endian using low three bytes in 32-bit word.
Definition: soundio.h:246
SoundIoErrorInvalid
@ SoundIoErrorInvalid
The programmer did not comply with the API.
Definition: soundio.h:84
soundio_version_minor
int soundio_version_minor(void)
See also soundio_version_major, soundio_version_string, soundio_version_patch.
SoundIoChannelIdAmbisonicW
@ SoundIoChannelIdAmbisonicW
first order ambisonic channels
Definition: soundio.h:151
SoundIoOutStream
The size of this struct is not part of the API or ABI.
Definition: soundio.h:493
soundio_channel_layout_get_default
const struct SoundIoChannelLayout * soundio_channel_layout_get_default(int channel_count)
Get the default builtin channel layout for the given number of channels.
soundio_destroy
void soundio_destroy(struct SoundIo *soundio)
SoundIoDeviceAimOutput
@ SoundIoDeviceAimOutput
playback
Definition: soundio.h:230
SoundIoChannelIdAux15
@ SoundIoChannelIdAux15
Definition: soundio.h:185
SoundIoChannelIdAux3
@ SoundIoChannelIdAux3
Definition: soundio.h:173
SoundIoDeviceAimInput
@ SoundIoDeviceAimInput
capture / recording
Definition: soundio.h:229
SoundIoChannelIdAux7
@ SoundIoChannelIdAux7
Definition: soundio.h:177
soundio_ring_buffer_create
struct SoundIoRingBuffer * soundio_ring_buffer_create(struct SoundIo *soundio, int requested_capacity)
requested_capacity in bytes.
SoundIoChannelIdAux5
@ SoundIoChannelIdAux5
Definition: soundio.h:175
SoundIoChannelIdAux12
@ SoundIoChannelIdAux12
Definition: soundio.h:182
SoundIoDevice::is_raw
bool is_raw
Raw means that you are directly opening the hardware device and not going through a proxy such as dmi...
Definition: soundio.h:474
SoundIoChannelIdInvalid
@ SoundIoChannelIdInvalid
Definition: soundio.h:107
soundio_channel_layout_find_channel
int soundio_channel_layout_find_channel(const struct SoundIoChannelLayout *layout, enum SoundIoChannelId channel)
Return the index of channel in layout, or -1 if not found.
soundio_device_ref
void soundio_device_ref(struct SoundIoDevice *device)
Add 1 to the reference count of device.
SoundIoChannelLayoutId
SoundIoChannelLayoutId
Built-in channel layouts for convenience.
Definition: soundio.h:189
soundio_outstream_start
int soundio_outstream_start(struct SoundIoOutStream *outstream)
After you call this function, SoundIoOutStream::write_callback will be called.
SoundIoChannelIdAmbisonicX
@ SoundIoChannelIdAmbisonicX
Definition: soundio.h:152
soundio_device_sort_channel_layouts
void soundio_device_sort_channel_layouts(struct SoundIoDevice *device)
Sorts channel layouts by channel count, descending.
SoundIoInStream::userdata
void * userdata
Defaults to NULL. Put whatever you want here.
Definition: soundio.h:626
SoundIoFormatS16LE
@ SoundIoFormatS16LE
Signed 16 bit Little Endian.
Definition: soundio.h:239
SoundIoBackendPulseAudio
@ SoundIoBackendPulseAudio
Definition: soundio.h:221
SoundIoBackendDummy
@ SoundIoBackendDummy
Definition: soundio.h:225
SoundIoChannelIdAux4
@ SoundIoChannelIdAux4
Definition: soundio.h:174
soundio_input_device_count
int soundio_input_device_count(struct SoundIo *soundio)
When you call soundio_flush_events, a snapshot of all device state is saved and these functions merel...
soundio_version_string
const char * soundio_version_string(void)
See also soundio_version_major, soundio_version_minor, soundio_version_patch.
SoundIoChannelLayoutIdQuadSide
@ SoundIoChannelLayoutIdQuadSide
Definition: soundio.h:198
soundio_get_bytes_per_frame
static int soundio_get_bytes_per_frame(enum SoundIoFormat format, int channel_count)
A frame is one sample per channel.
Definition: soundio.h:828
SoundIoErrorUnderflow
@ SoundIoErrorUnderflow
Buffer underrun occurred.
Definition: soundio.h:100
SoundIoChannelIdFrontRightWide
@ SoundIoChannelIdFrontRightWide
Definition: soundio.h:131
SoundIoOutStream::name
const char * name
Optional: Name of the stream.
Definition: soundio.h:575
SoundIoOutStream::error_callback
void(* error_callback)(struct SoundIoOutStream *, int err)
Optional callback.
Definition: soundio.h:567
SoundIoChannelArea::step
int step
How many bytes it takes to get from the beginning of one sample to the beginning of the next sample.
Definition: soundio.h:320
SoundIoDevice::ref_count
int ref_count
Devices are reference counted.
Definition: soundio.h:478
SoundIoChannelIdLfe2
@ SoundIoChannelIdLfe2
Definition: soundio.h:141
SoundIoErrorNoMem
@ SoundIoErrorNoMem
Out of memory.
Definition: soundio.h:75
SoundIoChannelArea
The size of this struct is OK to use.
Definition: soundio.h:315
SoundIoChannelLayoutIdQuad
@ SoundIoChannelLayoutIdQuad
Definition: soundio.h:197
SoundIoFormatFloat64BE
@ SoundIoFormatFloat64BE
Float 64 bit Big Endian, Range -1.0 to 1.0.
Definition: soundio.h:254
soundio_have_backend
bool soundio_have_backend(enum SoundIoBackend backend)
Returns whether libsoundio was compiled with backend.
SoundIoChannelLayoutId7Point1
@ SoundIoChannelLayoutId7Point1
Definition: soundio.h:212
SoundIoChannelLayoutId7Point0
@ SoundIoChannelLayoutId7Point0
Definition: soundio.h:210
SoundIoOutStream::format
enum SoundIoFormat format
Defaults to #SoundIoFormatFloat32NE, followed by the first one supported.
Definition: soundio.h:499
SoundIoOutStream::sample_rate
int sample_rate
Sample rate is the number of frames per second.
Definition: soundio.h:503
SoundIoChannelIdTopFrontRight
@ SoundIoChannelIdTopFrontRight
Definition: soundio.h:123
SoundIoErrorEncodingString
@ SoundIoErrorEncodingString
Unable to convert to or from UTF-8 to the native string format.
Definition: soundio.h:102
SoundIoChannelIdTopCenter
@ SoundIoChannelIdTopCenter
Definition: soundio.h:120
SoundIoDevice::sample_rate_current
int sample_rate_current
See SoundIoDevice::current_format 0 if sample rate information is missing due to a probe error.
Definition: soundio.h:450
SoundIoOutStream::bytes_per_sample
int bytes_per_sample
computed automatically when you call soundio_outstream_open
Definition: soundio.h:586
SoundIoDeviceAim
SoundIoDeviceAim
Definition: soundio.h:228
SoundIoError
SoundIoError
See also soundio_strerror.
Definition: soundio.h:72
SoundIoChannelLayoutIdStereo
@ SoundIoChannelLayoutIdStereo
Definition: soundio.h:191
SoundIoBackend
SoundIoBackend
Definition: soundio.h:218
SoundIoDevice::software_latency_current
double software_latency_current
Software latency in seconds.
Definition: soundio.h:467
SoundIoInStream::bytes_per_sample
int bytes_per_sample
computed automatically when you call soundio_instream_open
Definition: soundio.h:669
SoundIoBackendCoreAudio
@ SoundIoBackendCoreAudio
Definition: soundio.h:223
SoundIoChannelLayoutId5Point0Side
@ SoundIoChannelLayoutId5Point0Side
Definition: soundio.h:201
soundio_device_supports_sample_rate
bool soundio_device_supports_sample_rate(struct SoundIoDevice *device, int sample_rate)
Convenience function.
soundio_ring_buffer_fill_count
int soundio_ring_buffer_fill_count(struct SoundIoRingBuffer *ring_buffer)
Returns how many bytes of the buffer is used, ready for reading.
SoundIoChannelIdXyX
@ SoundIoChannelIdXyX
X-Y Recording.
Definition: soundio.h:157
SoundIoChannelIdSideLeft
@ SoundIoChannelIdSideLeft
Definition: soundio.h:118
SoundIoBackendWasapi
@ SoundIoBackendWasapi
Definition: soundio.h:224
SoundIoChannelIdDialogCentricMix
@ SoundIoChannelIdDialogCentricMix
Last of the "other" channel ids.
Definition: soundio.h:167
SoundIoOutStream::device
struct SoundIoDevice * device
Populated automatically when you call soundio_outstream_create.
Definition: soundio.h:495
SoundIoChannelIdLeftLfe
@ SoundIoChannelIdLeftLfe
Definition: soundio.h:139
SoundIoDevice::sample_rate_count
int sample_rate_count
How many sample rate ranges are available in SoundIoDevice::sample_rates.
Definition: soundio.h:447
SoundIoInStream::format
enum SoundIoFormat format
Defaults to #SoundIoFormatFloat32NE, followed by the first one supported.
Definition: soundio.h:601
soundio_outstream_create
struct SoundIoOutStream * soundio_outstream_create(struct SoundIoDevice *device)
Allocates memory and sets defaults.
SoundIo::on_events_signal
void(* on_events_signal)(struct SoundIo *)
Optional callback.
Definition: soundio.h:350
SoundIoChannelIdHearingImpaired
@ SoundIoChannelIdHearingImpaired
Definition: soundio.h:164
SoundIoChannelIdAux10
@ SoundIoChannelIdAux10
Definition: soundio.h:180
SoundIoChannelIdBackCenter
@ SoundIoChannelIdBackCenter
Definition: soundio.h:117
soundio_instream_start
int soundio_instream_start(struct SoundIoInStream *instream)
After you call this function, SoundIoInStream::read_callback will be called.
soundio_force_device_scan
void soundio_force_device_scan(struct SoundIo *soundio)
If necessary you can manually trigger a device rescan.
SoundIoChannelIdClickTrack
@ SoundIoChannelIdClickTrack
Definition: soundio.h:162
SoundIoErrorInterrupted
@ SoundIoErrorInterrupted
Definition: soundio.h:98
soundio_get_bytes_per_sample
int soundio_get_bytes_per_sample(enum SoundIoFormat format)
Returns -1 on invalid format.
SoundIo::on_backend_disconnect
void(* on_backend_disconnect)(struct SoundIo *, int err)
Optional callback.
Definition: soundio.h:346
soundio_instream_open
int soundio_instream_open(struct SoundIoInStream *instream)
After you call this function, SoundIoInStream::software_latency is set to the correct value.
SoundIoFormatU16LE
@ SoundIoFormatU16LE
Unsigned 16 bit Little Endian.
Definition: soundio.h:241
SoundIoChannelLayoutId4Point1
@ SoundIoChannelLayoutId4Point1
Definition: soundio.h:199
SoundIoChannelIdRightLfe
@ SoundIoChannelIdRightLfe
Definition: soundio.h:140
soundio_outstream_open
int soundio_outstream_open(struct SoundIoOutStream *outstream)
After you call this function, SoundIoOutStream::software_latency is set to the correct value.
SoundIoDevice::software_latency_max
double software_latency_max
Software latency maximum in seconds.
Definition: soundio.h:461
SoundIoFormatU8
@ SoundIoFormatU8
Unsigned 8 bit.
Definition: soundio.h:238
soundio_disconnect
void soundio_disconnect(struct SoundIo *soundio)
SoundIoInStream::overflow_callback
void(* overflow_callback)(struct SoundIoInStream *)
This optional callback happens when the sound device buffer is full, yet there is more captured audio...
Definition: soundio.h:644
SoundIoChannelLayoutIdOctagonal
@ SoundIoChannelLayoutIdOctagonal
Definition: soundio.h:215
SoundIoDevice::aim
enum SoundIoDeviceAim aim
Tells whether this device is an input device or an output device.
Definition: soundio.h:400
SoundIoChannelIdBottomLeftCenter
@ SoundIoChannelIdBottomLeftCenter
Definition: soundio.h:143
soundio_create
struct SoundIo * soundio_create(void)
Create a SoundIo context.
SoundIoFormatS16BE
@ SoundIoFormatS16BE
Signed 16 bit Big Endian.
Definition: soundio.h:240
SoundIoInStream::error_callback
void(* error_callback)(struct SoundIoInStream *, int err)
Optional callback.
Definition: soundio.h:651
soundio_version_patch
int soundio_version_patch(void)
See also soundio_version_major, soundio_version_minor, soundio_version_string.
SoundIoChannelIdFrontRightHigh
@ SoundIoChannelIdFrontRightHigh
Definition: soundio.h:134
SoundIoChannelIdBottomRightCenter
@ SoundIoChannelIdBottomRightCenter
Definition: soundio.h:144
SoundIoFormatS32BE
@ SoundIoFormatS32BE
Signed 32 bit Big Endian.
Definition: soundio.h:248