// Crossover: clean crossovers as a multi-out plugin
// 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 .
#![cfg_attr(feature = "simd", feature(portable_simd))]
#[cfg(not(feature = "simd"))]
compile_error!("Compiling without SIMD support is currently not supported");
use crossover::fir::{FirCrossover, FirCrossoverType};
use crossover::iir::{IirCrossover, IirCrossoverType};
use nih_plug::prelude::*;
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::Arc;
mod crossover;
/// The number of channels this plugin supports. Hard capped at 2 for SIMD reasons.
pub const NUM_CHANNELS: u32 = 2;
/// The number of bands. Not used directly here, but this avoids hardcoding some constants in the
/// crossover implementations.
pub const NUM_BANDS: usize = 5;
const MIN_CROSSOVER_FREQUENCY: f32 = 40.0;
const MAX_CROSSOVER_FREQUENCY: f32 = 20_000.0;
struct Crossover {
params: Arc,
buffer_config: BufferConfig,
/// Provides the LR24 crossover.
iir_crossover: IirCrossover,
/// Provides the linear-phase LR24 crossover.
fir_crossover: FirCrossover,
/// Set when the number of bands has changed and the filters must be updated.
should_update_filters: Arc,
}
#[derive(Params)]
struct CrossoverParams {
/// The number of bands between 2 and 5
#[id = "bandcnt"]
pub num_bands: IntParam,
// We'll only provide frequency controls, as gain, panning, solo, mute etc. is all already
// provided by Bitwig's UI
#[id = "xov1fq"]
pub crossover_1_freq: FloatParam,
#[id = "xov2fq"]
pub crossover_2_freq: FloatParam,
#[id = "xov3fq"]
pub crossover_3_freq: FloatParam,
#[id = "xov4fq"]
pub crossover_4_freq: FloatParam,
// Having this parameter first or after the number of bands makes more sense, but this way the
// band control plus the four crossovers fits exactly in Bitwig's parameter list
#[id = "xovtyp"]
pub crossover_type: EnumParam,
}
// The `non_exhaustive` is to prevent adding cases for latency compensation when adding more types
// later
#[derive(Debug, Clone, Copy, PartialEq, Eq, Enum)]
#[non_exhaustive]
enum CrossoverType {
#[id = "lr24"]
#[name = "LR24"]
LinkwitzRiley24,
#[id = "lr24-lp"]
#[name = "LR24 (LP)"]
LinkwitzRiley24LinearPhase,
}
impl CrossoverParams {
fn new(should_update_filters: Arc) -> Self {
let crossover_range = FloatRange::Skewed {
min: MIN_CROSSOVER_FREQUENCY,
max: MAX_CROSSOVER_FREQUENCY,
factor: FloatRange::skew_factor(-1.0),
};
let crossover_smoothing_style = SmoothingStyle::Logarithmic(100.0);
let crossover_value_to_string = formatters::v2s_f32_hz_then_khz(0);
let crossover_string_to_value = formatters::s2v_f32_hz_then_khz();
Self {
num_bands: IntParam::new(
"Band Count",
2,
IntRange::Linear {
min: 2,
max: NUM_BANDS as i32,
},
)
.with_callback({
let should_update_filters = should_update_filters.clone();
Arc::new(move |_| should_update_filters.store(true, Ordering::Relaxed))
}),
// TODO: More sensible default frequencies
crossover_1_freq: FloatParam::new("Crossover 1", 200.0, crossover_range)
.with_smoother(crossover_smoothing_style)
.with_value_to_string(crossover_value_to_string.clone())
.with_string_to_value(crossover_string_to_value.clone()),
crossover_2_freq: FloatParam::new("Crossover 2", 1000.0, crossover_range)
.with_smoother(crossover_smoothing_style)
.with_value_to_string(crossover_value_to_string.clone())
.with_string_to_value(crossover_string_to_value.clone()),
crossover_3_freq: FloatParam::new("Crossover 3", 5000.0, crossover_range)
.with_smoother(crossover_smoothing_style)
.with_value_to_string(crossover_value_to_string.clone())
.with_string_to_value(crossover_string_to_value.clone()),
crossover_4_freq: FloatParam::new("Crossover 4", 10000.0, crossover_range)
.with_smoother(crossover_smoothing_style)
.with_value_to_string(crossover_value_to_string.clone())
.with_string_to_value(crossover_string_to_value.clone()),
crossover_type: EnumParam::new("Type", CrossoverType::LinkwitzRiley24).with_callback(
Arc::new(move |_| should_update_filters.store(true, Ordering::Relaxed)),
),
}
}
}
impl Default for Crossover {
fn default() -> Self {
let should_update_filters = Arc::new(AtomicBool::new(false));
Crossover {
params: Arc::new(CrossoverParams::new(should_update_filters.clone())),
buffer_config: BufferConfig {
sample_rate: 1.0,
min_buffer_size: None,
max_buffer_size: 0,
process_mode: ProcessMode::Realtime,
},
iir_crossover: IirCrossover::new(IirCrossoverType::LinkwitzRiley24),
fir_crossover: FirCrossover::new(FirCrossoverType::LinkwitzRiley24LinearPhase),
should_update_filters,
}
}
}
impl Plugin for Crossover {
const NAME: &'static str = "Crossover";
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 = NUM_CHANNELS;
const DEFAULT_NUM_OUTPUTS: u32 = NUM_CHANNELS;
const DEFAULT_AUX_OUTPUTS: Option = Some(AuxiliaryIOConfig {
// Two to five of these busses will be used at a time
num_busses: 5,
num_channels: NUM_CHANNELS,
});
const PORT_NAMES: PortNames = PortNames {
main_input: None,
// We won't output any sound here
main_output: Some("The Void"),
aux_inputs: None,
aux_outputs: Some(&["Band 1", "Band 2", "Band 3", "Band 4", "Band 5"]),
};
fn params(&self) -> Arc {
self.params.clone()
}
fn accepts_bus_config(&self, config: &BusConfig) -> bool {
// Only do stereo
config.num_input_channels == NUM_CHANNELS
&& config.num_output_channels == NUM_CHANNELS
&& config.aux_output_busses.num_channels == NUM_CHANNELS
}
fn initialize(
&mut self,
_bus_config: &BusConfig,
buffer_config: &BufferConfig,
context: &mut impl InitContext,
) -> bool {
self.buffer_config = *buffer_config;
// Make sure the filter states match the current parameters
self.update_filters(1);
// The FIR filters are linear-phase and introduce latency
match self.params.crossover_type.value() {
CrossoverType::LinkwitzRiley24 => (),
CrossoverType::LinkwitzRiley24LinearPhase => {
context.set_latency_samples(self.fir_crossover.latency())
}
}
true
}
fn reset(&mut self) {
self.iir_crossover.reset();
self.fir_crossover.reset();
}
fn process(
&mut self,
buffer: &mut Buffer,
aux: &mut AuxiliaryBuffers,
context: &mut impl ProcessContext,
) -> ProcessStatus {
// Right now both crossover types only do 24 dB/octave Linkwitz-Riley style crossovers
match self.params.crossover_type.value() {
CrossoverType::LinkwitzRiley24 => {
context.set_latency_samples(0);
self.process_iir(buffer, aux);
}
CrossoverType::LinkwitzRiley24LinearPhase => {
context.set_latency_samples(self.fir_crossover.latency());
self.process_fir(buffer, aux);
}
}
ProcessStatus::Normal
}
}
impl Crossover {
/// Takes care of all of the boilerplate in zipping the outputs together to get a nice iterator
/// friendly and SIMD-able interface for the processing function. Prevents having to branch per
/// sample. The closure receives an input sample and it should write the output samples for each
/// band to the array.
fn process_iir(&mut self, buffer: &mut Buffer, aux: &mut AuxiliaryBuffers) {
let aux_outputs = &mut aux.outputs;
let (band_1_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_2_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_3_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_4_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_5_buffer, _) = aux_outputs.split_first_mut().unwrap();
// Snoclists for days
for (
(
(
((main_channel_samples, band_1_channel_samples), band_2_channel_samples),
band_3_channel_samples,
),
band_4_channel_samples,
),
band_5_channel_samples,
) in buffer
.iter_samples()
.zip(band_1_buffer.iter_samples())
.zip(band_2_buffer.iter_samples())
.zip(band_3_buffer.iter_samples())
.zip(band_4_buffer.iter_samples())
.zip(band_5_buffer.iter_samples())
{
// We can avoid a lot of hardcoding and conditionals by restoring the original array structure
let bands = [
band_1_channel_samples,
band_2_channel_samples,
band_3_channel_samples,
band_4_channel_samples,
band_5_channel_samples,
];
// Only update the filters when needed
if self.should_update_filters() {
self.update_filters(1);
}
self.iir_crossover.process(
self.params.num_bands.value as usize,
&main_channel_samples,
bands,
);
// The main output should be silent as the signal is already evenly split over the other
// bands
for sample in main_channel_samples {
*sample = 0.0;
}
}
}
/// `process_iir()`, but for the linear-phase FIR crossovers. This processes an entire channel
/// at once instead of processing per-sample since we use FFT convolution.
fn process_fir(&mut self, buffer: &mut Buffer, aux: &mut AuxiliaryBuffers) {
// In theory we could do smoothing in between processed blocks, but this hsould be fine
if self.should_update_filters() {
self.update_filters(buffer.len() as u32);
}
let aux_outputs = &mut aux.outputs;
let (band_1_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_2_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_3_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_4_buffer, aux_outputs) = aux_outputs.split_first_mut().unwrap();
let (band_5_buffer, _) = aux_outputs.split_first_mut().unwrap();
// We can avoid a lot of hardcoding and conditionals by restoring the original array structure
for channel_idx in 0..buffer.channels() {
let main_io = &mut buffer.as_slice()[channel_idx];
let band_outputs = [
&mut band_1_buffer.as_slice()[channel_idx],
&mut band_2_buffer.as_slice()[channel_idx],
&mut band_3_buffer.as_slice()[channel_idx],
&mut band_4_buffer.as_slice()[channel_idx],
&mut band_5_buffer.as_slice()[channel_idx],
];
self.fir_crossover.process(
self.params.num_bands.value as usize,
main_io,
band_outputs,
channel_idx,
);
// The main output should be silent as the signal is already evenly split over the other
// bands
main_io.fill(0.0);
}
}
/// Returns whether the filters should be updated. There are different updating functions for
/// the IIR and FIR crossovers.
fn should_update_filters(&mut self) -> bool {
// Technically this would only require a &self since `should_update_filters` has interior
// mutability, but with the current setup this doesn't cause any problems and makes the
// former a bit more obvious
self.should_update_filters
.compare_exchange(true, false, Ordering::Relaxed, Ordering::Relaxed)
.is_ok()
|| self.params.crossover_1_freq.smoothed.is_smoothing()
|| self.params.crossover_2_freq.smoothed.is_smoothing()
|| self.params.crossover_3_freq.smoothed.is_smoothing()
|| self.params.crossover_4_freq.smoothed.is_smoothing()
}
/// Update the filter coefficients for the crossovers. The step size can be used when the filter
/// coefficietns aren't updated every sample.
fn update_filters(&mut self, step_size: u32) {
let crossover_frequencies = [
self.params.crossover_1_freq.smoothed.next_step(step_size),
self.params.crossover_2_freq.smoothed.next_step(step_size),
self.params.crossover_3_freq.smoothed.next_step(step_size),
self.params.crossover_4_freq.smoothed.next_step(step_size),
];
match self.params.crossover_type.value() {
CrossoverType::LinkwitzRiley24 => self.iir_crossover.update(
self.buffer_config.sample_rate,
self.params.num_bands.value as usize,
crossover_frequencies,
),
CrossoverType::LinkwitzRiley24LinearPhase => self.fir_crossover.update(
self.buffer_config.sample_rate,
self.params.num_bands.value as usize,
crossover_frequencies,
),
}
}
}
impl ClapPlugin for Crossover {
const CLAP_ID: &'static str = "nl.robbertvanderhelm.crossover";
const CLAP_DESCRIPTION: Option<&'static str> =
Some("Cleanly split a signal into multiple bands");
const CLAP_MANUAL_URL: Option<&'static str> = Some(Self::URL);
const CLAP_SUPPORT_URL: Option<&'static str> = None;
const CLAP_FEATURES: &'static [ClapFeature] = &[
ClapFeature::AudioEffect,
ClapFeature::Stereo,
ClapFeature::Utility,
];
}
impl Vst3Plugin for Crossover {
const VST3_CLASS_ID: [u8; 16] = *b"CrossoverRvdH...";
const VST3_CATEGORIES: &'static str = "Fx|Tools";
}
nih_export_clap!(Crossover);
nih_export_vst3!(Crossover);