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,   // 0.0–1.0, and against the name higher = brighter repeats (0 = silent)
    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

// Sets the gain of band 4. The frequency and Q arguments are ignored.
eq.SetBandGain(4, 500f, 1.0f, +2.5f);

eq.SetPreset(EqualizerPreset.Rock);

var comp = new CompressorEffect
{
    Threshold    = -12.0f, // dB, -60–0
    Ratio        = 4.0f,   // 1.0–100.0 (N:1)
    AttackTime   = 10f,    // 0.1–1000ms
    ReleaseTime  = 100f,   // 1–2000ms
    KneeWidth    = 6.0f,   // dB, 0 = hard knee
    MakeupGain   = 1.6f    // dB
};
comp.SetPreset(CompressorPreset.VocalGentle);

var comp = new OwnCompressorEffect
{
    Threshold         = -18f,  // dBFS, -60–0
    Ratio             = 4f,    // 1–100 (above 20 it acts as a limiter)
    Knee              = 6f,    // dB, 0 = hard knee … 24
    Attack            = 10f,   // ms, 0.01–300 (10 % → 90 % of the step)
    Release           = 100f,  // ms, 5–5000
    AutoRelease       = true,  // slower release after long, deep compression
    Lookahead         = 2f,    // ms, 0–10 — also the effect's latency
    Detector          = OwnCompressorDetector.Rms,          // or Peak
    Topology          = OwnCompressorTopology.FeedForward,  // or Feedback
    StereoLink        = 1f,    // 0 = independent channels … 1 = fully linked
    ChannelMode       = OwnCompressorChannelMode.LeftRight, // or MidSide
    SidechainHighPass = 100f,  // Hz, 0 = off or 20–500 (detector only)
    Makeup            = 3f,    // dB, -24–+24
    AutoMakeup        = false,
    Range             = 60f,   // dB, most gain reduction allowed
    Mix               = 1f     // parallel mix, 0 = dry … 1 = fully compressed
};

// Or start from a preset
var bus = new OwnCompressorEffect(OwnCompressorPreset.Bus);

// Meters, when the effect is processed directly
float grDb = comp.GainReductionDb;

var delay = new OwnDelayEffect
{
    TimeLeft      = 375f,   // ms, 15–4000
    TimeRight     = 500f,   // ms, 15–4000
    Feedback      = 0.45f,  // 0.0–1.0
    CrossFeedback = 0.1f,   // 0.0–1.0, L ↔ R (ping-pong)
    TimeMode      = OwnDelayTimeMode.Glide,  // or Crossfade
    Glide         = 150f,   // ms, 5–2000 (Glide mode only)
    Drive         = 6f,     // dB, 0–24 tape saturation in the loop
    LowCut        = 150f,   // Hz, 20–2000
    HighCut       = 6000f,  // Hz, 500–20000
    Diffusion     = 0.3f,   // 0.0–1.0, smears repeats towards a reverb
    ModRate       = 0.6f,   // Hz, 0.05–10 wow
    ModDepth      = 0.5f,   // ms, 0–5
    DuckAmount    = 0.5f,   // 0 = off … 1, the dry input pushes the wet down
    DuckThreshold = -30f,   // dBFS
    Width         = 1.2f,   // 0 = mono … 2
    Mix           = 0.3f
};

// Tempo sync
delay.SyncToTempo(120, OwnDelayNoteValue.DottedEighth, OwnDelayNoteValue.Quarter);

// Hold whatever is in the loop forever
delay.Freeze = true;

delay.SetPreset(OwnDelayPreset.TapeEcho);

var rider = new OwnDynamicAmpEffect
{
    TargetLoudness  = -14f,   // LUFS, -40 to -5 (-14 streaming, -23 EBU R128)
    Window          = 8f,     // s, 0.4 to 60, memory of the loudness estimate
    MaxBoost        = 12f,    // dB, 0 to 30
    MaxCut          = 12f,    // dB, 0 to 30
    RiseRate        = 1.5f,   // dB/s, 0.1 to 20
    FallRate        = 3f,     // dB/s, 0.1 to 40
    Tolerance       = 1f,     // dB, 0 to 6, dead band around the target
    Smoothing       = 300f,   // ms, 10 to 5000, rounds the gain curve
    RelativeGate    = -10f,   // LU below the programme, quieter passages keep the gain
    FreezeThreshold = -55f,   // LUFS, silence and noise never get pumped up
    Ceiling         = -1f,    // dBTP, -20 to 0
    Lookahead       = 5f      // ms, 1 to 10, also the latency
};

// Or start from a preset
var broadcast = new OwnDynamicAmpEffect(OwnDynamicAmpPreset.Broadcast);

// Meters, when the effect is processed directly
float programLufs = rider.ProgramLoudness;
float gainDb      = rider.CurrentGainDb;

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 - needs AudioConfig.EnableInput = true and a running mixer,
// the noise plays and the mic records through the mixer the effect sits on
smartMaster.StartMicMonitoring();          // optional: live level via GetLastMicLevel()
await smartMaster.StartMeasurementAsync(); // plays pink noise, measures the room
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