Effects & VST3

var reverb = new ReverbEffect
{
    RoomSize   = 0.7f,  // 0.0–1.0 (larger = longer tail)
    Damping    = 0.5f,  // 0.0–1.0 (higher = darker)
    Mix        = 0.3f,  // 0.0–1.0 wet/dry
    Width      = 1.0f,  // 0.0–1.0 stereo spread
    WetLevel   = 0.33f, // 0.0–1.0 reverb tail level
    DryLevel   = 1.0f   // 0.0–1.0 direct signal level
};

// Or use a preset
reverb.SetPreset(ReverbPreset.LargeHall);

var delay = new DelayEffect
{
    Time     = 375,    // ms (1–5000)
    Repeat   = 0.4f,   // feedback 0.0–1.0
    Damping  = 0.3f,   // high-freq damping 0.0–1.0
    Mix      = 0.3f,
    PingPong = true    // stereo ping-pong
};
delay.SetPreset(DelayPreset.PingPong);

var eq = new EqualizerEffect();
eq.Band0Gain = +6.0f;       // boost 31.25Hz by 6dB
eq.Band9Gain = -3.0f;       // cut 16kHz by 3dB
float g = eq.Band4Gain;     // query 500Hz band

// Retune a band completely: index, centre frequency, Q, gain in dB
eq.SetBandGain(4, 500f, 1.0f, +2.5f);

eq.SetPreset(EqualizerPreset.Rock);

var comp = new CompressorEffect
{
    Threshold    = 0.7f,   // 0.0–1.0 linear amplitude
    Ratio        = 4.0f,   // 1.0–100.0 (N:1)
    AttackTime   = 10f,    // 0.1–1000ms
    ReleaseTime  = 100f,   // 1–2000ms
    MakeupGain   = 1.2f    // linear amplitude multiplier
};
comp.SetPreset(CompressorPreset.VocalGentle);

var smartMaster = new SmartMasterEffect();
mixer.AddMasterEffect(smartMaster);

// Factory preset by speaker type
smartMaster.LoadSpeakerPreset(SpeakerType.Studio);
// Other types: Default, HiFi, Headphone, Club, Concert

// Save / load user presets
smartMaster.Save("my-studio");
smartMaster.Load("my-studio");

// Reset to defaults
smartMaster.ResetToDefaults();

// Auto room measurement
await smartMaster.StartMeasurementAsync(); // plays test signal, auto-calibrates EQ
smartMaster.CancelMeasurement();
MeasurementStatusInfo status = smartMaster.GetMeasurementStatus();
// Result is saved to a "measured" preset, never applied on its own

// Edit the live config, then rebuild the chain from it
SmartMasterConfig cfg = smartMaster.GetConfiguration();
cfg.GraphicEQGains[5] = 2.5f;                   // 63 Hz
smartMaster.ApplyConfiguration();

// Lifecycle
smartMaster.OnPlaybackStopped(); // call when transport stops

var config = new SmartMasterConfig
{
    GraphicEQGains       = new float[SmartMasterConfig.EqBands], // 30 bands, dB (0 = flat)
    CompressorEnabled    = true,
    CompressorThreshold  = 0.5f,           // 0.0–1.0 linear
    CompressorRatio      = 4.0f,           // 4:1
    CompressorAttack     = 10f,            // ms
    CompressorRelease    = 100f,           // ms
    SubharmonicEnabled   = false,
    SubharmonicMix       = 0.0f,           // 0.0–1.0, parallel level
    SubharmonicLowLevel  = 1.0f,           // 24–36 Hz band
    SubharmonicHighLevel = 1.0f,           // 36–56 Hz band
    LimiterThreshold     = -0.1f,          // dBFS
    LimiterCeiling       = -0.1f,          // dBFS
    LimiterRelease       = 50f             // ms
};

// Arrays are fitted to the length the chain expects, so an older or hand
// edited preset can't silently disable a stage.
smartMaster.ApplyConfiguration(config);

using OwnaudioNET.Effects;

// Discover plugins
List<string>         paths = VST3PluginHost.FindPlugins();
List<VST3PluginInfo> info  = VST3PluginHost.ScanPluginsQuick();

// Load plugin
VST3PluginHost host = await VST3PluginHost.CreateAsync("/path/plugin.vst3");

if (!host.IsEffect) { host.Dispose(); return; } // reject instruments

// Initialize audio processing
int sampleRate = OwnaudioNet.Engine!.Config.SampleRate;
bool ready     = await host.InitializeAudioAsync(sampleRate, maxBlockSize: 1024);

// Add to mixer or track effect chain
mixer.AddMasterEffect(host.GetProcessor());
// or: trackFx.AddEffect(host.GetProcessor());

// Plugin UI
host.OpenEditor();
await host.OpenEditorAsync();
host.CloseEditor();
var size = await host.GetEditorSizeAsync();

// Read parameters
VST3ParameterInfo[] params = await host.GetParametersAsync();
int    count = await host.GetParameterCountAsync();
double value = await host.GetParameterAsync(paramId);

// Set parameters
host.SetParameter(paramId, 0.5);
await host.SetParametersAsync(new Dictionary<int, double> { { paramId, 0.75 } });

// Preset state (for project save/load)
byte[]? state = await host.GetStateAsync();
await host.SetStateAsync(state);

// Cleanup
await host.DisposeAsync();
// or:
host.Dispose();

using var analyzer = new EffectSpectrumAnalyzer(_mixer.CreateEffectTap(vocals.Id));

// from a 30–60 ms timer
if (analyzer.Update())
{
    ReadOnlySpan<float> dry = analyzer.PreMagnitudesDb;    // going into the chain
    ReadOnlySpan<float> wet = analyzer.PostMagnitudesDb;   // coming out of it
    ReadOnlySpan<float> hz  = analyzer.Frequencies;
    Redraw(hz, dry, wet);
}

using var tap = _mixer.CreateMasterEffectTap();

var pre  = new float[4096];
var post = new float[4096];

int read = tap.Read(pre, post);   // 0 = nothing new yet; both spans get the same count