// Safety limiter: ear protection for the 21st century
// Copyright (C) 2022 Robbert van der Helm
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
use nih_plug::prelude::*;
use std::sync::Arc;
/// After reaching the threshold, it will take this many milliseconds under that threshold to fade
/// back to the normal signal. Peaking above the threshold again during this time resets this.
const MORSE_FADEOUT_MS: f32 = 5000.0;
struct SafetyLimiter {
params: Arc,
buffer_config: BufferConfig,
/// `MORSE_FADEOUT_MS` translated into samples.
morse_fadeout_samples_total: u32,
/// The number of samples into the fadeout.
morse_fadeout_samples_current: u32,
}
#[derive(Params)]
struct SafetyLimiterParams {
/// The level at which to start engaging the safety limiter. Stored as a gain ratio instead of
/// decibels.
#[id = "threshold"]
threshold_gain: FloatParam,
}
impl Default for SafetyLimiterParams {
fn default() -> Self {
Self {
threshold_gain: FloatParam::new(
"Threshold",
util::db_to_gain(0.00),
// This parameter mostly exists to allow small peaks through, so no need to go below
// 0 dBFS
FloatRange::Linear {
min: util::db_to_gain(0.0),
max: util::db_to_gain(12.0),
},
)
// And smoothing is not necessary here since we'll disable automation
.non_automatable()
.with_unit(" dB")
.with_value_to_string(formatters::v2s_f32_gain_to_db(2))
.with_string_to_value(formatters::s2v_f32_gain_to_db()),
}
}
}
impl Default for SafetyLimiter {
fn default() -> Self {
SafetyLimiter {
params: Arc::new(SafetyLimiterParams::default()),
buffer_config: BufferConfig {
sample_rate: 1.0,
min_buffer_size: None,
max_buffer_size: 0,
process_mode: ProcessMode::Realtime,
},
morse_fadeout_samples_total: 0,
morse_fadeout_samples_current: 0,
}
}
}
impl Plugin for SafetyLimiter {
const NAME: &'static str = "Safety Limiter";
const VENDOR: &'static str = "Robbert van der Helm";
const URL: &'static str = "https://github.com/robbert-vdh/nih-plug";
const EMAIL: &'static str = "mail@robbertvanderhelm.nl";
const VERSION: &'static str = "0.1.0";
const DEFAULT_NUM_INPUTS: u32 = 2;
const DEFAULT_NUM_OUTPUTS: u32 = 2;
fn params(&self) -> Arc {
self.params.clone()
}
fn accepts_bus_config(&self, config: &BusConfig) -> bool {
config.num_input_channels == config.num_output_channels
}
fn initialize(
&mut self,
_bus_config: &BusConfig,
buffer_config: &BufferConfig,
_context: &mut impl ProcessContext,
) -> bool {
self.buffer_config = *buffer_config;
self.morse_fadeout_samples_total =
(MORSE_FADEOUT_MS / 1000.0 * buffer_config.sample_rate).round() as u32;
true
}
fn reset(&mut self) {
self.morse_fadeout_samples_current = 0;
}
fn process(
&mut self,
buffer: &mut Buffer,
_context: &mut impl ProcessContext,
) -> ProcessStatus {
// Don't do anything when bouncing
if self.buffer_config.process_mode == ProcessMode::Offline {
return ProcessStatus::Normal;
}
for mut channel_samples in buffer.iter_samples() {
let mut is_peaking = false;
for sample in channel_samples.iter_mut() {
is_peaking |= sample.abs() > self.params.threshold_gain.value;
}
// TODO: Do the morse code thing, right now this just fades to silence
// TODO: Reset the morse code phase when peaking and `self.morse_fadeout_samples_current
// == self.morse_fadeout_samples_total`
if is_peaking {
for sample in channel_samples {
*sample = 0.0;
}
// This is the number of samples into the fadeout
self.morse_fadeout_samples_current = 1;
} else if self.morse_fadeout_samples_current < self.morse_fadeout_samples_total {
let original_t = self.morse_fadeout_samples_current as f32
/ self.morse_fadeout_samples_total as f32;
for sample in channel_samples {
*sample *= original_t;
}
self.morse_fadeout_samples_current += 1;
}
}
ProcessStatus::Normal
}
}
impl ClapPlugin for SafetyLimiter {
const CLAP_ID: &'static str = "nl.robbertvanderhelm.safety-limiter";
const CLAP_DESCRIPTION: &'static str = "Plays SOS in Morse code when redlining";
const CLAP_FEATURES: &'static [&'static str] = &["audio_effect", "stereo", "utility"];
const CLAP_MANUAL_URL: &'static str = Self::URL;
const CLAP_SUPPORT_URL: &'static str = Self::URL;
}
impl Vst3Plugin for SafetyLimiter {
const VST3_CLASS_ID: [u8; 16] = *b"SafetyLimtrRvdH.";
const VST3_CATEGORIES: &'static str = "Fx|Tools";
}
nih_export_clap!(SafetyLimiter);
nih_export_vst3!(SafetyLimiter);