Struct Graph 

pub struct Graph<T: Transcendental, const BUF_SIZE: usize> {
    pub system_clock: Option<Arc<SystemClock>>,
    /* private fields */
}

Immutable signal graph with static DAG topology.

Once built the graph cannot be modified. The graph owns no processing logic — it is a pure topology description. Processing is driven by port-level methods (pre_process, snapshot_feedback, propagate) called from external code (e.g. a real-time signal callback or an offline renderer).

Fields

system_clock: Option<Arc<SystemClock>>

Optional shared system clock, updated by external sync sources (MIDI, JACK transport). When set, the I/O callback reads BPM from it and creates ClockTick::with_tempo.

Implementations

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

pub fn nodes(&self) -> &[NodeVariant<T, BUF_SIZE>]

Borrow the node array (read-only).

pub fn current_tick(&self) -> ClockTick

Return the current clock tick.

pub fn node_count(&self) -> usize

Return the number of nodes in the graph.

pub fn topo_order(&self) -> &[usize]

Return the topological ordering of node indices.

pub fn resources(&self) -> &[GraphResource]

Access the named resources (tape loops, etc.) allocated for this graph.

pub fn process_block(&mut self, tick: &ClockTick) -> ProcessResult<()>

Process one block of signal data driven by an external ClockTick.

Called from the backend’s process callback. Performs:

1. Drains the graph’s actor mailbox (applies queued SetParameters).
2. Creates a RenderContext from the tick.
3. Calls process_block on the source node and recursively propagates through the DAG via Port::propagate.
4. Sends the tick to the parent ActorRef (if any).

The graph is !Send + !Sync — it stays on the I/O callback thread.

pub fn into_processing_state(self) -> ProcessingState<T, BUF_SIZE>

Consume the graph and return a [ProcessingState] that owns all parts needed for the I/O callback loop.

ProcessingState is !Send + !Sync — it stays on the I/O thread and is moved into the backend’s process callback closure.

pub fn handle(&self) -> ActorRef<CommandEnum>

Obtain an ActorRef for sending commands to this graph.