Struct GraphBuilder 

pub struct GraphBuilder<T: Transcendental, const BUF_SIZE: usize> { /* private fields */ }

Mutable builder for an immutable signal graph.

Node factory

The builder holds an Arc<NodeFactory> for constructing nodes by type name, provided at construction via GraphBuilder::new.

Implementations

impl<T: Transcendental, const BUF_SIZE: usize> GraphBuilder<T, BUF_SIZE>

pub fn new( factory: Arc<NodeFactory<T, BUF_SIZE>>, backend_factory: Arc<BackendFactory<T>>, ) -> Self

Create a new empty graph builder without a node factory.

pub fn add_node( &mut self, type_name: &str, params: &Params, ) -> Result<usize, RegistryError>

Add a node by type name using the internal factory.

The type must have been registered in the factory before calling this method.

Returns the index of the newly added node.

Errors

Returns RegistryError if no factory is set or the type name is not registered.

pub fn add_node_with_id( &mut self, type_name: &str, params: &Params, id: NodeId, ) -> Result<usize, RegistryError>

Add a node with an explicit NodeId.

Like add_node but uses the provided id. Important for serialization where external references depend on exact IDs.

pub fn set_node_backend(&mut self, idx: usize, name: String)

Assign a named backend to the node at the given index.

During build, the backend is created via the builder’s BackendFactory and passed to the node’s Node::resolve_backend.

pub fn add_resource(&mut self, resource: GraphResource)

Register a named resource (tape loop, buffer, etc.).

pub fn node_count(&self) -> usize

Number of nodes added to the builder so far.

pub fn set_default_backend( &mut self, name: String, params: HashMap<String, ParamValue>, )

Set the default backend name and parameters. Nodes without an explicit backend in [NodeDef::backend] will use this during build.

pub fn default_backend_name(&self) -> Option<&String>

Get the default backend name, if set.

pub fn set_sample_rate(&mut self, sr: f32)

Set the sample rate for this builder.

pub fn set_clock_tx(&mut self, tx: ActorRef<ClockTick>)

Set the clock tick channel (audio → control).

pub fn backend_factory(&self) -> &Arc<BackendFactory<T>>

Access the shared backend factory.

pub fn add_source(&mut self, source: Box<dyn Source<T, BUF_SIZE>>) -> usize

Add a source node and return its index.

pub fn add_processor( &mut self, processor: Box<dyn Processor<T, BUF_SIZE>>, ) -> usize

Add a processor node and return its index.

pub fn add_sink(&mut self, sink: Box<dyn Sink<T, BUF_SIZE>>) -> usize

Add a sink node and return its index.

pub fn add_router(&mut self, router: Box<dyn Router<T, BUF_SIZE>>) -> usize

Add a Router node (N→M configurable routing, no DSP).

pub fn connect_signal( &mut self, from_node: usize, from_port: usize, to_node: usize, to_port: usize, )

Connect signal ports (audio data).

pub fn connect_control( &mut self, from_node: usize, from_port: usize, to_node: usize, to_port: usize, )

Connect control ports (modulation values).

pub fn connect_clock( &mut self, from_node: usize, from_port: usize, to_node: usize, to_port: usize, )

Connect clock ports (timing events).

pub fn connect_feedback( &mut self, from_node: usize, from_port: usize, to_node: usize, to_port: usize, )

Connect feedback ports (delay lines, state carryover).

pub fn build(self) -> Result<Graph<T, BUF_SIZE>, BuildError>

Build the graph.

Creates backends for nodes that have a backend name set (via [NodeDef::backend] or the builder’s default). Finds the active (driver) node and stores its index for Graph::run.