/* Copyright (C) 2010-2020 The RetroArch team * * --------------------------------------------------------------------------------------- * The following license statement only applies to this file (audio_resampler.h). * --------------------------------------------------------------------------------------- * * Permission is hereby granted, free of charge, * to any person obtaining a copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, * and to permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifndef __LIBRETRO_SDK_AUDIO_RESAMPLER_DRIVER_H #define __LIBRETRO_SDK_AUDIO_RESAMPLER_DRIVER_H #include #include #include #include RETRO_BEGIN_DECLS #define RESAMPLER_SIMD_SSE (1 << 0) #define RESAMPLER_SIMD_SSE2 (1 << 1) #define RESAMPLER_SIMD_VMX (1 << 2) #define RESAMPLER_SIMD_VMX128 (1 << 3) #define RESAMPLER_SIMD_AVX (1 << 4) #define RESAMPLER_SIMD_NEON (1 << 5) #define RESAMPLER_SIMD_SSE3 (1 << 6) #define RESAMPLER_SIMD_SSSE3 (1 << 7) #define RESAMPLER_SIMD_MMX (1 << 8) #define RESAMPLER_SIMD_MMXEXT (1 << 9) #define RESAMPLER_SIMD_SSE4 (1 << 10) #define RESAMPLER_SIMD_SSE42 (1 << 11) #define RESAMPLER_SIMD_AVX2 (1 << 12) #define RESAMPLER_SIMD_VFPU (1 << 13) #define RESAMPLER_SIMD_PS (1 << 14) enum resampler_quality { RESAMPLER_QUALITY_DONTCARE = 0, RESAMPLER_QUALITY_LOWEST, RESAMPLER_QUALITY_LOWER, RESAMPLER_QUALITY_NORMAL, RESAMPLER_QUALITY_HIGHER, RESAMPLER_QUALITY_HIGHEST }; /* A bit-mask of all supported SIMD instruction sets. * Allows an implementation to pick different * resampler_implementation structs. */ typedef unsigned resampler_simd_mask_t; #define RESAMPLER_API_VERSION 1 struct resampler_data { const float *data_in; float *data_out; size_t input_frames; size_t output_frames; double ratio; }; /* Returns true if config key was found. Otherwise, * returns false, and sets value to default value. */ typedef int (*resampler_config_get_float_t)(void *userdata, const char *key, float *value, float default_value); typedef int (*resampler_config_get_int_t)(void *userdata, const char *key, int *value, int default_value); /* Allocates an array with values. free() with resampler_config_free_t. */ typedef int (*resampler_config_get_float_array_t)(void *userdata, const char *key, float **values, unsigned *out_num_values, const float *default_values, unsigned num_default_values); typedef int (*resampler_config_get_int_array_t)(void *userdata, const char *key, int **values, unsigned *out_num_values, const int *default_values, unsigned num_default_values); typedef int (*resampler_config_get_string_t)(void *userdata, const char *key, char **output, const char *default_output); /* Calls free() in host runtime. Sometimes needed on Windows. * free() on NULL is fine. */ typedef void (*resampler_config_free_t)(void *ptr); struct resampler_config { resampler_config_get_float_t get_float; resampler_config_get_int_t get_int; resampler_config_get_float_array_t get_float_array; resampler_config_get_int_array_t get_int_array; resampler_config_get_string_t get_string; /* Avoid problems where resampler plug and host are * linked against different C runtimes. */ resampler_config_free_t free; }; /* NEW: Init takes a pointer to a pointer to a retro_resampler struct, and * fills it out with an altered version of the static structure. This is so * other threads don't clobber the process pointer in each other's instances * when selecting different resampler modes. * * Only the init function needs it on input, and the free function cleans up * after it. The process and latency functions shouldn't need it. */ typedef struct retro_resampler retro_resampler_t; /* Bandwidth factor. Will be < 1.0 for downsampling, > 1.0 for upsampling. * Corresponds to expected resampling ratio. */ typedef void *(*resampler_init_t)(const struct resampler_config *config, const retro_resampler_t **resampler, double bandwidth_mod, enum resampler_quality quality, size_t channels, resampler_simd_mask_t mask); /* Frees the handle, and if duped by above, the resampler */ typedef void (*resampler_free_t)(const retro_resampler_t *resampler, void *data); /* Processes input data. */ typedef void (*resampler_process_t)(void *_data, struct resampler_data *data); typedef size_t (*resampler_latency_t)(void *_data); struct retro_resampler { resampler_init_t init; resampler_process_t process; resampler_free_t free; resampler_latency_t latency; /* Must be RESAMPLER_API_VERSION */ unsigned api_version; /* Human readable identifier of implementation. */ const char *ident; /* Computer-friendly short version of ident. * Lower case, no spaces and special characters, etc. */ const char *short_ident; }; typedef struct audio_frame_float { float l; float r; } audio_frame_float_t; extern retro_resampler_t sinc_resampler; #ifdef HAVE_CC_RESAMPLER extern retro_resampler_t CC_resampler; #endif extern retro_resampler_t nearest_resampler; /** * audio_resampler_driver_find_handle: * @index : index of driver to get handle to. * * Returns: handle to audio resampler driver at index. Can be NULL * if nothing found. **/ const void *audio_resampler_driver_find_handle(int index); /** * audio_resampler_driver_find_ident: * @index : index of driver to get handle to. * * Returns: Human-readable identifier of audio resampler driver at index. * Can be NULL if nothing found. **/ const char *audio_resampler_driver_find_ident(int index); /** * retro_resampler_realloc: * @re : Resampler handle * @backend : Resampler backend that is about to be set. * @ident : Identifier name for resampler we want. * @bw_ratio : Bandwidth ratio. * * Reallocates resampler. Will free previous handle before * allocating a new one. If ident is NULL, first resampler will be used. * * Returns: true (1) if successful, otherwise false (0). **/ bool retro_resampler_realloc(void **re, const retro_resampler_t **backend, const char *ident, enum resampler_quality quality, size_t channels, double bw_ratio); RETRO_END_DECLS #endif