/* RetroArch - A frontend for libretro. * Copyright (C) 2010-2014 - Hans-Kristian Arntzen * Copyright (C) 2011-2016 - Daniel De Matteis * * RetroArch is free software: you can redistribute it and/or modify it under the terms * of the GNU General Public License as published by the Free Software Found- * ation, either version 3 of the License, or (at your option) any later version. * * RetroArch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along with RetroArch. * If not, see . */ #ifndef __AUDIO_DRIVER__H #define __AUDIO_DRIVER__H #include #include #include #include #include "audio_dsp_filter.h" #ifdef __cplusplus extern "C" { #endif #define AUDIO_CHUNK_SIZE_BLOCKING 512 /* So we don't get complete line-noise when fast-forwarding audio. */ #define AUDIO_CHUNK_SIZE_NONBLOCKING 2048 #define AUDIO_MAX_RATIO 16 enum rarch_audio_ctl_state { RARCH_AUDIO_CTL_NONE = 0, RARCH_AUDIO_CTL_INIT, RARCH_AUDIO_CTL_DEINIT, RARCH_AUDIO_CTL_DESTROY, RARCH_AUDIO_CTL_DESTROY_DATA, RARCH_AUDIO_CTL_START, RARCH_AUDIO_CTL_STOP, RARCH_AUDIO_CTL_FIND_DRIVER, RARCH_AUDIO_CTL_SETUP_REWIND, /* Sets audio monitor refresh rate to new value. */ RARCH_AUDIO_CTL_MONITOR_SET_REFRESH_RATE, RARCH_AUDIO_CTL_MONITOR_ADJUST_SYSTEM_RATES, RARCH_AUDIO_CTL_MUTE_TOGGLE, RARCH_AUDIO_CTL_SET_CALLBACK_ENABLE, RARCH_AUDIO_CTL_SET_CALLBACK_DISABLE, RARCH_AUDIO_CTL_SET_CALLBACK, RARCH_AUDIO_CTL_UNSET_CALLBACK, RARCH_AUDIO_CTL_CALLBACK, RARCH_AUDIO_CTL_HAS_CALLBACK, RARCH_AUDIO_CTL_ALIVE, RARCH_AUDIO_CTL_FRAME_IS_REVERSE, RARCH_AUDIO_CTL_SET_OWN_DRIVER, RARCH_AUDIO_CTL_UNSET_OWN_DRIVER, RARCH_AUDIO_CTL_OWNS_DRIVER, RARCH_AUDIO_CTL_SET_ACTIVE, RARCH_AUDIO_CTL_UNSET_ACTIVE, RARCH_AUDIO_CTL_IS_ACTIVE, RARCH_AUDIO_CTL_RESAMPLER_DEINIT, RARCH_AUDIO_CTL_RESAMPLER_INIT, RARCH_AUDIO_CTL_RESAMPLER_PROCESS }; typedef struct audio_driver { /* Creates and initializes handle to audio driver. * * Returns: audio driver handle on success, otherwise NULL. **/ void *(*init)(const char *device, unsigned rate, unsigned latency); /* * @data : Pointer to audio data handle. * @buf : Audio buffer data. * @size : Size of audio buffer. * * Write samples to audio driver. **/ ssize_t (*write)(void *data, const void *buf, size_t size); /* Stops driver. */ bool (*stop)(void *data); /* Starts driver. */ bool (*start)(void *data); /* Is the audio driver currently running? */ bool (*alive)(void *data); /* Should we care about blocking in audio thread? Fast forwarding. */ void (*set_nonblock_state)(void *data, bool toggle); /* Frees driver data. */ void (*free)(void *data); /* Defines if driver will take standard floating point samples, * or int16_t samples. */ bool (*use_float)(void *data); /* Human-readable identifier. */ const char *ident; /* Optional. */ size_t (*write_avail)(void *data); size_t (*buffer_size)(void *data); } audio_driver_t; bool audio_driver_ctl(enum rarch_audio_ctl_state state, void *data); /** * audio_driver_find_handle: * @index : index of driver to get handle to. * * Returns: handle to audio driver at index. Can be NULL * if nothing found. **/ const void *audio_driver_find_handle(int index); /** * audio_driver_find_ident: * @index : index of driver to get handle to. * * Returns: Human-readable identifier of audio driver at index. Can be NULL * if nothing found. **/ const char *audio_driver_find_ident(int index); void audio_driver_set_nonblocking_state(bool enable); /** * config_get_audio_driver_options: * * Get an enumerated list of all audio driver names, separated by '|'. * * Returns: string listing of all audio driver names, separated by '|'. **/ const char* config_get_audio_driver_options(void); void audio_driver_sample(int16_t left, int16_t right); size_t audio_driver_sample_batch(const int16_t *data, size_t frames); void audio_driver_sample_rewind(int16_t left, int16_t right); size_t audio_driver_sample_batch_rewind(const int16_t *data, size_t frames); void audio_driver_set_volume_gain(float gain); void audio_driver_dsp_filter_free(void); void audio_driver_dsp_filter_init(const char *device); void audio_driver_set_buffer_size(size_t bufsize); extern audio_driver_t audio_rsound; extern audio_driver_t audio_oss; extern audio_driver_t audio_alsa; extern audio_driver_t audio_alsathread; extern audio_driver_t audio_roar; extern audio_driver_t audio_openal; extern audio_driver_t audio_opensl; extern audio_driver_t audio_jack; extern audio_driver_t audio_sdl; extern audio_driver_t audio_xa; extern audio_driver_t audio_pulse; extern audio_driver_t audio_dsound; extern audio_driver_t audio_coreaudio; extern audio_driver_t audio_xenon360; extern audio_driver_t audio_ps3; extern audio_driver_t audio_gx; extern audio_driver_t audio_psp; extern audio_driver_t audio_ctr_csnd; extern audio_driver_t audio_ctr_dsp; extern audio_driver_t audio_rwebaudio; extern audio_driver_t audio_null; #ifdef __cplusplus } #endif #endif