sound4cl_cdef.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#ifdef __unix__
    #include <sys/types.h>
#endif
 
#ifdef _WIN32
    #include <stringapiset.h>
    #include <wchar.h>
    #define fs_strdup wcsdup
    typedef wchar_t fs_char;
    #ifdef _MSC_VER
        #define __BYTE_ORDER__  REG_DWORD
        #define __ORDER_LITTLE_ENDIAN__ REG_DWORD_LITTLE_ENDIAN
        #define __ORDER_BIG_ENDIAN__    REG_DWORD_BIG_ENDIAN
    #endif
    #ifdef _MSC_VER
        #pragma warning(disable : 4996)
    #endif
#else // !_WIN32
    #define fs_strdup strdup
    typedef char fs_char;
#endif // !_WIN32
 
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
 
struct sound4cl_SOUND4_ProcessInfo {
    size_t struct_size;         
    const char *name;           
    const char *prefix;         
    const char *shortname;      
    const char *version;        
};
enum sound4cl_LogSeverity {
    sound4cl_none     = 0,
    sound4cl_fatal    = 1,
    sound4cl_error    = 2,
    sound4cl_warning  = 3,
    sound4cl_info     = 4,
    sound4cl_verbose  = 5,
    sound4cl_verbose2 = 6,
    sound4cl_verbose3 = 7,
    sound4cl_verbose4 = 8,
    sound4cl_verbose5 = 9,
};
struct sound4cl_CInstance;
struct sound4cl_CParameters;
struct sound4cl_CBus;
struct sound4cl_CClientInstance;
struct sound4cl_CAudioConverter;
enum sound4cl_PresetChange_Kind {
    change_kind_created = 1,    
    change_kind_modified   ,    
    change_kind_deleted    ,    
};
#define SOUND4_INVALID_WEBSERVER_ID            ((uint64_t)-1)
#define SOUND4_WEBSERVER_HTTP_OK               (1<<0)
#define SOUND4_WEBSERVER_HTTPS_OK              (1<<1)
 
enum sound4cl_SampleFormat {
    INVALID_FORMAT=0,       
    S16_LE,                 
    S16_BE,                 
    S24_LE,                 
    S24_BE,                 
    S32_LE,                 
    S32_BE,                 
    F32_LE,                 
    F32_BE,                 
 
    // Native definitions, only links to the physical ones
    #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
        S16_NATIVE=S16_LE,  
        S24_NATIVE=S24_LE,  
        S32_NATIVE=S32_LE,  
        F32_NATIVE=F32_LE,  
    #else
        S16_NATIVE=S16_BE,  
        S24_NATIVE=S24_BE,  
        S32_NATIVE=S32_BE,  
        F32_NATIVE=F32_BE,  
    #endif
};
 
enum sound4cl_ConverterTargetMode {
    sound4cl_ConverterTargetMode_AsInput = 0,    
    sound4cl_ConverterTargetMode_Mono,           
    sound4cl_ConverterTargetMode_Stereo,         
    sound4cl_ConverterTargetMode_StereoToMono,   
    sound4cl_ConverterTargetMode_MonoToStereo,   
};
 
const struct sound4cl_SOUND4_ProcessInfo* sound4cl_SOUND4_GetProcessInfo();
const char *sound4cl_GetVersion();
unsigned int sound4cl_GetChunkSizeInFrames();
unsigned int* sound4cl_GetPossibleChunkSizeInFrames();
unsigned int sound4cl_GetChannelCount();
unsigned int sound4cl_GetAudioInputCount();
unsigned int sound4cl_GetAudioOutputCount();
unsigned int sound4cl_GetSampleRate();
typedef void (*sound4cl_loggerfn) (enum sound4cl_LogSeverity, const char *);
void sound4cl_SetLoggerCallback( sound4cl_loggerfn logger );
void sound4cl_SetLogSeverity( enum sound4cl_LogSeverity severity );
struct sound4cl_CParameters *sound4cl_NewParameters();
void sound4cl_FreeParameters(struct sound4cl_CParameters *params);
void sound4cl_SetParameter(struct sound4cl_CParameters *params, const char *name, const char *value);
const char *sound4cl_GetParameter(struct sound4cl_CParameters *params, const char *name);
void sound4cl_FreeParameterValue(const char *value);
struct sound4cl_CInstance *sound4cl_InitProcess(
        const char *LoginKey,
        const char *RadioName,
        const char *Access_Key_ID,
        const char *Access_Key_Secret,
        const char *save_path
    );
struct sound4cl_CInstance *sound4cl_InitProcess2(
        const char *LoginKey,
        const char *RadioName,
        const char *Access_Key_ID,
        const char *Access_Key_Secret,
        const char *save_path,
        const struct sound4cl_CParameters *parameters
    );
struct sound4cl_CInstance *sound4cl_InitProcess3(
        const char *LoginKey,
        const char *RadioName,
        const char *Access_Key_ID,
        const char *Access_Key_Secret,
        const char *save_path,
        const struct sound4cl_CParameters *parameters,
        unsigned int frames_per_chunk
    );
unsigned int sound4cl_GetProcessChunkFrames(struct sound4cl_CInstance *instance);
int sound4cl_TerminateProcess(struct sound4cl_CInstance *instance);
void sound4cl_ExitProcess(struct sound4cl_CInstance *instance);
struct sound4cl_CBus* sound4cl_NewBus();
void sound4cl_FreeBus(struct sound4cl_CBus *bus);
void sound4cl_SetInstanceBus(struct sound4cl_CParameters *params, struct sound4cl_CBus *bus);
typedef char * (*sound4cl_storage_reader) (const fs_char *filename, void* userdata);
typedef void (*sound4cl_storage_reader_free) (char *content, void* userdata);
typedef int (*sound4cl_storage_writer) (const fs_char *filename, const char *content, void* userdata);
typedef int (*sound4cl_storage_exists) (const fs_char *filename, void* userdata);
typedef fs_char** (*sound4cl_storage_getall) (void* userdata);
typedef void (*sound4cl_storage_getall_free) (fs_char**all, void* userdata);
typedef int (*sound4cl_storage_remove) (const fs_char *filename, void* userdata);
typedef int (*sound4cl_storage_rename) (const fs_char *from, const fs_char *to, void* userdata);
void sound4cl_SetPresetManager(struct sound4cl_CParameters *params
    , sound4cl_storage_reader reader, sound4cl_storage_reader_free
    , sound4cl_storage_writer writer
    , sound4cl_storage_exists exists
    , sound4cl_storage_getall getall, sound4cl_storage_getall_free getall_free
    , sound4cl_storage_remove remove
    , sound4cl_storage_rename rename
    , int IsReadOnly
    , void* userdata
    );
void sound4cl_PresetManager_InformChange(struct sound4cl_CInstance *instance, const fs_char *relative_path, enum sound4cl_PresetChange_Kind change_kind);
void sound4cl_SetMetadata(struct sound4cl_CInstance *instance, const char* key, const char* value);
void sound4cl_SetMetadataMulti(struct sound4cl_CInstance *instance, const char** keyvalue);
const char** sound4cl_GetMetadataInfos(struct sound4cl_CInstance *instance);
void sound4cl_FreeMetadataInfos(struct sound4cl_CInstance *instance, const char** infos);
void sound4cl_StartUpdateThread(struct sound4cl_CInstance *instance, unsigned int port);
void sound4cl_StopUpdateThread(struct sound4cl_CInstance *instance);
int sound4cl_WaitUpdateThreadReady(struct sound4cl_CInstance *instance, int milliseconds);
void sound4cl_ProcessAudio(struct sound4cl_CInstance *instance, const float *input, float *output );
void sound4cl_ProcessAudio_Planar(struct sound4cl_CInstance *instance
    , float const * const *input
    , float * const *output);
float *sound4cl_GetBufferIn(struct sound4cl_CInstance *instance);
float *sound4cl_GetBufferOut(struct sound4cl_CInstance *instance);
unsigned int sound4cl_GetEstimatedDelay(struct sound4cl_CInstance *instance);
const char *sound4cl_GetFormatName(const enum sound4cl_SampleFormat fmt);
enum sound4cl_SampleFormat sound4cl_GetFormatFromName(const char *name);
unsigned int sound4cl_GetBytesFromFormat(const enum sound4cl_SampleFormat fmt);
unsigned int sound4cl_GetMaxPacketFrame(struct sound4cl_CInstance *instance);
unsigned int sound4cl_AddAudio(struct sound4cl_CInstance *instance, const uint8_t *payload, unsigned int nFrame, enum sound4cl_SampleFormat fmt );
unsigned int sound4cl_AddPadAudio(struct sound4cl_CInstance *instance);
unsigned int sound4cl_GetOutputCount(struct sound4cl_CInstance *instance);
unsigned int sound4cl_GetAudio(struct sound4cl_CInstance *instance, uint8_t *payload, unsigned int max_nFrame, enum sound4cl_SampleFormat fmt );
void sound4cl_AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, enum sound4cl_SampleFormat fmt);
void sound4cl_AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, enum sound4cl_SampleFormat fmt);
void sound4cl_StereoToMono(const float *input, float *output, size_t nFrame);
void sound4cl_MonoToStereo(const float *input, float *output, size_t nFrame);
void sound4cl_StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame);
void sound4cl_MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame);
void sound4cl_AudioMonoFromLiveStereo(const uint8_t *payload, float *output);
void sound4cl_AudioMonoToLiveStereo(const float *input, uint8_t *payload);
struct sound4cl_CAudioConverter* sound4cl_GetAudioConverter(enum sound4cl_SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, sound4cl_ConverterTargetMode tartget_mode);
void sound4cl_FreeAudioConverter(struct sound4cl_CAudioConverter *converter);
void sound4cl_AudioConverter_From(struct sound4cl_CAudioConverter *converter, const uint8_t *payload, float *output);
void sound4cl_AudioConverter_To(struct sound4cl_CAudioConverter *converter, const float *input, uint8_t *payload);
struct sound4cl_CClientInstance *sound4cl_NewClient(struct sound4cl_CInstance *instance);
void sound4cl_DeleteClient(struct sound4cl_CClientInstance *client);
const char *sound4cl_ProcessJson(struct sound4cl_CClientInstance *client, const char *json_str, int *need_save);
void sound4cl_FreeJsonAnswer(const char *json_str);
int sound4cl_SaveState(struct sound4cl_CInstance *instance);
uint64_t sound4cl_Webserver_tcp(unsigned int listenport, unsigned int listenport_secure, const char *socket_ip, unsigned int socket_port);
uint64_t sound4cl_Webserver_tcp2(unsigned int listenport, unsigned int listenport_secure, const char *socket_ip, unsigned int socket_port, const struct sound4cl_CParameters *parameters);
uint64_t sound4cl_Webserver(unsigned int listenport, unsigned int listenport_secure, struct sound4cl_CInstance *instance);
int sound4cl_Webserver_Stop(uint64_t id, int timeout_ms);
int sound4cl_Webserver_Status(uint64_t id);
void sound4cl_Webserver_SetAppHealth(struct sound4cl_CInstance *instance, int httpcode, const char* contenttype, const char* content);
void sound4cl_Webserver_GetAppHealth(struct sound4cl_CInstance *instance, int* httpcode, char** contenttype, char** content);
void sound4cl_Webserver_FreeString(char* str);
 
//   Tracing (Windows only)
#ifdef _WIN32
    #ifndef TLG_HAVE_EVENT_SET_INFORMATION // TraceLoggingProvider.h has not been included
        struct _tlgProvider_t;
        typedef struct _tlgProvider_t const* TraceLoggingHProvider;
    #endif // !TLG_HAVE_EVENT_SET_INFORMATION
void sound4cl_SetInstanceTracing(struct sound4cl_CParameters *params, TraceLoggingHProvider tracing_provider, GUID activity_guid);
void sound4cl_SetInstanceTracingProcessActivity(struct sound4cl_CInstance *instance, GUID activity_guid);
#endif // _WIN32
 
 
#ifdef __cplusplus
} // extern "C"
#endif // __cplusplus