Struct ControlMapper 

pub struct ControlMapper<T: Transcendental> { /* private fields */ }

Maps an incoming normalized control value [0, 1] to a parameter range using a MappingStrategy.

Implements Algorithm<T>. The input (if present) is treated as the normalized value; when input is None (source mode), the value received via apply_command() is used instead.

Example

use rill_core_dsp::mapping::{ControlMapper, MappingStrategy};
use rill_core::traits::Algorithm;
use rill_core::time::ClockTick;
use rill_core::traits::ActionContext;

let mut mapper = ControlMapper::new(20.0, 20000.0, MappingStrategy::Exponential { exponent: 2.0 });
let tick = ClockTick::default();
let ctx = ActionContext::new(&tick);

// Use apply_command to set the incoming value
mapper.apply_command(0.5);    // halfway in normalized range
let mut output = [0.0f32; 1];
mapper.process(None, &mut output).unwrap();
// output maps 0.5 exponentially between 20..20000

Implementations

impl<T: Transcendental> ControlMapper<T>

pub fn new(min: T, max: T, strategy: MappingStrategy) -> Self

Create a new ControlMapper.

pub fn set_range(&mut self, min: T, max: T)

Update the mapping range.

pub fn set_strategy(&mut self, strategy: MappingStrategy)

Update the mapping strategy.

pub fn current_mapped(&self) -> T

Get the current mapped value (without processing).

Trait Implementations

impl<T: Transcendental> Algorithm<T> for ControlMapper<T>

fn process( &mut self, input: Option<&[T]>, output: &mut [T], ) -> ProcessResult<()>

Process one block of signal.

fn apply_command(&mut self, value: T)

Receive a real-time command value from the control path.

fn init(&mut self, _sample_rate: f32)

Initialise the algorithm with a sample rate.

fn reset(&mut self)

Reset the algorithm to its initial state.

fn metadata(&self) -> AlgorithmMetadata

Descriptive metadata (defaults to empty).

impl<T: Clone + Transcendental> Clone for ControlMapper<T>

fn clone(&self) -> ControlMapper<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Transcendental> Debug for ControlMapper<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.