Version 2.0.2

- DynamicInitialize/DynamicDestroy APIs to dynamically load Superpowered. Allows for multiple loading into the same process. Example usecase: Superpowered in a VST plugin DLL.
- Guitar distortion effect including Marshall cabinet, ADA cabinet and V-Twin preamp simulation, 5-band equalizer, bass and treble tone controls and two distortion sounds.

Author: gaborszanto

Examples_Android/SuperpoweredRecorder/app/src/main/cpp/RecorderExample.cpp

@@ -7,8 +7,6 @@
 #include <SuperpoweredRecorder.h>
 #include <unistd.h>
 
-#define log_write __android_log_write
-
 static SuperpoweredAndroidAudioIO *audioIO;
 static Superpowered::Recorder *recorder;
 
@@ -85,7 +83,7 @@ Java_com_superpowered_recorder_MainActivity_StopRecording(JNIEnv * __unused env,
     // It's better to do this asynchronously, but we're just blocking (sleeping) now.
     while (!recorder->isFinished()) usleep(100000);
 
-    log_write(ANDROID_LOG_DEBUG, "RecorderExample", "Finished recording.");
+    __android_log_print(ANDROID_LOG_DEBUG, "Recorder", "Finished recording.");
     delete recorder;
 }
 

README.md

@@ -241,4 +241,4 @@ Superpowered FFT benefits from ideas in Construction of a High-Performance FFT b
 
 The Superpowered MP3 and AAC decoder benefits from optimizations by Ken Cooke.
 
-Superpowered version 2.0.0
+Superpowered version 2.0.2

Superpowered/Superpowered.h

@@ -7,7 +7,8 @@
 namespace Superpowered {
 
 /// @fn Initialize(const char *licenseKey, bool enableAudioAnalysis, bool enableFFTAndFrequencyDomain, bool enableAudioTimeStretching, bool enableAudioEffects, bool enableAudioPlayerAndDecoder, bool enableCryptographics, bool enableNetworking);
-/// @brief Initializes the Superpowered SDKs.
+/// @brief Initializes the Superpowered SDKs. Use this only once, when your app or library initializes.
+/// Do not use this if Superpowered is loaded dynamically and might be loaded multiple times (a DLL in a VST host for example). @see DynamicInitialize
 /// @param licenseKey Visit https://superpowered.com/dev to register license keys.
 /// @param enableAudioAnalysis Enables Analyzer, LiveAnalyzer, Waveform and BandpassFilterbank.
 /// @param enableFFTAndFrequencyDomain Enables FrequencyDomain, FFTComplex, FFTReal and PolarFFT.
@@ -26,6 +27,17 @@ void Initialize(const char *licenseKey,
                 bool enableCryptographics,
                 bool enableNetworking);
 
+/// @fn DynamicInitialize(const char *licenseKey);
+/// @brief Use this if Superpowered is loaded in a dynamically loaded library (such as a DLL on Windows). It allows for multiple loads (DLL in a VST host example). Enables all features.
+/// @param licenseKey Visit https://superpowered.com/dev to register license keys.
+void DynamicInitialize(const char *licenseKey);
+
+/// @fn DynamicDestroy();
+/// @brief Use this if Superpowered is used in a dynamically loaded library (such as a DLL on Windows), when the dynamically loaded library instance unloads (even if multiple loads may happen).
+/// This function will block waiting for all Superpowered background threads to exit when the last instance of the library is unloaded.
+/// Please note that you still need to "properly" release all Superpowered objects _before_ this call, such as delete all players, effects, etc.
+void DynamicDestroy();
+
 }
 
 /**

Superpowered/SuperpoweredAdvancedAudioPlayer.h

@@ -88,12 +88,11 @@ class AdvancedAudioPlayer {
     static const float MaxPlaybackRate;      ///< The maximum playback rate or scratching speed: 20.
 
 /// @brief Set the folder to store for temporary files. Used for HLS and progressive download only.
-/// Call this before any player instance is created. It will create a subfolder with the name "SuperpoweredAAP" in the folder.
+/// Call this before any player instance is created.
+/// It will create a subfolder with the name "SuperpoweredAAP" in the specified folder (and will clear all content inside SuperpoweredAAP if it exists already).
+/// If you need to clear the folder before your app quits, use NULL for the path.
 /// @param path File system path of the folder.
     static void setTempFolder(const char *path);
-
-/// @brief Removes the temp folder and all content inside. Use this when your program ends.
-    static void clearTempFolder();
 
 /// @return Returns with the temporary folder path.
     static const char *getTempFolderPath();

Superpowered/SuperpoweredGuitarDistortion.h

@@ -0,0 +1,51 @@
+#ifndef Header_SuperpoweredGuitarDistortion
+#define Header_SuperpoweredGuitarDistortion
+
+#include "SuperpoweredFX.h"
+
+namespace Superpowered {
+
+struct gdInternals;
+
+/// @brief Guitar distortion effect including Marshall cabinet, ADA cabinet and V-Twin preamp simulation, 5-band equalizer, bass and treble tone controls and two distortion sounds.
+/// One instance allocates around 32 kb memory.
+class GuitarDistortion: public FX {
+public:
+    float gainDecibel;     ///< Gain value in decibel. Limit: -96 to 24.
+    float drive;           ///< Drive percentage, from 0 to 1.
+    float bassFrequency;   ///< High-pass filter frequency in Hz. From 1 Hz to 250 Hz.
+    float trebleFrequency; ///< Low-pass filter frequency in Hz. From 6000 Hz to the half of the current sample rate.
+    float eq80HzDecibel;   ///< EQ 80 Hz decibel gain. Limit: -96 to 24.
+    float eq240HzDecibel;  ///< EQ 240 Hz decibel gain. Limit: -96 to 24.
+    float eq750HzDecibel;  ///< EQ 750 Hz decibel gain. Limit: -96 to 24.
+    float eq2200HzDecibel; ///< EQ 2200 Hz decibel gain. Limit: -96 to 24.
+    float eq6600HzDecibel; ///< EQ 6600 Hz decibel gain. Limit: -96 to 24.
+    bool distortion0;      ///< Enables the first distortion sound, that is similar to Boss DS-1.
+    bool distortion1;      ///< Enables the second distortion sound, that is similar to Tyrian.
+    bool marshall;         ///< Enables Marshall cabinet simulation.
+    bool ada;              ///< Enables ADA cabinet simulation. Adds a lot of bass and treble.
+    bool vtwin;            ///< Enables V-Twin preamp simulation. Recommended for blues/jazz.
+    
+/// @brief Constructor. Enabled is false by default.
+/// @param samplerate The initial sample rate in Hz.
+    GuitarDistortion(unsigned int samplerate);
+    ~GuitarDistortion();
+    
+/// @brief Processes the audio. Always call it in the audio processing callback, regardless if the effect is enabled or not for smooth, audio-artifact free operation.
+/// It's never blocking for real-time usage. You can change all properties on any thread, concurrently with process().
+/// @return If process() returns with true, the contents of output are replaced with the audio output. If process() returns with false, the contents of output are not changed.
+/// @param input Pointer to floating point numbers. 32-bit interleaved stereo input. Can point to the same location with output (in-place processing).
+/// @param output Pointer to floating point numbers. 32-bit interleaved stereo output.
+/// @param numberOfFrames Number of frames to process. Recommendation for best performance: multiply of 4, minimum 64.
+    bool process(float *input, float *output, unsigned int numberOfFrames);
+    
+private:
+    gdInternals *internals;
+    GuitarDistortion(const GuitarDistortion&);
+    GuitarDistortion& operator=(const GuitarDistortion&);
+};
+
+}
+
+#endif
+

Superpowered/SuperpoweredRSA.h

@@ -62,6 +62,9 @@ namespace Superpowered {
         /// @return Encrypted data or NULL on error. Don't forget to free() this at a later point to prevent memory leaks!
         unsigned char *encrypt(unsigned int inputLengthBytes, void *input, bool OAEP_PSS_V21);
 
+        /// @return Returns with the encrypted output data size in bytes.
+        unsigned int getEncryptedOutputSizeBytes();
+        
     private:
         friend class RSAPrivateKey;
         RSAContext *internals;