Struct GraphBuilder 

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

Mutable builder for an immutable signal graph.

Implementations

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

pub fn new() -> Self

Create a new empty graph builder.

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

Register a named resource.

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 add_node( &mut self, registry: &NodeRegistry<T, BUF_SIZE>, type_name: &str, params: &NodeParams, ) -> Result<usize, RegistryError>

Add a node by type name via the registry.

Looks up the type name in registry, calls its NodeConstructor::construct, and pushes the resulting NodeVariant into the graph. The node’s NodeId is automatically assigned from its position in the graph.

Returns the index of the newly added node.

Errors

Returns RegistryError if the type name is not registered or construction fails.

pub fn add_node_with_id( &mut self, registry: &NodeRegistry<T, BUF_SIZE>, type_name: &str, params: &NodeParams, id: NodeId, ) -> Result<usize, RegistryError>

Add a node with an explicit NodeId.

Unlike add_node which auto-assigns IDs, this method uses the provided id directly. Important for serialization where external references (e.g. patchbay bindings) depend on exact IDs.

Returns the index (position) of the newly added node.

Errors

Returns RegistryError if the type name is not registered or construction fails.

Panics

If id duplicates a previously registered ID the error is reported by the caller — this method does not check for duplicates.

pub fn node_count(&self) -> usize

Return the number of nodes added so far.

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

Connect signal output port from_port of node from_node to signal input port to_port of node to_node.

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

Connect a control output to a control input.

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

Connect a clock output to a clock input.

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

Connect a feedback output to a feedback input. This creates a feedback path (previous output → current input).

pub fn build( self, clock_source: Box<dyn ClockSource>, ) -> Result<SignalGraph<T, BUF_SIZE>, BuildError>

Build the immutable SignalGraph.

Errors

Returns BuildError::CycleDetected if the signal edges contain a cycle.

Trait Implementations

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

fn default() -> Self

Returns the “default value” for a type.