SOUND4 IMPACT FM.CL Library [2.0.0]
Loading...
Searching...
No Matches
sound4.impactfm.cl_dyn.hpp
Go to the documentation of this file.
1
7#pragma once
8
9#include <string>
10#include <exception>
11#include <thread>
12#include <functional>
13#include <memory>
14#include <array>
15#include <assert.h>
16#include <stdexcept>
17#include <filesystem>
18#include <string.h>
19
20#if defined(__unix__) || defined(__APPLE__)
21 #define UNIXLIKE 1
22#else
23 #define UNIXLIKE 0
24#endif
25
26#if UNIXLIKE
27 #include <dlfcn.h>
28#elif defined(_WIN32)
29 #include <libloaderapi.h>
30#else
31 #error "Unsupported OS"
32#endif
33
34// Needed to have function declarations
35#include "sound4.impactfm.cl.h"
36
37
38#ifdef _WIN32
39 #include <stringapiset.h>
40 #include <wchar.h>
42 #define fs_strdup wcsdup
43 #ifdef _MSC_VER
44 #pragma warning(disable : 4996)
45 #endif
46#else // !_WIN32
48 #define fs_strdup strdup
49#endif // !_WIN32
50
51// bridge C callbacks to CPresetLoader
52extern "C" {
53 static char *impactfm_custom_reader(const fs_char *filename, void* userdata);
54 static void impactfm_custom_reader_free(char *content, void* userdata);
55 static int impactfm_custom_writer(const fs_char *filename, const char *content, void* userdata);
56 static int impactfm_custom_exists(const fs_char *filename, void* userdata);
57 static fs_char** impactfm_custom_getall(void* userdata);
58 static void impactfm_custom_getall_free(fs_char** all, void* userdata);
59 static int impactfm_custom_remove(const fs_char *filename, void* userdata);
60 static int impactfm_custom_rename(const fs_char *from, const fs_char *to, void* userdata);
61};
62
66namespace sound4 {
70namespace impactfm {
74namespace dyn {
75
79 namespace helper {
80
86 template <typename T>
88 // Storage definition, depending on OS
89 #if UNIXLIKE
90 using DynFunc_t = void *;
91 #else
92 using DynFunc_t = FARPROC;
93 #endif
94 private:
95 DynFunc_t m_ptr = NULL;
96 public:
97 DynFuncHolder() = default;
98 DynFuncHolder(DynFunc_t a_ptr) : m_ptr(a_ptr) {}
99 operator bool() const { return (m_ptr!=NULL); }
100 bool IsOk() const { return m_ptr!=NULL; }
101 operator T* () const { return reinterpret_cast<T*>(m_ptr); }
102 };
103
109 // Storage definition, depending on OS
110 #if UNIXLIKE
111 using DynLib_t = void *;
112 #else
113 using DynLib_t = HMODULE;
114 #endif
115 private:
116 DynLib_t m_lib {};
117 public:
118 CDynLoader() = default;
119 CDynLoader(CDynLoader&& other) noexcept : m_lib(other.m_lib) { other.m_lib = NULL; }
120 CDynLoader& operator=(CDynLoader&& other) noexcept {
121 if (this != &other) { Close(); m_lib = other.m_lib; other.m_lib = NULL; }
122 return *this;
123 }
124 // No copy allowed
125 CDynLoader(const CDynLoader&) = delete;
126 CDynLoader& operator=(CDynLoader const&) = delete;
127 operator bool() const {
128 return (m_lib!=NULL);
129 }
130 bool IsOk() const {
131 return (m_lib!=NULL);
132 }
133 #if UNIXLIKE
134 void Close() {
135 if (IsOk()) {
136 #ifndef __SANITIZE_ADDRESS__ // avoid unloading to keep call stack
137 dlclose(m_lib);
138 #endif // __SANITIZE_ADDRESS__
139 m_lib=NULL;
140 }
141 }
142 bool Load(const std::filesystem::path& dynlib)
143 {
144 Close();
145 m_lib=dlopen(dynlib.c_str(), RTLD_NOW|RTLD_LOCAL);
146 return IsOk();
147 }
148 template <typename T>
149 DynFuncHolder<T> GetSymbol(const std::string& name) {
150 auto ptr=dlsym(m_lib, name.c_str());
151 if (!ptr) {
152 throw std::runtime_error("Missing function in library");
153 }
154 return DynFuncHolder<T>(ptr);
155 }
156 template <typename T>
157 DynFuncHolder<T> GetSymbol_safe(const std::string& name) {
158 auto ptr=dlsym(m_lib, name.c_str());
159 return DynFuncHolder<T>(ptr);
160 }
161 static std::filesystem::path GetThisLibraryPath(void) {
162 Dl_info info; // local: static would be a data race across concurrent callers
163 if (! dladdr((void *) GetThisLibraryPath, & info)) return {};
164 auto rp=realpath(info.dli_fname, NULL);
165 if (!rp) {
166 #if defined(__unix__)
167 rp=realpath("/proc/self/exe", NULL);
168 #elif defined(__APPLE__)
169 // How to solve this for Apple ?
170 #endif
171 }
172 if (!rp) return {};
173 std::filesystem::path p(rp);
174 free(rp);
175 return p;
176 }
177 #else
184 void Close() {
185 if (IsOk()) {
186 // NOTE: On Windows, FreeLibrary may create a lot of troubles, should use FreeLibraryAndExitThread but...
187 // So define SOUND4_CALL_FREELIBRARY before including this file if you really want to unload the library dynamically
188 #if defined(SOUND4_CALL_FREELIBRARYANDEXITTHREAD)
189 FreeLibraryAndExitThread(m_lib, 0);
190 #elif defined(SOUND4_CALL_FREELIBRARY)
191 FreeLibrary(m_lib);
192 #endif // SOUND4_CALL_FREELIBRARY
193 m_lib=NULL;
194 }
195 }
196 template <typename T>
197 DynFuncHolder<T> GetSymbol(const std::string& name) {
198 auto ptr=GetProcAddress(m_lib, name.c_str());
199 if (!ptr) {
200 throw std::runtime_error("Missing function in library");
201 }
202 return DynFuncHolder<T>(ptr);
203 }
204 template <typename T>
205 DynFuncHolder<T> GetSymbol_safe(const std::string& name) {
206 auto ptr=GetProcAddress(m_lib, name.c_str());
207 return DynFuncHolder<T>(ptr);
208 }
209 static std::filesystem::path GetThisLibraryPath(void) {
210 static wchar_t path[MAX_PATH]={};
211 HMODULE hm = NULL;
215 {
216 if (GetModuleFileNameW(hm, path, MAX_PATH) > 0) {
217 return std::filesystem::path(path);
218 }
219 }
220 return {};
221 }
222 #endif
223 virtual ~CDynLoader() {
224 Close();
225 }
226 }; // class CDynLoader
227 }; // namespace helper
228
235 class CDynLib {
236 private:
237 helper::CDynLoader m_lib;
238 bool m_bOK = false;
239 public:
240 CDynLib() = default;
241
242 // All those wrapped functions have the same signature as there C impactfm_XXX
287#if IMPACTFM_HAS_WEBSERVER
293#endif // IMPACTFM_HAS_WEBSERVER
294
295 // added 2023-03-22
298
299 // added 2023-05-22
303
304 // added 2023-06-20
307
308 // added 2023-09-21
312
313#if IMPACTFM_HAS_CLOUDBUS
314 // added 2023-06-26
315 helper::DynFuncHolder< decltype(impactfm_NewBus ) > NewBus ;
316 helper::DynFuncHolder< decltype(impactfm_FreeBus ) > FreeBus ;
317 helper::DynFuncHolder< decltype(impactfm_SetInstanceBus ) > SetInstanceBus ;
318#endif // IMPACTFM_HAS_CLOUDBUS
319
320 // added 2024-02-19
322
323#if IMPACTFM_HAS_WEBSERVER
324 // added 2024-05-23
328#endif // IMPACTFM_HAS_WEBSERVER
329
330#ifdef _WIN32
331 // added 2025-05-28
334#endif // _WIN32
335
336 // added 2025-05-28
341
349 bool Load(const std::filesystem::path& path = {}) {
350 std::string filename;
351 #if defined(__APPLE__)
352 filename="libsound4.impactfm.cl.dylib";
353 #elif defined(__unix__)
354 filename="libsound4.impactfm.cl.so";
355 #else
356 filename="sound4.impactfm.cl.dll";
357 #endif
358 m_lib.Close();
359 // If a path is given, use it directly and do not try other path
360 if (!path.empty() && !m_lib.Load(path / filename)) {
361 return false;
362 } else if (!m_lib.IsOk()) {
363 auto thisdir=helper::CDynLoader::GetThisLibraryPath().parent_path();
364 #ifndef _WIN32
365 // Linux: if in a bin directory, try ../lib first
366 if (!m_lib.IsOk() && thisdir.filename()=="bin") {
367 auto libdir = thisdir.parent_path() / "lib";
368 m_lib.Load(libdir / filename);
369 }
370 #endif // !_WIN32
371 if (!m_lib.IsOk()) {
372 // Search in the same directory this code is in
373 m_lib.Load(thisdir / filename);
374 }
375 if (!m_lib.IsOk()) {
376 // Try current path
377 std::error_code ec;
378 auto p = std::filesystem::current_path(ec);
379 if (!ec) {
380 m_lib.Load(p / filename);
381 }
382 }
383 if (!m_lib.IsOk()) {
384 return false;
385 }
386 }
387 // Load all C functions
388 try {
389 GetVersion = m_lib.GetSymbol< decltype(impactfm_GetVersion ) >("impactfm_GetVersion" );
390 GetChunkSizeInFrames = m_lib.GetSymbol< decltype(impactfm_GetChunkSizeInFrames ) >("impactfm_GetChunkSizeInFrames" );
391 GetChannelCount = m_lib.GetSymbol< decltype(impactfm_GetChannelCount ) >("impactfm_GetChannelCount" );
392 GetAudioInputCount = m_lib.GetSymbol< decltype(impactfm_GetAudioInputCount ) >("impactfm_GetAudioInputCount" );
393 GetAudioOutputCount = m_lib.GetSymbol< decltype(impactfm_GetAudioOutputCount ) >("impactfm_GetAudioOutputCount" );
394 GetSampleRate = m_lib.GetSymbol< decltype(impactfm_GetSampleRate ) >("impactfm_GetSampleRate" );
395 SetLoggerCallback = m_lib.GetSymbol< decltype(impactfm_SetLoggerCallback ) >("impactfm_SetLoggerCallback" );
396 SetLogSeverity = m_lib.GetSymbol< decltype(impactfm_SetLogSeverity ) >("impactfm_SetLogSeverity" );
397 NewParameters = m_lib.GetSymbol< decltype(impactfm_NewParameters ) >("impactfm_NewParameters" );
398 FreeParameters = m_lib.GetSymbol< decltype(impactfm_FreeParameters ) >("impactfm_FreeParameters" );
399 SetParameter = m_lib.GetSymbol< decltype(impactfm_SetParameter ) >("impactfm_SetParameter" );
400 GetParameter = m_lib.GetSymbol< decltype(impactfm_GetParameter ) >("impactfm_GetParameter" );
401 FreeParameterValue = m_lib.GetSymbol< decltype(impactfm_FreeParameterValue ) >("impactfm_FreeParameterValue" );
402 InitProcess = m_lib.GetSymbol< decltype(impactfm_InitProcess ) >("impactfm_InitProcess" );
403 InitProcess2 = m_lib.GetSymbol< decltype(impactfm_InitProcess2 ) >("impactfm_InitProcess2" );
404 TerminateProcess = m_lib.GetSymbol< decltype(impactfm_TerminateProcess ) >("impactfm_TerminateProcess" );
405 ExitProcess = m_lib.GetSymbol< decltype(impactfm_ExitProcess ) >("impactfm_ExitProcess" );
406 StartUpdateThread = m_lib.GetSymbol< decltype(impactfm_StartUpdateThread ) >("impactfm_StartUpdateThread" );
407 StopUpdateThread = m_lib.GetSymbol< decltype(impactfm_StopUpdateThread ) >("impactfm_StopUpdateThread" );
408 WaitUpdateThreadReady = m_lib.GetSymbol< decltype(impactfm_WaitUpdateThreadReady ) >("impactfm_WaitUpdateThreadReady" );
409 ProcessAudio = m_lib.GetSymbol< decltype(impactfm_ProcessAudio ) >("impactfm_ProcessAudio" );
410 ProcessAudio_Planar = m_lib.GetSymbol< decltype(impactfm_ProcessAudio_Planar ) >("impactfm_ProcessAudio_Planar" );
411 GetBufferIn = m_lib.GetSymbol< decltype(impactfm_GetBufferIn ) >("impactfm_GetBufferIn" );
412 GetBufferOut = m_lib.GetSymbol< decltype(impactfm_GetBufferOut ) >("impactfm_GetBufferOut" );
413 GetEstimatedDelay = m_lib.GetSymbol< decltype(impactfm_GetEstimatedDelay ) >("impactfm_GetEstimatedDelay" );
414 GetFormatName = m_lib.GetSymbol< decltype(impactfm_GetFormatName ) >("impactfm_GetFormatName" );
415 GetFormatFromName = m_lib.GetSymbol< decltype(impactfm_GetFormatFromName ) >("impactfm_GetFormatFromName" );
416 GetBytesFromFormat = m_lib.GetSymbol< decltype(impactfm_GetBytesFromFormat ) >("impactfm_GetBytesFromFormat" );
417 GetMaxPacketFrame = m_lib.GetSymbol< decltype(impactfm_GetMaxPacketFrame ) >("impactfm_GetMaxPacketFrame" );
418 AddAudio = m_lib.GetSymbol< decltype(impactfm_AddAudio ) >("impactfm_AddAudio" );
419 AddPadAudio = m_lib.GetSymbol< decltype(impactfm_AddPadAudio ) >("impactfm_AddPadAudio" );
420 GetOutputCount = m_lib.GetSymbol< decltype(impactfm_GetOutputCount ) >("impactfm_GetOutputCount" );
421 GetAudio = m_lib.GetSymbol< decltype(impactfm_GetAudio ) >("impactfm_GetAudio" );
422 AudioConvertFrom = m_lib.GetSymbol< decltype(impactfm_AudioConvertFrom ) >("impactfm_AudioConvertFrom" );
423 AudioConvertTo = m_lib.GetSymbol< decltype(impactfm_AudioConvertTo ) >("impactfm_AudioConvertTo" );
424 StereoToMono = m_lib.GetSymbol< decltype(impactfm_StereoToMono ) >("impactfm_StereoToMono" );
425 MonoToStereo = m_lib.GetSymbol< decltype(impactfm_MonoToStereo ) >("impactfm_MonoToStereo" );
426 AudioMonoFromLiveStereo = m_lib.GetSymbol< decltype(impactfm_AudioMonoFromLiveStereo) >("impactfm_AudioMonoFromLiveStereo");
427 AudioMonoToLiveStereo = m_lib.GetSymbol< decltype(impactfm_AudioMonoToLiveStereo ) >("impactfm_AudioMonoToLiveStereo" );
428 NewClient = m_lib.GetSymbol< decltype(impactfm_NewClient ) >("impactfm_NewClient" );
429 DeleteClient = m_lib.GetSymbol< decltype(impactfm_DeleteClient ) >("impactfm_DeleteClient" );
430 ProcessJson = m_lib.GetSymbol< decltype(impactfm_ProcessJson ) >("impactfm_ProcessJson" );
431 FreeJsonAnswer = m_lib.GetSymbol< decltype(impactfm_FreeJsonAnswer ) >("impactfm_FreeJsonAnswer" );
432 SaveState = m_lib.GetSymbol< decltype(impactfm_SaveState ) >("impactfm_SaveState" );
433#if IMPACTFM_HAS_WEBSERVER
434 Webserver_tcp = m_lib.GetSymbol< decltype(impactfm_Webserver_tcp ) >("impactfm_Webserver_tcp" );
435 Webserver_tcp2 = m_lib.GetSymbol< decltype(impactfm_Webserver_tcp2 ) >("impactfm_Webserver_tcp2" );
436 Webserver = m_lib.GetSymbol< decltype(impactfm_Webserver ) >("impactfm_Webserver" );
437 Webserver_Stop = m_lib.GetSymbol< decltype(impactfm_Webserver_Stop ) >("impactfm_Webserver_Stop" );
438 Webserver_Status = m_lib.GetSymbol< decltype(impactfm_Webserver_Status ) >("impactfm_Webserver_Status" );
439#endif // IMPACTFM_HAS_WEBSERVER
440
441 // added 2023-03-22
442 StereoToMono_Planar = m_lib.GetSymbol< decltype(impactfm_StereoToMono_Planar ) >("impactfm_StereoToMono_Planar" );
443 MonoToStereo_Planar = m_lib.GetSymbol< decltype(impactfm_MonoToStereo_Planar ) >("impactfm_MonoToStereo_Planar" );
444
445 } catch (std::runtime_error& ) {
446 return false;
447 }
448 // C functions allowed to be missing
449 try {
450 // added 2023-05-22
451 SetMetadata = m_lib.GetSymbol< decltype(impactfm_SetMetadata ) >("impactfm_SetMetadata" );
452 GetMetadataInfos = m_lib.GetSymbol< decltype(impactfm_GetMetadataInfos ) >("impactfm_GetMetadataInfos" );
453 FreeMetadataInfos = m_lib.GetSymbol< decltype(impactfm_FreeMetadataInfos ) >("impactfm_FreeMetadataInfos" );
454 // added 2023-06-20
455 SetPresetManager = m_lib.GetSymbol< decltype(impactfm_SetPresetManager ) >("impactfm_SetPresetManager" );
456 PresetManager_InformChange = m_lib.GetSymbol< decltype(impactfm_PresetManager_InformChange ) >("impactfm_PresetManager_InformChange" );
457
458 // added 2023-09-21
459 GetPossibleChunkSizeInFrames = m_lib.GetSymbol< decltype(impactfm_GetPossibleChunkSizeInFrames ) >("impactfm_GetPossibleChunkSizeInFrames" );
460 GetProcessChunkFrames = m_lib.GetSymbol< decltype(impactfm_GetProcessChunkFrames ) >("impactfm_GetProcessChunkFrames" );
461 InitProcess3 = m_lib.GetSymbol< decltype(impactfm_InitProcess3 ) >("impactfm_InitProcess3" );
462
463#if IMPACTFM_HAS_CLOUDBUS
464 // added 2023-06-26
465 NewBus = m_lib.GetSymbol< decltype(impactfm_NewBus ) >("impactfm_NewBus" );
466 FreeBus = m_lib.GetSymbol< decltype(impactfm_FreeBus ) >("impactfm_FreeBus" );
467 SetInstanceBus = m_lib.GetSymbol< decltype(impactfm_SetInstanceBus ) >("impactfm_SetInstanceBus" );
468#endif // IMPACTFM_HAS_CLOUDBUS
469
470 // added 2024-02-19
471 SetMetadataMulti = m_lib.GetSymbol< decltype(impactfm_SetMetadataMulti ) >("impactfm_SetMetadataMulti" );
472
473#if IMPACTFM_HAS_WEBSERVER
474 // added 2024-05-23
475 Webserver_SetAppHealth = m_lib.GetSymbol< decltype(impactfm_Webserver_SetAppHealth ) >("Webserver_SetAppHealth" );
476 Webserver_GetAppHealth = m_lib.GetSymbol< decltype(impactfm_Webserver_GetAppHealth ) >("Webserver_GetAppHealth" );
477 Webserver_FreeString = m_lib.GetSymbol< decltype(impactfm_Webserver_FreeString ) >("Webserver_FreeString" );
478 #endif // IMPACTFM_HAS_WEBSERVER
479
480#ifdef _WIN32
481 // added 2025-05-28
482 SetInstanceTracing = m_lib.GetSymbol< decltype(impactfm_SetInstanceTracing ) >("SetInstanceTracing" );
483 SetInstanceTracingProcessActivity = m_lib.GetSymbol< decltype(impactfm_SetInstanceTracingProcessActivity) >("SetInstanceTracingProcessActivity");
484#endif // _WIN32
485
486 // added 2025-05-28
487 GetAudioConverter = m_lib.GetSymbol< decltype(impactfm_GetAudioConverter ) >("GetAudioConverter" );
488 FreeAudioConverter = m_lib.GetSymbol< decltype(impactfm_FreeAudioConverter ) >("FreeAudioConverter" );
489 AudioConverter_From = m_lib.GetSymbol< decltype(impactfm_AudioConverter_From ) >("AudioConverter_From" );
490 AudioConverter_To = m_lib.GetSymbol< decltype(impactfm_AudioConverter_To ) >("AudioConverter_To" );
491
492 } catch (std::runtime_error& ) {
493 // Ignored, handler will take care
494 }
495
496 m_bOK=true;
497 return true;
498 }
505 bool IsOk() const {
506 return m_bOK;
507 }
508
509 };
510
511
512
513 static constexpr const char *process_name = "SOUND4 IMPACT FM.CL";
514 static constexpr const char *process_shortname = "impactfm";
546
550 namespace helper {
551 #ifdef _WIN32
557 static inline std::string WStringToUTF8(const std::wstring& wstr) {
558 if (wstr.empty()) return {};
559 int size = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), NULL, 0, NULL, NULL);
560 std::string str(size, 0);
561 WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), &str[0], size, NULL, NULL);
562 return str;
563 }
569 static inline std::wstring UTF8ToWString(const std::string& str) {
570 if (str.empty()) return std::wstring();
571 int size = MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), NULL, 0);
572 std::wstring wstr(size, 0);
573 MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), &wstr[0], size);
574 return wstr;
575 }
576 #endif // _WIN32
577
583 template<typename T>
585 };
586 template<>
587 struct SampleFormat<int16_t> {
588 const impactfm_SampleFormat format = S16_NATIVE;
589 };
590 template<>
591 struct SampleFormat<int32_t> {
592 const impactfm_SampleFormat format = S32_NATIVE;
593 };
594 template<>
595 struct SampleFormat<float> {
596 const impactfm_SampleFormat format = F32_NATIVE;
597 };
598
599 // --------------------------------------------------------------
611 static inline void AudioConvertFrom(CDynLib& dynlib, const uint8_t *payload, float *output, size_t nSpl, impactfm_SampleFormat fmt) {
612 dynlib.AudioConvertFrom(payload, output, nSpl, fmt);
613 }
614
626 static inline void AudioConvertTo(CDynLib& dynlib, const float *input, uint8_t *payload, size_t nSpl, impactfm_SampleFormat fmt) {
627 dynlib.AudioConvertTo(input, payload, nSpl, fmt);
628 }
629
640 static inline void StereoToMono(CDynLib& dynlib, const float *input, float *output, size_t nFrame) {
641 dynlib.StereoToMono(input, output, nFrame);
642 }
643
654 static inline void MonoToStereo(CDynLib& dynlib, const float *input, float *output, size_t nFrame) {
655 dynlib.MonoToStereo(input, output, nFrame);
656 }
657
669 static inline void StereoToMono_Planar(CDynLib& dynlib, const float *inputL, const float *inputR, float *output, size_t nFrame) {
670 dynlib.StereoToMono_Planar(inputL, inputR, output, nFrame);
671 }
672
684 static inline void MonoToStereo_Planar(CDynLib& dynlib, const float *input, float *outputL, float *outputR, size_t nFrame) {
685 dynlib.MonoToStereo_Planar(input, outputL, outputR, nFrame);
686 }
687
695 static inline void AudioMonoFromLiveStereo(CDynLib& dynlib, const uint8_t *payload, float *output) {
696 dynlib.AudioMonoFromLiveStereo(payload, output);
697 }
698
706 static inline void AudioMonoToLiveStereo(CDynLib& dynlib, const float *input, uint8_t *payload) {
707 dynlib.AudioMonoToLiveStereo(input, payload);
708 }
709
710 }; // namespace helper
711
718 static inline std::string GetVersion(CDynLib& dynlib)
719 {
720 return std::string(dynlib.GetVersion());
721 }
722
734 static inline unsigned int GetChunkSizeInFrames(CDynLib& dynlib)
735 {
736 return dynlib.GetChunkSizeInFrames();
737 }
738
748 static inline std::vector<unsigned int> GetPossibleChunkSizeInFrames(CDynLib& dynlib)
749 {
750 std::vector<unsigned int> list;
751 if (dynlib.GetPossibleChunkSizeInFrames) {
752 for (unsigned int* src=dynlib.GetPossibleChunkSizeInFrames();*src;src++) {
753 list.push_back(*src);
754 }
755 } else {
756 list.push_back(64);
757 }
758 return list;
759 }
760
767 static inline unsigned int GetChannelCount(CDynLib& dynlib)
768 {
769 return dynlib.GetChannelCount();
770 }
771
780 static inline unsigned int GetAudioInputCount(CDynLib& dynlib)
781 {
782 return dynlib.GetAudioInputCount();
783 }
784
793 static inline unsigned int GetAudioOutputCount(CDynLib& dynlib)
794 {
795 return dynlib.GetAudioOutputCount();
796 }
797
806 static inline unsigned int GetSampleRate(CDynLib& dynlib)
807 {
808 return dynlib.GetSampleRate();
809 }
810
818 static inline void SanityCheck(CDynLib& dynlib, bool a_bCheckFrames = true)
819 {
820 // Do some sanity checks
821 if (dynlib.GetSampleRate()!=IMPACTFM_SAMPLE_RATE) {
822 throw std::runtime_error("Bad library sampling rate");
823 }
824 if (a_bCheckFrames && dynlib.GetChunkSizeInFrames()!=ChunkFrames) {
825 throw std::runtime_error("Bad library frame size");
826 }
828 throw std::runtime_error("Bad library channel count");
829 }
831 throw std::runtime_error("Bad library input count");
832 }
834 throw std::runtime_error("Bad library output count");
835 }
836 }
837
845 static inline std::string GetFormatName(CDynLib& dynlib, const SampleFormat fmt)
846 {
847 return std::string(dynlib.GetFormatName(fmt));
848 }
849
857 static inline SampleFormat GetFormatFromName(CDynLib& dynlib, const std::string& name)
858 {
859 return dynlib.GetFormatFromName(name.c_str());
860 }
861
869 static inline unsigned int GetBytesFromFormat(CDynLib& dynlib, const SampleFormat fmt)
870 {
871 return dynlib.GetBytesFromFormat(fmt);
872 }
873
881 using log_cb_t = std::function<void(LogSeverity,const std::string&)>;
882
887 extern "C" {
888 static inline void _log_cb_c(impactfm_LogSeverity severity, const char *c_msg) {
889 _log_cb(severity, std::string(c_msg));
890 }
891 }
895 static inline void SetLogSeverity(CDynLib& dynlib, LogSeverity severity)
896 {
897 dynlib.SetLogSeverity(severity);
898 }
902 static inline void SetLoggerCallback(CDynLib& dynlib, log_cb_t cb)
903 {
904 _log_cb=cb;
906 }
907
908#if IMPACTFM_HAS_CLOUDBUS
914 class CBus {
915 public:
916 CBus(CDynLib& dynlib)
917 : m_dynlib(dynlib)
918 {
919 if (m_dynlib.NewBus) {
920 m_bus=m_dynlib.NewBus();
921 }
922 }
923 ~CBus()
924 {
925 if (m_bus && m_dynlib.FreeBus) {
926 m_dynlib.FreeBus(m_bus);
927 }
928 m_bus = nullptr;
929 }
930 impactfm_CBus *Get() const { return m_bus; }
931 private:
932 CDynLib& m_dynlib;
933 impactfm_CBus *m_bus;
934 };
935#endif // IMPACTFM_HAS_CLOUDBUS
936
943 public:
944 CPresetLoader() = default;
945 virtual ~CPresetLoader() = default;
946
947 virtual bool IsReadOnly() = 0;
948 virtual bool Exists(const std::filesystem::path &name) = 0;
949 virtual bool Remove(const std::filesystem::path &name) = 0;
950 virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to) = 0;
951 virtual std::vector<std::filesystem::path> GetAll() = 0;
952 virtual std::string Read(const std::filesystem::path &filename) = 0;
953 virtual bool Write(const std::filesystem::path &filename, const std::string &content) =0;
954 };
956
962 class CInstance {
963 public:
968 : m_dynlib(dynlib)
969 {
970 params = m_dynlib.NewParameters();
971 if (!params) throw std::bad_alloc();
972 }
973 // non-copyable
974 CInstance( const CInstance& ) = delete;
975 CInstance& operator=( const CInstance& ) = delete;
979 virtual ~CInstance()
980 {
981 Stop();
982 if (params) m_dynlib.FreeParameters(params);
983 }
987 bool IsOk() const { return instance!=nullptr; }
997 void SetParam(const std::string& name, const std::string& value)
998 {
999 assert(params);
1000 m_dynlib.SetParameter(params, name.c_str(), value.c_str());
1001 }
1008 std::string GetParam(const std::string& name)
1009 {
1010 assert(params);
1011 auto c_value=m_dynlib.GetParameter(params, name.c_str());
1012 std::string ret(c_value);
1013 m_dynlib.FreeParameterValue(c_value);
1014 return ret;
1015 }
1016#if IMPACTFM_HAS_CLOUDBUS
1025 void SetBus(const CBus& bus) {
1026 assert(params);
1027 if (m_dynlib.SetInstanceBus) {
1028 m_dynlib.SetInstanceBus(params,bus.Get());
1029 }
1030 }
1031#endif // IMPACTFM_HAS_CLOUDBUS
1032
1043 void SetPresetManager(CPresetLoader *preset_manager)
1044 {
1045 if (!preset_manager) return;
1046 if (!m_dynlib.SetPresetManager) return;
1047 assert(params);
1048 m_dynlib.SetPresetManager(params,
1057 preset_manager->IsReadOnly(),
1058 preset_manager
1059 );
1060 }
1061
1084 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)
1085 {
1086 assert(!instance);
1087 std::string l_save_path;
1088 if (!save_path.empty()) {
1089 #if (__cplusplus<202002L)
1090 l_save_path = save_path.u8string();
1091 #else // C++20
1092 l_save_path = (const char*)save_path.u8string().c_str();
1093 #endif // C++20
1094 }
1095 if (m_dynlib.InitProcess3) {
1096 instance = m_dynlib.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);
1097 } else if (frames_per_chunk!=64) {
1098 return false;
1099 } else {
1100 instance = m_dynlib.InitProcess2(LoginKey.c_str(), RadioName.c_str(), Access_Key_ID.c_str(), Access_Key_Secret.c_str(), l_save_path.c_str(), params);
1101 }
1102 if (!instance) return false;
1103 if (!init_metadata.empty()) {
1104 for (auto&& [key,value]: init_metadata) {
1105 m_dynlib.SetMetadata(instance, key.c_str(), value.c_str());
1106 }
1107 init_metadata.clear();
1108 }
1109 update_thread = std::thread([this, json_port](){
1111 m_dynlib.StartUpdateThread(instance, json_port);
1113 });
1114 int timeout=5000;
1115 #ifdef DEBUG
1116 timeout=60*1000; // For debugger pauses
1117 #endif
1118 if (m_dynlib.WaitUpdateThreadReady(instance, timeout)<0) {
1119 return false;
1120 }
1121 return true;
1122 }
1123
1131 unsigned int GetChunkFrames() {
1132 if (instance && m_dynlib.GetProcessChunkFrames) {
1133 return m_dynlib.GetProcessChunkFrames(instance);
1134 }
1135 return 64;
1136 }
1137
1145 void PresetManager_InformChange(const std::filesystem::path& relative_path, PresetChange_Kind change_kind)
1146 {
1147 if (m_dynlib.PresetManager_InformChange) {
1148 m_dynlib.PresetManager_InformChange(instance, relative_path.c_str(), (impactfm_PresetChange_Kind) change_kind);
1149 }
1150 }
1151
1163 void SetMetadata(const std::string& key, const char* value)
1164 {
1165 if (m_dynlib.SetMetadata) {
1166 if (instance) {
1167 m_dynlib.SetMetadata(instance, key.c_str(), value);
1168 } else {
1169 init_metadata.push_back( {key, value} );
1170 }
1171 }
1172 }
1173
1174
1184 void SetMetadataMulti(const std::unordered_map<std::string, const char*>& list)
1185 {
1186 if (instance) {
1187 if (m_dynlib.SetMetadataMulti) {
1188 typedef const char* pchar;
1189 pchar* keyvalue=new pchar[2*list.size()+1];
1190 size_t n=0;
1191 for (auto&& [key,value]: list) {
1192 keyvalue[2*n+0]=key.c_str();
1193 keyvalue[2*n+1]=value;
1194 n++;
1195 }
1196 keyvalue[2*n+0]=nullptr;
1197
1198 impactfm_SetMetadataMulti(instance, keyvalue);
1199
1200 delete[] keyvalue;
1201 } else {
1202 for (auto&& [key,value]: list) {
1203 SetMetadata(key, value);
1204 }
1205 }
1206 } else {
1207 for (auto&& [key,value]: list) {
1208 if (value) {
1209 init_metadata.push_back( {key, value} );
1210 }
1211 }
1212 }
1213 }
1214
1220 std::vector< std::tuple<std::string,std::string> > GetMetadataInfos()
1221 {
1222 std::vector< std::tuple<std::string,std::string> > values;
1223 if (m_dynlib.GetMetadataInfos) {
1224 const char** c_values = m_dynlib.GetMetadataInfos(instance);
1225 if (c_values) {
1226 for (const char** c_value=c_values; *c_value; ) {
1227 std::string key(*c_value);
1228 c_value++;
1229 if (*c_value) {
1230 std::string descr(*c_value);
1231 c_value++;
1232 values.push_back( {key,descr} );
1233 }
1234 }
1235 m_dynlib.FreeMetadataInfos(instance, c_values);
1236 }
1237 }
1238 return values;
1239 }
1240
1244 virtual void OnUpdateThreadStart() {}
1248 virtual void OnUpdateThreadStop() {}
1249
1250#if IMPACTFM_HAS_WEBSERVER
1264 bool StartWebServer(int http_port, int https_port=0)
1265 {
1266 assert(instance);
1267 assert(webserver==SOUND4_INVALID_WEBSERVER_ID);
1268 webserver = m_dynlib.Webserver(http_port,https_port,instance);
1269 if (webserver==SOUND4_INVALID_WEBSERVER_ID) {
1270 return false;
1271 }
1272 int web_status=m_dynlib.Webserver_Status(webserver);
1273 if (http_port && (web_status & SOUND4_WEBSERVER_HTTP_OK) == 0) {
1274 return false;
1275 }
1276 if (https_port && (web_status & SOUND4_WEBSERVER_HTTPS_OK) == 0) {
1277 return false;
1278 }
1279 return true;
1280 }
1281
1289 void StopWebServer(int timeout_ms = 1000)
1290 {
1291 if (webserver != SOUND4_INVALID_WEBSERVER_ID) {
1292 m_dynlib.Webserver_Stop(webserver, timeout_ms);
1293 webserver = SOUND4_INVALID_WEBSERVER_ID;
1294 }
1295 }
1296
1300 void SetWebServerAppHealth(int httpcode, const std::string& contenttype, const std::string& content)
1301 {
1302 assert(instance);
1303 if (!m_dynlib.Webserver_SetAppHealth) return;
1304 m_dynlib.Webserver_SetAppHealth(instance, httpcode, contenttype.c_str(), content.c_str());
1305 }
1309 void GetWebServerAppHealth(int &httpcode, std::string& contenttype, std::string& content)
1310 {
1311 assert(instance);
1312 if (!m_dynlib.Webserver_GetAppHealth) return;
1313 char* c_contenttype=nullptr;
1314 char* c_content=nullptr;
1315 m_dynlib.Webserver_GetAppHealth(instance, &httpcode, &c_contenttype, &c_content);
1316 contenttype=c_contenttype;
1317 content=c_content;
1318 m_dynlib.Webserver_FreeString(c_contenttype);
1319 m_dynlib.Webserver_FreeString(c_content);
1320 }
1321#endif // IMPACTFM_HAS_WEBSERVER
1322
1332 {
1333 if (!instance) return 0;
1334 return m_dynlib.TerminateProcess(instance);
1335 }
1336
1340 void Stop()
1341 {
1342 if (!instance) return;
1343#if IMPACTFM_HAS_WEBSERVER
1344 StopWebServer();
1345#endif // IMPACTFM_HAS_WEBSERVER
1346 if (update_thread.joinable()) {
1347 m_dynlib.StopUpdateThread(instance); // this will exit the update thread
1348 update_thread.join();
1349 }
1350 m_dynlib.ExitProcess(instance);
1351 instance=nullptr;
1352 }
1353
1363 unsigned int GetEstimatedDelay()
1364 {
1365 assert(instance);
1366 return m_dynlib.GetEstimatedDelay(instance);
1367 }
1368
1381 std::array<float,InputSampleSize>& GetBufferIn()
1382 {
1383 assert(instance);
1384 float *buf=m_dynlib.GetBufferIn(instance);
1385 return reinterpret_cast< std::array<float,InputSampleSize>& >(*buf);
1386
1387 }
1399 std::array<float,OutputSampleSize>& GetBufferOut()
1400 {
1401 assert(instance);
1402 float *buf= m_dynlib.GetBufferOut(instance);
1403 return reinterpret_cast< std::array<float,OutputSampleSize>& >(*buf);
1404 }
1409 {
1410 assert(instance);
1411 m_dynlib.ProcessAudio(instance, m_dynlib.GetBufferIn(instance), m_dynlib.GetBufferOut(instance));
1412 }
1424 void ProcessAudio_Planar(float const * const *input, float * const *output)
1425 {
1426 assert(instance);
1427 m_dynlib.ProcessAudio_Planar(instance, input, output);
1428 }
1429
1441 template<typename T>
1442 std::vector<T> ProcessAnyAudio(const std::vector<T> input)
1443 {
1444 assert(instance);
1445 std::vector<T> output;
1446 unsigned int out_offset=0;
1447 unsigned int in_offset=0;
1448 unsigned int todo = input.size();
1449 while (todo>0) {
1450 unsigned int left = AddAudio(&input[in_offset], todo);
1451 unsigned int out_avail = m_dynlib.GetOutputCount(instance);
1452 output.resize(out_offset + out_avail);
1453 GetAudio(&output[out_offset], out_avail);
1454 out_offset+=out_avail;
1455 in_offset += todo-left;
1456 todo=left;
1457 }
1458 return output;
1459 }
1460
1466 class CClient {
1467 public:
1469 : m_dynlib(dynlib)
1470 {
1471 assert(instance);
1472 client=m_dynlib.NewClient(instance);
1473 if (!client) throw std::bad_alloc();
1474 }
1475 // non-copyable
1476 CClient( const CInstance& ) = delete;
1477 CClient& operator=( const CInstance& ) = delete;
1479 {
1480 if (client) {
1481 m_dynlib.DeleteClient(client);
1482 client=nullptr;
1483 }
1484 }
1492 std::string ProcessJson(const std::string &request, bool *NeedSave = nullptr)
1493 {
1494 assert(client);
1495 int need_save=0;
1496 const char *canswer = m_dynlib.ProcessJson(client, request.c_str(), &need_save);
1497 if (!canswer) return {};
1498 std::string answer(canswer);
1499 m_dynlib.FreeJsonAnswer (canswer);
1500 if (NeedSave) {
1501 *NeedSave=(need_save!=0);
1502 }
1503 return answer;
1504 }
1505 private:
1506 CDynLib& m_dynlib;
1507 impactfm_CClientInstance *client = nullptr;
1508 };
1516 std::shared_ptr<CClient> NewClient()
1517 {
1518 assert(instance);
1519 return std::make_shared<CClient>(instance, m_dynlib);
1520 }
1521
1532 bool SaveState() {
1533 assert(instance);
1534 if (m_dynlib.SaveState(instance)!=0) {
1535 return false;
1536 }
1537 return true;
1538 }
1539#ifdef _WIN32
1546 void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid = {}) {
1547 if (m_dynlib.SetInstanceTracing) {
1548 m_dynlib.SetInstanceTracing(params, tracing_provider, activity_guid);
1549 }
1550 }
1557 void SetInstanceTracingProcessActivity(GUID activity_guid) {
1558 assert(instance);
1559 if (m_dynlib.SetInstanceTracingProcessActivity) {
1560 m_dynlib.SetInstanceTracingProcessActivity(instance, activity_guid);
1561 }
1562 }
1563#endif // _WIN32
1564 protected:
1565 template<typename T>
1566 unsigned int AddAudio(const T* payload, unsigned int nFrame)
1567 {
1568 assert(instance);
1569 return m_dynlib.AddAudio(instance, reinterpret_cast<const T*>(payload), nFrame, helper::SampleFormat<T>::format);
1570 }
1571 template<typename T>
1572 unsigned int GetAudio(T* payload, unsigned int max_nFrame)
1573 {
1574 assert(instance);
1575 return m_dynlib.GetAudio(instance, reinterpret_cast<T*>(payload), max_nFrame, helper::SampleFormat<T>::format);
1576 }
1577
1578 private:
1579 CDynLib& m_dynlib;
1580 impactfm_CParameters* params = nullptr;
1581 impactfm_CInstance* instance = nullptr;
1582 std::thread update_thread;
1583 std::vector< std::pair<std::string,std::string> > init_metadata;
1584#if IMPACTFM_HAS_WEBSERVER
1585 uint64_t webserver = SOUND4_INVALID_WEBSERVER_ID;
1586#endif // IMPACTFM_HAS_WEBSERVER
1587 };
1588
1596 public:
1603 : m_dynlib(dynlib)
1604 { }
1605
1610 {
1611 Delete();
1612 }
1613
1629 bool Configure(SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, impactfm_ConverterTargetMode target_mode)
1630 {
1631 Delete();
1632 if (m_dynlib.GetAudioConverter)
1633 m_cvt = m_dynlib.GetAudioConverter((impactfm_SampleFormat)fmt, nFrame, payl_ch, payl_ch_offset, target_mode);
1634 return IsOK();
1635 }
1636 void Delete()
1637 {
1638 if (m_cvt && m_dynlib.FreeAudioConverter) {
1639 m_dynlib.FreeAudioConverter(m_cvt);
1640 }
1641 m_cvt = nullptr;
1642 }
1643 bool IsOK() const { return (m_cvt!=nullptr); }
1644
1653 void ConvertFrom(const uint8_t *payload, float *output)
1654 { m_dynlib.AudioConverter_From(m_cvt, payload, output); }
1655
1664 void ConvertTo(const float *input, uint8_t *payload)
1665 { m_dynlib.AudioConverter_To(m_cvt, input, payload); }
1666
1667 private:
1668 CDynLib& m_dynlib;
1669 impactfm_CAudioConverter *m_cvt = nullptr;
1670 };
1671
1672}; // namespace dyn
1673}; // namespace impactfm
1674}; // namespace sound4
1675
1676// bridge C callbacks to CPresetLoader
1677extern "C" {
1678 static char *impactfm_custom_reader(const fs_char *filename, void* userdata) {
1679 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1680 std::string content=preset_loader->Read(filename);
1681 return strdup(content.c_str());
1682 }
1683 static void impactfm_custom_reader_free(char *content, void* userdata) {
1684 if (!content) return;
1685 free(content);
1686 }
1687 static int impactfm_custom_writer(const fs_char *filename, const char *content, void* userdata) {
1688 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1689 auto res=preset_loader->Write(filename,content);
1690 return res?0:-1;
1691 }
1692 static int impactfm_custom_exists(const fs_char *filename, void* userdata) {
1693 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1694 auto res=preset_loader->Exists(filename);
1695 return res?0:-1;
1696 }
1697 static fs_char** impactfm_custom_getall(void* userdata) {
1698 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1699 auto res=preset_loader->GetAll();
1700 fs_char**all=(fs_char**)malloc((res.size()+1)*sizeof(const fs_char*));
1701 for (size_t n=0;n<res.size();n++) {
1702 all[n]=fs_strdup(res[n].c_str());
1703 }
1704 all[res.size()]=nullptr;
1705 return all;
1706 }
1707 static void impactfm_custom_getall_free(fs_char** all, void* userdata) {
1708 if (!all) return;
1709 for (fs_char** one=all;*one;one++) {
1710 free(*one);
1711 }
1712 free(all);
1713 }
1714 static int impactfm_custom_remove(const fs_char *filename, void* userdata) {
1715 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1716 auto res=preset_loader->Remove(filename);
1717 return res?0:-1;
1718 }
1719 static int impactfm_custom_rename(const fs_char *from, const fs_char *to, void* userdata) {
1720 sound4::impactfm::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::impactfm::dyn::CPresetLoader*>(userdata);
1721 auto res=preset_loader->Rename(from,to);
1722 return res?0:-1;
1723 }
1724
1725};
Shared Bus.
Definition sound4cl.hpp:871
sound4cl_CBus * Get() const
Definition sound4cl.hpp:889
void ConvertFrom(const uint8_t *payload, float *output)
void ConvertTo(const float *input, uint8_t *payload)
virtual ~CAudioConverter()
Destroy the CAudioConverter object.
CAudioConverter(CDynLib &dynlib)
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)
helper::DynFuncHolder< decltype(impactfm_SetPresetManager) > SetPresetManager
helper::DynFuncHolder< decltype(impactfm_GetAudioConverter) > GetAudioConverter
helper::DynFuncHolder< decltype(impactfm_TerminateProcess) > TerminateProcess
helper::DynFuncHolder< decltype(impactfm_ProcessJson) > ProcessJson
helper::DynFuncHolder< decltype(impactfm_GetMaxPacketFrame) > GetMaxPacketFrame
helper::DynFuncHolder< decltype(impactfm_GetBytesFromFormat) > GetBytesFromFormat
helper::DynFuncHolder< decltype(impactfm_GetPossibleChunkSizeInFrames) > GetPossibleChunkSizeInFrames
helper::DynFuncHolder< decltype(impactfm_GetFormatName) > GetFormatName
helper::DynFuncHolder< decltype(impactfm_Webserver) > Webserver
bool Load(const std::filesystem::path &path={})
Loads the library.
helper::DynFuncHolder< decltype(impactfm_InitProcess3) > InitProcess3
helper::DynFuncHolder< decltype(impactfm_AudioConvertFrom) > AudioConvertFrom
helper::DynFuncHolder< decltype(impactfm_GetAudioOutputCount) > GetAudioOutputCount
helper::DynFuncHolder< decltype(impactfm_MonoToStereo) > MonoToStereo
helper::DynFuncHolder< decltype(impactfm_GetSampleRate) > GetSampleRate
helper::DynFuncHolder< decltype(impactfm_DeleteClient) > DeleteClient
helper::DynFuncHolder< decltype(impactfm_SaveState) > SaveState
helper::DynFuncHolder< decltype(impactfm_ProcessAudio) > ProcessAudio
helper::DynFuncHolder< decltype(impactfm_SetInstanceTracingProcessActivity) > SetInstanceTracingProcessActivity
helper::DynFuncHolder< decltype(impactfm_GetEstimatedDelay) > GetEstimatedDelay
helper::DynFuncHolder< decltype(impactfm_ExitProcess) > ExitProcess
helper::DynFuncHolder< decltype(impactfm_WaitUpdateThreadReady) > WaitUpdateThreadReady
helper::DynFuncHolder< decltype(impactfm_ProcessAudio_Planar) > ProcessAudio_Planar
helper::DynFuncHolder< decltype(impactfm_SetMetadata) > SetMetadata
helper::DynFuncHolder< decltype(impactfm_NewClient) > NewClient
helper::DynFuncHolder< decltype(impactfm_AudioMonoToLiveStereo) > AudioMonoToLiveStereo
helper::DynFuncHolder< decltype(impactfm_AddPadAudio) > AddPadAudio
helper::DynFuncHolder< decltype(impactfm_Webserver_GetAppHealth) > Webserver_GetAppHealth
helper::DynFuncHolder< decltype(impactfm_FreeParameters) > FreeParameters
helper::DynFuncHolder< decltype(impactfm_MonoToStereo_Planar) > MonoToStereo_Planar
helper::DynFuncHolder< decltype(impactfm_GetParameter) > GetParameter
helper::DynFuncHolder< decltype(impactfm_Webserver_SetAppHealth) > Webserver_SetAppHealth
helper::DynFuncHolder< decltype(impactfm_GetFormatFromName) > GetFormatFromName
helper::DynFuncHolder< decltype(impactfm_InitProcess) > InitProcess
helper::DynFuncHolder< decltype(impactfm_AudioConverter_To) > AudioConverter_To
helper::DynFuncHolder< decltype(impactfm_GetChunkSizeInFrames) > GetChunkSizeInFrames
helper::DynFuncHolder< decltype(impactfm_StereoToMono_Planar) > StereoToMono_Planar
helper::DynFuncHolder< decltype(impactfm_Webserver_Status) > Webserver_Status
helper::DynFuncHolder< decltype(impactfm_GetBufferIn) > GetBufferIn
helper::DynFuncHolder< decltype(impactfm_GetAudioInputCount) > GetAudioInputCount
helper::DynFuncHolder< decltype(impactfm_GetVersion) > GetVersion
helper::DynFuncHolder< decltype(impactfm_FreeJsonAnswer) > FreeJsonAnswer
helper::DynFuncHolder< decltype(impactfm_FreeParameterValue) > FreeParameterValue
helper::DynFuncHolder< decltype(impactfm_StopUpdateThread) > StopUpdateThread
helper::DynFuncHolder< decltype(impactfm_Webserver_FreeString) > Webserver_FreeString
helper::DynFuncHolder< decltype(impactfm_SetInstanceTracing) > SetInstanceTracing
helper::DynFuncHolder< decltype(impactfm_StereoToMono) > StereoToMono
helper::DynFuncHolder< decltype(impactfm_NewParameters) > NewParameters
bool IsOk() const
Check if the library was loaded correctly.
helper::DynFuncHolder< decltype(impactfm_GetAudio) > GetAudio
helper::DynFuncHolder< decltype(impactfm_SetLogSeverity) > SetLogSeverity
helper::DynFuncHolder< decltype(impactfm_PresetManager_InformChange) > PresetManager_InformChange
helper::DynFuncHolder< decltype(impactfm_StartUpdateThread) > StartUpdateThread
helper::DynFuncHolder< decltype(impactfm_AudioConverter_From) > AudioConverter_From
helper::DynFuncHolder< decltype(impactfm_InitProcess2) > InitProcess2
helper::DynFuncHolder< decltype(impactfm_AddAudio) > AddAudio
helper::DynFuncHolder< decltype(impactfm_SetLoggerCallback) > SetLoggerCallback
helper::DynFuncHolder< decltype(impactfm_GetChannelCount) > GetChannelCount
helper::DynFuncHolder< decltype(impactfm_GetProcessChunkFrames) > GetProcessChunkFrames
helper::DynFuncHolder< decltype(impactfm_GetBufferOut) > GetBufferOut
helper::DynFuncHolder< decltype(impactfm_Webserver_Stop) > Webserver_Stop
helper::DynFuncHolder< decltype(impactfm_Webserver_tcp2) > Webserver_tcp2
helper::DynFuncHolder< decltype(impactfm_GetOutputCount) > GetOutputCount
helper::DynFuncHolder< decltype(impactfm_SetParameter) > SetParameter
helper::DynFuncHolder< decltype(impactfm_AudioMonoFromLiveStereo) > AudioMonoFromLiveStereo
helper::DynFuncHolder< decltype(impactfm_FreeAudioConverter) > FreeAudioConverter
helper::DynFuncHolder< decltype(impactfm_SetMetadataMulti) > SetMetadataMulti
helper::DynFuncHolder< decltype(impactfm_AudioConvertTo) > AudioConvertTo
helper::DynFuncHolder< decltype(impactfm_GetMetadataInfos) > GetMetadataInfos
helper::DynFuncHolder< decltype(impactfm_FreeMetadataInfos) > FreeMetadataInfos
helper::DynFuncHolder< decltype(impactfm_Webserver_tcp) > Webserver_tcp
CClient & operator=(const CInstance &)=delete
CClient(impactfm_CInstance *instance, CDynLib &dynlib)
std::string ProcessJson(const std::string &request, bool *NeedSave=nullptr)
Process a JSON request and returns the answer.
void ProcessAudio_Planar(float const *const *input, float *const *output)
CInstance(const CInstance &)=delete
std::array< float, InputSampleSize > & GetBufferIn()
void SetPresetManager(CPresetLoader *preset_manager)
void PresetManager_InformChange(const std::filesystem::path &relative_path, PresetChange_Kind change_kind)
std::string GetParam(const std::string &name)
void GetWebServerAppHealth(int &httpcode, std::string &contenttype, std::string &content)
void SetMetadataMulti(const std::unordered_map< std::string, const char * > &list)
unsigned int GetAudio(T *payload, unsigned int max_nFrame)
void SetParam(const std::string &name, const std::string &value)
unsigned int AddAudio(const T *payload, unsigned int nFrame)
std::vector< std::tuple< std::string, std::string > > GetMetadataInfos()
void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid={})
std::vector< T > ProcessAnyAudio(const std::vector< T > input)
std::array< float, OutputSampleSize > & GetBufferOut()
bool StartWebServer(int http_port, int https_port=0)
void SetMetadata(const std::string &key, const char *value)
CInstance & operator=(const CInstance &)=delete
void SetInstanceTracingProcessActivity(GUID activity_guid)
void SetWebServerAppHealth(int httpcode, const std::string &contenttype, const std::string &content)
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)
virtual std::vector< std::filesystem::path > GetAll()=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 Remove(const std::filesystem::path &name)=0
virtual std::string Read(const std::filesystem::path &filename)=0
virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to)=0
DynFuncHolder< T > GetSymbol(const std::string &name)
CDynLoader(const CDynLoader &)=delete
bool Load(const std::filesystem::path &dynlib, uint32_t loadflags=LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR|LOAD_LIBRARY_SEARCH_APPLICATION_DIR|LOAD_LIBRARY_SEARCH_USER_DIRS|LOAD_LIBRARY_SEARCH_SYSTEM32)
CDynLoader & operator=(CDynLoader &&other) noexcept
CDynLoader & operator=(CDynLoader const &)=delete
DynFuncHolder< T > GetSymbol_safe(const std::string &name)
static std::filesystem::path GetThisLibraryPath(void)
impactfm_SampleFormat
unsigned int impactfm_AddAudio(struct impactfm_CInstance *instance, const uint8_t *payload, unsigned int nFrame, enum impactfm_SampleFormat fmt)
unsigned int impactfm_GetMaxPacketFrame(struct impactfm_CInstance *instance)
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_AddPadAudio(struct impactfm_CInstance *instance)
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)
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)
struct impactfm_CInstance * impactfm_InitProcess2(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)
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)
struct impactfm_CInstance * impactfm_InitProcess(const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path)
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
uint64_t impactfm_Webserver_tcp(unsigned int listenport, unsigned int listenport_secure, const char *socket_ip, unsigned int socket_port)
int impactfm_Webserver_Stop(uint64_t id, int timeout_ms)
#define SOUND4_WEBSERVER_HTTP_OK
void impactfm_Webserver_FreeString(char *str)
uint64_t impactfm_Webserver_tcp2(unsigned int listenport, unsigned int listenport_secure, const char *socket_ip, unsigned int socket_port, const struct impactfm_CParameters *parameters)
#define SOUND4_INVALID_WEBSERVER_ID
void impactfm_Webserver_SetAppHealth(struct impactfm_CInstance *instance, int httpcode, const char *contenttype, const char *content)
static void MonoToStereo_Planar(CDynLib &dynlib, const float *input, float *outputL, float *outputR, size_t nFrame)
static void MonoToStereo(CDynLib &dynlib, const float *input, float *output, size_t nFrame)
static void AudioMonoFromLiveStereo(CDynLib &dynlib, const uint8_t *payload, float *output)
static void StereoToMono(CDynLib &dynlib, const float *input, float *output, size_t nFrame)
static void AudioMonoToLiveStereo(CDynLib &dynlib, const float *input, uint8_t *payload)
static void AudioConvertFrom(CDynLib &dynlib, const uint8_t *payload, float *output, size_t nSpl, impactfm_SampleFormat fmt)
static std::wstring UTF8ToWString(const std::string &str)
static void AudioConvertTo(CDynLib &dynlib, const float *input, uint8_t *payload, size_t nSpl, impactfm_SampleFormat fmt)
static void StereoToMono_Planar(CDynLib &dynlib, const float *inputL, const float *inputR, float *output, size_t nFrame)
static std::string WStringToUTF8(const std::wstring &wstr)
static constexpr const char * process_shortname
static void SetLogSeverity(CDynLib &dynlib, LogSeverity severity)
static void SanityCheck(CDynLib &dynlib, bool a_bCheckFrames=true)
static void _log_cb_c(impactfm_LogSeverity severity, const char *c_msg)
std::function< void(LogSeverity, const std::string &)> log_cb_t
static void SetLoggerCallback(CDynLib &dynlib, log_cb_t cb)
static unsigned int GetBytesFromFormat(CDynLib &dynlib, const SampleFormat fmt)
static constexpr const char * process_name
static SampleFormat GetFormatFromName(CDynLib &dynlib, const std::string &name)
static std::string GetFormatName(CDynLib &dynlib, const SampleFormat fmt)
static unsigned int GetChunkSizeInFrames()
static unsigned int GetSampleRate()
static unsigned int GetChannelCount()
static unsigned int GetAudioInputCount()
static unsigned int GetAudioOutputCount()
static std::string GetVersion()
static std::vector< unsigned int > GetPossibleChunkSizeInFrames()
@ 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
@ info
info
Definition sound4cl.hpp:285
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)
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)