Struct SimpleFmSynth 

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

Simple 2-operator FM synthesizer

Basic FM architecture: one modulator modulates one carrier. Ideal for:

• Creating metallic timbres
• Bell-like sounds
• Complex harmonic structures

Example

use rill_core::time::ClockTick;
use rill_core::traits::ActionContext;
use rill_core_dsp::generators::*;
use rill_core::traits::algorithm::Algorithm;

let tick = ClockTick::default();
let ctx = ActionContext::new(&tick);

// Create FM synthesizer with 2:1 frequency ratio
let mut fm = SimpleFmSynth::<f32>::new(
    440.0,  // carrier frequency (A4)
    2.0,    // modulator one octave higher
    1.5     // modulation index
);
fm.init(44100.0);

// Generate sample
let mut output = [0.0_f32];
fm.process(None, &mut output).unwrap();
let sample = output[0];

Implementations

impl<T: Transcendental> SimpleFmSynth<T>

pub fn new(carrier_freq: f32, modulator_ratio: f32, modulation_index: T) -> Self

Create a new FM synthesizer

Arguments

• carrier_freq - carrier frequency in Hz
• modulator_ratio - frequency ratio (modulator/carrier)
• modulation_index - modulation index (0.0 - 10.0)

pub fn with_carrier_waveform(self, waveform: Waveform) -> Self

Set carrier waveform

Default is sine wave

pub fn with_modulator_waveform(self, waveform: Waveform) -> Self

Set modulator waveform

Default is sine wave

pub fn set_carrier_frequency(&mut self, freq: f32)

Set carrier frequency

pub fn set_modulation_index(&mut self, index: T)

Set modulation index

Arguments

• index - modulation index (0.0 - 10.0)

pub fn set_ratio(&mut self, ratio: f32)

Set frequency ratio

Arguments

• ratio - ratio (modulator/carrier), typically 0.1 - 10.0

pub fn modulation_index(&self) -> T

Get current modulation index

pub fn ratio(&self) -> f32

Get current frequency ratio

Trait Implementations

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

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 process( &mut self, _input: Option<&[T]>, output: &mut [T], ) -> ProcessResult<()>

Process one block of signal.

fn metadata(&self) -> AlgorithmMetadata

Descriptive metadata (defaults to empty).

fn apply_command(&mut self, _value: T)

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

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

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy + Transcendental> Copy for SimpleFmSynth<T>

impl<T: Transcendental> Generator<T> for SimpleFmSynth<T>

fn phase(&self) -> T

Get current phase (0.0 - 1.0)

fn set_phase(&mut self, phase: T)

Set phase

fn frequency(&self) -> f32

Get frequency in Hz

fn set_frequency(&mut self, freq: f32)

Set frequency

fn amplitude(&self) -> T

Get amplitude

fn set_amplitude(&mut self, amp: T)

Set amplitude

fn reset_phase(&mut self)

Reset phase to 0

impl<T: Transcendental> ModulatableGenerator<T> for SimpleFmSynth<T>

fn modulate_frequency(&mut self, amount: T)

Apply frequency modulation

fn modulation_index(&self) -> T

Modulation index (current FM amount)

fn set_modulation_index(&mut self, index: T)

Set modulation index