SOUND4 IMPACT.CL Library [1.3.12]
Loading...
Searching...
No Matches
sound4.impact.cl.hpp
Go to the documentation of this file.
1
4#pragma once
5
6#include <string>
7#include <exception>
8#include <thread>
9#include <functional>
10#include <memory>
11#include <array>
12#include <assert.h>
13#include <stdexcept>
14#include <filesystem>
15#include <string.h>
16
17#include "sound4.impact.cl.h"
18
19
20// Filesystem path char type
21#ifdef _WIN32
22 #include <stringapiset.h>
23 #include <wchar.h>
25 #define fs_strdup wcsdup
26 #ifdef _MSC_VER
27 #pragma warning(disable : 4996)
28 #endif
29#else // !_WIN32
31 #define fs_strdup strdup
32#endif // !_WIN32
33
34// bridge C callbacks to CPresetLoader
35extern "C" {
36 static char *impact_custom_reader(const fs_char *filename, void* userdata);
37 static void impact_custom_reader_free(char *content, void* userdata);
38 static int impact_custom_writer(const fs_char *filename, const char *content, void* userdata);
39 static int impact_custom_exists(const fs_char *filename, void* userdata);
40 static fs_char** impact_custom_getall(void* userdata);
41 static void impact_custom_getall_free(fs_char** all, void* userdata);
42 static int impact_custom_remove(const fs_char *filename, void* userdata);
43 static int impact_custom_rename(const fs_char *from, const fs_char *to, void* userdata);
44};
45
49namespace sound4 {
51 std::string id;
52 std::string description;
53 unsigned int sample_rate;
54 unsigned int channel_count;
55 const float *buffer;
56 };
60namespace impact {
61 static constexpr const char *process_name = "SOUND4 IMPACT.CL";
62 static constexpr const char *process_shortname = "impact";
94
98 namespace helper {
99 #ifdef _WIN32
105 static inline std::string WStringToUTF8(const std::wstring& wstr) {
106 if (wstr.empty()) return {};
107 int size = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), NULL, 0, NULL, NULL);
108 std::string str(size, 0);
109 WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), &str[0], size, NULL, NULL);
110 return str;
111 }
117 static inline std::wstring UTF8ToWString(const std::string& str) {
118 if (str.empty()) return std::wstring();
119 int size = MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), NULL, 0);
120 std::wstring wstr(size, 0);
121 MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), &wstr[0], size);
122 return wstr;
123 }
124 #endif // _WIN32
125
131 template<typename T>
133 };
134 template<>
135 struct SampleFormat<int16_t> {
136 const impact_SampleFormat format = S16_NATIVE;
137 };
138 template<>
139 struct SampleFormat<int32_t> {
140 const impact_SampleFormat format = S32_NATIVE;
141 };
142 template<>
143 struct SampleFormat<float> {
144 const impact_SampleFormat format = F32_NATIVE;
145 };
146
147 // --------------------------------------------------------------
158 static inline void AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, impact_SampleFormat fmt) {
159 impact_AudioConvertFrom(payload, output, nSpl, fmt);
160 }
161
172 static inline void AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, impact_SampleFormat fmt) {
173 impact_AudioConvertTo(input, payload, nSpl, fmt);
174 }
175
185 static inline void StereoToMono(const float *input, float *output, size_t nFrame) {
186 impact_StereoToMono(input, output, nFrame);
187 }
188
198 static inline void MonoToStereo(const float *input, float *output, size_t nFrame) {
199 impact_MonoToStereo(input, output, nFrame);
200 }
201
212 static inline void StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame) {
213 impact_StereoToMono_Planar(inputL, inputR, output, nFrame);
214 }
215
226 static inline void MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame) {
227 impact_MonoToStereo_Planar(input, outputL, outputR, nFrame);
228 }
229
236 static inline void AudioMonoFromLiveStereo(const uint8_t *payload, float *output) {
237 impact_AudioMonoFromLiveStereo(payload, output);
238 }
239
246 static inline void AudioMonoToLiveStereo(const float *input, uint8_t *payload) {
247 impact_AudioMonoToLiveStereo(input, payload);
248 }
249
250 }; // namespace helper
251
257 static inline std::string GetVersion()
258 {
259 return std::string(impact_GetVersion());
260 }
261
272 static inline unsigned int GetChunkSizeInFrames()
273 {
275 }
276
285 static inline std::vector<unsigned int> GetPossibleChunkSizeInFrames()
286 {
287 std::vector<unsigned int> list;
288 for (unsigned int* src=impact_GetPossibleChunkSizeInFrames();*src;src++) {
289 list.push_back(*src);
290 }
291 return list;
292 }
293
299 static inline unsigned int GetChannelCount()
300 {
301 return impact_GetChannelCount();
302 }
303
311 static inline unsigned int GetAudioInputCount()
312 {
314 }
315
323 static inline unsigned int GetAudioOutputCount()
324 {
326 }
327
335 static inline unsigned int GetSampleRate()
336 {
337 return impact_GetSampleRate();
338 }
339
345 static inline void SanityCheck(bool a_bCheckFrames = true)
346 {
347 // Do some sanity checks
349 throw std::runtime_error("Bad library sampling rate");
350 }
351 if (a_bCheckFrames && impact_GetChunkSizeInFrames()!=ChunkFrames) {
352 throw std::runtime_error("Bad library frame size");
353 }
355 throw std::runtime_error("Bad library channel count");
356 }
358 throw std::runtime_error("Bad library input count");
359 }
361 throw std::runtime_error("Bad library output count");
362 }
363 }
364
371 static inline std::string GetFormatName(const SampleFormat fmt)
372 {
373 return std::string(impact_GetFormatName(fmt));
374 }
375
382 static inline SampleFormat GetFormatFromName(const std::string& name)
383 {
384 return impact_GetFormatFromName(name.c_str());
385 }
386
393 static inline unsigned int GetBytesFromFormat(const SampleFormat fmt)
394 {
395 return impact_GetBytesFromFormat(fmt);
396 }
397
405 using log_cb_t = std::function<void(LogSeverity,const std::string&)>;
406
411 extern "C" {
412 static inline void _log_cb_c(impact_LogSeverity severity, const char *c_msg) {
413 _log_cb(severity, std::string(c_msg));
414 }
415 }
419 static inline void SetLogSeverity(LogSeverity severity)
420 {
421 impact_SetLogSeverity(severity);
422 }
426 static inline void SetLoggerCallback(log_cb_t cb)
427 {
428 _log_cb=cb;
430 }
431
432#if IMPACT_HAS_CLOUDBUS
438 class CBus {
439 public:
440 CBus()
441 : m_bus(impact_NewBus()) {}
442 ~CBus()
443 {
444 impact_FreeBus(m_bus);
445 m_bus = nullptr;
446 }
447 impact_CBus *Get() const { return m_bus; }
448 private:
449 impact_CBus *m_bus;
450 };
451#endif // IMPACT_HAS_CLOUDBUS
452
459 public:
460 CPresetLoader() = default;
461 virtual ~CPresetLoader() = default;
462
463 virtual bool IsReadOnly() = 0;
464 virtual bool Exists(const std::filesystem::path &name) = 0;
465 virtual bool Remove(const std::filesystem::path &name) = 0;
466 virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to) = 0;
467 virtual std::vector<std::filesystem::path> GetAll() = 0;
468 virtual std::string Read(const std::filesystem::path &filename) = 0;
469 virtual bool Write(const std::filesystem::path &filename, const std::string &content) =0;
470 };
472
478 class CInstance {
479 public:
484 {
485 params = impact_NewParameters();
486 if (!params) throw std::bad_alloc();
487 }
488 // non-copyable
489 CInstance( const CInstance& ) = delete;
490 CInstance& operator=( const CInstance& ) = delete;
494 virtual ~CInstance()
495 {
496 Stop();
497 if (params) impact_FreeParameters(params);
498 }
502 bool IsOk() const { return instance!=nullptr; }
512 void SetParam(const std::string& name, const std::string& value)
513 {
514 assert(params);
515 impact_SetParameter(params, name.c_str(), value.c_str());
516 }
523 std::string GetParam(const std::string& name)
524 {
525 assert(params);
526 auto c_value=impact_GetParameter(params, name.c_str());
527 std::string ret(c_value);
529 return ret;
530 }
531
532#if IMPACT_HAS_CLOUDBUS
541 void SetBus(const CBus& bus) {
542 assert(params);
543 impact_SetInstanceBus(params,bus.Get());
544 }
545#endif // IMPACT_HAS_CLOUDBUS
546
557 void SetPresetManager(CPresetLoader *preset_manager)
558 {
559 if (!preset_manager) return;
560 assert(params);
570 preset_manager->IsReadOnly(),
571 preset_manager
572 );
573 }
574
597 bool Create(const std::string& LoginKey, const std::string& RadioName, const std::string& Access_Key_ID, const std::string& Access_Key_Secret, const std::filesystem::path& save_path, int json_port = 0, unsigned int frames_per_chunk=64)
598 {
599 assert(!instance);
600 std::string l_save_path;
601 if (!save_path.empty()) {
602 l_save_path = save_path.u8string();
603 }
604 instance = impact_InitProcess3(LoginKey.c_str(), RadioName.c_str(), Access_Key_ID.c_str(), Access_Key_Secret.c_str(), l_save_path.c_str(), params, frames_per_chunk);
605 if (!instance) return false;
606 if (!init_metadata.empty()) {
607 for (auto&& [key,value]: init_metadata) {
608 impact_SetMetadata(instance, key.c_str(), value.c_str());
609 }
610 init_metadata.clear();
611 }
612 update_thread = std::thread([this, json_port](){
614 impact_StartUpdateThread(instance, json_port);
616 });
617 int timeout=5000;
618 #ifdef DEBUG
619 timeout=60*1000; // For debugger pauses
620 #endif
621 if (impact_WaitUpdateThreadReady(instance, timeout)<0) {
622 return false;
623 }
624 return true;
625 }
626
634 unsigned int GetChunkFrames() {
635 if (instance) {
636 return impact_GetProcessChunkFrames(instance);
637 }
638 return 0;
639 }
640
648 void PresetManager_InformChange(const std::filesystem::path& relative_path, PresetChange_Kind change_kind)
649 {
650 impact_PresetManager_InformChange(instance, relative_path.c_str(), (impact_PresetChange_Kind) change_kind);
651 }
652
664 void SetMetadata(const std::string& key, const char* value)
665 {
666 if (instance) {
667 impact_SetMetadata(instance, key.c_str(), value);
668 } else {
669 init_metadata.push_back( {key, value} );
670 }
671 }
672
682 void SetMetadataMulti(const std::unordered_map<std::string, const char*>& list)
683 {
684 if (instance) {
685 typedef const char* pchar;
686 pchar* keyvalue=new pchar[2*list.size()+1];
687 size_t n=0;
688 for (auto&& [key,value]: list) {
689 keyvalue[2*n+0]=key.c_str();
690 keyvalue[2*n+1]=value;
691 n++;
692 }
693 keyvalue[2*n+0]=nullptr;
694
695 impact_SetMetadataMulti(instance, keyvalue);
696
697 delete[] keyvalue;
698 } else {
699 for (auto&& [key,value]: list) {
700 if (value) {
701 init_metadata.push_back( {key, value} );
702 }
703 }
704 }
705 }
706
712 std::vector< std::tuple<std::string,std::string> > GetMetadataInfos()
713 {
714 std::vector< std::tuple<std::string,std::string> > values;
715 const char** c_values = impact_GetMetadataInfos(instance);
716 if (c_values) {
717 for (const char** c_value=c_values; *c_value; ) {
718 std::string key(*c_value);
719 c_value++;
720 if (*c_value) {
721 std::string descr(*c_value);
722 c_value++;
723 values.push_back( {key,descr} );
724 }
725 }
726 impact_FreeMetadataInfos(instance, c_values);
727 }
728 return values;
729 }
730
736 std::vector<AuxiliaryOutputInfos> GetAuxiliaryAudioOutputInfos()
737 {
738 std::vector<AuxiliaryOutputInfos> values;
740 if (c_values) {
741 for (SOUND4_AuxiliaryOutputInfos** c_value=c_values; *c_value; c_value++) {
742 auto c_info=*c_value;
743 values.emplace_back( AuxiliaryOutputInfos{
744 .id = c_info->id ,
745 .description = c_info->description ,
746 .sample_rate = c_info->sample_rate ,
747 .channel_count = c_info->channel_count,
748 .buffer = c_info->buffer ,
749 });
750 }
752 }
753 return values;
754 }
755 void ActivateAuxiliaryAudioID(const std::string& id)
756 {
757 impact_ActivateAuxiliaryAudioID(instance, id.c_str());
758 }
762 virtual void OnUpdateThreadStart() {}
766 virtual void OnUpdateThreadStop() {}
767
768#if IMPACT_HAS_WEBSERVER
782 bool StartWebServer(int http_port, int https_port=0)
783 {
784 assert(instance);
785 assert(webserver==SOUND4_INVALID_WEBSERVER_ID);
786 webserver = impact_Webserver(http_port,https_port,instance);
787 if (webserver==SOUND4_INVALID_WEBSERVER_ID) {
788 return false;
789 }
790 int web_status=impact_Webserver_Status(webserver);
791 if (http_port && (web_status & SOUND4_WEBSERVER_HTTP_OK) == 0) {
792 return false;
793 }
794 if (https_port && (web_status & SOUND4_WEBSERVER_HTTPS_OK) == 0) {
795 return false;
796 }
797 return true;
798 }
799
807 void StopWebServer(int timeout_ms = 1000)
808 {
809 if (webserver != SOUND4_INVALID_WEBSERVER_ID) {
810 impact_Webserver_Stop(webserver, timeout_ms);
811 webserver = SOUND4_INVALID_WEBSERVER_ID;
812 }
813 }
814
818 void SetWebServerAppHealth(int httpcode, const std::string& contenttype, const std::string& content)
819 {
820 assert(instance);
821 impact_Webserver_SetAppHealth(instance, httpcode, contenttype.c_str(), content.c_str());
822 }
826 void GetWebServerAppHealth(int &httpcode, std::string& contenttype, std::string& content)
827 {
828 assert(instance);
829 char* c_contenttype=nullptr;
830 char* c_content=nullptr;
831 impact_Webserver_GetAppHealth(instance, &httpcode, &c_contenttype, &c_content);
832 contenttype=c_contenttype;
833 content=c_content;
834 impact_Webserver_FreeString(c_contenttype);
836 }
837#endif // IMPACT_HAS_WEBSERVER
838
848 {
849 if (!instance) return 0;
850 return impact_TerminateProcess(instance);
851 }
852
856 void Stop()
857 {
858 if (!instance) return;
859#if IMPACT_HAS_WEBSERVER
861#endif // IMPACT_HAS_WEBSERVER
862 if (update_thread.joinable()) {
863 impact_StopUpdateThread(instance); // this will exit the update thread
864 update_thread.join();
865 }
866 impact_ExitProcess(instance);
867 instance=nullptr;
868 }
869
879 unsigned int GetEstimatedDelay()
880 {
881 assert(instance);
882 return impact_GetEstimatedDelay(instance);
883 }
884
897 std::array<float,InputSampleSize>& GetBufferIn()
898 {
899 assert(instance);
900 float *buf=impact_GetBufferIn(instance);
901 return reinterpret_cast< std::array<float,InputSampleSize>& >(*buf);
902
903 }
915 std::array<float,OutputSampleSize>& GetBufferOut()
916 {
917 assert(instance);
918 float *buf= impact_GetBufferOut(instance);
919 return reinterpret_cast< std::array<float,OutputSampleSize>& >(*buf);
920 }
925 {
926 assert(instance);
927 impact_ProcessAudio(instance, impact_GetBufferIn(instance), impact_GetBufferOut(instance));
928 }
940 void ProcessAudio_Planar(float const * const *input, float * const *output)
941 {
942 assert(instance);
943 impact_ProcessAudio_Planar(instance, input, output);
944 }
945
957 template<typename T>
958 std::vector<T> ProcessAnyAudio(const std::vector<T> input)
959 {
960 assert(instance);
961 std::vector<T> output;
962 unsigned int out_offset=0;
963 unsigned int in_offset=0;
964 unsigned int todo = input.size();
965 while (todo>0) {
966 unsigned int left = AddAudio(&input[in_offset], todo);
967 unsigned int out_avail = impact_GetOutputCount(instance);
968 output.resize(out_offset + out_avail);
969 GetAudio(&output[out_offset], out_avail);
970 out_offset+=out_avail;
971 in_offset += todo-left;
972 todo=left;
973 }
974 return output;
975 }
976
982 class CClient {
983 public:
985 {
986 assert(instance);
987 client=impact_NewClient(instance);
988 if (!client) throw std::bad_alloc();
989 }
990 // non-copyable
991 CClient( const CInstance& ) = delete;
992 CClient& operator=( const CInstance& ) = delete;
994 {
995 if (client) {
996 impact_DeleteClient(client);
997 client=nullptr;
998 }
999 }
1007 std::string ProcessJson(const std::string &request, bool *NeedSave = nullptr)
1008 {
1009 assert(client);
1010 int need_save=0;
1011 const char *canswer = impact_ProcessJson(client, request.c_str(), &need_save);
1012 if (!canswer) return {};
1013 std::string answer(canswer);
1014 impact_FreeJsonAnswer (canswer);
1015 if (NeedSave) {
1016 *NeedSave=(need_save!=0);
1017 }
1018 return answer;
1019 }
1020 private:
1021 impact_CClientInstance *client = nullptr;
1022 };
1030 std::shared_ptr<CClient> NewClient()
1031 {
1032 assert(instance);
1033 return std::make_shared<CClient>(instance);
1034 }
1035
1046 bool SaveState() {
1047 assert(instance);
1048 if (impact_SaveState(instance)!=0) {
1049 return false;
1050 }
1051 return true;
1052 }
1053#ifdef _WIN32
1060 void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid = {}) {
1061 impact_SetInstanceTracing(params, tracing_provider, activity_guid);
1062 }
1069 void SetInstanceTracingProcessActivity(GUID activity_guid) {
1070 assert(instance);
1071 impact_SetInstanceTracingProcessActivity(instance, activity_guid);
1072 }
1073#endif // _WIN32
1074 protected:
1075 template<typename T>
1076 unsigned int AddAudio(const T* payload, unsigned int nFrame)
1077 {
1078 assert(instance);
1079 return impact_AddAudio(instance, reinterpret_cast<const T*>(payload), nFrame, helper::SampleFormat<T>::format);
1080 }
1081 template<typename T>
1082 unsigned int GetAudio(T* payload, unsigned int max_nFrame)
1083 {
1084 assert(instance);
1085 return impact_GetAudio(instance, reinterpret_cast<T*>(payload), max_nFrame, helper::SampleFormat<T>::format);
1086 }
1087
1088 private:
1089 impact_CParameters* params = nullptr;
1090 impact_CInstance* instance = nullptr;
1091 std::thread update_thread;
1092 std::vector< std::pair<std::string,std::string> > init_metadata;
1093#if IMPACT_HAS_WEBSERVER
1094 uint64_t webserver = SOUND4_INVALID_WEBSERVER_ID;
1095#endif // IMPACT_HAS_WEBSERVER
1096 };
1097
1098}; // namespace impact
1099}; // namespace sound4
1100
1101// bridge C callbacks to CPresetLoader
1102extern "C" {
1103 static char *impact_custom_reader(const fs_char *filename, void* userdata) {
1104 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1105 std::string content=preset_loader->Read(filename);
1106 return strdup(content.c_str());
1107 }
1108 static void impact_custom_reader_free(char *content, void* userdata) {
1109 if (!content) return;
1110 free(content);
1111 }
1112 static int impact_custom_writer(const fs_char *filename, const char *content, void* userdata) {
1113 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1114 auto res=preset_loader->Write(filename,content);
1115 return res?0:-1;
1116 }
1117 static int impact_custom_exists(const fs_char *filename, void* userdata) {
1118 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1119 auto res=preset_loader->Exists(filename);
1120 return res?0:-1;
1121 }
1122 static fs_char** impact_custom_getall(void* userdata) {
1123 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1124 auto res=preset_loader->GetAll();
1125 fs_char**all=(fs_char**)malloc((res.size()+1)*sizeof(const fs_char*));
1126 for (size_t n=0;n<res.size();n++) {
1127 all[n]=fs_strdup(res[n].c_str());
1128 }
1129 all[res.size()]=nullptr;
1130 return all;
1131 }
1132 static void impact_custom_getall_free(fs_char** all, void* userdata) {
1133 if (!all) return;
1134 for (fs_char** one=all;*one;one++) {
1135 free(*one);
1136 }
1137 free(all);
1138 }
1139 static int impact_custom_remove(const fs_char *filename, void* userdata) {
1140 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1141 auto res=preset_loader->Remove(filename);
1142 return res?0:-1;
1143 }
1144 static int impact_custom_rename(const fs_char *from, const fs_char *to, void* userdata) {
1145 sound4::impact::CPresetLoader *preset_loader=reinterpret_cast<sound4::impact::CPresetLoader*>(userdata);
1146 auto res=preset_loader->Rename(from,to);
1147 return res?0:-1;
1148 }
1149
1150};
Shared Bus.
Definition sound4cl.hpp:848
sound4cl_CBus * Get() const
Definition sound4cl.hpp:866
CClient(impact_CInstance *instance)
std::string ProcessJson(const std::string &request, bool *NeedSave=nullptr)
Process a JSON request and returns the answer.
CClient(const CInstance &)=delete
CClient & operator=(const CInstance &)=delete
Instance handling class.
void PresetManager_InformChange(const std::filesystem::path &relative_path, PresetChange_Kind change_kind)
std::array< float, OutputSampleSize > & GetBufferOut()
void StopWebServer(int timeout_ms=1000)
void SetParam(const std::string &name, const std::string &value)
void GetWebServerAppHealth(int &httpcode, std::string &contenttype, std::string &content)
std::string GetParam(const std::string &name)
void SetMetadataMulti(const std::unordered_map< std::string, const char * > &list)
std::vector< T > ProcessAnyAudio(const std::vector< T > input)
CInstance & operator=(const CInstance &)=delete
CInstance(const CInstance &)=delete
unsigned int GetAudio(T *payload, unsigned int max_nFrame)
std::vector< AuxiliaryOutputInfos > GetAuxiliaryAudioOutputInfos()
std::shared_ptr< CClient > NewClient()
void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid={})
void ProcessAudio_Planar(float const *const *input, float *const *output)
bool StartWebServer(int http_port, int https_port=0)
std::array< float, InputSampleSize > & GetBufferIn()
void SetMetadata(const std::string &key, const char *value)
void SetPresetManager(CPresetLoader *preset_manager)
void SetWebServerAppHealth(int httpcode, const std::string &contenttype, const std::string &content)
void SetInstanceTracingProcessActivity(GUID activity_guid)
bool Create(const std::string &LoginKey, const std::string &RadioName, const std::string &Access_Key_ID, const std::string &Access_Key_Secret, const std::filesystem::path &save_path, int json_port=0, unsigned int frames_per_chunk=64)
std::vector< std::tuple< std::string, std::string > > GetMetadataInfos()
unsigned int AddAudio(const T *payload, unsigned int nFrame)
void ActivateAuxiliaryAudioID(const std::string &id)
Custom preset handler helper.
virtual ~CPresetLoader()=default
virtual bool Remove(const std::filesystem::path &name)=0
virtual std::vector< std::filesystem::path > GetAll()=0
virtual std::string Read(const std::filesystem::path &filename)=0
virtual bool Write(const std::filesystem::path &filename, const std::string &content)=0
virtual bool Exists(const std::filesystem::path &name)=0
virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to)=0
unsigned int impact_GetBytesFromFormat(const enum impact_SampleFormat fmt)
unsigned int impact_AddAudio(struct impact_CInstance *instance, const uint8_t *payload, unsigned int nFrame, enum impact_SampleFormat fmt)
const char * impact_GetFormatName(const enum impact_SampleFormat fmt)
impact_SampleFormat
enum impact_SampleFormat impact_GetFormatFromName(const char *name)
unsigned int impact_GetOutputCount(struct impact_CInstance *instance)
unsigned int impact_GetAudio(struct impact_CInstance *instance, uint8_t *payload, unsigned int max_nFrame, enum impact_SampleFormat fmt)
struct SOUND4_AuxiliaryOutputInfos ** impact_GetAuxiliaryAudioOutputInfos(struct impact_CInstance *instance)
void impact_FreeAuxiliaryAudioInfos(struct SOUND4_AuxiliaryOutputInfos **infos)
int impact_ActivateAuxiliaryAudioID(struct impact_CInstance *instance, const char *id)
void impact_FreeJsonAnswer(const char *json_str)
const char * impact_ProcessJson(struct impact_CClientInstance *client, const char *json_str, int *need_save)
void impact_DeleteClient(struct impact_CClientInstance *client)
int impact_SaveState(struct impact_CInstance *instance)
struct impact_CClientInstance * impact_NewClient(struct impact_CInstance *instance)
void impact_AudioMonoFromLiveStereo(const uint8_t *payload, float *output)
void impact_AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, enum impact_SampleFormat fmt)
void impact_MonoToStereo(const float *input, float *output, size_t nFrame)
void impact_MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame)
void impact_AudioMonoToLiveStereo(const float *input, uint8_t *payload)
void impact_StereoToMono(const float *input, float *output, size_t nFrame)
void impact_StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame)
void impact_AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, enum impact_SampleFormat fmt)
void impact_ProcessAudio(struct impact_CInstance *instance, const float *input, float *output)
unsigned int impact_GetEstimatedDelay(struct impact_CInstance *instance)
float * impact_GetBufferIn(struct impact_CInstance *instance)
float * impact_GetBufferOut(struct impact_CInstance *instance)
void impact_ProcessAudio_Planar(struct impact_CInstance *instance, float const *const *input, float *const *output)
#define IMPACT_AUDIO_INPUT_COUNT
#define IMPACT_SAMPLE_RATE
unsigned int * impact_GetPossibleChunkSizeInFrames()
unsigned int impact_GetAudioOutputCount()
const char * impact_GetVersion()
unsigned int impact_GetChunkSizeInFrames()
void impact_SetLoggerCallback(impact_loggerfn logger)
#define IMPACT_CHANNEL_COUNT
#define IMPACT_AUDIOFRAME_COUNT
impact_LogSeverity
unsigned int impact_GetChannelCount()
void impact_SetLogSeverity(enum impact_LogSeverity severity)
unsigned int impact_GetSampleRate()
unsigned int impact_GetAudioInputCount()
#define IMPACT_AUDIO_OUTPUT_COUNT
struct impact_CParameters * impact_NewParameters()
void impact_SetParameter(struct impact_CParameters *params, const char *name, const char *value)
struct impact_CInstance * impact_InitProcess3(const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path, const struct impact_CParameters *parameters, unsigned int frames_per_chunk)
int impact_TerminateProcess(struct impact_CInstance *instance)
void impact_FreeParameters(struct impact_CParameters *params)
void impact_ExitProcess(struct impact_CInstance *instance)
void impact_FreeParameterValue(const char *value)
unsigned int impact_GetProcessChunkFrames(struct impact_CInstance *instance)
const char * impact_GetParameter(struct impact_CParameters *params, const char *name)
void impact_FreeMetadataInfos(struct impact_CInstance *instance, const char **infos)
const char ** impact_GetMetadataInfos(struct impact_CInstance *instance)
void impact_SetMetadataMulti(struct impact_CInstance *instance, const char **keyvalue)
void impact_SetMetadata(struct impact_CInstance *instance, const char *key, const char *value)
void impact_SetPresetManager(struct impact_CParameters *params, impact_storage_reader reader, impact_storage_reader_free, impact_storage_writer writer, impact_storage_exists exists, impact_storage_getall getall, impact_storage_getall_free getall_free, impact_storage_remove remove, impact_storage_rename rename, int IsReadOnly, void *userdata)
void impact_PresetManager_InformChange(struct impact_CInstance *instance, const fs_char *relative_path, enum impact_PresetChange_Kind change_kind)
impact_PresetChange_Kind
wchar_t fs_char
void impact_SetInstanceTracing(struct impact_CParameters *params, TraceLoggingHProvider tracing_provider, GUID activity_guid)
void impact_SetInstanceTracingProcessActivity(struct impact_CInstance *instance, GUID activity_guid)
void impact_StopUpdateThread(struct impact_CInstance *instance)
void impact_StartUpdateThread(struct impact_CInstance *instance, unsigned int port)
int impact_WaitUpdateThreadReady(struct impact_CInstance *instance, int milliseconds)
#define SOUND4_WEBSERVER_HTTPS_OK
int impact_Webserver_Stop(uint64_t id, int timeout_ms)
uint64_t impact_Webserver(unsigned int listenport, unsigned int listenport_secure, struct impact_CInstance *instance)
void impact_Webserver_GetAppHealth(struct impact_CInstance *instance, int *httpcode, char **contenttype, char **content)
int impact_Webserver_Status(uint64_t id)
#define SOUND4_WEBSERVER_HTTP_OK
#define SOUND4_INVALID_WEBSERVER_ID
void impact_Webserver_SetAppHealth(struct impact_CInstance *instance, int httpcode, const char *contenttype, const char *content)
void impact_Webserver_FreeString(char *str)
static void StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame)
static void MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame)
static void AudioMonoToLiveStereo(const float *input, uint8_t *payload)
static void StereoToMono(const float *input, float *output, size_t nFrame)
static void MonoToStereo(const float *input, float *output, size_t nFrame)
static void AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, impact_SampleFormat fmt)
static void AudioMonoFromLiveStereo(const uint8_t *payload, float *output)
static std::string WStringToUTF8(const std::wstring &wstr)
static std::wstring UTF8ToWString(const std::string &str)
static void AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, impact_SampleFormat fmt)
const size_t OutputSampleSize
static unsigned int GetAudioOutputCount()
const size_t InputChannels
static std::string GetVersion()
static void _log_cb_c(impact_LogSeverity severity, const char *c_msg)
static unsigned int GetChunkSizeInFrames()
static constexpr const char * process_name
static unsigned int GetAudioInputCount()
static SampleFormat GetFormatFromName(const std::string &name)
static std::vector< unsigned int > GetPossibleChunkSizeInFrames()
const size_t ChunkFrames
const size_t OutputChannels
static log_cb_t _log_cb
static void SetLogSeverity(LogSeverity severity)
static constexpr const char * process_shortname
const size_t SampleRate
const size_t InputSampleSize
static unsigned int GetSampleRate()
static unsigned int GetBytesFromFormat(const SampleFormat fmt)
static std::string GetFormatName(const SampleFormat fmt)
static unsigned int GetChannelCount()
std::function< void(LogSeverity, const std::string &)> log_cb_t
static void SanityCheck(bool a_bCheckFrames=true)
static void SetLoggerCallback(log_cb_t cb)
@ S32_NATIVE
32-bit signed integer, native
Definition sound4cl.hpp:72
@ F32_NATIVE
32-bit floating-point, native
Definition sound4cl.hpp:73
@ S16_NATIVE
16-bit signed integer, native
Definition sound4cl.hpp:70
C interface for library.
struct _tlgProvider_t const * TraceLoggingHProvider
static int impact_custom_writer(const fs_char *filename, const char *content, void *userdata)
static int impact_custom_rename(const fs_char *from, const fs_char *to, void *userdata)
static fs_char ** impact_custom_getall(void *userdata)
static void impact_custom_reader_free(char *content, void *userdata)
static char * impact_custom_reader(const fs_char *filename, void *userdata)
static int impact_custom_exists(const fs_char *filename, void *userdata)
static void impact_custom_getall_free(fs_char **all, void *userdata)
static int impact_custom_remove(const fs_char *filename, void *userdata)
const float * buffer
The output buffer of the output. See sound4::impact::CInstance::ProcessAudio for format.
std::string description
The description of the output.
std::string id
The ID of the output (fixed across versions)
unsigned int channel_count
The number of channels of this output.
unsigned int sample_rate
The sampling rate of this output.
Helper for Sample format types.