SOUND4 IMPACT FM.CL Library [2.0.0]
Loading...
Searching...
No Matches
sound4.impactfm.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.impactfm.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 *impactfm_custom_reader(const fs_char *filename, void* userdata);
37 static void impactfm_custom_reader_free(char *content, void* userdata);
38 static int impactfm_custom_writer(const fs_char *filename, const char *content, void* userdata);
39 static int impactfm_custom_exists(const fs_char *filename, void* userdata);
40 static fs_char** impactfm_custom_getall(void* userdata);
41 static void impactfm_custom_getall_free(fs_char** all, void* userdata);
42 static int impactfm_custom_remove(const fs_char *filename, void* userdata);
43 static int impactfm_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 impactfm {
61 static constexpr const char *process_name = "SOUND4 IMPACT FM.CL";
62 static constexpr const char *process_shortname = "impactfm";
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 impactfm_SampleFormat format = S16_NATIVE;
137 };
138 template<>
139 struct SampleFormat<int32_t> {
140 const impactfm_SampleFormat format = S32_NATIVE;
141 };
142 template<>
143 struct SampleFormat<float> {
144 const impactfm_SampleFormat format = F32_NATIVE;
145 };
146
147 // --------------------------------------------------------------
158 static inline void AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, impactfm_SampleFormat fmt) {
159 impactfm_AudioConvertFrom(payload, output, nSpl, fmt);
160 }
161
172 static inline void AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, impactfm_SampleFormat fmt) {
173 impactfm_AudioConvertTo(input, payload, nSpl, fmt);
174 }
175
185 static inline void StereoToMono(const float *input, float *output, size_t nFrame) {
186 impactfm_StereoToMono(input, output, nFrame);
187 }
188
198 static inline void MonoToStereo(const float *input, float *output, size_t nFrame) {
199 impactfm_MonoToStereo(input, output, nFrame);
200 }
201
212 static inline void StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame) {
213 impactfm_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 impactfm_MonoToStereo_Planar(input, outputL, outputR, nFrame);
228 }
229
236 static inline void AudioMonoFromLiveStereo(const uint8_t *payload, float *output) {
237 impactfm_AudioMonoFromLiveStereo(payload, output);
238 }
239
246 static inline void AudioMonoToLiveStereo(const float *input, uint8_t *payload) {
247 impactfm_AudioMonoToLiveStereo(input, payload);
248 }
249
250 }; // namespace helper
251
257 static inline std::string GetVersion()
258 {
259 return std::string(impactfm_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=impactfm_GetPossibleChunkSizeInFrames();*src;src++) {
289 list.push_back(*src);
290 }
291 return list;
292 }
293
299 static inline unsigned int GetChannelCount()
300 {
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 impactfm_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 && impactfm_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(impactfm_GetFormatName(fmt));
374 }
375
382 static inline SampleFormat GetFormatFromName(const std::string& name)
383 {
384 return impactfm_GetFormatFromName(name.c_str());
385 }
386
393 static inline unsigned int GetBytesFromFormat(const SampleFormat fmt)
394 {
395 return impactfm_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(impactfm_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 impactfm_SetLogSeverity(severity);
422 }
426 static inline void SetLoggerCallback(log_cb_t cb)
427 {
428 _log_cb=cb;
430 }
431
432#if IMPACTFM_HAS_CLOUDBUS
438 class CBus {
439 public:
440 CBus()
441 : m_bus(impactfm_NewBus()) {}
442 ~CBus()
443 {
444 impactfm_FreeBus(m_bus);
445 m_bus = nullptr;
446 }
447 impactfm_CBus *Get() const { return m_bus; }
448 private:
449 impactfm_CBus *m_bus;
450 };
451#endif // IMPACTFM_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 = impactfm_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) impactfm_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 impactfm_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=impactfm_GetParameter(params, name.c_str());
527 std::string ret(c_value);
529 return ret;
530 }
531
532#if IMPACTFM_HAS_CLOUDBUS
541 void SetBus(const CBus& bus) {
542 assert(params);
543 impactfm_SetInstanceBus(params,bus.Get());
544 }
545#endif // IMPACTFM_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 #if (__cplusplus<202002L)
603 l_save_path = save_path.u8string();
604 #else // C++20
605 l_save_path = (const char*)save_path.u8string().c_str();
606 #endif // C++20
607 }
608 instance = impactfm_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);
609 if (!instance) return false;
610 if (!init_metadata.empty()) {
611 for (auto&& [key,value]: init_metadata) {
612 impactfm_SetMetadata(instance, key.c_str(), value.c_str());
613 }
614 init_metadata.clear();
615 }
616 update_thread = std::thread([this, json_port](){
618 impactfm_StartUpdateThread(instance, json_port);
620 });
621 int timeout=5000;
622 #ifdef DEBUG
623 timeout=60*1000; // For debugger pauses
624 #endif
625 if (impactfm_WaitUpdateThreadReady(instance, timeout)<0) {
626 return false;
627 }
628 return true;
629 }
630
638 unsigned int GetChunkFrames() {
639 if (instance) {
640 return impactfm_GetProcessChunkFrames(instance);
641 }
642 return 0;
643 }
644
652 void PresetManager_InformChange(const std::filesystem::path& relative_path, PresetChange_Kind change_kind)
653 {
654 impactfm_PresetManager_InformChange(instance, relative_path.c_str(), (impactfm_PresetChange_Kind) change_kind);
655 }
656
668 void SetMetadata(const std::string& key, const char* value)
669 {
670 if (instance) {
671 impactfm_SetMetadata(instance, key.c_str(), value);
672 } else {
673 init_metadata.push_back( {key, value} );
674 }
675 }
676
686 void SetMetadataMulti(const std::unordered_map<std::string, const char*>& list)
687 {
688 if (instance) {
689 typedef const char* pchar;
690 pchar* keyvalue=new pchar[2*list.size()+1];
691 size_t n=0;
692 for (auto&& [key,value]: list) {
693 keyvalue[2*n+0]=key.c_str();
694 keyvalue[2*n+1]=value;
695 n++;
696 }
697 keyvalue[2*n+0]=nullptr;
698
699 impactfm_SetMetadataMulti(instance, keyvalue);
700
701 delete[] keyvalue;
702 } else {
703 for (auto&& [key,value]: list) {
704 if (value) {
705 init_metadata.push_back( {key, value} );
706 }
707 }
708 }
709 }
710
716 std::vector< std::tuple<std::string,std::string> > GetMetadataInfos()
717 {
718 std::vector< std::tuple<std::string,std::string> > values;
719 const char** c_values = impactfm_GetMetadataInfos(instance);
720 if (c_values) {
721 for (const char** c_value=c_values; *c_value; ) {
722 std::string key(*c_value);
723 c_value++;
724 if (*c_value) {
725 std::string descr(*c_value);
726 c_value++;
727 values.push_back( {key,descr} );
728 }
729 }
730 impactfm_FreeMetadataInfos(instance, c_values);
731 }
732 return values;
733 }
734
740 std::vector<AuxiliaryOutputInfos> GetAuxiliaryAudioOutputInfos()
741 {
742 std::vector<AuxiliaryOutputInfos> values;
744 if (c_values) {
745 for (SOUND4_AuxiliaryOutputInfos** c_value=c_values; *c_value; c_value++) {
746 auto c_info=*c_value;
747 values.emplace_back( AuxiliaryOutputInfos{
748 .id = c_info->id ,
749 .description = c_info->description ,
750 .sample_rate = c_info->sample_rate ,
751 .channel_count = c_info->channel_count,
752 .buffer = c_info->buffer ,
753 });
754 }
756 }
757 return values;
758 }
759 void ActivateAuxiliaryAudioID(const std::string& id)
760 {
761 impactfm_ActivateAuxiliaryAudioID(instance, id.c_str());
762 }
766 virtual void OnUpdateThreadStart() {}
770 virtual void OnUpdateThreadStop() {}
771
772#if IMPACTFM_HAS_WEBSERVER
786 bool StartWebServer(int http_port, int https_port=0)
787 {
788 assert(instance);
789 assert(webserver==SOUND4_INVALID_WEBSERVER_ID);
790 webserver = impactfm_Webserver(http_port,https_port,instance);
791 if (webserver==SOUND4_INVALID_WEBSERVER_ID) {
792 return false;
793 }
794 int web_status=impactfm_Webserver_Status(webserver);
795 if (http_port && (web_status & SOUND4_WEBSERVER_HTTP_OK) == 0) {
796 return false;
797 }
798 if (https_port && (web_status & SOUND4_WEBSERVER_HTTPS_OK) == 0) {
799 return false;
800 }
801 return true;
802 }
803
811 void StopWebServer(int timeout_ms = 1000)
812 {
813 if (webserver != SOUND4_INVALID_WEBSERVER_ID) {
814 impactfm_Webserver_Stop(webserver, timeout_ms);
815 webserver = SOUND4_INVALID_WEBSERVER_ID;
816 }
817 }
818
822 void SetWebServerAppHealth(int httpcode, const std::string& contenttype, const std::string& content)
823 {
824 assert(instance);
825 impactfm_Webserver_SetAppHealth(instance, httpcode, contenttype.c_str(), content.c_str());
826 }
830 void GetWebServerAppHealth(int &httpcode, std::string& contenttype, std::string& content)
831 {
832 assert(instance);
833 char* c_contenttype=nullptr;
834 char* c_content=nullptr;
835 impactfm_Webserver_GetAppHealth(instance, &httpcode, &c_contenttype, &c_content);
836 contenttype=c_contenttype;
837 content=c_content;
838 impactfm_Webserver_FreeString(c_contenttype);
840 }
841#endif // IMPACTFM_HAS_WEBSERVER
842
852 {
853 if (!instance) return 0;
854 return impactfm_TerminateProcess(instance);
855 }
856
860 void Stop()
861 {
862 if (!instance) return;
863#if IMPACTFM_HAS_WEBSERVER
865#endif // IMPACTFM_HAS_WEBSERVER
866 if (update_thread.joinable()) {
867 impactfm_StopUpdateThread(instance); // this will exit the update thread
868 update_thread.join();
869 }
870 impactfm_ExitProcess(instance);
871 instance=nullptr;
872 }
873
883 unsigned int GetEstimatedDelay()
884 {
885 assert(instance);
886 return impactfm_GetEstimatedDelay(instance);
887 }
888
901 std::array<float,InputSampleSize>& GetBufferIn()
902 {
903 assert(instance);
904 float *buf=impactfm_GetBufferIn(instance);
905 return reinterpret_cast< std::array<float,InputSampleSize>& >(*buf);
906
907 }
919 std::array<float,OutputSampleSize>& GetBufferOut()
920 {
921 assert(instance);
922 float *buf= impactfm_GetBufferOut(instance);
923 return reinterpret_cast< std::array<float,OutputSampleSize>& >(*buf);
924 }
929 {
930 assert(instance);
932 }
944 void ProcessAudio_Planar(float const * const *input, float * const *output)
945 {
946 assert(instance);
947 impactfm_ProcessAudio_Planar(instance, input, output);
948 }
949
961 template<typename T>
962 std::vector<T> ProcessAnyAudio(const std::vector<T> input)
963 {
964 assert(instance);
965 std::vector<T> output;
966 unsigned int out_offset=0;
967 unsigned int in_offset=0;
968 unsigned int todo = input.size();
969 while (todo>0) {
970 unsigned int left = AddAudio(&input[in_offset], todo);
971 unsigned int out_avail = impactfm_GetOutputCount(instance);
972 output.resize(out_offset + out_avail);
973 GetAudio(&output[out_offset], out_avail);
974 out_offset+=out_avail;
975 in_offset += todo-left;
976 todo=left;
977 }
978 return output;
979 }
980
986 class CClient {
987 public:
989 {
990 assert(instance);
991 client=impactfm_NewClient(instance);
992 if (!client) throw std::bad_alloc();
993 }
994 // non-copyable
995 CClient( const CInstance& ) = delete;
996 CClient& operator=( const CInstance& ) = delete;
998 {
999 if (client) {
1000 impactfm_DeleteClient(client);
1001 client=nullptr;
1002 }
1003 }
1011 std::string ProcessJson(const std::string &request, bool *NeedSave = nullptr)
1012 {
1013 assert(client);
1014 int need_save=0;
1015 const char *canswer = impactfm_ProcessJson(client, request.c_str(), &need_save);
1016 if (!canswer) return {};
1017 std::string answer(canswer);
1018 impactfm_FreeJsonAnswer (canswer);
1019 if (NeedSave) {
1020 *NeedSave=(need_save!=0);
1021 }
1022 return answer;
1023 }
1024 private:
1025 impactfm_CClientInstance *client = nullptr;
1026 };
1034 std::shared_ptr<CClient> NewClient()
1035 {
1036 assert(instance);
1037 return std::make_shared<CClient>(instance);
1038 }
1039
1050 bool SaveState() {
1051 assert(instance);
1052 if (impactfm_SaveState(instance)!=0) {
1053 return false;
1054 }
1055 return true;
1056 }
1057#ifdef _WIN32
1064 void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid = {}) {
1065 impactfm_SetInstanceTracing(params, tracing_provider, activity_guid);
1066 }
1073 void SetInstanceTracingProcessActivity(GUID activity_guid) {
1074 assert(instance);
1075 impactfm_SetInstanceTracingProcessActivity(instance, activity_guid);
1076 }
1077#endif // _WIN32
1078 protected:
1079 template<typename T>
1080 unsigned int AddAudio(const T* payload, unsigned int nFrame)
1081 {
1082 assert(instance);
1083 return impactfm_AddAudio(instance, reinterpret_cast<const T*>(payload), nFrame, helper::SampleFormat<T>::format);
1084 }
1085 template<typename T>
1086 unsigned int GetAudio(T* payload, unsigned int max_nFrame)
1087 {
1088 assert(instance);
1089 return impactfm_GetAudio(instance, reinterpret_cast<T*>(payload), max_nFrame, helper::SampleFormat<T>::format);
1090 }
1091
1092 private:
1093 impactfm_CParameters* params = nullptr;
1094 impactfm_CInstance* instance = nullptr;
1095 std::thread update_thread;
1096 std::vector< std::pair<std::string,std::string> > init_metadata;
1097#if IMPACTFM_HAS_WEBSERVER
1098 uint64_t webserver = SOUND4_INVALID_WEBSERVER_ID;
1099#endif // IMPACTFM_HAS_WEBSERVER
1100 };
1101
1109 public:
1113 CAudioConverter() = default;
1114
1119 {
1120 Delete();
1121 }
1122
1138 bool Configure(SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, impactfm_ConverterTargetMode target_mode)
1139 {
1140 Delete();
1141 m_cvt = impactfm_GetAudioConverter((impactfm_SampleFormat)fmt, nFrame, payl_ch, payl_ch_offset, target_mode);
1142 return IsOK();
1143 }
1144 void Delete()
1145 {
1146 if (m_cvt) {
1148 }
1149 m_cvt = nullptr;
1150 }
1151 bool IsOK() const { return (m_cvt!=nullptr); }
1152
1161 void ConvertFrom(const uint8_t *payload, float *output)
1162 { impactfm_AudioConverter_From(m_cvt, payload, output); }
1163
1172 void ConvertTo(const float *input, uint8_t *payload)
1173 { impactfm_AudioConverter_To(m_cvt, input, payload); }
1174
1175 private:
1176 impactfm_CAudioConverter *m_cvt = nullptr;
1177 };
1178
1179}; // namespace impactfm
1180}; // namespace sound4
1181
1182// bridge C callbacks to CPresetLoader
1183extern "C" {
1184 static char *impactfm_custom_reader(const fs_char *filename, void* userdata) {
1185 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1186 std::string content=preset_loader->Read(filename);
1187 return strdup(content.c_str());
1188 }
1189 static void impactfm_custom_reader_free(char *content, void* userdata) {
1190 if (!content) return;
1191 free(content);
1192 }
1193 static int impactfm_custom_writer(const fs_char *filename, const char *content, void* userdata) {
1194 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1195 auto res=preset_loader->Write(filename,content);
1196 return res?0:-1;
1197 }
1198 static int impactfm_custom_exists(const fs_char *filename, void* userdata) {
1199 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1200 auto res=preset_loader->Exists(filename);
1201 return res?0:-1;
1202 }
1203 static fs_char** impactfm_custom_getall(void* userdata) {
1204 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1205 auto res=preset_loader->GetAll();
1206 fs_char**all=(fs_char**)malloc((res.size()+1)*sizeof(const fs_char*));
1207 for (size_t n=0;n<res.size();n++) {
1208 all[n]=fs_strdup(res[n].c_str());
1209 }
1210 all[res.size()]=nullptr;
1211 return all;
1212 }
1213 static void impactfm_custom_getall_free(fs_char** all, void* userdata) {
1214 if (!all) return;
1215 for (fs_char** one=all;*one;one++) {
1216 free(*one);
1217 }
1218 free(all);
1219 }
1220 static int impactfm_custom_remove(const fs_char *filename, void* userdata) {
1221 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1222 auto res=preset_loader->Remove(filename);
1223 return res?0:-1;
1224 }
1225 static int impactfm_custom_rename(const fs_char *from, const fs_char *to, void* userdata) {
1226 sound4::impactfm::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::CPresetLoader*>(userdata);
1227 auto res=preset_loader->Rename(from,to);
1228 return res?0:-1;
1229 }
1230
1231};
Shared Bus.
Definition sound4cl.hpp:871
sound4cl_CBus * Get() const
Definition sound4cl.hpp:889
CAudioConverter()=default
Construct a new empty CAudioConverter object.
bool Configure(SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, impactfm_ConverterTargetMode target_mode)
virtual ~CAudioConverter()
Destroy the CAudioConverter object.
void ConvertFrom(const uint8_t *payload, float *output)
void ConvertTo(const float *input, uint8_t *payload)
std::string ProcessJson(const std::string &request, bool *NeedSave=nullptr)
Process a JSON request and returns the answer.
CClient & operator=(const CInstance &)=delete
CClient(impactfm_CInstance *instance)
CClient(const CInstance &)=delete
void SetWebServerAppHealth(int httpcode, const std::string &contenttype, const std::string &content)
std::string GetParam(const std::string &name)
void SetMetadata(const std::string &key, const char *value)
CInstance & operator=(const CInstance &)=delete
std::array< float, OutputSampleSize > & GetBufferOut()
std::shared_ptr< CClient > NewClient()
std::vector< AuxiliaryOutputInfos > GetAuxiliaryAudioOutputInfos()
void PresetManager_InformChange(const std::filesystem::path &relative_path, PresetChange_Kind change_kind)
void SetPresetManager(CPresetLoader *preset_manager)
unsigned int AddAudio(const T *payload, unsigned int nFrame)
void SetMetadataMulti(const std::unordered_map< std::string, const char * > &list)
unsigned int GetAudio(T *payload, unsigned int max_nFrame)
bool StartWebServer(int http_port, int https_port=0)
void GetWebServerAppHealth(int &httpcode, std::string &contenttype, std::string &content)
CInstance(const CInstance &)=delete
void StopWebServer(int timeout_ms=1000)
void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid={})
std::vector< T > ProcessAnyAudio(const std::vector< T > input)
void ActivateAuxiliaryAudioID(const std::string &id)
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()
void SetInstanceTracingProcessActivity(GUID activity_guid)
std::array< float, InputSampleSize > & GetBufferIn()
void SetParam(const std::string &name, const std::string &value)
void ProcessAudio_Planar(float const *const *input, float *const *output)
Custom preset handler helper.
virtual std::vector< std::filesystem::path > GetAll()=0
virtual bool Remove(const std::filesystem::path &name)=0
virtual bool Write(const std::filesystem::path &filename, const std::string &content)=0
virtual std::string Read(const std::filesystem::path &filename)=0
virtual ~CPresetLoader()=default
virtual bool Exists(const std::filesystem::path &name)=0
virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to)=0
impactfm_SampleFormat
unsigned int impactfm_AddAudio(struct impactfm_CInstance *instance, const uint8_t *payload, unsigned int nFrame, enum impactfm_SampleFormat fmt)
unsigned int impactfm_GetAudio(struct impactfm_CInstance *instance, uint8_t *payload, unsigned int max_nFrame, enum impactfm_SampleFormat fmt)
const char * impactfm_GetFormatName(const enum impactfm_SampleFormat fmt)
unsigned int impactfm_GetOutputCount(struct impactfm_CInstance *instance)
unsigned int impactfm_GetBytesFromFormat(const enum impactfm_SampleFormat fmt)
enum impactfm_SampleFormat impactfm_GetFormatFromName(const char *name)
struct SOUND4_AuxiliaryOutputInfos ** impactfm_GetAuxiliaryAudioOutputInfos(struct impactfm_CInstance *instance)
void impactfm_FreeAuxiliaryAudioInfos(struct SOUND4_AuxiliaryOutputInfos **infos)
int impactfm_ActivateAuxiliaryAudioID(struct impactfm_CInstance *instance, const char *id)
void impactfm_FreeJsonAnswer(const char *json_str)
const char * impactfm_ProcessJson(struct impactfm_CClientInstance *client, const char *json_str, int *need_save)
int impactfm_SaveState(struct impactfm_CInstance *instance)
struct impactfm_CClientInstance * impactfm_NewClient(struct impactfm_CInstance *instance)
void impactfm_DeleteClient(struct impactfm_CClientInstance *client)
void impactfm_StereoToMono(const float *input, float *output, size_t nFrame)
void impactfm_AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, enum impactfm_SampleFormat fmt)
void impactfm_MonoToStereo(const float *input, float *output, size_t nFrame)
void impactfm_MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame)
impactfm_ConverterTargetMode
void impactfm_StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame)
struct impactfm_CAudioConverter * impactfm_GetAudioConverter(enum impactfm_SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, enum impactfm_ConverterTargetMode target_mode)
void impactfm_AudioConverter_From(struct impactfm_CAudioConverter *converter, const uint8_t *payload, float *output)
void impactfm_AudioConverter_To(struct impactfm_CAudioConverter *converter, const float *input, uint8_t *payload)
void impactfm_AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, enum impactfm_SampleFormat fmt)
void impactfm_AudioMonoToLiveStereo(const float *input, uint8_t *payload)
void impactfm_AudioMonoFromLiveStereo(const uint8_t *payload, float *output)
void impactfm_FreeAudioConverter(struct impactfm_CAudioConverter *converter)
unsigned int impactfm_GetEstimatedDelay(struct impactfm_CInstance *instance)
float * impactfm_GetBufferOut(struct impactfm_CInstance *instance)
float * impactfm_GetBufferIn(struct impactfm_CInstance *instance)
void impactfm_ProcessAudio_Planar(struct impactfm_CInstance *instance, float const *const *input, float *const *output)
void impactfm_ProcessAudio(struct impactfm_CInstance *instance, const float *input, float *output)
#define IMPACTFM_AUDIOFRAME_COUNT
#define IMPACTFM_AUDIO_OUTPUT_COUNT
impactfm_LogSeverity
#define IMPACTFM_CHANNEL_COUNT
void impactfm_SetLoggerCallback(impactfm_loggerfn logger)
unsigned int impactfm_GetChannelCount()
unsigned int impactfm_GetAudioInputCount()
unsigned int * impactfm_GetPossibleChunkSizeInFrames()
const char * impactfm_GetVersion()
unsigned int impactfm_GetChunkSizeInFrames()
unsigned int impactfm_GetAudioOutputCount()
#define IMPACTFM_SAMPLE_RATE
unsigned int impactfm_GetSampleRate()
#define IMPACTFM_AUDIO_INPUT_COUNT
void impactfm_SetLogSeverity(enum impactfm_LogSeverity severity)
void impactfm_SetParameter(struct impactfm_CParameters *params, const char *name, const char *value)
void impactfm_FreeParameterValue(const char *value)
struct impactfm_CInstance * impactfm_InitProcess3(const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path, const struct impactfm_CParameters *parameters, unsigned int frames_per_chunk)
int impactfm_TerminateProcess(struct impactfm_CInstance *instance)
void impactfm_ExitProcess(struct impactfm_CInstance *instance)
struct impactfm_CParameters * impactfm_NewParameters()
const char * impactfm_GetParameter(struct impactfm_CParameters *params, const char *name)
void impactfm_FreeParameters(struct impactfm_CParameters *params)
unsigned int impactfm_GetProcessChunkFrames(struct impactfm_CInstance *instance)
void impactfm_SetMetadataMulti(struct impactfm_CInstance *instance, const char **keyvalue)
void impactfm_FreeMetadataInfos(struct impactfm_CInstance *instance, const char **infos)
void impactfm_SetMetadata(struct impactfm_CInstance *instance, const char *key, const char *value)
const char ** impactfm_GetMetadataInfos(struct impactfm_CInstance *instance)
impactfm_PresetChange_Kind
void impactfm_SetPresetManager(struct impactfm_CParameters *params, impactfm_storage_reader reader, impactfm_storage_reader_free, impactfm_storage_writer writer, impactfm_storage_exists exists, impactfm_storage_getall getall, impactfm_storage_getall_free getall_free, impactfm_storage_remove remove, impactfm_storage_rename rename, int IsReadOnly, void *userdata)
void impactfm_PresetManager_InformChange(struct impactfm_CInstance *instance, const fs_char *relative_path, enum impactfm_PresetChange_Kind change_kind)
wchar_t fs_char
void impactfm_SetInstanceTracing(struct impactfm_CParameters *params, TraceLoggingHProvider tracing_provider, GUID activity_guid)
void impactfm_SetInstanceTracingProcessActivity(struct impactfm_CInstance *instance, GUID activity_guid)
void impactfm_StopUpdateThread(struct impactfm_CInstance *instance)
int impactfm_WaitUpdateThreadReady(struct impactfm_CInstance *instance, int milliseconds)
void impactfm_StartUpdateThread(struct impactfm_CInstance *instance, unsigned int port)
int impactfm_Webserver_Status(uint64_t id)
uint64_t impactfm_Webserver(unsigned int listenport, unsigned int listenport_secure, struct impactfm_CInstance *instance)
void impactfm_Webserver_GetAppHealth(struct impactfm_CInstance *instance, int *httpcode, char **contenttype, char **content)
#define SOUND4_WEBSERVER_HTTPS_OK
int impactfm_Webserver_Stop(uint64_t id, int timeout_ms)
#define SOUND4_WEBSERVER_HTTP_OK
void impactfm_Webserver_FreeString(char *str)
#define SOUND4_INVALID_WEBSERVER_ID
void impactfm_Webserver_SetAppHealth(struct impactfm_CInstance *instance, int httpcode, const char *contenttype, const char *content)
static std::string WStringToUTF8(const std::wstring &wstr)
static void MonoToStereo(const float *input, float *output, size_t nFrame)
static void AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, impactfm_SampleFormat fmt)
static void StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame)
static void AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, impactfm_SampleFormat fmt)
static void MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame)
static std::wstring UTF8ToWString(const std::string &str)
static void StereoToMono(const float *input, float *output, size_t nFrame)
static void AudioMonoFromLiveStereo(const uint8_t *payload, float *output)
static void AudioMonoToLiveStereo(const float *input, uint8_t *payload)
static unsigned int GetChunkSizeInFrames()
static void SanityCheck(bool a_bCheckFrames=true)
static void _log_cb_c(impactfm_LogSeverity severity, const char *c_msg)
static log_cb_t _log_cb
static constexpr const char * process_shortname
static void SetLogSeverity(LogSeverity severity)
const size_t InputSampleSize
static unsigned int GetSampleRate()
static unsigned int GetChannelCount()
static std::string GetFormatName(const SampleFormat fmt)
static unsigned int GetAudioInputCount()
static unsigned int GetAudioOutputCount()
static std::string GetVersion()
static void SetLoggerCallback(log_cb_t cb)
static unsigned int GetBytesFromFormat(const SampleFormat fmt)
const size_t OutputChannels
std::function< void(LogSeverity, const std::string &)> log_cb_t
static std::vector< unsigned int > GetPossibleChunkSizeInFrames()
static constexpr const char * process_name
static SampleFormat GetFormatFromName(const std::string &name)
const size_t OutputSampleSize
@ 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 impactfm_custom_writer(const fs_char *filename, const char *content, void *userdata)
static int impactfm_custom_rename(const fs_char *from, const fs_char *to, void *userdata)
static void impactfm_custom_getall_free(fs_char **all, void *userdata)
static void impactfm_custom_reader_free(char *content, void *userdata)
static int impactfm_custom_exists(const fs_char *filename, void *userdata)
static fs_char ** impactfm_custom_getall(void *userdata)
static char * impactfm_custom_reader(const fs_char *filename, void *userdata)
static int impactfm_custom_remove(const fs_char *filename, void *userdata)
const float * buffer
The output buffer of the output. See sound4::impactfm::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.