Struct RillProgram 

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

A compiled program ready to run inside the rill graph.

Implementations

impl<T: Transcendental> RillProgram<T>

pub fn new(ir: Ir) -> Self

Create a program from a compiled IR. Allocates state, delays, registers, and builds the execution schedule. Built-ins are NOT instantiated — use new_with if the IR references built-in functions.

pub fn new_with( ir: Ir, registry: &Registry<T>, sample_rate: f32, ) -> Result<Self, CompileError>

Create a program from a compiled Ir, instantiating all built-ins via the provided Registry. Also sets the initial sample_rate.

Parses builtins from the IR, allocates registers, state, and delays, and builds the execution schedule. The resulting program implements Algorithm<T>.

pub fn param_index(&self, name: &str) -> Option<usize>

Index of a named parameter, if present.

pub fn set_param(&mut self, idx: usize, value: ParamValue)

Set a parameter by index. RT-safe (plain store).

pub fn param(&self, idx: usize) -> ParamValue

Current value of a parameter by index.

pub fn params_meta(&self) -> &[ParamDef]

Metadata for all parameters (name, default, range).

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

Reference implementation: the MVP per-sample interpreter. Used by tests as a numerical oracle; not the production path.

pub fn init(&mut self, sample_rate: f32)

Forward initialisation to all built-in instances.

Trait Implementations

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

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

Process one block of signal.

fn reset(&mut self)

Reset the algorithm to its initial state.

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 metadata(&self) -> AlgorithmMetadata

Descriptive metadata (defaults to empty).

impl<T: Transcendental> BlockBuiltin<T> for RillProgram<T>

fn set_param(&mut self, index: usize, value: &ParamValue)

Set a parameter by index.